[Python-Dev] PEP 453 (pip bootstrap) TL;DR and Usage Scenario

[anatoly techtonik]

On Mon, Sep 23, 2013 at 2:15 PM, Nick Coghlan <ncoghlan at gmail.com> wrote:
> With the last round of updates, I believe PEP 453 is ready for
> Martin's pronouncement.
>
> HTML: http://www.python.org/dev/peps/pep-0453/
> Major diffs: http://hg.python.org/peps/rev/b2993450b32a

I'd enjoy concise PEP texts, but it is extremely hard to write one, so
is it possible to at least add a TL;DR chapter that just shows the
concept in 15 seconds without all the gory details? What is the
entrypoint in the bootstrap process and knowledge requirements for the
user?

For the same sake, is it possible to include real world usage scenario
as a code paste example of user session. For instance:

   # --- 001: user reads install instruction on <package> site
   # 'pip install <package>'

   # user executes 'pip install <package>' on Windows
   > pip install <package>
   'pip' is not recognized as an internal or external command,
   operable program or batch file.
   # user ...<does what>... ? [ ]

   # user executes 'pip install <package>' on Ubuntu
   $ pip install <package>
   The program 'pip' is currently not installed. You can install it by typing:
   sudo apt-get install pip
   $ sudo apt-get install pip
   # (user has sudo - done)
   # user doesn't have sudo, command fails
   # user ...<does what>... ? [ ]

   # --- 002: user reads install instruction on <package> site
   # 'python -m pip install <package>'

   $ python -m pip install <package>
   /usr/bin/python: No module named pip
   # user ...<does what>... ? [ ]

-- 
anatoly t.