From c3562aebefdc20874a3fff21e34782b0c83f9704 Mon Sep 17 00:00:00 2001
From: Scott Kitterman <scott@kitterman.com>
Date: Wed, 21 May 2014 00:33:31 -0400
Subject: [PATCH] Add python policy for Python Wheels
---
debian/changelog | 7 +++++++
debian/python-policy.sgml | 44 ++++++++++++++++++++++++++++++++++++++-
2 files changed, 50 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index 03fbcf8..07047d7 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+python-defaults (2.7.6-2) unstable; urgency=medium
+
+ [ Barry Warsaw ]
+ * Add python policy for Python Wheels
+
+ -- Scott Kitterman <scott@kitterman.com> Wed, 21 May 2014 00:04:16 -0400
+
python-defaults (2.7.6-1) unstable; urgency=medium
* Bump version to 2.7.6.
diff --git a/debian/python-policy.sgml b/debian/python-policy.sgml
index e133706..c71d4c0 100644
--- a/debian/python-policy.sgml
+++ b/debian/python-policy.sgml
@@ -32,7 +32,11 @@
<name>Scott Kitterman</name>
<email>scott@kitterman.com</email>
</author>
- <version>version 0.9.5</version>
+ <author>
+ <name>Barry Warsaw</name>
+ <email>barry@debian.org</email>
+ </author>
+ <version>version 0.10.0</version>
<abstract>
This document describes the packaging of Python within the
@@ -468,6 +472,44 @@
programs included in the same package.
</p>
</sect>
+ <sect id="wheels">
+ <heading>Wheels</heading>
+ <p>
+ <url id="http://legacy.python.org/dev/peps/pep-0427/"
+ name="PEP 427">
+ defines a built-package format called "wheels", which is a zip
+ format archive containing Python code and a "dist-info" metadata
+ directory, in a single file named with the .whl suffix. As zip
+ files, wheels containing pure-Python can be put on sys.path and
+ modules in the wheel can be imported directly by Python's "import"
+ statement. (Importing extension modules from wheels is not yet
+ supported as of Python 3.4.)
+ </p><p>
+ Except as described below, packages must not build or provide
+ wheels. They are redundant to the established way of providing
+ Python libraries to Debian users, take no advantage of distro-based
+ tools, and are less convenient to use. E.g. they must be explicitly
+ added to sys.path, cannot be easily grepped, and stack traces
+ through zips are more difficult to debug.
+ </p><p>
+ A very limited set of wheel packages are available in the archive,
+ but these support the narrow purpose of providing the Python 3
+ built-in virtual environment creation executable
+ <prgn>pyvenv-3.x</prgn>, as well as the within-venv <prgn>pip</prgn>
+ executable, in a Debian policy compliant way. The set of packages
+ providing wheels for this purpose are (by source package name):
+ chardet, distlib, html5lib, python-colorama, python-pip,
+ python-setuptools, python-urllib3, requests, six, and urllib3.
+ </p><p>
+ Wheel packages supporting <prgn>pyvenv</prgn> and <prgn>pip</prgn>
+ are named with the <var>python-</var> prefix, and the <var>-whl</var>
+ suffix, e.g. <package>python-chardet-whl</package>. When these
+ binary packages are installed, their .whl files must be placed in
+ the /usr/share/python-wheels directory. Such wheels must be built
+ with the <tt>--universal</tt> flag so as to generate wheels
+ compatible with both Python 2 and Python 3.
+ </p>
+ </sect>
<sect id="package_names">
<heading>Module Package Names</heading>
<p>
--
GitLab