Skip to content

Clarify that TOML v1.0 is used for specs #1987

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sirosen wants to merge 1 commit into
base: main
Choose a base branch
from
+7 −3
Open

Clarify that TOML v1.0 is used for specs #1987

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
3 changes: 2 additions & 1 deletion source/specifications/inline-script-metadata.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ script type
-----------

The first type of metadata block is named ``script``, which contains
script metadata (dependency data and tool configuration).
script metadata (dependency data and tool configuration) formatted as TOML 1.0 text.

This document MAY include the top-level fields ``dependencies`` and ``requires-python``,
and MAY optionally include a ``[tool]`` table.
Expand Down Expand Up @@ -217,3 +217,4 @@ History
block type was renamed to ``script``, and the ``[run]`` table was dropped,
making the ``dependencies`` and ``requires-python`` keys
top-level. Additionally, the specification is no longer provisional.
- January 2026: Clarify that the ``script`` block is TOML 1.0 formatted text.
3 changes: 2 additions & 1 deletion source/specifications/pylock-toml.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ file would be in the directory that held all the projects being locked.
File Format
-----------

The format of the file is TOML_.
The format of the file is TOML_ version 1.0.

Tools SHOULD write their lock files in a consistent way to minimize noise in
diff output. Keys in tables -- including the top-level table -- SHOULD be
Expand Down Expand Up @@ -826,6 +826,7 @@ History
-------

- April 2025: Initial version, approved via :pep:`751`.
- January 2026: Clarify that the TOML format version is 1.0 .


.. _Content-Length: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Length
Expand Down
4 changes: 3 additions & 1 deletion source/specifications/pyproject-toml.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ 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 <https://toml.io>`_. Three
The ``pyproject.toml`` file is written in `TOML <https://toml.io>`_ version 1.0. Three
tables are currently specified, namely
:ref:`[build-system] <pyproject-build-system-table>`,
:ref:`[project] <pyproject-project-table>` and
Expand Down Expand Up @@ -649,4 +649,6 @@ History
- October 2025: The ``import-names`` and ``import-namespaces`` keys were added
through :pep:`794`.

- January 2026: Clarify that the TOML format version is 1.0 .

.. _TOML: https://toml.io
Loading