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

Update to latest metadata 1.3 draft

This commit is contained in:
Nick Coghlan 2012-09-09 01:53:56 +10:00
parent 36006c87d2
commit b280f47364
1 changed files with 15 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
pep-0426.txt
View File

@ -31,9 +31,10 @@ variable to the `environment markers` specification.
Metadata Files
==============
The syntax defined in this PEP is for use with Python distribution metadata
files. This file format is a single set of RFC-822 headers parseable by
the ``rfc822`` or ``email`` modules. The field names listed in the
The syntax defined in this PEP is for use with Python distribution
metadata files. The file format is a simple UTF-8 encoded Key: value
format with no line length parsable by the ``email`` module with an
appropriate ``email.policy.Policy()``. The field names listed in the
`Fields`_ section are used as the header names.
There are two standard locations for these metadata files:
@ -51,8 +52,9 @@ binary distribution archive format).
Encoding
========
Keys must be ASCII. Values are expected to be displayed as UTF-8,
but should otherwise be treated as opaque bytes.
Metadata 1.3 files are UTF-8, with the restriction that keys must be
ASCII. Parsers should be aware that older versions of the Metadata
specification do not specify an encoding.
Fields
======
@ -435,9 +437,10 @@ The label is a free text limited to 32 signs.
Provides-Extra (multiple use)
:::::::::::::::::::::::::::::
A string containing the name of an optional feature. Must be a valid Python
identifier. May be used to make a dependency conditional on whether the
optional feature has been requested.
A string containing the name of an optional feature. Must be printable
ASCII, not containing whitespace, comma (,), or square brackets [].
May be used to make a dependency conditional on whether the optional
feature has been requested.
Example::
@ -475,13 +478,13 @@ not been declared with `Provides-Extra`.
Extension (multiple-use)
::::::::::::::::::::::::
An ASCII string, not containing whitespace or the - character, that
An ASCII string, not containing whitespace or the / character, that
indicates the presence of extended metadata. Additional tags defined by
the extension should be of the form string-Name::
the extension should be of the form string/Name::
Extension: Chili
Chili-Type: Poblano
Chili-Heat: Mild
Chili/Type: Poblano
Chili/Heat: Mild
Version Specifiers