Differenze tra le versioni 28 e 62 (in 34 versioni)

Attenzione! Questa è una Pagina di prova. Le informazioni riportate potrebbero essere incomplete, errate e potenzialmente pericolose. Per contribuire alla realizzazione di questa pagina consultare la discussione di riferimento.

Indice

Introduzione
Prerequisiti e avvertenze
Prerequisiti e avvertenze
Installazione
Utilizzo
Aggiornamento
Ulteriori risorse

Guida verificata con Ubuntu: 22.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.
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.

Prerequisiti e avvertenze

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 installazione (apt, snap, da sorgenti ecc.). Tuttavia utilizzare pip a livello di sistema è altamente scnsigliato. Questo perché, essendo molti programmi di Ubuntu scritti in Python (fra cui componenti essenziali del sistema), l'eventuale presenza di versioni diverse potrebbe provocare problemi di dipendenze e/o esecuzione, rendendo Ubuntu altamente instabile o non funzionante.

Si consiglia quindi questo utilizzo di pip soltanto in ambienti "protetti", quali:

macchine virtuali
Python virtual environments
sistemi/macchine dedicate, non destinate alla produttività, ma per scopi di istruzione, test o sviluppo, ecc.

Prerequisiti e avvertenze

Per creare un ambiente virtuale, procedere come descritto di seguito:

Per aggiungere il modulo venv, installare il pacchetto python3-venv.
Per creare una cartella di destinazione digitando 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.

A partire da Ubuntu 23.04 l'ambiente base di Python viene considerato externally managed, quindi non consente installazioni a livello utente e/o di sistema. Per maggiori informazioni consultare questa pagina.

