diff --git a/source/specifications/pyproject-toml.rst b/source/specifications/pyproject-toml.rst index 4ce9b7484..f5e0c02ec 100644 --- a/source/specifications/pyproject-toml.rst +++ b/source/specifications/pyproject-toml.rst @@ -16,13 +16,15 @@ tools (as well as other tools). .. note:: This specification was originally defined in :pep:`518` and :pep:`621`. -The ``pyproject.toml`` file is written in `TOML `_. Three +The ``pyproject.toml`` file is written in `TOML `_. Several tables are currently specified, namely :ref:`[build-system] `, -:ref:`[project] ` and -:ref:`[tool] `. Other tables are reserved for future +:ref:`[project] `, +:ref:`[tool] `, and +:ref:`[dependency-groups] `. Other tables are reserved for future use (tool-specific configuration should use the ``[tool]`` table). + .. _pyproject-build-system-table: Declaring build system dependencies: the ``[build-system]`` table @@ -541,4 +543,19 @@ History added and ``License::`` classifiers were deprecated through :pep:`639`. +.. _pyproject-dependency-groups-table: + +Declaring dependency groups: the ``[dependency-groups]`` table +============================================================== + +This specification defines Dependency Groups, a mechanism for storing package requirements in +``[pyproject.toml]`` files such that they are not included in project metadata when it is built. + +The ``[dependency-groups]`` table is an optional top-level table that allows defining non-distribution dependencies used for internal tooling, such as testing or linting. +Dependency groups are also suitable for use in projects which are not built for distribution, such as collections of related scripts. + +For the full specification and behavior, refer to the `Dependency Groups specification `_. + + + .. _TOML: https://toml.io