Skip to content

Commit a81a2d0

Browse files
committed
Allow referencing/linking to individual fields in pyproject.toml
1 parent 09f4316 commit a81a2d0

File tree

1 file changed

+30
-1
lines changed

1 file changed

+30
-1
lines changed

source/specifications/pyproject-toml.rst

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,8 @@ The complete list of keys allowed in the ``[project]`` table are:
149149
- ``version``
150150

151151

152+
.. _pyproject-toml-name:
153+
152154
``name``
153155
--------
154156

@@ -161,6 +163,9 @@ The name of the project.
161163
Tools SHOULD :ref:`normalize <name-normalization>` this name, as soon
162164
as it is read for internal consistency.
163165

166+
167+
.. _pyproject-toml-version:
168+
164169
``version``
165170
-----------
166171

@@ -174,6 +179,8 @@ The version of the project, as defined in the
174179
Users SHOULD prefer to specify already-normalized versions.
175180

176181

182+
.. _pyproject-toml-description:
183+
177184
``description``
178185
---------------
179186

@@ -185,6 +192,8 @@ The summary description of the project in one line. Tools MAY error
185192
if this includes multiple lines.
186193

187194

195+
.. _pyproject-toml-readme:
196+
188197
``readme``
189198
----------
190199

@@ -224,6 +233,8 @@ as supported by the :ref:`core metadata <core-metadata>`. Otherwise
224233
tools MUST raise an error for unsupported content-types.
225234

226235

236+
.. _pyproject-toml-requires-python:
237+
227238
``requires-python``
228239
-------------------
229240

@@ -234,6 +245,8 @@ tools MUST raise an error for unsupported content-types.
234245
The Python version requirements of the project.
235246

236247

248+
.. _pyproject-toml-license:
249+
237250
``license``
238251
-----------
239252

@@ -285,6 +298,9 @@ license files. For example they can choose not to include any files or use
285298
their own logic to discover the appropriate files in the distribution.
286299

287300

301+
.. _pyproject-toml-authors:
302+
.. _pyproject-toml-maintainers:
303+
288304
``authors``/``maintainers``
289305
---------------------------
290306

@@ -327,6 +343,8 @@ follows:
327343
4. Multiple values should be separated by commas.
328344

329345

346+
.. _pyproject-toml-keywords:
347+
330348
``keywords``
331349
------------
332350

@@ -337,6 +355,8 @@ follows:
337355
The keywords for the project.
338356

339357

358+
.. _pyproject-toml-classifiers:
359+
340360
``classifiers``
341361
---------------
342362

@@ -353,6 +373,8 @@ Build tools MAY raise an error if both the ``license`` string value
353373
classifiers are used.
354374

355375

376+
.. _pyproject-toml-urls:
377+
356378
``urls``
357379
--------
358380

@@ -365,6 +387,10 @@ URL itself. See :ref:`well-known-project-urls` for normalization rules
365387
and well-known rules when processing metadata for presentation.
366388

367389

390+
.. _pyproject-toml-scripts:
391+
.. _pyproject-toml-gui-scripts:
392+
.. _pyproject-toml-entry-points:
393+
368394
Entry points
369395
------------
370396

@@ -395,6 +421,9 @@ be ambiguous in the face of ``[project.scripts]`` and
395421
``[project.gui-scripts]``, respectively.
396422

397423

424+
.. _pyproject-toml-dependencies:
425+
.. _pyproject-toml-optional-dependencies:
426+
398427
``dependencies``/``optional-dependencies``
399428
------------------------------------------
400429

@@ -422,7 +451,7 @@ matching :ref:`Provides-Extra <core-metadata-provides-extra>`
422451
metadata.
423452

424453

425-
454+
.. _pyproject-toml-dynamic:
426455
.. _declaring-project-metadata-dynamic:
427456

428457
``dynamic``

0 commit comments

Comments
 (0)