Skip to content

Move get-pip.py warning above instructions to prevent accidental misuse #1953

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
+8 −8
Open

Move get-pip.py warning above instructions to prevent accidental misuse #1953

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions source/tutorials/installing-packages.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,21 +133,21 @@ standard library:

If that still doesn't allow you to run ``python -m pip``:

.. warning::

Be cautious if you're using a Python install that's managed by your
operating system or another package manager. ``get-pip.py`` does not
coordinate with those tools, and may leave your system in an inconsistent
state. You can use ``python get-pip.py --prefix=/usr/local/`` to install
in ``/usr/local`` which is designed for locally-installed software.

* Securely Download `get-pip.py
Copy link
Member

@webknjaz webknjaz Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Normally, list items are supposed to follow a : at the end of a paragraph. Putting the warning between that and the items gets us weird rendering.

Currenlty, the warning ended up being wrapped into a blockquote: https://python-packaging-user-guide--1953.org.readthedocs.build/en/1953/tutorials/installing-packages/#ensure-you-can-run-pip-from-the-command-line.

<https://bootstrap.pypa.io/get-pip.py>`_ [1]_

* Run ``python get-pip.py``. [2]_ This will install or upgrade pip.
Additionally, it will install :ref:`setuptools` and :ref:`wheel` if they're
not installed already.

.. warning::

Be cautious if you're using a Python install that's managed by your
operating system or another package manager. get-pip.py does not
coordinate with those tools, and may leave your system in an
inconsistent state. You can use ``python get-pip.py --prefix=/usr/local/``
to install in ``/usr/local`` which is designed for locally-installed
software.


Ensure pip, setuptools, and wheel are up to date
Expand Down
Loading