From 585cc8c019b905dc50e03a331ad45a0b1e6d3bac Mon Sep 17 00:00:00 2001 From: Ralf Gommers Date: Tue, 3 Nov 2026 12:59:02 +0000 Subject: [PATCH] Clarify packaging specifications titles and terminology A lot used "PyPA specifications" or more detailed versions of that; that's no longer true, and I don't think anyone has been using it like that for a long time - these are simply Python packaging specifications. --- source/guides/dropping-older-python-versions.rst | 2 +- source/index.rst | 2 +- source/specifications/entry-points.rst | 4 ++-- source/specifications/glob-patterns.rst | 4 ++-- source/specifications/index.rst | 13 ++++++++----- source/specifications/schemas/index.rst | 8 +++++++- 6 files changed, 21 insertions(+), 12 deletions(-) diff --git a/source/guides/dropping-older-python-versions.rst b/source/guides/dropping-older-python-versions.rst index 223b65cd0d..f509280496 100644 --- a/source/guides/dropping-older-python-versions.rst +++ b/source/guides/dropping-older-python-versions.rst @@ -98,7 +98,7 @@ If using the :ref:`setuptools` build backend, consult the `dependency-management Within a Python source package (the zip or the tar-gz file you download) is a text file called PKG-INFO. This file is generated by the :term:`build backend ` when it generates the source package. -The file contains a set of keys and values, the list of keys is part of the PyPA standard metadata format. +The file contains a set of keys and values defined by the :ref:`Core Metadata specification `. You can see the contents of the generated file like this: diff --git a/source/index.rst b/source/index.rst index 3a8b8b61c6..08351016ba 100644 --- a/source/index.rst +++ b/source/index.rst @@ -15,7 +15,7 @@ Python Packaging User Guide tutorials/index guides/index discussions/index - specifications/index + Specifications key_projects glossary support diff --git a/source/specifications/entry-points.rst b/source/specifications/entry-points.rst index 9e59862aae..9fc9f38664 100644 --- a/source/specifications/entry-points.rst +++ b/source/specifications/entry-points.rst @@ -18,8 +18,8 @@ example: The entry point file format was originally developed to allow packages built with setuptools to provide integration point metadata that would be read at -runtime with :py:mod:`importlib.metadata`. It is now defined as a PyPA interoperability -specification in order to allow build tools other than ``setuptools`` to publish +runtime with :py:mod:`importlib.metadata`. It is now defined as a Python packaging +interoperability specification in order to allow build tools other than ``setuptools`` to publish :py:mod:`importlib.metadata` compatible entry point metadata, and runtime libraries other than :py:mod:`importlib.metadata` to portably read published entry point metadata (potentially with different caching and conflict resolution strategies). diff --git a/source/specifications/glob-patterns.rst b/source/specifications/glob-patterns.rst index 8ff3f09fbf..2496d31e01 100644 --- a/source/specifications/glob-patterns.rst +++ b/source/specifications/glob-patterns.rst @@ -2,7 +2,7 @@ ``glob`` patterns ================= -Some PyPA specifications, e.g. :ref:`pyproject.toml's license-files +Some Python packaging specifications, e.g. :ref:`pyproject.toml's license-files `, accept certain types of *glob patterns* to match a given string containing wildcards and character ranges against files and directories. This specification defines which patterns are acceptable @@ -12,7 +12,7 @@ and how they should be handled. Valid glob patterns =================== -For PyPA purposes, a *valid glob pattern* MUST be a string matched against +For this specification, a *valid glob pattern* MUST be a string matched against filesystem entries as specified below: - Alphanumeric characters, spaces (`` ``), underscores (``_``), hyphens (``-``), diff --git a/source/specifications/index.rst b/source/specifications/index.rst index c375654a28..bbd35ad893 100644 --- a/source/specifications/index.rst +++ b/source/specifications/index.rst @@ -1,12 +1,15 @@ +.. legacy title, keep for now to avoid breaking incoming links +.. _pypa-specifications: + .. _`packaging-specifications`: -PyPA specifications -################### +Python Packaging Specifications +############################### This is a list of currently active interoperability specifications maintained -by the Python Packaging Authority. The process for updating these standards, -and for proposing new ones, is documented on -`pypa.io `__. +by the Python Packaging Council. The process for updating these standards, +and for proposing new ones, is documented in +`the python/packaging-council repo `__. .. toctree:: :titlesonly: diff --git a/source/specifications/schemas/index.rst b/source/specifications/schemas/index.rst index a808919759..2df76c9d78 100644 --- a/source/specifications/schemas/index.rst +++ b/source/specifications/schemas/index.rst @@ -1,8 +1,14 @@ +.. legacy title, keep for now to avoid breaking incoming links + +.. _pypa-schemas: +.. _json-schemas: .. _`packaging-schemas`: -PyPA schemas +JSON Schemas ############ +JSON schemas for data structures defined by the packaging specifications. + - `direct_url.json `_ - `build-details.json `_ - `pylock.toml `_