[Distutils] DRAFT PEP 396 - module version number
Barry Warsaw
barry at python.org
Thu Jun 9 00:14:03 CEST 2011
Given Ben's and Fred's feedback, what do you think about this list in the
Specification's section:
#. In general, modules in the standard library SHOULD NOT have version
numbers. They implicitly carry the version number of the Python
release they are included in.
#. On a case-by-case basis, standard library modules which are also
released in standalone form for other Python versions MAY include a
module version number when included in the standard library, and
SHOULD include a version number when packaged separately.
#. When a module (or package) includes a version number, the version
SHOULD be available in the ``__version__`` attribute.
#. For modules which live inside a namespace package, the sub-package
name SHOULD include the ``__version__`` attribute. The namespace
module itself SHOULD NOT include its own ``__version__`` attribute.
#. The ``__version__`` attribute's value SHOULD be a string.
#. Module version numbers SHOULD conform to the normalized version
format specified in PEP 386 [6]_.
#. Module version numbers SHOULD NOT contain version control system
supplied revision numbers, or any other semantically different
version numbers (e.g. underlying library version number).
#. The ``version`` attribute in a classic distutils ``setup.py``
file, or the PEP 345 [7]_ ``Version`` metadata field SHOULD be
derived from the ``__version__`` field, or vice versa.
-Barry
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20110608/1a90e229/attachment.pgp>
More information about the Distutils-SIG
mailing list