realpython / realpython/python-guide

Potential for confusion on Pipenv & Virtual Environments

Abierto
#840 4 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
Batchfile
Estrellas
29.8k
Forks
5.9k
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

I arrived on the Pipenv & Virtual Environments page from Installing Python 3 on Mac OS X. At that point, I've have installed python2 and python3 via homebrew and there is also the system python. Installing Python 3 on Mac OS X clearly states that

Working with Python 3
At this point, you have the system Python 2.7 available, potentially the Homebrew version of Python 2 installed, and the Homebrew version of Python 3 as well.

$ python
will launch the system Python interpreter.

$ python2
will launch the homebrew-installed Python 2 interpreter (if any).

$ python3
will launch the homebrew-installed Python 3 interpreter.

And yet on Pipenv & Virtual Environments the first thing I'm encouraged to do is make sure python3 is installed by typing $python --version which will display the system Python interpreter version.

This could potentially confuse a new developer who may be wondering why they are seeing version say 2.7.x instead of 3.6.x as the writeup suggest. Besides as at the time of writting there are not many OS's that have $python defaulting to version 3.6.x.

If the writeup in insisting of starting Python 3 with the command $python then it needs to be explained how this can be done safely.

Thanks.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Comienza comparando las páginas Installing Python 3 on Mac OS X y Pipenv & Virtual Environments, especialmente sus instrucciones para comprobar la versión de Python. Aclara qué comando debe usarse para Python 3 y explica las diferencias entre los comandos python, python2 y python3; la documentación estará terminada cuando las instrucciones de configuración no sean ambiguas para el entorno de macOS descrito.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
python
Área
documentation
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
45/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.