[Python-checkins] peps: Update to latest metadata 1.3 draft
nick.coghlan
python-checkins at python.org
Sat Sep 8 17:54:05 CEST 2012
http://hg.python.org/peps/rev/547555402269
changeset: 4508:547555402269
user: Nick Coghlan <ncoghlan at gmail.com>
date: Sun Sep 09 01:53:56 2012 +1000
summary:
Update to latest metadata 1.3 draft
files:
pep-0426.txt | 27 +++++++++++++++------------
1 files changed, 15 insertions(+), 12 deletions(-)
diff --git a/pep-0426.txt b/pep-0426.txt
--- a/pep-0426.txt
+++ b/pep-0426.txt
@@ -31,9 +31,10 @@
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 @@
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 @@
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 @@
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
--
Repository URL: http://hg.python.org/peps
More information about the Python-checkins
mailing list