Skip to content

Commit 8e1a237

Browse files
authored
Mention manylinux_x_y in platform tags specification
1 parent 78e821a commit 8e1a237

1 file changed

Lines changed: 15 additions & 12 deletions

File tree

source/specifications/platform-compatibility-tags.rst

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,12 @@ The scheme defined in :pep:`425` is insufficient for public distribution of
3333
wheel files (and \*nix wheel files in general) to Linux platforms, due to the
3434
large ecosystem of Linux platforms and subtle differences between them.
3535

36-
Instead, :pep:`513` defines the ``manylinux`` standard, which represents a
36+
Instead, :pep:`600` defines the ``manylinux`` standard, which represents a
3737
common subset of Linux platforms, and allows building wheels tagged with the
3838
``manylinux`` platform tag which can be used across most common Linux
3939
distributions.
4040

41-
There are multiple iterations of the ``manylinux`` specification, each
41+
There were multiple iterations of the ``manylinux`` specification, each
4242
representing the common subset of Linux platforms at a given point in time:
4343

4444
* ``manylinux1`` (:pep:`513`) supports ``x86_64`` and ``i686``
@@ -51,6 +51,8 @@ representing the common subset of Linux platforms at a given point in time:
5151
and ``s390x``) and updates the base platform to a compatible Linux platform
5252
from 2014.
5353

54+
``manylinux_x_y`` (:pep:`600`) supersedes all previous PEPs to define a future-proof standard. It defines ``x`` and ``y`` as glibc major an minor versions supported (e.g. ``manylinux_2_24`` should work on any distro using glibc 2.24+). Previous tags are still supported for backward compatibility.
55+
5456
In general, distributions built for older versions of the specification are
5557
forwards-compatible (meaning that ``manylinux1`` distributions should continue
5658
to work on modern systems) but not backwards-compatible (meaning that
@@ -59,26 +61,27 @@ existed before 2010).
5961

6062
Package maintainers should attempt to target the most compatible specification
6163
possible, with the caveat that the provided build environment for
62-
``manylinux1`` has reached end-of-life, and the build environment for
63-
``manylinux2010`` will reach end-of-life in November 2020 [#]_, meaning that
64+
``manylinux1`` and ``manylinux2010`` have reached end-of-life meaning that
6465
these images will no longer receive security updates.
6566

6667
Manylinux compatibility support
6768
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6869

6970
.. Note::
70-
The ``manylinux2014`` specification is relatively new and is not yet widely
71+
* The ``manylinux2014`` specification is relatively new and is not yet widely
72+
recognised by install tools.
73+
* The ``manylinux_x_y`` specification is relatively new and is not yet widely
7174
recognised by install tools.
7275

7376
The following table shows the minimum versions of relevant projects to support
7477
the various ``manylinux`` standards:
7578

76-
========== ============== ================= =================
77-
Tool ``manylinux1`` ``manylinux2010`` ``manylinux2014``
78-
========== ============== ================= =================
79-
pip ``>=8.1.0`` ``>=19.0`` ``>=19.3``
80-
auditwheel ``>=1.0.0`` ``>=2.0.0`` ``>=3.0.0``
81-
========== ============== ================= =================
79+
========== ============== ================= ================= =================
80+
Tool ``manylinux1`` ``manylinux2010`` ``manylinux2014`` ``manylinux_x_y``
81+
========== ============== ================= ================= =================
82+
pip ``>=8.1.0`` ``>=19.0`` ``>=19.3`` ``>=20.3``
83+
auditwheel ``>=1.0.0`` ``>=2.0.0`` ``>=3.0.0`` ``>=3.3.0`` [#]_
84+
========== ============== ================= ================= =================
8285

8386
Platform tags for other \*nix platforms
8487
---------------------------------------
@@ -89,4 +92,4 @@ distribution of wheel files to other \*nix platforms. Efforts are currently
8992
schemes for AIX and for Alpine Linux.
9093

9194

92-
.. [#] https://wiki.centos.org/About/Product
95+
.. [#] Only support for ``manylinux_2_24`` has been added in auditwheel 3.3.0

0 commit comments

Comments
 (0)