diff --git a/docs/html/installation.md b/docs/html/installation.md index d9b9a2d9fef..7db0d47ab23 100644 --- a/docs/html/installation.md +++ b/docs/html/installation.md @@ -45,6 +45,34 @@ More details about this script can be found in [pypa/get-pip]'s README. [pypa/get-pip]: https://github.com/pypa/get-pip +### Standalone zip application + +```{note} +The zip application is currently experimental. We test that pip runs correctly +in this form, but it is possible that there could be issues in some situations. +We will accept bug reports in such cases, but for now the zip application should +not be used in production environments. +``` + +In addition to installing pip in your environment, pip is available as a +standalone [zip application](https://docs.python.org/3.11/library/zipapp.html). +This can be downloaded from . There are +also zip applications for specific pip versions, named `pip-X.Y.Z.pyz`. + +The zip application can be run using any supported version of Python: + +```{pip-cli} +$ python pip.pyz --help +``` + +If run directly: + +```{pip-cli} +$ pip.pyz --help +``` + +then the currently active Python interpreter will be used. + ## Alternative Methods Depending on how you installed Python, there might be other mechanisms diff --git a/news/11459.feature.rst b/news/11459.feature.rst new file mode 100644 index 00000000000..a4a11c09353 --- /dev/null +++ b/news/11459.feature.rst @@ -0,0 +1 @@ +Document the new (experimental) zipapp distribution of pip.