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