Pip es el gestor de paquetes preferido por la comunidad Python, a partir de la versión 3.4 de Python se incluye por defecto en el instalador del lenguaje.
Pip descarga e instala de forma transparente los paquetes que se encuentran en los repositorios de PyPI ubicados en la web https://pypi.org/
Dependiendo del sistema operativo instalado y la forma de instalación de Python, se usará pip o pip3 para instalar los paquetes de Python 3.
Pip por tanto, ayuda en la búsqueda, instalación o desinstalación de estos packages externos.
Para mostrar la ayuda hay que escribir el siguiente comando en la terminal.
pip help
Uso:
pip3 <comando> [opciones]
Comandos | |
install | Instala paquetes. |
download | Descarga paquetes. |
uninstall | Desinstala paquetes. |
freeze | Muestra los paquetes instalados en el formato para requirements. |
list | Muestra los paquetes instalados. |
show | Muestra información sobre los paquetes instalados |
check | Verifica si los paquetes instalados tienen dependencias compatibles |
config | Gestiona la configuración local y global |
search | Busca paquetes en PyPI. |
wheel | Construye wheels desde tus requirements. |
hash | Calcula los hashes de los paquetes de archivos. |
completion | Un comando auxiliar usado para completar el comando. |
help | Muestra ayuda de los comandos |
Opciones generales | |
-h, –help | Muestra la ayuda. |
–isolated | Ejecuta pip en modo aislado, ignorando las variables de entorno y configuración de usuario. |
-v, –verbose | Muestra mas información en la salida estándar. Esta opción se puede añadir hasta 3 veces. |
-V, –version | Muestra la versión y sale del intérprete. |
-q, –quiet | Muestra menos información. También se puede añadir hasta 3 veces, correspondiendo con los niveles de log WARNING, ERROR y CRITICAL. |
–log <path> | Ruta donde se anexará un log con registro detallado. |
–proxy <proxy> | Especifica un proxy en la forma [usuario:contraseña@]servidor.proxy:puerto |
–retries <intentos> | Máximo número de intentos que cada conexión debería probar (por defecto 5). |
–timeout <seg> | Establece el timeout del socket (por defecto 15 segundos) |
–exists-action <acción> | Acción por defecto cuando ya existe una ruta: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. |
–trusted-host <hostname> | Marca el hostname como confiable, incluso aunque no tenga certificado válido ni https |
–cert <path> | Ruta al paquete CA alternativo. |
–client-cert <path> | Ruta al certificado SSL del cliente, un fichero simple conteniendo la clave privada y el certificado en formato PEM. |
–cache-dir <dir> | Almacena los datos caché en la ruta <dir> |
–no-cache-dir | Deshabilita la caché |
–disable-pip-version-check | No revisa periódicamente PyPI para determinar si está disponible una nueva versión de pip para la descarga. Implica –no-index. |
–no-color | Suprime los colores en la salida estandar. |
Para obtener una ayuda mas detallada se usa la siguiente sintaxis:
pip nombre_comando -h
Los comandos básicos son:
pip install nombre_paquete instala un paquete desde el repositorio.
pip install nombre_paquete.whl instala un paquete descargado.
pip uninstall nombre_paquete desinstala un paquete previamente instalado con pip.
pip download nombre_paquete descarga el paquete para su instalación manual.
pip freeze devuelve una lista con todos los paquetes y sus números de versión instalados en Python en formato de requirements.
Para guardar un archivo de texto con la lista de paquetes instalados en el sistema se puede usar pip freeze > requirements.txt. En los entornos virtuales se suele usar requirements.txt para tener un backup del nombre de los paquetes instalado y sus versiones.
pip install -r requirements.txt sirve para instalar los paquetes y versiones almacenados en el fichero requirements.txt de nuevo, ya sea en el mismo entorno virtual o en cualquier otro.
pip list muestra una lista formateada con los paquetes y sus números de versión.
pip show nombre_paquete muestra información sobre el paquete.
pip check nombre_paquete, verifica que los paquetes instalados tengan dependencias compatibles.
En las opciones generales se pueden observar opciones tan interesantes como:
-v o –verbose muestra información mas detallada cuando se ejecuta el comando.
-V o –version muestra la versión de pip.
–log ruta_y_nombre_fichero almacena la información en un fichero log.
–proxy <proxy> para especificar el proxy a usar en la conexión a PyPi en la forma [usuario:passwd@]servidor_proxy:puerto.