Como usar bibliotecas do Python

Como declarar e gerenciar dependências

As dependências dos aplicativos Python são declaradas em um arquivo requirements.txt. Exemplo:

Flask==0.10.1
google-cloud-storage

Use qualquer pacote Python compatível com Linux no ambiente flexível do App Engine, inclusive pacotes que exijam extensões nativas (C).

O tempo de execução do Python instalar automaticamente todas as dependências declaradas em seu requirements.txt durante a implantação.

Como instalar dependências localmente

Durante o desenvolvimento e o teste local do aplicativo, recomendamos que você use o venv para isolar as dependências do aplicativo dos pacotes do sistema. Isso também garante que as dependências terão a mesma versão na máquina local e no aplicativo implantado.

Para usar o venvvenv na instalação de dependências, conclua as etapas a seguir:

Mac OS/Linux

Observação: estas instruções descrevem como configurar um ambiente virtual no Python 3. Para aplicativos do Python 2, use virtualenv (link em inglês) para configurar um ambiente virtual.
  1. Crie um ambiente Python isolado em um diretório fora do projeto e ative-o:
    python3 -m venv env
    source env/bin/activate
  2. Navegue até o diretório do projeto e instale as dependências:
    cd YOUR_PROJECT
    pip install  -r requirements.txt

Windows

Observação: estas instruções descrevem como configurar um ambiente virtual no Python 3. Para aplicativos do Python 2, use virtualenv (link em inglês) para configurar um ambiente virtual.

Use o PowerShell para executar os pacotes Python.

  1. Localize a instalação do PowerShell.
  2. Clique com o botão direito do mouse no atalho do PowerShell e inicie-o como administrador.
  3. Crie um ambiente Python isolado em um diretório fora do projeto e ative-o:
    python -m venv env
    env\Scripts\activate
  4. Navegue até o diretório do projeto e instale as dependências:
    cd YOUR_PROJECT
    pip install -r requirements.txt

Agora, ao executar o aplicativo, você pode ter certeza de que apenas as dependências declaradas em requirements.txt estão disponíveis.

Dica: normalmente, você desconhecerá as dependências exatas. Depois de instalar as dependências, use pip freeze para gravar o nome e a versão de todos os pacotes instalados no requirements.txt.

Como instalar um framework da Web

Você precisará usar uma estrutura da Web para permitir que seu aplicativo disponibilize solicitações da Web. É possível usar qualquer biblioteca da Web do Python, inclusive estas:

Para usar um framework web específico, basta adicioná-lo a seu requirements.txt:

Flask==0.10.1

Como instalar um servidor WSGI

Algumas bibliotecas da Web têm servidores WSGI integrados. Porém, poucos deles são indicados para disponibilizar o tráfego de produção. A maioria dos aplicativos da Web usa um servidor WSGI independente, como Gunicorn, uWSGI ou Waitress. Para mais informações sobre como instalar, configurar e usar um servidor WSGI, consulte inicialização do aplicativo.

Como instalar a biblioteca de cliente do Google Cloud

A biblioteca de cliente do Google Cloud para Python é uma biblioteca de cliente para acessar serviços do Google Cloud Platform que reduz significativamente o código padrão que você precisa escrever. A biblioteca fornece abstrações detalhadas de API para facilitar o entendimento. Ela usa os idiomas do Python, funciona bem com a biblioteca padrão e se integra melhor à sua base de código. Assim, você passa mais tempo criando o código necessário.

Para instalar a biblioteca no local:

pip install google-cloud

A biblioteca de cliente também gerencia automaticamente para você a autenticação no local usando o Google Cloud SDK:

gcloud auth login