This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# `ensurepip` — Ejecutando el instalador `pip`

Nuevo en la versión 3.4.

El paquete `ensurepip` proporciona soporte para ejecutar el instalador `pip` en una instalación de Python existente o en un entorno virtual. Este enfoque de arranque refleja el hecho de que `pip` es un proyecto independiente con su propio ciclo de lanzamiento, y la última versión estable disponible se incluye con el mantenimiento y las versiones de características del intérprete de referencia CPython.

En la mayoría de los casos, los usuarios finales de Python no deberían tener que invocar este módulo directamente (como `pip` deben arrancarse de forma predeterminada), pero puede ser necesario si se omitió la instalación de `pip` al instalar Python (o al crear un entorno virtual) o después de desinstalar explícitamente `pip`.

Nota

Este módulo no accede a Internet. Todos los componentes necesarios para ejecutar `pip` se incluyen como partes internas del paquete.

Ver también

Instalando módulos de Python

  La guía del usuario final para instalar paquetes python

PEP 453: Arranque explícito de pip en instalaciones de Python

  La justificación original y la especificación de este módulo.

## Interfaz de línea de comandos

La interfaz de línea de comandos se invoca mediante el modificador `-m` del intérprete.

La invocación más simple posible es:

    python -m ensurepip

Esta invocación instalará `pip` si aún no está instalado, pero de lo contrario no hace nada. Para asegurarse de que la versión instalada de `pip` es al menos tan reciente como la incluida con `ensurepip`, pase la opción `--upgrade`:

    python -m ensurepip --upgrade

De forma predeterminada, `pip` se instala en el entorno virtual actual (si uno está activo) o en los paquetes de sitio del sistema (si no hay ningún entorno virtual activo). La ubicación de instalación se puede controlar a través de dos opciones de línea de comandos adicionales:

- `--root <dir>`: Instala `pip` en relación con el directorio raíz dado en lugar de la raíz del entorno virtual activo actualmente (si existe) o la raíz predeterminada para la instalación actual de Python.

- `--user`: Instala `pip` en el directorio de paquetes de sitio de usuario en lugar de globalmente para la instalación actual de Python (esta opción no está permitida dentro de un entorno virtual activo).

De forma predeterminada, se instalarán los scripts `pipX` y `pipX.Y` (donde X.Y representa la versión de Python utilizada para invocar `ensurepip`). Los scripts instalados se pueden controlar a través de dos opciones de línea de comandos adicionales:

- `--altinstall`: si se solicita una instalación alternativa, no se instalará el script `pipX`.

- `--default-pip`: si se solicita una instalación de «pip predeterminado», se instalará el script `pip` además de los dos scripts regulares.

Proporcionar ambas opciones de selección de script desencadenará una excepción.

## API del módulo

`ensurepip` expone dos funciones para su uso programático:

`ensurepip.``version`()

  Retorna una cadena de caracteres que especifica la versión incluida de pip que se instalará al ejecutarlo en un entorno.

`ensurepip.``bootstrap`(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)

  Ejecuta `pip` en el entorno actual o designado.

  root especifica un directorio raíz alternativo para instalar en relación con. Si root es `None`, la instalación utiliza la ubicación de instalación predeterminada para el entorno actual.

  upgrade indica si se debe actualizar o no una instalación existente de una versión anterior de `pip` a la versión incluida.

  user indica si se debe utilizar el esquema de usuario en lugar de instalar globalmente.

  De forma predeterminada, se instalarán los scripts `pipX` y `pipX.Y` (donde X.Y representa la versión actual de Python).

  Si se establece altinstall, no se instalará `pipX`.

  Si se establece default_pip, se instalará `pip` además de los dos scripts normales.

  Establecer tanto altinstall como default_pip desencadenará `ValueError`.

  verbosity controla el nivel de salida a `sys.stdout` de la operación de ejecución.

  Genera un evento auditing `ensurepip.bootstrap` con el argumento `root`.

  Nota

  El proceso de ejecución tiene efectos secundarios tanto en `sys.path` como `os.environ`. Invocar la interfaz de línea de comandos en un subproceso en su lugar permite evitar estos efectos secundarios.

  Nota

  El proceso de ejecución puede instalar módulos adicionales requeridos por `pip`, pero otro software no debe asumir que esas dependencias siempre estarán presentes de forma predeterminada (ya que las dependencias se pueden eliminar en una versión futura de `pip`).