Os aplicativos do Google App Engine em Python se comunicam com o servidor da web usando o padrão CGI. Quando o servidor recebe uma solicitação para seu aplicativo, ele executa o aplicativo com os dados solicitados nas variáveis do ambiente e no fluxo de entrada padrão (para dados POST). Para responder, o aplicativo grava a resposta no fluxo de saída padrão, incluindo cabeçalhos e conteúdo HTTP.
Vamos começar pela implementação de um pequeno aplicativo que exibe uma mensagem curta.
Crie um diretório denominado helloworld. Todos os arquivos deste aplicativo residem neste diretório.
Dentro do diretório helloworld, crie um arquivo denominado helloworld.py e coloque nele o conteúdo abaixo:
print 'Content-Type: text/plain' print '' print 'Hello, world!'
Este script Python responde a uma solicitação com um cabeçalho HTTP descrevendo o conteúdo, uma linha em branco e a mensagem Hello, world!.
Um aplicativo do Google App Engine possui um arquivo de configuração, denominado app.yaml. Entre outras coisas, esse arquivo descreve quais scripts de manipulador devem ser usados para quais URLs.
Dentro do diretório helloworld, crie um arquivo denominado app.yaml e coloque nele o conteúdo abaixo:
application: helloworld version: 1 runtime: python api_version: 1 handlers: - url: /.* script: helloworld.py
De cima para baixo, este arquivo de configuração informa o seguinte sobre o aplicativo:
|
helloworld. Ao registrar seu aplicativo com o Google App Engine na etapa final, você irá selecionar um identificador exclusivo e atualizará este valor. Durante o desenvolvimento, esse valor pode ser qualquer coisa. Por enquanto, deixe-o definido como helloworld.1 do código deste aplicativo. Se você ajustar esse valor antes de enviar novas versões do seu software aplicativo, o Google App Engine reterá as versões anteriores e permitirá que você retorne a uma versão anterior usando o console administrativo.python, versão "1". Ambientes de execução e linguagens adicionais poderão ser suportados no futuro./.* (todos os URLs) deve ser manipulada pelo script helloworld.py.A sintaxe deste arquivo está no formato YAML. Para obter uma lista completa de opções de configuração, consulte a referência do app.yaml.
Com um script de manipulador e um arquivo de configuração mapeando cada URL para o manipulador, o aplicativo está completo. Agora você pode testá-lo com o servidor da web fornecido com o SDK do Google App Engine.
Inicie o servidor da web com o comando abaixo, fornecendo-lhe o caminho para o diretório helloworld:
google_appengine/dev_appserver.py helloworld/
Agora, o servidor da web está sendo executado e recebendo as solicitações pela porta 8080. Para testar o aplicativo, visite o URL abaixo a partir do seu navegador:
Para obter mais informações sobre como executar o servidor da web para desenvolvimento, incluindo como alterar a porta usada, consulte a referência do Servidor da web para desenvolvimento ou execute o comando com a opção --help.
Você pode deixar o servidor da web sendo executado durante o desenvolvimento do seu aplicativo. O servidor da web acompanha as alterações nos seus arquivos de origem e os recarrega quando necessário.
Tente agora: Deixe o servidor da web sendo executado e edite helloworld.py para alterar Hello, world! para outro valor. Recarregue http://localhost:8080/ para ver a alteração.
Para desconectar o servidor da web, verifique se a janela do terminal está ativa e pressione Control-C (ou a tecla "break" apropriada em seu console).
Deixe o servidor da web sendo executado durante o restante deste tutorial. Se precisar interrompê-lo, você pode reiniciá-lo novamente executando o comando acima.
Agora você tem um aplicativo completo do Google App Engine! Você pode implementar esta simples saudação agora mesmo e compartilhá-la com usuários em todo o mundo. Antes de implementá-la, considere a possibilidade de usar uma estrutura de aplicativo da web para facilitar a adição de recursos.
Vá para Uso da estrutura do webapp.