¿Cuál es el efecto de usar `python -m pip` en lugar de solo `pip`? [duplicate]

cuando uso python -m pip install <package>¿en qué se diferencia eso de usar solo pip install <package>? Del mismo modo, ¿por qué escribiría python -m pip install --upgrade pip para actualizar Pip, en lugar de solo pip install --upgrade pip?

Considere el siguiente escenario.

Tienes tres versiones de Python instaladas:

• Pitón 3.7
• Pitón 3.8
• Pitón 3.9

Su versión “predeterminada” es 3.8. Es el primero que aparece en tu camino. Por lo tanto, cuando escribe python3 (Linux o Mac) o python (Windows) en un shell, iniciará un intérprete 3.8 porque ese es el primer ejecutable de Python que se encuentra al atravesar su ruta.

Suponga que está comenzando un nuevo proyecto en el que desea usar Python 3.9. Creas un entorno virtual llamado .venv y activarlo.

python3.9 -m venv .venv         # "py -3.9" on Windows

source .venv/bin/activate    # ".venv\Scripts\activate" on Windows 

Ya tenemos activado el entorno virtual usando Python 3.9. Mecanografía python en un shell inicia el intérprete 3.9.

PEROsi escribes

pip install <some-package>

Entonces que versión de pip se usa? ¿Es el pip para la versión predeterminada, es decir, Python 3.8, o la versión de Python dentro del entorno virtual?

Una manera fácil de sortear esa ambigüedad es simplemente usar

python -m pip install <some-package>

El -m flag se asegura de que esté utilizando el pip que está vinculado al ejecutable activo de Python.

Es una buena práctica usar siempre -mincluso si solo tiene instalada una versión global de Python a partir de la cual crea entornos virtuales.

Re. camino

La llamada camino es una lista de directorios donde su sistema busca ejecutables. Cuando escribe un comando, como pythonesta lista se recorre desde el primer directorio hasta el último, buscando un nombre de archivo que coincida con el comando que escribió.

Si se encuentra el nombre de archivo/comando, el archivo coincidente se ejecuta sin tener en cuenta las posibles coincidencias posteriores. Si no se produce ninguna coincidencia, se obtiene un Command not found o una variación del mismo. Este comportamiento es por diseño.

En los sistemas UNIX, la variable de entorno de ruta se llama $PATHmientras que en los sistemas Windows se denomina %PATH%

Comentarios más generales sobre el -m-bandera (diciembre de 2022)

La mayoría de las personas que ven esto probablemente querrán la explicación dada anteriormente con pip. Sin embargo, en un sentido más general, cuando se usa python -m some_moduleel -m flag hace que Python se ejecute some_module como guión. Esto se afirma en el documentospero puede ser difícil de entender sin algunos conocimientos básicos.
¿Qué significa “ejecutar como un script”?

En Python, un módulo some_module normalmente se importa a otro archivo de Python con un import some_module instrucción en la parte superior del archivo de importación. Esto permite el uso de funciones, clases y variables definidas en some_module dentro del archivo de importación. Ejecutar some_module como un script en lugar de importarlo, definiría un if __name__ == "__main__" bloque dentro del archivo. Este bloque se ejecuta cuando se ejecuta python some_module.py en la línea de comando. Esto es útil porque Ud. no desea que este bloque de código se ejecute al importar a otros archivos, pero hacer desea que se ejecute cuando se invoque desde la línea de comandos.

Para los módulos dentro de su proyecto, esta construcción de secuencia de comandos/módulo debe ejecutarse tal cual, porque Python encontrará el módulo en su directorio de trabajo cuando se ejecuta desde la terminal:

python some_module.py

Pero para los módulos que forman parte de la biblioteca estándar de Python, esto no funcionará. El ejemplo de los usos de los documentos de Python timeit (pip funciona igual):

python3 timeit -s 'print("hello")'  # 'python timeit.py ...' fails as well 

Esto devuelve el error: "python: can't open file '/home/<username>/timeit': [Errno 2] No such file or directory"

Agregando el -m bandera le dice a Python que busque en la ruta timeit.py y ejecutar el if __name__ == "__main__" cláusula del expediente.

python3 -m timeit -s 'print("hello")'

Esto funciona como se esperaba.

La fuente de la if __name__ == "__main__" bloque para el módulo timeit se puede encontrar aquí.

De Documentos de Python:

Dado que el argumento es un nombre de módulo, no debe dar una extensión de archivo (.py). El module-name debe ser un nombre de módulo de Python válido, pero es posible que la implementación no siempre lo imponga (por ejemplo, puede permitirle usar un nombre que incluya un guión).

También se permiten nombres de paquetes. Cuando se proporciona un nombre de paquete en lugar de un módulo normal, el intérprete ejecutará <pkg>.__main__ como módulo principal. Este comportamiento es deliberadamente similar al manejo de directorios y archivos comprimidos que se pasan al intérprete como argumento del script.

si escribes python --help

Usted obtiene

// More flags above
-m mod : run library module as a script (terminates option list)
// and more flags below

Muchas cosas en una terminal le mostrarán cómo usarla si usa command --help o man command

El -m representa module-name.

De Línea de comandos y entorno:

pitón [-bBdEhiIOqsSuvVWx?] [-c command | -m module-name | script | – ] [args]

Cuando -m se usa con un python instrucción en la línea de comando, seguida de una <module_name>luego permite que el módulo se ejecute como un archivo ejecutable.

Puede consultar los documentos de python para lo mismo, o ejecutar python --help

Esta es realmente una pregunta interesante, así que exploremos el pep 338 vinculado por @jedwards en el comentario superior.

El indicador -m originalmente tenía un propósito más simple: convertir un nombre de módulo en un nombre de script. En python 2.4, el comportamiento era:

the command line is effectively reinterpreted from python <options> -m
<module> <args> to python <options> <filename> <args>.

Esto no parece muy útil, pero eso es lo que hizo en ese entonces. Pep 338 amplía aún más este comportamiento.

La semántica propuesta es bastante simple. [sic]: si se usa -m para ejecutar un módulo, los mecanismos de importación PEP 302 se usan para ubicar el módulo y recuperar su código compilado, antes de ejecutar el módulo de acuerdo con la semántica de un módulo de nivel superior.

Continúa explicando que Python identificará el paquete del que proviene el módulo, importará ese paquete usando el proceso estándar y ejecutará el módulo. Por lo que entiendo, llamar a “python3 -m package.module” es lo mismo que llamar:

python3
from package import module

El indicador -m ejecutará el módulo como __file__ y no __main__. También insertará el directorio local en sys.path en lugar del directorio del script. Por lo tanto, rompe las importaciones relativas, aunque esto no fue intencional, por lo que los autores recomiendan usar siempre importaciones absolutas. También depende de cómo lo llames: “python3 -m paquete.módulo” no es lo mismo que “python3 -m módulo”.

En teoría, es simple: carga python e importa el módulo en lugar de volcar el código en __main__. En la práctica eso tiene muchos efectos. Es un sistema de importación diferente que se comporta de manera diferente. Algunos de esos cambios no fueron intencionales y solo se descubrieron después de la implementación. Las importaciones de Python son un desastre y está bien estar confundido.

Increíble, esto es tan difícil de responder cuando algunas personas dicen que la pregunta es demasiado simple como para molestarse.

Por lo que puedo decir, el propósito práctico es que pueda usar la notación de puntos para ejecutar su script cuando no esté en el directorio.

Tu puedes correr
python -m path.to.my.happy.place

en lugar de estar en path/to/my/happy y corriendo python place.py