Skip to content

Commit 2ff0cc2

Browse files
sbidoulncoghlan
authored andcommitted
PEP 610: specification will live on packaging.python.org (#1282)
Also add note about reproducibility As suggested by Nick Coghlan at https://discuss.python.org/t/draft-pep-recording-the-origin-of-distributions-installed-from-direct-url-references/1535/41?u=sbidoul * PEP 610: amending must be done by writing a new PEP As suggested by NIck Coghlan
1 parent 7ecaee9 commit 2ff0cc2

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

pep-0610.rst

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,7 @@ as a dictionary with the following keys:
212212

213213
- A ``vcs`` key (type ``string``) MUST be present, containing the name of the VCS
214214
(i.e. one of ``git``, ``hg``, ``bzr``, ``svn``). Other VCS's SHOULD be registered by
215-
amending this PEP.
215+
writing a PEP to amend this specification.
216216
The ``url`` value MUST be compatible with the corresponding VCS,
217217
so an installer can hand it off without transformation to a
218218
checkout/download command of the VCS.
@@ -282,7 +282,7 @@ on how to use the ``vcs``, ``requested_revision``, and other fields of
282282
``vcs_info``; and in
283283
some cases additional VCS-specific fields.
284284
Tools MAY support other VCS's although it is RECOMMENDED to register
285-
them by amending this PEP. The ``vcs`` field SHOULD be the command name
285+
them by writing a PEP to amend this specification. The ``vcs`` field SHOULD be the command name
286286
(lowercased). Additional fields that would be necessary to
287287
support such VCS SHOULD be prefixed with the VCS command name.
288288

@@ -478,6 +478,13 @@ Use cases
478478
the ``tag`` value if present, as it has immutable semantics.
479479
Tools MAY choose another approach, depending on the needs of their users.
480480

481+
Note the initial iteration of this PEP does not attempt to make environments
482+
that include editable installs or installs from local directories
483+
reproducible, but it does attempt to make them readily identifiable. By
484+
locating the local project directory via the ``url`` and ``dir_info`` fields
485+
of this specification, tools can implement any strategy that fits their use
486+
cases.
487+
481488
Backwards Compatibility
482489
=======================
483490

0 commit comments

Comments
 (0)