# `ensurepip` — Bootstrapping the `pip` installer

Added in version 3.4.

Source code: Lib/ensurepip

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.

This is an optional module. If it is missing from your copy of CPython, look for documentation from your distributor (that is, whoever provided Python to you). If you are the distributor, see Requirements for optional modules.

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.

Availability: not Android, not iOS, not WASI.

This module is not supported on mobile platforms or WebAssembly platforms.

## Command-line interface

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` sea al menos tan reciente como la disponible en `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>

  Installs `pip` relative to the given root directory rather than the root of the currently active virtual environment (if any) or the default root for the current Python installation.

--user

  Installs `pip` into the user site packages directory rather than globally for the current Python installation (this option is not permitted inside an active virtual environment).

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

  If an alternate installation is requested, the `pipX` script will not be installed.

--default-pip

  If a «default pip» installation is requested, the `pip` script will be installed in addition to the two regular scripts.

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 que especifica la versión disponible de pip que se instalará al arrancar 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 disponible.

  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`).