guide définitif de python sur Mac OSX

installer Xcode (facultatif)

Xcode n’est pas requis pour installer Homebrew et Python, mais il est requis pour certains paquets Homebrew. Si vous pouvez épargner les gigaoctets, téléchargez-le depuis L’App Store. Sinon, vous devriez pouvoir compléter ce guide sans cela sur MacOS Mojave. Aucune garantie pour les futures versions de MacOS.,

Installer Xcode Outils de Ligne de Commande (obligatoire)

Alors que Xcode n’est pas nécessaire, Xcode Outils de Ligne de Commande sont.

ouvrez un terminal et tapez la commande suivante pour installer les outils de ligne de commande Xcode requis pour Homebrew:

xcode-select --install

Si vous utilisez MacOS Mojave, vous devrez installer les en-têtes système MacOS., Ce N’est pas nécessaire pour Catalina.

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

Vous serez invité à entrer votre mot de passe utilisateur OSX pour installer ce package SDK requis.

Si vous avez choisi de ne pas installer Xcode, vous devrez ajouter la variable d’environnementSDKROOT à votre shell:

echo "export SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk" >> ~/.bash_profile

Si vous utilisez zsh, changez la fin de cette dernière commande de ~/.bash_profile dans ~/.zshrc .

Installer Homebrew

Homebrew est un gestionnaire de paquets pour OSX. Nous allons l’utiliser pour installer les dépendances pour compiler et installer python., (Remarque: les versions précédentes de ce guide utilisaient Homebrew pour installer python, mais ce n’est pas nécessaire. Nous utiliserons pyenv pour installer python sous peu.)

rendez-vous ici: https://brew.sh/

Suivez les instructions pour installer Homebrew, qui, au moment de cette écriture est de coller cette ligne dans un terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Installer pyenv

Maintenant que Homebrew est installé, vous pouvez installer pyenv et les paquets nécessaires à l’installation de python.,

Installer pyenv:

brew install pyenv

Installer python paquets nécessaires:

brew install openssl readline sqlite3 xz zlib

Ajouter pyenv à votre shell:

echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bash_profile

Si vous utilisez zsh, changer la fin de cette dernière commande à partir de ~/.bash_profile de ~/.zshrc .

(facultatif) vous pouvez égalementbrew install pyenv-virtualenvpour ajouter le support virtualenv à pyenv, mais ce n’est pas nécessaire car la plupart du travail virtualenv que vous ferez avecpoetry après l’avoir installé plus tard. Certaines personnes aiment le supportpyenv-virtualenv de toute façon.,

installer Python avec Homebrew

Cette étape est facultative car nous n’utiliserons jamais ce python dans un projet, mais elle est recommandée pour deux raisons:

• raison 1: ce python installé par Homebrew devient un filet de sécurité au cas où nous oublierions de passer à un python installé par pyenv, nous ne polluerons pas accidentellement
• Raison 2: il devient un endroit pour installer des paquets globaux avec pipx., Cela vous permet de basculer entre les versions de python à volonté en utilisant pyenv tout en conservant un ensemble cohérent d’utilitaires globaux comme flake8 Et black qui sont toujours disponibles et ne polluent pas le python global.

Installer la dernière version de python 3.x et pipx
(facultatif, pour les paquets globaux)

# Install python 3.x
brew install python# Install pipx to manage global packages
python3 -m pip install --user pipx
python3 -m userpath append ~/.local/bin# Install global packages
python3 -m pipx install flake8
python3 -m pipx install black

installez la dernière version de python 2.7
(vraiment facultative, uniquement pour protéger le système python des erreurs)

brew install python@2

Si vous avez choisi d’installer python 2.,7, vous ne l’utiliserez jamais (sauf si vous avez un code hérité que vous devez exécuter). La fin de vie de Python 2.7 est fin 2019. Voir le compte à rebours de fin de vie de Python 2.7. Il agit uniquement comme un filet de sécurité pour protéger le système python au cas où vous commettriez une erreur.

Installer python!

enfin! Il est temps d’installer python

