Here is the diff I propose to Debian Python policy, describing our policy on packaging wheels.
Cheers, -Barry === modified file 'debian/python-policy.sgml' --- debian/python-policy.sgml 2014-05-12 10:21:25 +0000 +++ debian/python-policy.sgml 2014-05-16 15:23:30 +0000 @@ -32,7 +32,11 @@ <name>Scott Kitterman</name> <email>sc...@kitterman.com</email> </author> - <version>version 0.9.5</version> + <author> + <name>Barry Warsaw</name> + <email>ba...@debian.org</email> + </author> + <version>version 0.9.6</version> <abstract> This document describes the packaging of Python within the @@ -468,6 +472,36 @@ 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> + The use, building, and inclusion of wheels in binary packages is + strongly discouraged. 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. + </p><p> + Wheels supporting <prgn>pyvenv</prgn> and <prgn>pip</prgn> are named + with the <var>python-</var> prefix, and the <var>-wheels</var> + suffix, e.g. <package>python-chardet-wheels</package>. When + these binary packages are installed, their .whl files should be + placed in the /usr/share/python-wheels directory. Such wheels + should 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>
signature.asc
Description: PGP signature