definitieve gids voor python op Mac OSX

Install Xcode (optioneel)

Xcode is niet vereist om Homebrew en Python te installeren, maar het is vereist voor sommige Homebrew-pakketten. Als je de gigabytes kunt missen, download het dan in de App Store. Zo niet, moet u in staat zijn om deze gids te voltooien zonder het op MacOS Mojave. Geen garantie voor toekomstige versies van MacOS.,

install Xcode command line tools (required)

terwijl Xcode niet vereist is, zijn de Xcode command line tools wel vereist.

Open een terminal en typ de volgende opdracht om Xcode opdrachtregelprogramma ‘ s te installeren die nodig zijn voor Homebrew:

xcode-select --install

Als u MacOS Mojave gebruikt, moet u de macOS-systeemheaders installeren., Dit is niet vereist voor Catalina.

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

u wordt gevraagd om uw OSX-gebruikerswachtwoord om dit vereiste SDK-pakket te installeren.

Als u ervoor kiest om Xcode niet te installeren, moet u de SDKROOT omgevingsvariabele toevoegen aan uw shell:

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

Als u zsh gebruikt, wijzigt u het einde van dat laatste commando van ~/.bash_profile naar~/.zshrc .

install Homebrew

Homebrew is een pakketbeheerder voor OSX. We zullen het gebruiken om de afhankelijkheden te installeren om python te compileren en te installeren., (Opmerking: eerdere versies van deze gids gebruikt Homebrew om python te installeren, maar dit is niet vereist. We zullen pyenv gebruiken om python binnenkort te installeren.)

ga hier: https://brew.sh/

Volg de aanwijzingen om Homebrew te installeren, wat op het moment van schrijven is om deze regel in een terminal te plakken:

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

Install pyenv

nu Homebrew is geïnstalleerd, kunt u pyenv en de vereiste pakketten installeren om python te installeren.,

Install pyenv:

brew install pyenv

install python required packages:

brew install openssl readline sqlite3 xz zlib

voeg pyenv toe aan uw shell:

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

Als u zsh gebruikt, verander dan het einde van dat laatste commando van ~/.bash_profile to ~/.zshrc .

(optioneel) u kunt ook brew install pyenv-virtualenv om virtualenv-ondersteuning aan pyenv toe te voegen, maar het is niet nodig omdat het meeste virtualenv-werk dat u met poetry zult doen nadat we het later hebben geïnstalleerd. Sommige mensen zoals pyenv-virtualenv ondersteunen hoe dan ook.,

installeer Python met Homebrew

deze stap is optioneel omdat we deze python nooit in een project zullen gebruiken, maar het wordt aanbevolen om twee redenen:

• Reden 1: Deze Homebrew-geïnstalleerde python wordt een vangnet in het geval we vergeten over te schakelen naar een pyenv-geïnstalleerde python, zullen we niet per ongeluk het systeem python vervuilen.
• Reden 2: Het wordt een plaats om globale pakketten met pipx te installeren., Hiermee kunt u switchen tussen python-versies met behulp van pyenv met behoud van een consistente set globale hulpprogramma ‘ s zoals flake8 en black die altijd beschikbaar zijn en de Globale python niet vervuilen.

Installeer de nieuwste python 3.x en pipx
(optioneel, voor globale pakketten)

# 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

Installeer de nieuwste python 2.7
(echt optioneel, alleen om systeempython tegen fouten te beschermen)

brew install python@2

Als u python 2 wilt installeren.,7, Je zult het nooit gebruiken (tenzij je een aantal legacy code die u nodig hebt om uit te voeren). Python 2.7 einde van het leven is aan het einde van 2019. Zie de Python 2.7 end-of-life countdown. Het fungeert alleen als een vangnet om het systeem python te beschermen voor het geval je een fout maakt.

python installeren!

eindelijk! Tijd om python te installeren …

laten we beginnen met een nieuwe shell. Sluit uw terminal en open het opnieuw om te controleren of pyenv is geladen.,

u kunt een lijst met beschikbare pythonversies zien met pyenv:

Kies een versie en installeer deze:

pyenv install 3.7.3

Stel deze dan in als de Globale pythonversie:

pyenv global 3.7.3

Dit moet meteen van kracht worden. Controleer of u op de juiste python versie:

$ python -V
Python 3.7.3

Gefeliciteerd, je hebt python! Klaar, toch?? Nope.

install Poetry

Poetry is een fantastische Python pakketbeheerder die afhankelijkheidsbeheer, virtueel omgevingsbeheer en het bouwen en publiceren van python-code vereenvoudigt.,

waarom u poëzie moet gebruiken:

• Obsoletes virtualenv, virtualenvwrapper, pipenv, setup.py, requirements.txt, en meer.
• woont buiten python, dus je hoeft het niet te installeren met pip of je zorgen te maken over pakketconflicten.
• scheidt runtime afhankelijkheden zoals requests van ontwikkelingsafhankelijkheden zoals pytest.,
• het gebruikt het eenvoudige en gemakkelijk te begrijpen pypackage.toml bestand van pep-518 om alles over het project te bevatten.
• CLI-interface vergelijkbaar met bekende pakketbeheerders zoals npm en yarn.

Installeer poëzie volgens de installatiegids. Voer op het moment van schrijven het volgende commando uit:

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

Poetry creëert automatisch al uw virtuele omgevingen in een enkele map standaard., Als u uw virtuele omgevingen liever in dezelfde map met de code wilt laten wonen (zoals een .venv map in uw project), kunt u dit commando uitvoeren:

poetry config virtualenvs.in-project true

leer meer over poëzie

voorkomen dat er ongelukken gebeuren

nu zullen we een paar belangrijke stukken toevoegen aan de terminal-omgeving om ervoor te zorgen dat alles samen werkt en voorkomen dat onze zorgvuldig geconstrueerde python-ontwikkelomgeving wordt verbroken.

Open het bestand ~/.bash_profile (of ~/.zshrc voor zsh)., Maak dat bestand aan als het niet bestaat en zorg ervoor dat het de volgende regels heeft:

sla het bestand op, sluit en open vervolgens het terminalvenster om de wijzigingen te activeren.

u hebt nu pipx, pyenv, poetry geactiveerd en Pip vergrendeld om alleen in een virtuele omgeving te werken, zodat u niet per ongeluk python-pakketten kunt installeren in de Globale python-omgeving. Maak je geen zorgen, als je nog steeds een python pakket globaal wilt installeren (dat doe je niet!,) u kunt gpip of gpip3 gebruiken om deze bescherming te negeren en een pakket globaal te installeren.

ga door!

u bent nu klaar om met python te werken!

u hoeft geen virtuele omgevingen meer te maken of verwarrende standaardtekst te schrijven.,

maak Gewoon een nieuwe python project:

poetry new myproject
cd myproject

Beslissen over een python versie voor dit project:

pyenv local 3.7.3

en klik Vervolgens op toevoegen afhankelijkheden van het project, zoals de requests pakket:

poetry add requests

de ontwikkeling van uw afhankelijkheden:

poetry add --dev pytest

Een virtuele omgeving wordt automatisch gemaakt met de python versie die je hebt gekozen en de toegevoegde python pakketten.

u hoeft deze virtuele omgeving nooit in te voeren. Niet meer .venv/bin/activate of deactivate., Maar dat kan als je wilt. U kunt ook uw eigen onbeheerde virtuele omgevingen maken met behulp van de nieuwste venv-functies die zijn ingebouwd in python 3 om uw virtuele omgevingen te creëren. Gebruik virtualenvniet.

om uw project in de virtuele omgeving uit te voeren, doe iets als volgt:

poetry run python myscript.py

of maak een scripts sectie aan in pyproject.py om het entrypoint buiten de virtuele omgeving beschikbaar te maken.

zie de documentatie voor het run commando in poëzie voor verschillende manieren om uw python projecten uit te voeren vanaf de CLI.

veel plezier!