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
This commit is contained in:
parent
7ecaee9478
commit
2ff0cc2ad2
11
pep-0610.rst
11
pep-0610.rst
|
@ -212,7 +212,7 @@ as a dictionary with the following keys:
|
||||||
|
|
||||||
- A ``vcs`` key (type ``string``) MUST be present, containing the name of the VCS
|
- A ``vcs`` key (type ``string``) MUST be present, containing the name of the VCS
|
||||||
(i.e. one of ``git``, ``hg``, ``bzr``, ``svn``). Other VCS's SHOULD be registered by
|
(i.e. one of ``git``, ``hg``, ``bzr``, ``svn``). Other VCS's SHOULD be registered by
|
||||||
amending this PEP.
|
writing a PEP to amend this specification.
|
||||||
The ``url`` value MUST be compatible with the corresponding VCS,
|
The ``url`` value MUST be compatible with the corresponding VCS,
|
||||||
so an installer can hand it off without transformation to a
|
so an installer can hand it off without transformation to a
|
||||||
checkout/download command of the VCS.
|
checkout/download command of the VCS.
|
||||||
|
@ -282,7 +282,7 @@ on how to use the ``vcs``, ``requested_revision``, and other fields of
|
||||||
``vcs_info``; and in
|
``vcs_info``; and in
|
||||||
some cases additional VCS-specific fields.
|
some cases additional VCS-specific fields.
|
||||||
Tools MAY support other VCS's although it is RECOMMENDED to register
|
Tools MAY support other VCS's although it is RECOMMENDED to register
|
||||||
them by amending this PEP. The ``vcs`` field SHOULD be the command name
|
them by writing a PEP to amend this specification. The ``vcs`` field SHOULD be the command name
|
||||||
(lowercased). Additional fields that would be necessary to
|
(lowercased). Additional fields that would be necessary to
|
||||||
support such VCS SHOULD be prefixed with the VCS command name.
|
support such VCS SHOULD be prefixed with the VCS command name.
|
||||||
|
|
||||||
|
@ -478,6 +478,13 @@ Use cases
|
||||||
the ``tag`` value if present, as it has immutable semantics.
|
the ``tag`` value if present, as it has immutable semantics.
|
||||||
Tools MAY choose another approach, depending on the needs of their users.
|
Tools MAY choose another approach, depending on the needs of their users.
|
||||||
|
|
||||||
|
Note the initial iteration of this PEP does not attempt to make environments
|
||||||
|
that include editable installs or installs from local directories
|
||||||
|
reproducible, but it does attempt to make them readily identifiable. By
|
||||||
|
locating the local project directory via the ``url`` and ``dir_info`` fields
|
||||||
|
of this specification, tools can implement any strategy that fits their use
|
||||||
|
cases.
|
||||||
|
|
||||||
Backwards Compatibility
|
Backwards Compatibility
|
||||||
=======================
|
=======================
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue