Skip to content

Commit c8ce64f

Browse files
committed
Apply suggestions from review
- Specify that names should be normalized - "Importable" shouldn't be capitalised. - Use "must" rather than "Shall"
1 parent aeeae15 commit c8ce64f

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

source/specifications/recording-installed-packages.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,14 @@ backwards compatibility considerations.
3434
The .dist-info directory
3535
========================
3636

37-
Each project installed from a distribution shall, in addition to files,
38-
install a "``.dist-info``" directory located alongside Importable modules and
37+
Each project installed from a distribution must, in addition to files,
38+
install a "``.dist-info``" directory located alongside importable modules and
3939
packages (commonly, the ``site-packages`` directory).
4040

4141
This directory is named as ``{name}-{version}.dist-info``, with `name` and
4242
`version` fields corresponding to :ref:`core-metadata`.
43+
The name field must be in normalized form (see `PEP 503 <https://www.python.org/dev/peps/pep-0503/#normalized-names>`_
44+
for the definition of normalization).
4345

4446
This ``.dist-info`` directory can contain these files, described in detail
4547
below:
@@ -73,7 +75,7 @@ specification, version 1.1 or greater.
7375

7476
The ``METADATA`` file is mandatory.
7577
If it cannot be created, or if required core metadata is not available,
76-
no ``.dist-info`` directory should be created at all.
78+
installers must report an error and fail to install the project.
7779

7880

7981
The RECORD file

0 commit comments

Comments
 (0)