Differences between revisions 27 and 28
Revision 27 as of 2010-07-14 03:21:47
Size: 3222
Comment: changing section title "Current problems" to "Current regretful practices" and adding absence of -dbg packages
Revision 28 as of 2010-07-23 11:05:32
Size: 3746
Editor: UmangVarma
Comment: added comment on distutils' /usr/local/ installation target (as opposed to the upstream sys.prefix)
Deletions are marked like this. Additions are marked like this.
Line 42: Line 42:
 * `distutils` setup scripts install files in `/usr/local/` not `sys.prefix` (which is normally `/usr/`). This is because `/usr/` is reserved for files installed from Debian packages. Note that `/usr/local/lib/pythonX.Y/dist-packages` is in `sys.path` so that modules not installed from Debian packages can still be accessed by the system Python. Tools like debhelper pass the `--install-layout=deb` option to the setup script while building a Debian package so that its installs files into `/usr/` not `/usr/local/`.
 *

Python in Debian

Within the Debian project Python packages are maintained by individual developers and three main teams :

There are also :

Supported Python Versions

Debian's latest release Lenny contains multiple Python versions: 2.5 (the default) and 2.4.

Debian Python Policy for Python developers

The Debian Python Policy describes conventions for packaging and distributing Python code in Debian.

The official text is located at http://www.debian.org/doc/packaging-manuals/python-policy/.

Feel free to ask any questions on debian-python@list.debian.org mailing list.

if you want to maintain a Python package, you have to know how the Debian Development works.

Deviations from upstream

Debian distributions modify upstream Python in a few ways that are important to understand. Of course, where at all possible, we try to minimize deviations from upstream, but here is an enumeration of the changes you might encounter on a Debian system (and derivatives, such as Ubuntu).

  • dist-packages instead of site-packages. Third party Python software installed from Debian packages goes into dist-packages, not site-packages. This is to reduce conflict between the system Python, and any from-source Python build you might install manually.

  • The python-setuptools package installs the Distribute fork instead of the standard setuptools.

  • The python-virtualenv also uses distribute by default, but can enable classic setuptools with an optional switch.

  • distutils setup scripts install files in /usr/local/ not sys.prefix (which is normally /usr/). This is because /usr/ is reserved for files installed from Debian packages. Note that /usr/local/lib/pythonX.Y/dist-packages is in sys.path so that modules not installed from Debian packages can still be accessed by the system Python. Tools like debhelper pass the --install-layout=deb option to the setup script while building a Debian package so that its installs files into /usr/ not /usr/local/.

Current regretful practices

  • Tests from distributed packages are usually stripped, so it is not possible for user to run them to ensure that package works as expected. This assumes that package maintainers run tests for all possible system configurations. This also makes troubleshooting harder.
  • -dbg packages are not commonly built/packaged for modules with extensions. GDB gets constantly improving allowing to easier debugging of Python modules, and extensions built using python*-dbg libraries are necessary to take advantage.

See also