realpython / realpython/python-guide
Potential for confusion on Pipenv & Virtual Environments
Personne n'a encore pris cette issue.
- Langage dominant
- Batchfile
- Étoiles
- 29.8k
- Forks
- 5.9k
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Description
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.
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par comparer les pages Installing Python 3 on Mac OS X et Pipenv & Virtual Environments, en particulier leurs instructions pour vérifier la version de Python. Précisez quelle commande doit être utilisée pour Python 3 et expliquez les différences entre les commandes python, python2 et python3 ; la documentation sera terminée lorsque les instructions de configuration seront sans ambiguïté pour l’environnement macOS décrit.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 45/100