commençons par un nouveau shell. Fermez votre terminal et ouvrez-le à nouveau pour vous assurer que pyenv a été chargé.,

Vous pouvez voir une liste de versions de python avec pyenv:

Choisissez une version et l’installer:

pyenv install 3.7.3

Ensuite définie comme le mondial de version de python:

pyenv global 3.7.3

Cela devrait prendre effet immédiatement. Vérifiez que vous êtes sur la bonne version de python:

$ python -V
Python 3.7.3

Félicitations, vous avez python! À faire, non?? Nope.

Install Poetry

Poetry est un gestionnaire de paquets python fantastique qui simplifie la gestion des dépendances, la gestion de l’environnement virtuel, ainsi que la construction et la publication de code python.,

Pourquoi devriez-vous utiliser la poésie:

• Obsoletes virtualenv, virtualenvwrapper, pipenv, setup.py, requirements.txt, et plus encore.
• vit en dehors de python, vous n’avez donc pas besoin de l’installer avec pip ou de vous soucier des conflits de paquets.
• Sépare les dépendances d’exécution comme requests dans les dépendances de développement comme pytest.,
• Il utilise le simple et facile à comprendrepypackage.toml fichier de pep-518 pour contenir tout sur le projet.
• interface CLI similaires au bien connu des gestionnaires de paquets comme npm et yarn.

installez poetry en suivant le guide d’installation. Au moment d’écrire ces lignes, exécutez simplement cette commande:

curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python

Poetry crée automatiquement tous vos environnements virtuels à la demande dans un seul répertoire par défaut., Si vous préférez que vos environnements virtuels vivent dans le même répertoire avec le code (comme un répertoire .venv dans votre projet), vous pouvez exécuter cette commande:

poetry config virtualenvs.in-project true

En savoir plus sur poetry

Prevent accidents

maintenant, nous allons ajouter quelques éléments importants à l’environnement terminal pour s’assurer que tout fonctionne environnement de développement Python.

Ouvrez le fichier ~/.bash_profile (ou ~/.zshrc pour zsh)., Créer ce fichier si il n’existe pas et assurez-vous qu’il a les lignes suivantes:

Enregistrez le fichier, puis fermez et ré-ouvrez votre fenêtre de terminal pour activer les modifications.

Vous avez maintenant activé pipx, pyenv, poetry et verrouillé pip pour ne fonctionner qu’à l’intérieur d’un environnement virtuel afin que vous ne puissiez pas installer accidentellement des paquets python dans l’environnement python global. Ne vous inquiétez pas, si vous voulez toujours installer un paquet python globalement (vous ne le faites pas!,) vous pouvez utiliser gpip ou gpip3 pour remplacer cette protection et forcer un paquet à s’installer globalement.

Aller de l’avant!

Vous êtes maintenant prêt à travailler avec python!

Vous n’avez plus besoin de créer des environnements virtuels ou d’écrire un passe-partout déroutant.,

créez simplement un nouveau projet python:

poetry new myproject
cd myproject

décidez d’une version python pour ce projet:

pyenv local 3.7.3

puis ajoutez des dépendances au projet, telles que le requests package:

poetry add requests

et vos dépendances de développement:

poetry add --dev pytest

un environnement virtuel est automatiquement créé avec la version Python que vous avez choisie et les paquets python ajoutés.

Vous n’avez jamais besoin d’entrer dans cet environnement virtuel. Pas plus .venv/bin/activate ou deactivate., Bien que vous pouvez si vous voulez. Vous pouvez également créer vos propres environnements virtuels non gérés en utilisant les dernières fonctionnalités venv intégrées à python 3 pour créer vos environnements virtuels. N’utilisez pas virtualenv.

pour exécuter votre projet dans l’environnement virtuel, faites quelque chose comme ceci:

poetry run python myscript.py

ou créez une section scripts danspyproject.py pour rendre le point d’entrée disponible en dehors de l’environnement virtuel.

consultez la documentation de la commande run dans poetry pour connaître les différentes façons d’exécuter vos projets python à partir de la CLI.

Profitez-en!