Pour commencer à contribuer, vous allez devoir mettre en place un environnement de développement - un endroit où vous pouvez travailler sur du code et où où il peut se comporter de la même manière que l'environnement de tous les autres.

De nombreuses parties de BeeWare utilisent les mêmes outils : une version spécifique de Python, et des commandes d'environnement virtuel.

Python

Python est un langage de script disponible sur plusieurs systèmes d'exploitation. différents systèmes d'exploitation. Cependant, selon le système que vous utilisez, votre version de Python sera différente. que vous utilisez, votre version de Python sera différente. Pour cette raison, nous spécifions exactement la version de Python avec laquelle le code doit fonctionner. fonctionnera.

Pour les instructions suivantes, nous supposerons que vous savez exactement quelle version de Python vous devez installer. exactement quelle version de Python vous devez installer. Normalement, cela est dans le fichier README.md ou dans les informations du tutoriel. Notre CI ont besoin de savoir exactement quelle version de Python est requise. Donc si vous êtes vraiment coincé, essayez de regarder le fichier .github/workflows/ci.yml pour la version spécifique dont vous avez besoin.

Pour contribuer à BeeWare, vous devez avoir un interpréteur Python installé sur votre machine. Sur macOS et Windows, nous recommandons d'utiliser les [installateurs officiels de Python.org installers] (https://www.python.org/downloads/) ; sur Linux, nous recommandons d'utiliser la version de Python fournie par le gestionnaire de paquets de votre distribution.

Environnements virtuels

Lorsque Python est installé, il fournit un environnement global unique. Par défaut, si vous installez un paquetage, il sera installé dans cet environnement global. par défaut, si vous installez un paquetage, il sera installé dans cet environnement global. environnement global.

Cependant, si vous travaillez sur plus d'un projet Python, il est il est tout à fait probable que ces projets aient des exigences différentes - et et, dans certains cas, contradictoires. Ce dont vous avez besoin, c'est d'un moyen d'isoler chaque projet afin que l'installation d'un paquet pour un projet ne pour un projet ne force pas l'installation de ce même paquetage pour le second projet.

Pour ce faire, on utilise des environnements virtuels. Un environnement virtuel, ou venv, est un environnement isolé qui peut être facilement créé, détruit ou recréé. Tout paquet installé dans l'environnement virtuel n'est n'est accessible qu'à l'intérieur de cet environnement virtuel. Les environnements virtuels sont sont parfois qualifiés de "bac à sable" - un endroit sûr pour jouer, où si Si vous faites une erreur, vous pouvez détruire tout ce que vous avez construit et recommencer. recommencer.

Python fournit le module venv pour créer de nouveaux environnements virtuels. Chaque environnement virtuel a un nom qui peut être utilisé pour identifier l'environnement. l'environnement. Pour créer un nouvel environnement virtuel nommé "my-venv", exécutez :

$ python -m venv my-venv

La version de Python que vous utilisez pour créer l'environnement virtuel sera la version utilisée par défaut à l'intérieur de l'environnement virtuel. virtuel. Si vous avez plusieurs versions de Python installées, ou si vous utilisez un outil comme pyenv pour gérer les versions de Python, assurez-vous que la version de Python qui est actuellement active (ou la version à laquelle vous faites référence lorsque vous invoquez la commande -m venv). lorsque vous invoquez la commande -m venv) est la version que vous souhaitez. Une fois qu'un virtuel a été créé, vous ne pouvez pas changer la version de Python qu'il utilise. Pour changer la version de Python, vous devez créer un nouvel environnement virtuel.

L'invocation de -m venv va créer l'environnement virtuel, mais l'environnement n'est pas encore actif. l'environnement n'est pas encore actif. L'environnement virtuel est un ensemble de de fichiers sur le disque, stockés dans un répertoire qui correspond au nom de l'environnement. de l'environnement virtuel. Pour activer l'environnement virtuel, vous exécutez l'un des fichiers générés dans le cadre de l'environnement :

$ source my-venv/bin/activate

Un préfixe sera alors ajouté à l'invite de votre ligne de commande pour vous indiquer que vous vous trouvez dans un environnement virtuel. pour vous indiquer que vous êtes dans un environnement virtuel :

(my-venv) $

Tant que l'environnement virtuel est actif, toute commande pip install affectera *n'affectera que l'environnement virtuel. Cela n'a pas d'importance si vous changez de répertoire répertoires - si votre invite a un préfixe, cet environnement virtuel est actif. actif.

Si vous ouvrez une deuxième fenêtre de terminal, l'environnement ne sera pas actif. actif - vous devez réactiver l'environnement à chaque session de terminal vous devez réactiver l'environnement dans chaque session de terminal où vous souhaitez l'utiliser. Si vous obtenez des erreurs concernant l'indisponibilité de bibliothèques que vous êtes certain d'avoir installées, vérifiez si votre environnement virtuel est actif. vérifiez si votre environnement virtuel est actif.

Pour désactiver l'environnement virtuel, exécutez :

(my-venv) $ désactiver

Une fois désactivé, le préfixe sera supprimé de l'invite.