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

PEP 386: Resolve uses of the default role (#3376)

This commit is contained in:
Adam Turner 2023-09-01 20:19:28 +01:00 committed by GitHub
parent ea13fde512
commit eb75dbcb15
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
pep-0386.txt
View File

@ -25,9 +25,9 @@ Motivation
In Python there are no real restrictions yet on how a project should manage its In Python there are no real restrictions yet on how a project should manage its
versions, and how they should be incremented. versions, and how they should be incremented.
Distutils provides a `version` distribution meta-data field but it is freeform and Distutils provides a ``version`` distribution meta-data field but it is freeform and
current users, such as PyPI usually consider the latest version pushed as the current users, such as PyPI usually consider the latest version pushed as the
`latest` one, regardless of the expected semantics. ``latest`` one, regardless of the expected semantics.
Distutils will soon extend its capabilities to allow distributions to express a Distutils will soon extend its capabilities to allow distributions to express a
dependency on other distributions through the ``Requires-Dist`` metadata field dependency on other distributions through the ``Requires-Dist`` metadata field
@ -271,8 +271,8 @@ a particular package was using and to provide tools on top of PyPI.
Distutils classes are not really used in Python projects, but the Distutils classes are not really used in Python projects, but the
Setuptools function is quite widespread because it's used by tools like Setuptools function is quite widespread because it's used by tools like
`easy_install` [#ezinstall]_, `pip` [#pip]_ or `zc.buildout` [#zc.buildout]_ ``easy_install`` [#ezinstall]_, ``pip`` [#pip]_ or ``zc.buildout``
to install dependencies of a given project. [#zc.buildout]_ to install dependencies of a given project.
While Setuptools *does* provide a mechanism for comparing/sorting versions, While Setuptools *does* provide a mechanism for comparing/sorting versions,
it is much preferable if the versioning spec is such that a human can make a it is much preferable if the versioning spec is such that a human can make a
@ -292,7 +292,7 @@ The new versioning algorithm
During Pycon, members of the Python, Ubuntu and Fedora community worked on During Pycon, members of the Python, Ubuntu and Fedora community worked on
a version standard that would be acceptable for everyone. a version standard that would be acceptable for everyone.
It's currently called `verlib` and a prototype lives at [#prototype]_. It's currently called ``verlib`` and a prototype lives at [#prototype]_.
The pseudo-format supported is:: The pseudo-format supported is::
@ -362,9 +362,9 @@ Note that ``c`` is the preferred marker for third party projects.
NormalizedVersion NormalizedVersion
----------------- -----------------
The `NormalizedVersion` class is used to hold a version and to compare it with The ``NormalizedVersion`` class is used to hold a version and to compare it
others. It takes a string as an argument, that contains the representation of with others. It takes a string as an argument, that contains the representation
the version:: of the version::
>>> from verlib import NormalizedVersion >>> from verlib import NormalizedVersion
>>> version = NormalizedVersion('1.0') >>> version = NormalizedVersion('1.0')