44Dependency Groups
55=================
66
7- This specification defines Dependency Groups , a mechanism for storing package
7+ This specification defines dependency groups , a mechanism for storing package
88requirements in ``pyproject.toml `` files such that they are not included in
99project metadata when it is built.
1010
11- Dependency Groups are suitable for internal development use-cases like linting
11+ Dependency groups are suitable for internal development use-cases like linting
1212and testing, as well as for projects which are not built for distribution, like
1313collections of related scripts.
1414
15- Fundamentally, Dependency Groups should be thought of as being a standardized
15+ Fundamentally, dependency groups should be thought of as being a standardized
1616subset of the capabilities of ``requirements.txt `` files (which are
1717``pip ``-specific).
1818
@@ -38,7 +38,7 @@ and a similar table which defines ``docs``, ``test``, and ``coverage`` groups::
3838The ``[dependency-groups] `` Table
3939---------------------------------
4040
41- Dependency Groups are defined as a table in ``pyproject.toml `` named
41+ Dependency groups are defined as a table in ``pyproject.toml `` named
4242``dependency-groups ``. The ``dependency-groups `` table contains an arbitrary
4343number of user-defined keys, each of which has, as its value, a list of
4444requirements.
@@ -103,9 +103,9 @@ Package Building
103103
104104Build backends MUST NOT include Dependency Group data in built distributions as
105105package metadata. This means that sdist ``PKG-INFO `` and wheel ``METADATA ``
106- files should not include referenceable fields containing Dependency Groups .
106+ files should not include referenceable fields containing dependency groups .
107107
108- It is, however, valid to use Dependency Groups in the evaluation of dynamic
108+ It is, however, valid to use dependency groups in the evaluation of dynamic
109109metadata, and ``pyproject.toml `` files included in sdists will still contain
110110``[dependency-groups] ``. However, the table's contents are not part of a built
111111package's interfaces.
@@ -114,28 +114,28 @@ Installing Dependency Groups & Extras
114114-------------------------------------
115115
116116There is no syntax or specification-defined interface for installing or
117- referring to Dependency Groups . Tools are expected to provide dedicated
117+ referring to dependency groups . Tools are expected to provide dedicated
118118interfaces for this purpose.
119119
120120Tools MAY choose to provide the same or similar interfaces for interacting
121- with Dependency Groups as they do for managing extras. Tools authors are
121+ with dependency groups as they do for managing extras. Tools authors are
122122advised that the specification does not forbid having an extra whose name
123123matches a Dependency Group. Separately, users are advised to avoid creating
124- Dependency Groups whose names match extras, and tools MAY treat such matching
124+ dependency groups whose names match extras, and tools MAY treat such matching
125125as an error.
126126
127127Validation and Compatibility
128128----------------------------
129129
130- Tools supporting Dependency Groups may want to validate data before using it.
130+ Tools supporting dependency groups may want to validate data before using it.
131131When implementing such validation, authors should be aware of the possibility
132132of future extensions to the specification, so that they do not unnecessarily
133133emit errors or warnings.
134134
135135Tools SHOULD error when evaluating or processing unrecognized data in
136- Dependency Groups .
136+ dependency groups .
137137
138- Tools SHOULD NOT eagerly validate the contents of *all * Dependency Groups
138+ Tools SHOULD NOT eagerly validate the contents of *all * dependency groups
139139unless they have a need to do so.
140140
141141This means that in the presence of the following data, most tools should allow
@@ -151,7 +151,7 @@ the ``foo`` group to be used and only error if the ``bar`` group is used:
151151
152152 There are several known cases of tools which have good cause to be
153153 stricter. Linters and validators are an example, as their purpose is to
154- validate the contents of all Dependency Groups .
154+ validate the contents of all dependency groups .
155155
156156Reference Implementation
157157========================
0 commit comments