Evitare di lanciare pip con i privilegi di amministrazione.

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.6
```
In caso di assenza di errori, installare il pacchetto python3-pip.
Per verificare la versione di pip3 installata digitare:
```
pip3 --version
```

È disponibile per l'installazione anche il pacchetto python-pip, di riferimento per Python2. Si incoraggia tuttavia l'utilizzo della versione 3 (per maggiori informazioni consultare questa pagina.

Utilizzo

Comandi principali
pip3 install nome_pacchetto	Installa un pacchetto desiderato.
pip3 search termine_di_ricerca	Cerca su PyPI i pacchetti relativi al termine di ricerca inserito.
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.

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

Ulteriori risorse

Sito e documentazione ufficiali del progetto
Voce enciclopedica
GitHub
Python Package Index (PyPI)
pipx (strumento per installare ed eseguire applicazioni Python in isolated environments)
Python

CategoryHomepage

-  ⇤ ← Versione 28 del 14/11/2021 10.23.21 → 
  Dimensione: 2079
  Autore: andreas-xavier
  Commento: Macro PaginaDiProva
+   ← Versione 62 del 20/03/2023 11.37.09 → ⇥
  Dimensione: 7392
  Autore: andreas-xavier
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 5:
-<<Indice(depth=1)>>
<<Informazioni(forum="https://forum.ubuntu-it.org/viewtopic.php?t=251498"; rilasci="16.04 17.10";)>>
+<<Indice(depth=2)>>
<<Informazioni(forum="https://forum.ubuntu-it.org/viewtopic.php?f=46&t=631491"; rilasci="22.04")>>
-Linea 9:
+Linea 10:
-In questa pagina viene spiegato come gestire tramite interfaccia grafica i [[Repository|repository]] su '''Kubuntu'''.<<BR>> Per '''Ubuntu''' e le altre derivate si rimanda invece alla [[Repository/Ubuntu|guida specifica]].
+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 [[#risorse|link]] di approfondimento).
-Linea 11:
+Linea 12:
-L'interfaccia grafica dedicata è chiamata '''Sorgenti Software ''' e si può [[AmbienteGrafico/AvviareProgrammi|avviare]]:
 * Da menu [specificare]
 * Da [[AmministrazioneSistema/Terminale|terminale]] con il comando:{{{
software-properties-kde
+'''pip''' (acronimo di '''Pip Installs Packages''') è uno strumento a linea di comando che permette di installare software scritto in '''[[Programmazione/Python|Python]]'''.<<BR>>
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.

= Prerequisiti e avvertenze =

'''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 utilizzare pip a livello di sistema è __altamente scnsigliato__. Questo perché, essendo molti programmi di Ubuntu scritti in Python (fra cui componenti essenziali del sistema), l'eventuale presenza di versioni diverse potrebbe provocare problemi di dipendenze e/o esecuzione, rendendo Ubuntu altamente instabile o non funzionante.

Si consiglia quindi questo utilizzo di pip soltanto in ambienti "protetti", quali:
 * [[Virtualizzazione|macchine virtuali]]
 * Python virtual environments
 * sistemi/macchine dedicate, non destinate alla produttività, ma per scopi di istruzione, test o sviluppo, ecc.

<<Anchor(venv)>>
= Prerequisiti e avvertenze =

Per creare un ambiente virtuale, procedere come descritto di seguito:

 0. Per aggiungere il modulo `venv`, [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://python3-venv|python3-venv]].
 0. Per creare una cartella di destinazione digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
python3 -m venv nome_della_directory
-Linea 16:
+Linea 35:
- [verificare se con sudo]
+ sostituendo `nome_della_directory` con il nome desiderato.
 0. Attivare l'ambiente virtuale con il comando:{{{
source nome_della_directory/bin/activate
}}}
 sostituendo `nome_della_directory` con il nome desiderato.
-Linea 18:
+Linea 41:
-Una volta avviato il programma sarà possibile compiere le operazioni descritte di seguito.<<BR>>
Per poter apportare modifiche, il sistema richiederà la password di amministratore.
+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 21:
+Linea 45:
-<<Anchor(spunte)>>
= Gestire i repository ufficiali =
+Sarà quindi possibile installare e aggiornare pacchetti utilizzando pip.
-Linea 24:
+Linea 47:
-Per abilitare o disabilitare la ricezione dei pacchetti da un determinato [[Repository/Componenti|componente]] dei repositories di Ubuntu.
 0. Selezionare la scheda '''Software per Ubuntu''' (oppure '''Altro software''' per il repository '''Partner'''). 
 0. Aggiungere o togliere la spunta dalla casella accanto al nome del componente stesso:
  * Software open source supportato da Canonical (main)
  * Software open source mantenuto dalla comunità (universe)
  * Driver proprietari per i dispositivi (restricted)
  * Software con restrizioni per copyright o motivi legali (multiverse)
  * Codice sorgente
 0. Effettuate le modifiche, fare clic su '''Chiudi'''. Una finestra di dialogo chiederà di aggiornare l'elenco dei pacchetti disponibili.
-Linea 34:
+Linea 48:
- + scelta del server
+{{{#!wiki note
A partire da Ubuntu 23.04 l'ambiente base di Python viene considerato ''externally managed'', quindi non consente installazioni a livello utente e/o di sistema. Per maggiori informazioni consultare [[https://peps.python.org/pep-0668/|questa pagina]].
}}}
-Linea 36:
+Linea 52:
+{{{#!wiki important
Evitare di lanciare pip con i [[AmministrazioneSistema/Sudo|privilegi di amministrazione]].
}}}

= Installazione =

 0. Verificare la versione di Python installata e l'assenza di problemi digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
python3 --version
}}}
 L'output sarà simile al seguente:{{{
Python 3.10.6
}}}
 0. In caso di assenza di errori, [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://python3-pip|python3-pip]].
 0. Per verificare la versione di '''pip3''' installata digitare:{{{
pip3 --version
}}}

{{{#!wiki tip
È disponibile per l'installazione anche il pacchetto ''python-pip'', di riferimento per Python2. Si incoraggia tuttavia l'utilizzo della versione 3 (per maggiori informazioni consultare [[Programmazione/Python#Versioni_Python_2_e_3|questa pagina]].
}}}

= Utilizzo =

||<:-2 #cccccc>'''Comandi principali'''||
||<40%> '''pip3 install''' ''nome_pacchetto'' || Installa un pacchetto desiderato. ||
|| '''pip3 search''' ''termine_di_ricerca'' || Cerca su '''PyPI''' i pacchetti relativi al termine di ricerca inserito. ||
|| '''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. ||

{{{#!wiki note
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]].
}}}

{{{#!wiki important
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.
}}}

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 =

{{{#!wiki important
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 [[AmministrazioneSistema/Terminale|terminale]] il comando:{{{
pip3 install --upgrade pip
}}}

<<Anchor(risorse)>>
-Linea 37:
+Linea 133:
- * [[http://www.gnome-look.org/|Sito di GNOME Look]]
 * [[https://wiki.gnome.org/Apps/GnomeTweakTool|Gnome Tweak Tool]]
 * [[https://launchpad.net/ubuntu/+source/gnome-shell-extension-ubuntu-dock|Estensione Ubuntu Dock su Launchpad]]
+   * [[https://pip.pypa.io|Sito e documentazione ufficiali del progetto]]
 * [[https://en.wikipedia.org/wiki/Pip_(package_manager)|Voce enciclopedica]]
 * [[https://github.com/pypa/pip|GitHub]]
 * [[https://pypi.org/|Python Package Index (PyPI)]]
 * [[https://pypa.github.io/pipx/|pipx]] (strumento per installare ed eseguire applicazioni Python in ''isolated environments'')
 * [[Programmazione/Python|Python]]
-Linea 43:
+Linea 142:
+##CategoryProgrammazione
-Linea 44:
+Linea 144:
-##CategoryAmministrazione