Tutoriel 0 - Préparons-nous !

Avant de créer notre première application BeeWare, nous devons nous assurer que nous disposons de tous les prérequis pour le fonctionnement de BeeWare.

Installer Python

La première chose dont nous avons besoin est un interpréteur Python fonctionnel.

Si vous utilisez macOS, une version récente de Python est incluse dans Xcode ou dans les outils de développement en ligne de commande. Pour vérifier si vous l’avez déjà, exécutez la commande suivante :

$ python3 --version

Si Python est installé, vous verrez son numéro de version. Sinon, vous serez invité à installer les outils de développement en ligne de commande.

Si vous êtes sous Windows, vous pouvez obtenir l’installateur officiel à partir du site web de Python. Vous pouvez utiliser n’importe quelle version stable de Python à partir de la 3.8. Nous vous conseillons d’éviter les versions alpha, beta et release candidates à moins que vous ne sachiez vraiment ce que vous faites.

Distributions alternatives de Python

Il existe de nombreuses façons d’installer Python. Vous pouvez installer Python via homebrew. Vous pouvez utiliser pyenv pour gérer plusieurs installations de Python sur la même machine. Les utilisateurs de Windows peuvent installer Python à partir du Windows App Store. Les utilisateurs ayant une formation en science des données pourraient préfèrer utiliser Anaconda ou Miniconda.

Si vous êtes sous macOS ou Windows, peu importe comment vous avez installé Python – ce qui compte c’est que vous puissiez lancer python3 à partir de l’invite de commande/terminal de votre système d’exploitation, et obtenir un interpréteur Python fonctionnel.

Si vous êtes sous Linux, vous devez utiliser le Python fourni par votre système d’exploitation. Vous pourrez réaliser la majeure partie de ce tutoriel en utilisant un Python non système, mais vous ne pourrez pas empaqueter votre application pour la distribuer à d’autres.

Installer les dépendances

Ensuite, installez les dépendances supplémentaires nécessaires à votre système d’exploitation :

La construction d’applications BeeWare sur macOS nécessite :

  • Git, un système de contrôle de version. Il est inclus dans Xcode ou dans les outils de développement en ligne de commande, que vous avez installés précédemment.

Mise en place d’un environnement virtuel

Nous allons maintenant créer un environnement virtuel – un « bac à sable » (sandbox) que nous pouvons utiliser pour isoler notre travail sur ce tutoriel de notre installation Python principale. Si nous installons des paquets dans l’environnement virtuel, notre installation principale de Python (et tout autre projet Python sur notre ordinateur) ne sera pas affectée. Si nous provoquons un désordre complet dans notre environnement virtuel, nous pourrons simplement l’effacer et recommencer, sans affecter aucun autre projet Python sur notre ordinateur, et sans avoir besoin de réinstaller Python.

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

Si cela a fonctionné, votre prompt devrait maintenant être modifié – il devrait avoir un préfixe (beeware-venv). Cela vous permet de savoir que vous êtes actuellement dans votre environnement virtuel BeeWare. Chaque fois que vous travaillerez sur ce tutoriel, vous devrez vous assurer que votre environnement virtuel est activé. Si ce n’est pas le cas, relancez la dernière commande (la commande activate) pour réactiver votre environnement.

Environnements virtuels alternatifs

Si vous utilisez Anaconda ou miniconda, vous êtes peut-être plus familier avec l’utilisation des environnements conda. Vous avez peut-être aussi entendu parler de virtualenv, un prédécesseur du module intégré venv de Python. De même pour les installations de Python – si vous êtes sous macOS ou Windows, peu importe comment vous créez votre environnement virtuel, tant que vous en avez un. Si vous êtes sous Linux, vous devriez vous en tenir à venv et au Python du système.

Étapes suivantes

Nous avons maintenant mis en place notre environnement. Nous sommes prêts à créer notre première application BeeWare.