@@ -9,9 +9,9 @@ and the differences between them.
9
9
10
10
You will find files in two formats on package indices such as PyPI _: **source
11
11
distributions **, or **sdists ** for short, and **binary distributions **, commonly
12
- called **wheels **. For example, the `PyPI page for pip 23 .3.1 <pip-pypi _>`_
13
- lets you download two files, ``pip-23 .3.1.tar.gz `` and
14
- ``pip-23 .3.1-py3-none-any.whl ``. The former is an sdist, the latter is a
12
+ called **wheels **. For example, the `PyPI page for pip 24 .3.1 <pip-pypi _>`_
13
+ lets you download two files, ``pip-24 .3.1.tar.gz `` and
14
+ ``pip-24 .3.1-py3-none-any.whl ``. The former is an sdist, the latter is a
15
15
wheel. As explained below, these serve different purposes. When publishing a
16
16
package on PyPI (or elsewhere), you should always upload both an sdist and one
17
17
or more wheel.
@@ -42,7 +42,7 @@ MacPorts on macOS, ...), who, for various reasons, may prefer them over, e.g.,
42
42
pulling from a Git repository.
43
43
44
44
A source distribution is recognized by its file name, which has the form
45
- :samp: `{ package_name } -{ version } .tar.gz `, e.g., ``pip-23 .3.1.tar.gz ``.
45
+ :samp: `{ package_name } -{ version } .tar.gz `, e.g., ``pip-24 .3.1.tar.gz ``.
46
46
47
47
.. TODO: provide clear guidance on whether sdists should contain docs and tests.
48
48
Discussion: https://discuss.python.org/t/should-sdists-include-docs-and-tests/14578
@@ -115,7 +115,7 @@ files are missing from your wheels.
115
115
The file name of a wheel (ignoring some rarely used features) looks like this:
116
116
:samp: `{ package_name } -{ version } -{ python_tag } -{ abi_tag } -{ platform_tag } .whl `.
117
117
This naming convention identifies which platforms and Python versions the wheel
118
- is compatible with. For example, the name ``pip-23 .3.1-py3-none-any.whl `` means
118
+ is compatible with. For example, the name ``pip-24 .3.1-py3-none-any.whl `` means
119
119
that:
120
120
121
121
- (``py3 ``) This wheel can be installed on any implementation of Python 3,
@@ -187,7 +187,7 @@ Here's a breakdown of the important differences between wheel and egg.
187
187
188
188
189
189
190
- .. _pip-pypi : https://pypi.org/project/pip/23.3.1/ #files
190
+ .. _pip-pypi : https://pypi.org/project/pip/#files
191
191
.. _pypi : https://pypi.org
192
192
.. _pypi-eggs-deprecation : https://blog.pypi.org/posts/2023-06-26-deprecate-egg-uploads/
193
193
.. _pypy : https://pypy.org
0 commit comments