Skip to content

Commit 410e953

Browse files
committed
Add documentation for the zipapp distribution
1 parent bad03ef commit 410e953

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

docs/html/installation.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,34 @@ More details about this script can be found in [pypa/get-pip]'s README.
4545

4646
[pypa/get-pip]: https://github.com/pypa/get-pip
4747

48+
## Standalone zip application
49+
50+
In addition to installing pip in your environment, pip is available as a
51+
standalone [zip application](https://docs.python.org/3.11/library/zipapp.html).
52+
This can be downloaded from <https://bootstrap.pypa.io/pip/pip.pyz>. There are
53+
also zip applications for specific pip versions, named `pip-X.Y.Z.pyz`.
54+
55+
The zip application can be run using any supported version of Python:
56+
57+
```{pip-cli}
58+
$ python pip.pyz --help
59+
```
60+
61+
If run directly:
62+
63+
```{pip-cli}
64+
$ pip.pyz --help
65+
```
66+
67+
then the currently active Python interpreter will be used.
68+
69+
```{note}
70+
The zip application is currently experimental. We test that pip runs correctly
71+
in this form, but it is possible that there could be issues in some situations.
72+
We will accept bug reports in such cases, but for now the zip application should
73+
not be used in production environments.
74+
```
75+
4876
## Alternative Methods
4977

5078
Depending on how you installed Python, there might be other mechanisms

0 commit comments

Comments
 (0)