Skip to content

Commit 9356687

Browse files
committed
Expand on backward compatibility
1 parent 4051d6c commit 9356687

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

peps/pep-0780.rst

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -191,7 +191,7 @@ expressed as a frozen set of strings of the form ``f"{name}::{value}"``, where
191191
``name`` is the name of the field and ``value`` is the string representation of
192192
its value.
193193

194-
The ``sys_abi_info`` environment variable
194+
The ``sys_abi_info`` Environment Variable
195195
'''''''''''''''''''''''''''''''''''''''''
196196
To do this, we need to extend the grammar laid out in :pep:`508` and maintained
197197
in the :ref:`packaging:dependency-specifiers` and document the possible values,
@@ -303,6 +303,15 @@ However, the introduction of the feature has implications for a number of
303303
ecosystem tools, especially those which attempt to support examination of data
304304
in ``pyproject.toml`` and ``requirements.txt``.
305305

306+
In particular, current tools generally work with a fixed list of environment
307+
variables, either in their own implementation (e.g. `uv <https://github.com/astral-sh/uv/blob/86e7b2e97a193ce3f506804be4c41c611191fa72/crates/uv-pep508/src/marker/tree.rs#L170>`_)
308+
or via an established package like `pypa/packaging <https://github.com/pypa/packaging/blob/8f13a4309aa620bf643cd508304f783b456e8c49/src/packaging/_tokenizer.py#L63>`_ (e.g. pip).
309+
Hence, it is principally impossible to add any new environment markers without
310+
making new packages using these markers incompatible with older versions of
311+
these tools.
312+
However, once these tools support the proposed marker variable, changes in its
313+
contents are handled gracefully.
314+
306315
Audit and Update Tools
307316
----------------------
308317

0 commit comments

Comments
 (0)