iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

PEP 610: add canonical URL and minor clarification (#1283)

This commit is contained in:
Stéphane Bidoul 2020-01-26 14:29:59 +01:00 committed by Nick Coghlan
parent d6fa383389
commit bf9d3a51cc
1 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
pep-0610.rst
View File

@ -184,6 +184,9 @@ Specification
This PEP specifies a ``direct_url.json`` file in the ``.dist-info`` directory This PEP specifies a ``direct_url.json`` file in the ``.dist-info`` directory
of an installed distribution, to record the Direct URL Origin of the distribution. of an installed distribution, to record the Direct URL Origin of the distribution.
The canonical source for the name and semantics of this metadata file is
the `Recording the Direct URL Origin of installed distributions`_ document.
This file MUST be created by installers when installing a distribution This file MUST be created by installers when installing a distribution
from a requirement specifying a direct URL reference (including a VCS URL). from a requirement specifying a direct URL reference (including a VCS URL).
@ -251,12 +254,12 @@ present as a dictionary with the following key:
When ``url`` refers to a local directory, it MUST have the ``file`` sheme When ``url`` refers to a local directory, it MUST have the ``file`` sheme
and be compliant with `RFC 8089`_. In particular, the path component must and be compliant with `RFC 8089`_. In particular, the path component must
be absolute. Symbolic links SHOULD be preserved when make relative be absolute. Symbolic links SHOULD be preserved when making relative
paths absolute. paths absolute.
.. note:: .. note::
When the requested URL points to a local directory that happens to contain a When the requested URL has the file:// scheme and points to a local directory that happens to contain a
VCS checkout, installers MUST NOT attempt to infer any VCS information and VCS checkout, installers MUST NOT attempt to infer any VCS information and
therefore MUST NOT output any VCS related information (such as ``vcs_info``) therefore MUST NOT output any VCS related information (such as ``vcs_info``)
in ``direct_url.json``. in ``direct_url.json``.
@ -532,6 +535,7 @@ References
.. _`environment variables in the user:password part of URLs`: https://pip.pypa.io/en/stable/reference/pip_install/#id10 .. _`environment variables in the user:password part of URLs`: https://pip.pypa.io/en/stable/reference/pip_install/#id10
.. _`RFC 8259`: https://tools.ietf.org/html/rfc8259 .. _`RFC 8259`: https://tools.ietf.org/html/rfc8259
.. _`RFC 8089`: https://tools.ietf.org/html/rfc8089 .. _`RFC 8089`: https://tools.ietf.org/html/rfc8089
.. _`Recording the Direct URL Origin of installed distributions`: https://packaging.python.org/specifications/direct-url
Acknowledgements Acknowledgements
================ ================