Guida definitiva a python su Mac OSX

Installa Xcode (opzionale)

Xcode non è necessario per installare Homebrew e Python, ma è necessario per alcuni pacchetti Homebrew. Se è possibile risparmiare i gigabyte, scaricarlo da App Store. In caso contrario, si dovrebbe essere in grado di completare questa guida senza di essa su macOS Mojave. Nessuna garanzia per le future versioni di macOS.,

Installare Xcode Strumenti a Riga di Comando (richiesto)

Mentre Xcode non è necessaria, la Xcode Strumenti a Riga di Comando sono.

Aprire un terminale e digitare il seguente comando per installare gli strumenti della riga di comando Xcode necessari per Homebrew:

xcode-select --install

Se si utilizza macOS Mojave, è necessario installare le intestazioni di sistema macOS., Questo non è richiesto per Catalina.

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

Ti verrà richiesta la password utente OSX per installare questo pacchetto SDK richiesto.

Se hai scelto di non installare Xcode, dovrai aggiungere la variabile di ambiente SDKROOT alla tua shell:

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

Se usi zsh, cambia la fine di quell’ultimo comando da~/.bash_profile a~/.zshrc .

Installa Homebrew

Homebrew è un gestore di pacchetti per OSX. Lo useremo per installare le dipendenze per compilare e installare python., (Nota: le versioni precedenti di questa guida usavano Homebrew per installare python, ma questo non è richiesto. Useremo pyenv per installare python a breve.)

Andate qui: https://brew.sh/

Seguire le istruzioni per installare Homebrew, che al momento della scrittura di questo documento è quello di incollare questa riga nel terminale:

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

Installazione pyenv

Ora che Homebrew è installato, è possibile installare pyenv e i pacchetti necessari per installare python.,

Installare pyenv:

brew install pyenv

Installare python pacchetti necessari:

brew install openssl readline sqlite3 xz zlib

Aggiungi pyenv di shell:

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

Se si utilizza zsh, modificare la fine dell’ultimo comando ~/.bash_profile ~/.zshrc .

(Opzionale) Puoi anche brew install pyenv-virtualenvaggiungere il supporto virtualenv a pyenv, ma non è necessario poiché la maggior parte del lavoro virtualenv lo farai con poetry dopo averlo installato in un secondo momento. Ad alcune persone piace comunque il supporto pyenv-virtualenv.,

Installazione di Python con Homebrew

Questo passaggio è facoltativo in quanto non ci sarà mai utilizzare questo python in un progetto, ma è consigliato per due motivi:

• Motivo 1: Questo Homebrew installato python diventa una rete di sicurezza nel caso in cui ci dimentichiamo di passare a un pyenv-installato python, noi non inquinare accidentalmente il sistema di python.
• Motivo 2: Diventa un luogo per installare pacchetti globali con pipx., Ciò consente di passare tra le versioni python a piacimento utilizzando pyenv mantenendo un insieme coerente di utility globali come flake8 e black che sono sempre disponibili e non inquinano il python globale.

Installa l’ultimo python 3.x e pipx
(Opzionale, per i pacchetti globali)

# 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

Installa l’ultimo python 2.7
(Davvero opzionale, solo per proteggere il sistema python dagli errori)

brew install python@2

Se hai scelto di installare python 2.,7, non lo userai mai (a meno che tu non abbia un codice legacy che devi eseguire). Python 2.7 fine della vita è alla fine del 2019. Vedi il conto alla rovescia di fine vita di Python 2.7. Agisce solo come una rete di sicurezza per proteggere il sistema python nel caso in cui si commetta un errore.

Installa python!

Finalmente! È ora di installare python

Iniziamo con una nuova shell. Chiudi il tuo terminale e aprilo di nuovo per assicurarti che pyenv sia stato caricato.,

Puoi vedere un elenco di versioni python disponibili con pyenv:

Scegli una versione e installala:

pyenv install 3.7.3

Quindi impostala come versione globale di python:

pyenv global 3.7.3

Questo dovrebbe avere effetto immediatamente. Verifica di essere sulla versione python giusta:

$ python -V
Python 3.7.3

Congratulazioni, hai python! Fatto, giusto?? No.

Installa Poetry

Poetry è un fantastico gestore di pacchetti python che semplifica la gestione delle dipendenze, la gestione dell’ambiente virtuale e la creazione e la pubblicazione di codice python.,

Perché dovresti usare la poesia:

• Obsoletes virtualenv, virtualenvwrapper, pipenv, setup.py, requirements.txt, e altro ancora.
• Vive al di fuori di python, quindi non è necessario installarlo con pip o preoccuparsi di conflitti di pacchetti.
• Separa le dipendenze di runtime comerequests dalle dipendenze di sviluppo comepytest.,
• Utilizza il semplice e facile da capire pypackage.toml file da pep-518 per contenere tutto ciò che riguarda il progetto.
• Interfaccia CLI simile a gestori di pacchetti ben noti come npmeyarn.

Installare poetry seguendo la guida all’installazione. Al momento della stesura di questo articolo, è sufficiente eseguire questo comando:

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

Poetry crea automaticamente tutti i tuoi ambienti virtuali su richiesta in una singola directory per impostazione predefinita., Se si preferisce ambienti virtuali a vivere nella stessa directory con il codice (come un .venv directory del progetto), è possibile eseguire questo comando:

poetry config virtualenvs.in-project true

per Saperne di più sulla poesia

Evitare incidenti

Ora, aggiungiamo un paio di pezzi importanti per l’ambiente del terminale, per assicurarsi che tutto funziona insieme ed evitare di rompere la nostra accuratamente costruita di sviluppo python in ambiente.

Aprire il file~/.bash_profile (o~/.zshrc per zsh)., Crea quel file se non esiste e assicurati che abbia le seguenti righe:

Salva il file, quindi chiudi e riapri la finestra del terminale per attivare le modifiche.

Ora hai attivato pipx, pyenv, poetry e bloccato pip per funzionare solo all’interno di un ambiente virtuale in modo da non poter installare accidentalmente pacchetti python nell’ambiente python globale. Non preoccuparti, se vuoi ancora installare un pacchetto Python a livello globale (non lo fai!,) è possibile utilizzaregpip ogpip3 per ignorare questa protezione e forzare l’installazione di un pacchetto a livello globale.

Vai avanti!

Ora sei pronto per lavorare con python!

Non è più necessario creare ambienti virtuali o scrivere boilerplate confusi.,

Semplicemente creare un nuovo progetto di python:

poetry new myproject
cd myproject

Decidere su una versione di python per questo progetto:

pyenv local 3.7.3

Poi aggiungere le dipendenze per il progetto, come il requests pacchetto:

poetry add requests

E lo sviluppo di dipendenze:

poetry add --dev pytest

in Un ambiente virtuale viene creato automaticamente con la versione di python che hai scelto e l’aggiunta di pacchetti di python.

Non è mai necessario entrare in questo ambiente virtuale. Non più .venv/bin/activate o deactivate., Anche se è possibile, se si vuole. È inoltre possibile creare i propri ambienti virtuali non gestiti utilizzando le più recenti funzionalità venv integrate in Python 3 per creare i propri ambienti virtuali. Non usare virtualenv.

Per eseguire il progetto nell’ambiente virtuale, fare qualcosa del genere:

poetry run python myscript.py

O creare una sezione script in pyproject.py per rendere disponibile il punto di ingresso all’esterno dell’ambiente virtuale.

Vedere la documentazione per il comando run in poetry per vari modi per eseguire i progetti python dalla CLI.

Buon divertimento!