Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 30 additions & 1 deletion source/specifications/pyproject-toml.rst
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,8 @@ The complete list of keys allowed in the ``[project]`` table are:
- ``version``


.. _pyproject-toml-name:

``name``
--------

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


.. _pyproject-toml-version:

``version``
-----------

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


.. _pyproject-toml-description:

``description``
---------------

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


.. _pyproject-toml-readme:

``readme``
----------

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


.. _pyproject-toml-requires-python:

``requires-python``
-------------------

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


.. _pyproject-toml-license:

``license``
-----------

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


.. _pyproject-toml-authors:
.. _pyproject-toml-maintainers:

``authors``/``maintainers``
---------------------------

Expand Down Expand Up @@ -327,6 +343,8 @@ follows:
4. Multiple values should be separated by commas.


.. _pyproject-toml-keywords:

``keywords``
------------

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


.. _pyproject-toml-classifiers:

``classifiers``
---------------

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


.. _pyproject-toml-urls:

``urls``
--------

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


.. _pyproject-toml-scripts:
.. _pyproject-toml-gui-scripts:
.. _pyproject-toml-entry-points:

Entry points
------------

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


.. _pyproject-toml-dependencies:
.. _pyproject-toml-optional-dependencies:

``dependencies``/``optional-dependencies``
------------------------------------------

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



.. _pyproject-toml-dynamic:
.. _declaring-project-metadata-dynamic:

``dynamic``
Expand Down