Skip to content

Commit 174e3c1

Browse files
committed
Convert 'Dependency Groups' to lowercase
Outside of titles and other contexts, convert this term to lowercase. This usage better matches other terms defined in the packaging specifications, such as "script metadata" and "dependency specifiers". For reference, this change was inspired by: pypa#1847 (comment)
1 parent 56c1fef commit 174e3c1

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

source/specifications/dependency-groups.rst

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,15 @@
44
Dependency 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
88
requirements in ``pyproject.toml`` files such that they are not included in
99
project 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
1212
and testing, as well as for projects which are not built for distribution, like
1313
collections 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
1616
subset 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::
3838
The ``[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
4343
number of user-defined keys, each of which has, as its value, a list of
4444
requirements.
@@ -103,9 +103,9 @@ Package Building
103103

104104
Build backends MUST NOT include Dependency Group data in built distributions as
105105
package 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
109109
metadata, and ``pyproject.toml`` files included in sdists will still contain
110110
``[dependency-groups]``. However, the table's contents are not part of a built
111111
package's interfaces.
@@ -114,28 +114,28 @@ Installing Dependency Groups & Extras
114114
-------------------------------------
115115

116116
There 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
118118
interfaces for this purpose.
119119

120120
Tools 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
122122
advised that the specification does not forbid having an extra whose name
123123
matches 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
125125
as an error.
126126

127127
Validation 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.
131131
When implementing such validation, authors should be aware of the possibility
132132
of future extensions to the specification, so that they do not unnecessarily
133133
emit errors or warnings.
134134

135135
Tools 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
139139
unless they have a need to do so.
140140

141141
This 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

156156
Reference Implementation
157157
========================

0 commit comments

Comments
 (0)