Utiliser les bibliothèques Python

Déclarer et gérer les dépendances

Les dépendances pour les applications Python sont déclarées dans un fichier requirements.txt standard. Exemple :

Flask==0.10.1
google-cloud-storage

Dans l'environnement flexible App Engine, vous pouvez utiliser n'importe quel package Python compatible avec Linux, y compris ceux qui requièrent des extensions (C) natives.

L'environnement d'exécution Python installe automatiquement toutes les dépendances déclarées dans le fichier requirements.txt lors du déploiement.

Installer les dépendances en local

Lorsque vous développez et testez votre application en local, nous vous recommandons d'utiliser venv pour isoler les dépendances de votre application des packages système. Ainsi, vous avez la garantie que les mêmes versions de ces dépendances seront utilisées sur votre ordinateur local et sur l'application déployée.

Pour utiliser venv afin d'installer des dépendances, procédez comme suit :

macOS/Linux

  1. Créez un environnement Python isolé dans un répertoire externe à votre projet et activez-le :
    python3 -m venv env
    source env/bin/activate
  2. Accédez au répertoire de votre projet et installez des dépendances :
    cd YOUR_PROJECT
    pip install  -r requirements.txt

Windows

Exécutez les packages Python à l'aide de PowerShell.

  1. Localisez votre installation de PowerShell.
  2. Cliquez avec le bouton droit sur le raccourci PowerShell et démarrez une session en tant qu'administrateur.
  3. Créez un environnement Python isolé dans un répertoire externe à votre projet et activez-le :
    python -m venv env
    env\Scripts\activate
  4. Accédez au répertoire de votre projet et installez des dépendances :
    cd YOUR_PROJECT
    pip install -r requirements.txt

Dorénavant, lorsque vous exécutez votre application, vous avez la certitude que seules les dépendances déclarées dans le fichier requirements.txt sont disponibles.

Conseil : Souvent, vous ne saurez pas précisément les dépendances dont vous disposez. Après avoir installé les dépendances, vous pouvez utiliser pip freeze pour écrire les noms et versions de tous les packages installés dans le fichier requirements.txt.

Installer un framework Web

Vous devez utiliser un framework Web pour permettre à votre application de répondre aux requêtes Web. Vous pouvez utiliser n'importe quel framework Web Python, par exemple :

Pour utiliser un framework Web particulier, il vous suffit de l'ajouter à votre fichier requirements.txt :

Flask==0.10.1

Installer un serveur WSGI

Certains frameworks Web offrent des serveurs WSGI intégrés. Cependant, peu d'entre eux sont adaptés à la diffusion du trafic de production. La plupart des applications Web utilisent un serveur WSGI autonome tel que Gunicorn, uWSGI ou Waitress. Pour en savoir plus sur l'installation, la configuration et l'utilisation d'un serveur WSGI, consultez la section Démarrage de l'application.

Installer la bibliothèque cliente Google Cloud

La bibliothèque cliente Google Cloud pour Python permet d'accéder facilement aux services Google Cloud Platform. De ce fait, la quantité de code récurrent que vous devez développer est fortement réduite. La bibliothèque fournit des abstractions d'API de haut niveau, ce qui implique que les API sont plus faciles à comprendre et à utiliser. Cette bibliothèque accepte les idiomes de Python, fonctionne bien avec la bibliothèque standard et s'intègre mieux à votre base de code. Tout cela signifie que vous pouvez consacrer plus de temps à développer du code qui a une réelle valeur pour vous.

Pour installer la bibliothèque en local :

pip install google-cloud

La bibliothèque cliente peut également gérer automatiquement l'authentification en local par le biais du SDK Google Cloud.

gcloud auth login