|
Dimensione: 6646
Commento: nuovo stile note/avvisi/suggerimenti
|
Dimensione: 9104
Commento: + 24.04 22.04 e revisione generale
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 5: | Linea 5: |
| <<Informazioni(forum="https://forum.ubuntu-it.org/viewtopic.php?f=46&t=631491"; rilasci="18.04")>> | <<Informazioni(forum="https://forum.ubuntu-it.org/viewtopic.php?f=46&t=631491"; rilasci="24.04 22.04 20.04")>> |
| Linea 12: | Linea 12: |
| I pacchetti vengono reperiti da '''PyPI''' ('''Python Package Index'''). Quest'ultimo è un repository globale dove vengono archiviati migliaia di progetti e programmi relativi a Python, per essere quindi gestiti e organizzati in base alle versioni dei pacchetti e alle loro dipendenze. | Risulta quindi molto utile per reperire facilmente moduli, librerie, frameworks, strumenti per sviluppo software, ricerca scientifica, svago e tanto altro. I pacchetti vengono reperiti da '''PyPI''' ('''Python Package Index'''). Quest'ultimo è un repository globale dove vengono archiviati migliaia di progetti e programmi relativi a Python, per essere quindi gestiti e organizzati in base alle versioni dei pacchetti e alle loro dipendenze. |
| Linea 14: | Linea 14: |
| == Consigli generali == '''pip''' risulta molto utile per installare facilmente svariato software basato su '''Python''', come moduli, librerie, frameworks e tanto altro (strumenti per sviluppo, ricerca scientifica, svago ecc.). Inoltre '''pip''' può essere usato per installare alcuni programmi come alternativa alle consuete modalità di [[AmministrazioneSistema/InstallareProgrammi|installazione]] ('''apt''', '''snap''', da sorgenti ecc.). Tuttavia si consiglia tale utilizzo soltanto: * se si ha una sufficiente esperienza con '''pip'''; * per motivi di istruzione, test o sviluppo, o comunque in sistemi non destinati alla produttività; * in ambienti "protetti", quali [[Virtualizzazione|macchine virtuali]], Python virtual environments ecc. * qualora il software desiderato sia disponibile soltanto tramite '''pip'''. {{{#!wiki important Poiché molti componenti essenziali di Ubuntu sono scritti in Python, si raccomanda di non installare e/o aggiornare tramite pip i pacchetti fondamentali del sistema. Questo perché la presenza di versioni diverse potrebbe provocare problemi di dipendenze e/o esecuzione, rendendo Ubuntu altamente instabile o non funzionante. Si raccomanda infine di non lanciare pip con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]], se non in ambienti "protetti" (come macchine virtuali, virtualenv ecc.). |
{{{#!wiki tip Spesso alcuni pacchetti di cui si potrebbe aver bisogno sono disponibili nei [[Repository|repository]] di Ubuntu. Si consiglia pertanto di effettuare prima di tutto una [[AmministrazioneSistema/InstallareProgrammi/Apt#Altre_operazioni|ricerca]] tramite '''apt'''. |
| Linea 28: | Linea 18: |
| = Installazione = | == Python virtual environments == |
| Linea 30: | Linea 20: |
| In Ubuntu 18.04 '''Python''' è presente sia nella versione 2.* che nella versione 3.*. Pertanto è possibile installare '''pip''' per entrambe le versioni. | '''pip''' potrebbe essere usato per installare alcuni programmi scritti in Python come alternativa alle consuete modalità di [[AmministrazioneSistema/InstallareProgrammi|installazione]] ('''apt''', '''snap''', da sorgenti ecc.). Tuttavia: * spesso quando si lavora ad un progetto si potrebbe avere bisogno di pacchetti python non forniti dalla distribuzione in uso, oppure disponibili in un'altra versione; * molte parti delle distribuzioni GNU/Linux sono scritti in Python (fra cui componenti importanti del sistema), quindi l'utilizzo di programmi installati con pip potrebbe provocare vari conflitti o problemi, rendendo il sistema altamente instabile o non funzionante. |
| Linea 32: | Linea 24: |
| == Python2 == | Per questi motivi è previsto l'utilizzo di ambienti protetti, i ''[[#venv|Python virtual environments]]'', in cui poter operare senza creare conflitti con i pacchetti python già installati nel sistema operativo. A tal proposito in Ubuntu 23.04 e successivi non sono consentite installazioni di pacchetti Python a livello di sistema (per maggiori informazioni si veda questo [[#problemi|paragrafo]]). |
| Linea 34: | Linea 26: |
| 0. Verificare la versione di Python installata e l'assenza di problemi digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{ python2 --version |
<<Anchor(venv)>> = Creazione di un ambiente virtuale = Per creare un ambiente virtuale, procedere come descritto di seguito. 0. Aggiungere il modulo `venv`, [[AmministrazioneSistema/InstallareProgrammi|installado]] il pacchetto [[apt://python3-venv|python3-venv]]. 0. Per creare una cartella di destinazione digitare nel [[AmministrazioneSistema/Terminale|terminale]]:{{{ python3 -m venv nome_della_directory |
| Linea 37: | Linea 35: |
| L'output sarà simile al seguente:{{{ Python 2.7.15rc1 |
sostituendo `nome_della_directory` con il nome desiderato. 0. Attivare l'ambiente virtuale con il comando:{{{ source nome_della_directory/bin/activate |
| Linea 40: | Linea 39: |
| 0. In caso di assenza di errori, [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://python-pip|python-pip]]. 0. Per verificare la versione di '''pip''' installata digitare:{{{ pip --version |
sostituendo `nome_della_directory` con il nome desiderato. Una volta attivato, la shell in uso punterà alla cartella creata. Se ad esempio si crea la cartella `il_mio_progetto` verrà restituito un output simile al seguente:{{{ (il_mio_progetto) $ |
| Linea 45: | Linea 45: |
| == Python3 == | Sarà quindi possibile installare e aggiornare pacchetti utilizzando '''pip'''. = Installazione = |
| Linea 51: | Linea 53: |
| Python 3.6.7 | Python 3.10.12 |
| Linea 58: | Linea 60: |
| {{{#!wiki note In Ubuntu 22.04 è disponibile per l'installazione anche il pacchetto ''python-pip'', di riferimento per Python2. Si raccomanda tuttavia l'utilizzo della versione 3, poiché per la versione precedente non sono garantiti aggiornamenti di sicurezza (per maggiori informazioni consultare [[Programmazione/Python#Versioni_Python_2_e_3|questa pagina]]). In caso di utilizzo di pip con Python 2, tutti i comandi vanno eseguiti digitando `pip` al posto di `pip3`. }}} |
|
| Linea 60: | Linea 67: |
| ||<:-2 #cccccc>'''Comandi principali'''|| ||<40%> '''pip3 install''' ''nome_pacchetto'' || Installa un pacchetto desiderato. || || '''pip3 install --upgrade''' ''nome_pacchetto'' || Aggiorna un pacchetto desiderato. || || '''pip3 uninstall''' ''nome_pacchetto'' || Rimuove un pacchetto desiderato. || || '''pip3 show''' ''nome_pacchetto'' || Mostra le informazioni disponibili su un pacchetto installato. || || '''pip3 list''' || Elenca i pacchetti installati. || || '''pip3 freeze''' || Elenca i pacchetti installati nei formati richiesti. || || '''pip3 check''' || Controlla lo stato delle dipendenze dei pacchetti installati. || || '''pip3 help''' || Mostra informazioni sull'uso di pip, fra cui l'elenco dei principali comandi e delle opzioni. || |
|
| Linea 61: | Linea 78: |
| Di seguito sono riportate le funzioni principali del programma, utilizzabili sia col comando `pip` che `pip3`. Per l'utilizzo delle opzioni, del file `requirements.txt`, di wheel, delle configurazioni avanzate e altre funzionalità si rimanda a [[https://pip.pypa.io/en/latest/reference/|questa guida]]. | Per l'utilizzo delle opzioni, del file `requirements.txt`, di wheel, delle configurazioni avanzate e altre funzionalità si rimanda a [[https://pip.pypa.io/en/latest/reference/|questa guida]]. |
| Linea 64: | Linea 81: |
| ||<:-2 #cccccc>'''Comandi principali'''|| ||<40%> '''pip install''' ''nome_pacchetto'' || Installa un pacchetto desiderato. || || '''pip search''' ''termine_di_ricerca'' || Cerca su '''PyPI''' i pacchetti relativi al termine di ricerca inserito. || || '''pip install --upgrade''' ''nome_pacchetto'' || Aggiorna un pacchetto desiderato. || || '''pip uninstall''' ''nome_pacchetto'' || Rimuove un pacchetto desiderato. || || '''pip show''' ''nome_pacchetto'' || Mostra le informazioni disponibili su un pacchetto installato. || || '''pip list''' || Elenca i pacchetti installati. || || '''pip freeze''' || Elenca i pacchetti installati nei formati richiesti. || || '''pip check''' || Controlla lo stato delle dipendenze dei pacchetti installati. || || '''pip help''' || Mostra informazioni sull'uso di pip, fra cui l'elenco dei principali comandi e delle opzioni. || |
|
| Linea 76: | Linea 82: |
| A differenza di apt, pip non supporta l'autocompletamento. Pertanto occorre digitare il nome esatto del pacchetto da installare, facendo attenzione ad evitare errori di battitura durante la digitazione. | A differenza di apt, pip non supporta l'autocompletamento. Pertanto occorre digitare il nome esatto del pacchetto da installare, facendo attenzione ad evitare errori di battitura durante la digitazione.<<BR>> Evitare di lanciare pip con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]]. |
| Linea 82: | Linea 89: |
| pip install nome_pacchetto==N | pip3 install nome_pacchetto==N |
| Linea 85: | Linea 92: |
| pip install Django==1.0.4 | pip3 install Django==4.1.7 |
| Linea 88: | Linea 95: |
| pip install Django>=1.0.4 | pip3 install Django>=4.1.1 |
| Linea 91: | Linea 98: |
| pip install --pre nome_pacchetto | pip3 install --pre nome_pacchetto |
| Linea 94: | Linea 101: |
| pip install ./Percorso/File/nome_pacchetto.tar.gz | pip3 install ./Percorso/File/nome_pacchetto.tar.gz |
| Linea 97: | Linea 104: |
| pip list --outdated --format columns | pip3 list --outdated --format columns |
| Linea 100: | Linea 107: |
| pip <comando> -h | pip3 <comando> -h |
| Linea 103: | Linea 110: |
| pip list -h | pip3 list -h |
| Linea 113: | Linea 120: |
| pip install --upgrade pip | pip3 install --upgrade pip }}} <<Anchor(problemi)>> = Soluzione dei problemi = == error: externally managed environment (Ubuntu 23.04 e successivi) == A partire da Ubuntu 23.04 non sono consentite di default operazioni al di fuori dell'ambiente base di Python, considerate perciò ''externally managed'' (per maggiori informazioni consultare [[https://peps.python.org/pep-0668/|questa pagina]]). Se non è possibile utilizzare un [[#venv|ambiente virtuale]], è possibile aggirare questa limitazione: * installando il pacchetto desiderato tramite '''apt''', quando disponibile. * utilizzando '''pipx''': è uno strumento alternativo a '''pip''' che permette di installare ed eseguire applicazioni Python in ''isolated environments'', garantendo una certa sicurezza. '''pipx''' infatti crea automaticamente un ambiente virtuale per ogni applicazione installata, generando contestualmente un collegamento nella cartella `.local/bin` dell'utente (quindi non a livello di sistema). Per utilizzare lo strumento [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://pipx|pipx]]. Per il suo utilizzo consultare la [[https://pypa.github.io/pipx/docs/|documentazione]] del progetto. * usando l'opzione '''--break-system-packages''': è un'opzione che permette a '''pip''' di forzare l'installazione a livello di sistema, come nel seguente esempio:{{{ pip install arrow --break-system-packages }}} {{{#!wiki important Questa opzione è potenzialmente pericolosa; __non__ usarla in ambienti di produttività se non si sono adottate le dovute precauzioni. |
| Linea 123: | Linea 147: |
| * [[https://pypa.github.io/pipx/|pipx]] |
Guida verificata con Ubuntu: 20.04 22.04 24.04
Problemi in questa pagina? Segnalali in questa discussione
Introduzione
In questa guida sono descritte le istruzioni per installare pip su Ubuntu e derivate, nonché nozioni generali sul suo utilizzo (per informazioni più specifiche si rimanda ai link di approfondimento).
pip (acronimo di Pip Installs Packages) è uno strumento a linea di comando che permette di installare software scritto in Python.
Risulta quindi molto utile per reperire facilmente moduli, librerie, frameworks, strumenti per sviluppo software, ricerca scientifica, svago e tanto altro. I pacchetti vengono reperiti da PyPI (Python Package Index). Quest'ultimo è un repository globale dove vengono archiviati migliaia di progetti e programmi relativi a Python, per essere quindi gestiti e organizzati in base alle versioni dei pacchetti e alle loro dipendenze.
Spesso alcuni pacchetti di cui si potrebbe aver bisogno sono disponibili nei repository di Ubuntu. Si consiglia pertanto di effettuare prima di tutto una ricerca tramite apt.
Python virtual environments
pip potrebbe essere usato per installare alcuni programmi scritti in Python come alternativa alle consuete modalità di installazione (apt, snap, da sorgenti ecc.). Tuttavia:
- spesso quando si lavora ad un progetto si potrebbe avere bisogno di pacchetti python non forniti dalla distribuzione in uso, oppure disponibili in un'altra versione;
- molte parti delle distribuzioni GNU/Linux sono scritti in Python (fra cui componenti importanti del sistema), quindi l'utilizzo di programmi installati con pip potrebbe provocare vari conflitti o problemi, rendendo il sistema altamente instabile o non funzionante.
Per questi motivi è previsto l'utilizzo di ambienti protetti, i Python virtual environments, in cui poter operare senza creare conflitti con i pacchetti python già installati nel sistema operativo. A tal proposito in Ubuntu 23.04 e successivi non sono consentite installazioni di pacchetti Python a livello di sistema (per maggiori informazioni si veda questo paragrafo).
Creazione di un ambiente virtuale
Per creare un ambiente virtuale, procedere come descritto di seguito.
Aggiungere il modulo venv, installado il pacchetto python3-venv.
Per creare una cartella di destinazione digitare nel terminale:
python3 -m venv nome_della_directory
sostituendo nome_della_directory con il nome desiderato.
Attivare l'ambiente virtuale con il comando:
source nome_della_directory/bin/activate
sostituendo nome_della_directory con il nome desiderato.
Una volta attivato, la shell in uso punterà alla cartella creata. Se ad esempio si crea la cartella il_mio_progetto verrà restituito un output simile al seguente:
(il_mio_progetto) $
Sarà quindi possibile installare e aggiornare pacchetti utilizzando pip.
Installazione
Verificare la versione di Python installata e l'assenza di problemi digitando nel terminale:
python3 --version
L'output sarà simile al seguente:
Python 3.10.12
In caso di assenza di errori, installare il pacchetto python3-pip.
Per verificare la versione di pip3 installata digitare:
pip3 --version
In Ubuntu 22.04 è disponibile per l'installazione anche il pacchetto python-pip, di riferimento per Python2. Si raccomanda tuttavia l'utilizzo della versione 3, poiché per la versione precedente non sono garantiti aggiornamenti di sicurezza (per maggiori informazioni consultare questa pagina). In caso di utilizzo di pip con Python 2, tutti i comandi vanno eseguiti digitando pip al posto di pip3.
Utilizzo
Comandi principali |
|
pip3 install nome_pacchetto |
Installa un pacchetto desiderato. |
pip3 install --upgrade nome_pacchetto |
Aggiorna un pacchetto desiderato. |
pip3 uninstall nome_pacchetto |
Rimuove un pacchetto desiderato. |
pip3 show nome_pacchetto |
Mostra le informazioni disponibili su un pacchetto installato. |
pip3 list |
Elenca i pacchetti installati. |
pip3 freeze |
Elenca i pacchetti installati nei formati richiesti. |
pip3 check |
Controlla lo stato delle dipendenze dei pacchetti installati. |
pip3 help |
Mostra informazioni sull'uso di pip, fra cui l'elenco dei principali comandi e delle opzioni. |
Per l'utilizzo delle opzioni, del file requirements.txt, di wheel, delle configurazioni avanzate e altre funzionalità si rimanda a questa guida.
A differenza di apt, pip non supporta l'autocompletamento. Pertanto occorre digitare il nome esatto del pacchetto da installare, facendo attenzione ad evitare errori di battitura durante la digitazione.
Evitare di lanciare pip con i privilegi di amministrazione.
Di seguito sono riportati ulteriori esempi di utilizzo:
Installare specifiche versioni dei pacchetti:
pip3 install nome_pacchetto==N
dove N sta per la versione del pacchetto, come nel seguente esempio:
pip3 install Django==4.1.7
oppure versioni inferiori/superiori/uguali ad una specifica versione, come nel seguente esempio:
pip3 install Django>=4.1.1
Installare versioni in sviluppo:
pip3 install --pre nome_pacchetto
Installare un pacchetto salvato in locale:
pip3 install ./Percorso/File/nome_pacchetto.tar.gz
Mostrare in una lista incolonnata i pacchetti che hanno versioni più recenti rispetto a quelle presenti nel sistema:
pip3 list --outdated --format columns
Mostrare informazioni sull'utilizzo di un determinato comando:
pip3 <comando> -h
come nel seguente esempio:
pip3 list -h
Aggiornamento
Questa operazione è fortemente sconsigliata agli utenti poco esperti, poiché potrebbe rendere non utilizzabile pip senza opportune modifiche alle configurazioni del programma. Per lo stesso motivo è opportuno ignorare eventuali consigli di aggiornamento nell'ouput di pip, simili al seguente: You should consider upgrading via the 'pip install --upgrade pip' command.
Per aggiornare pip digitare nel terminale il comando:
pip3 install --upgrade pip
Soluzione dei problemi
error: externally managed environment (Ubuntu 23.04 e successivi)
A partire da Ubuntu 23.04 non sono consentite di default operazioni al di fuori dell'ambiente base di Python, considerate perciò externally managed (per maggiori informazioni consultare questa pagina).
Se non è possibile utilizzare un ambiente virtuale, è possibile aggirare questa limitazione:
installando il pacchetto desiderato tramite apt, quando disponibile.
utilizzando pipx: è uno strumento alternativo a pip che permette di installare ed eseguire applicazioni Python in isolated environments, garantendo una certa sicurezza. pipx infatti crea automaticamente un ambiente virtuale per ogni applicazione installata, generando contestualmente un collegamento nella cartella .local/bin dell'utente (quindi non a livello di sistema). Per utilizzare lo strumento installare il pacchetto pipx. Per il suo utilizzo consultare la documentazione del progetto.
usando l'opzione --break-system-packages: è un'opzione che permette a pip di forzare l'installazione a livello di sistema, come nel seguente esempio:
pip install arrow --break-system-packages
Questa opzione è potenzialmente pericolosa; non usarla in ambienti di produttività se non si sono adottate le dovute precauzioni.
