From cef78b42ae416bc08b351a26f4e8b1a8d6c7d1ea Mon Sep 17 00:00:00 2001 From: Richard Jones Date: Fri, 14 Jun 2013 11:15:22 +1000 Subject: [PATCH] clarify some wording based on feedback from Marcus Smith; note resolution of Fedora issue --- pep-0439.txt | 47 ++++++++++++++++++++++++++--------------------- 1 file changed, 26 insertions(+), 21 deletions(-) diff --git a/pep-0439.txt b/pep-0439.txt index 102a3d96d..3aa3c13d1 100644 --- a/pep-0439.txt +++ b/pep-0439.txt @@ -63,14 +63,15 @@ The pip bootstrap ----------------- The Python installation includes an executable called "pip3" (see PEP 394 for -naming rationale etc.) that attempts to import pip machinery. If it can -then the pip command proceeds as normal. If it cannot it will bootstrap pip by -downloading the pip implementation wheel file. Once installed, the pip command -proceeds as normal. +naming rationale etc.) that attempts to import pip machinery. If it can then +the pip command proceeds as normal. If it cannot it will bootstrap pip by +downloading the pip implementation wheel file. Once installed, the pip +command proceeds as normal. Once the bootstrap process is complete the "pip3" +command is no longer the bootstrap but rather the full pip command. -A boostrap is used in the place of a the full pip code so that we -don't have to bundle pip and also the install tool is upgradeable -outside of the regular Python upgrade timeframe and processes. +A boostrap is used in the place of a the full pip code so that we don't have +to bundle pip and also pip is upgradeable outside of the regular Python +upgrade timeframe and processes. To avoid issues with sudo we will have the bootstrap default to installing the pip implementation to the per-user site-packages @@ -114,13 +115,12 @@ would use the "-i" (Base URL of Python Package Index) argument to the it) and display further instructions for downloading and installing the file manually. -Manual installation of the pip implementation will be supported -through the manual download of the wheel file and "pip3 install -". - -This installation will not perform standard pip installation steps of -saving the file to a cache directory or updating any local database of -installed files. +Some users may have no Internet access suitable for fetching the pip +implementation file. Manual installation of the pip implementation will be +supported through the manual download of the wheel file and "pip3 install +". This installation - since it uses only the bootstrap +code - will not perform standard pip installation steps of saving the file to +a cache directory or updating any local database of installed files. The download of the pip implementation install file should be performed securely. The transport from pypi.python.org will be done over HTTPS but the CA @@ -195,16 +195,16 @@ issue tracker [2]_ Risks ===== -The Fedora variant of Linux has had a separate program called "pip" (a -Perl package installer) available for install for some time. The -current Python "pip" program is installed as "pip-python". It is -hoped that the Fedora community will resolve this issue by renaming -the Perl installer. - The key that is used to sign the pip implementation download might be compromised and this PEP currently proposes no mechanism for key revocation. +There is a Perl package installer also named "pip". It is quite rare and not +commonly used. The Fedora variant of Linux has historically named Python's +"pip" as "python-pip" and Perl's "pip" as "perl-pip". This policy has been +altered[3] so that future Fedora installations will use the name "pip" for +Python's "pip". Existing installations will still have the old name for the +Python "pip", though the potential for confusion is now much reduced. References @@ -216,6 +216,9 @@ References .. [2] pip issue tracking work needed for this PEP https://github.com/pypa/pip/issues/863 +.. [3] Fedora's python-pip package does not provide /usr/bin/pip + https://bugzilla.redhat.com/show_bug.cgi?id=958377 + Acknowledgments =============== @@ -223,7 +226,9 @@ Acknowledgments Nick Coghlan for his thoughts on the proposal and dealing with the Red Hat issue. -Jannis Leidel and Carl Meyer for their thoughts. +Jannis Leidel and Carl Meyer for their thoughts. Marcus Smith for feedback. + +Marcela Mašláňová for resolving the Fedora issue. Copyright