From 5df768c7fd02468b2cd8fe08395dcde1db41de28 Mon Sep 17 00:00:00 2001 From: Atiqur Rahman Date: Fri, 31 Jul 2026 19:38:09 +0600 Subject: [PATCH 1/4] doc: add pyproject.toml entry-point example to plugin documentation (fixes #10721) --- doc/en/how-to/writing_plugins.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/doc/en/how-to/writing_plugins.rst b/doc/en/how-to/writing_plugins.rst index 17823098d0c..55df2e270f5 100644 --- a/doc/en/how-to/writing_plugins.rst +++ b/doc/en/how-to/writing_plugins.rst @@ -215,7 +215,14 @@ as plugins. As an example consider the following package:: pytest_foo/plugin.py pytest_foo/helper.py -With the following typical ``setup.py`` extract: +With the following typical ``pyproject.toml`` extract: + +.. code-block:: toml + + [project.entry-points.pytest11] + foo = "pytest_foo.plugin" + +Or with a legacy ``setup.py`` extract: .. code-block:: python From b9da513155f50f878a004fc0cc34eaad82d1aabc Mon Sep 17 00:00:00 2001 From: Atiqur Rahman Date: Fri, 31 Jul 2026 20:29:37 +0600 Subject: [PATCH 2/4] changelog: add entry fragment for #10721 --- changelog/10721.doc.rst | 1 + 1 file changed, 1 insertion(+) create mode 100644 changelog/10721.doc.rst diff --git a/changelog/10721.doc.rst b/changelog/10721.doc.rst new file mode 100644 index 00000000000..8b8fecf1546 --- /dev/null +++ b/changelog/10721.doc.rst @@ -0,0 +1 @@ +Document PEP 621 ``pyproject.toml`` entry point format for ``pytest11`` plugins in plugin writing guide. From cd21c4e4362f2e14ce069faca1894cc1f8b1df12 Mon Sep 17 00:00:00 2001 From: Atiqur Rahman Date: Sat, 1 Aug 2026 10:59:27 +0600 Subject: [PATCH 3/4] doc: use intersphinx reference for tox package_env in changelog --- doc/en/changelog.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/en/changelog.rst b/doc/en/changelog.rst index c5601712b00..1d1d053e645 100644 --- a/doc/en/changelog.rst +++ b/doc/en/changelog.rst @@ -466,7 +466,7 @@ Packaging updates and notes for downstreams ------------------------------------------- - `#13933 `_: The tox configuration has been adjusted to make sure the desired - version string can be passed into its :ref:`package_env` through + version string can be passed into its :external+tox:ref:`package_env` through the ``SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST`` environment variable as a part of the release process -- by :user:`webknjaz`. @@ -481,7 +481,7 @@ Contributor-facing changes - `#13933 `_: The tox configuration has been adjusted to make sure the desired - version string can be passed into its :ref:`package_env` through + version string can be passed into its :external+tox:ref:`package_env` through the ``SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST`` environment variable as a part of the release process -- by :user:`webknjaz`. From e317508486e749892411a526fb94dfcd861e48c7 Mon Sep 17 00:00:00 2001 From: Atiqur Rahman Date: Sat, 1 Aug 2026 11:25:49 +0600 Subject: [PATCH 4/4] doc: add changelog fragment and direct link for package_env (#14823) --- changelog/14823.doc.rst | 1 + doc/en/changelog.rst | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) create mode 100644 changelog/14823.doc.rst diff --git a/changelog/14823.doc.rst b/changelog/14823.doc.rst new file mode 100644 index 00000000000..66d9dc63185 --- /dev/null +++ b/changelog/14823.doc.rst @@ -0,0 +1 @@ +Fix unresolved Sphinx cross-reference for ``package_env`` in changelog documentation. diff --git a/doc/en/changelog.rst b/doc/en/changelog.rst index 1d1d053e645..8ecdf31d116 100644 --- a/doc/en/changelog.rst +++ b/doc/en/changelog.rst @@ -466,7 +466,7 @@ Packaging updates and notes for downstreams ------------------------------------------- - `#13933 `_: The tox configuration has been adjusted to make sure the desired - version string can be passed into its :external+tox:ref:`package_env` through + version string can be passed into its `package_env `_ through the ``SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST`` environment variable as a part of the release process -- by :user:`webknjaz`. @@ -481,7 +481,7 @@ Contributor-facing changes - `#13933 `_: The tox configuration has been adjusted to make sure the desired - version string can be passed into its :external+tox:ref:`package_env` through + version string can be passed into its `package_env `_ through the ``SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST`` environment variable as a part of the release process -- by :user:`webknjaz`.