Debian Python FAQ
1. Supporting multiple python versions
We always have several versions of Python in Debian. Some packages provide modules only for the default version, and other provide modules for all available versions. Some sources packages do that by providing several binary packages while other do that with a single one.
We should reduce that diversity and if possible provide the modules for all python version available within Debian. The following guidelines should help you.
1.1. Using python-support
A non-binary module (i.e. package with architecture: all) can use python-support to make the module available to all available Python versions. For this you need to install the module in a sub-directory of /usr/share/python-support and then you need to register that directory with update-python-modules in the postint (and unregister accordingly in prerm). Of course you need to add "python-support" as a dependency. Please note that the default Depends field generated by dh_python is wrong since the package now supports multiple versions. Until this is fixed you need to manually define the dependency (like "python (>=2.3), python (<< 2.5)", if you say that you support python 2.3 and python2.4).
Example of postinst:
set -e #DEBHELPER# if [ "$1" = "configure" ] && which update-python-modules >/dev/null 2>&1; then update-python-modules -i /usr/share/python-support/kid fi
Example of prerm:
set -e #DEBHELPER# if which update-python-modules >/dev/null 2>&1; then update-python-modules -c -i /usr/share/python-support/kid fi
2. Python eggs
2.1. What are Python eggs?
2.2. How should we package Python eggs?
We don't want to provide ".egg" files within the .deb. However we want to make the "egg meta-information" available so that users can use eggs if they so wish. For that you need to pass the option "--single-version-externally-managed" to the "setup.py install" call.
Packages relying on CDBS can do that this way:
# Install egg-info directories DEB_PYTHON_INSTALL_ARGS_ALL += --single-version-externally-managed
2.3. How do we add Egg support to a package that doesnt support it yet?
Basicly, you should modify setup.py to use the setup function of "setuptools" instead of "distutils". Of course, you must then Build-Depends on "python-setuptools (>= 0.6a9)" which is the first version supporting the egg-info directories.
Check the following links for documentation about setuptools and creation of Eggs:
Example of minimal patch:
--- elementtree-1.2.6.old/setup.py 2006-04-18 12:25:33.000000000 +0000 +++ elementtree-1.2.6/setup.py 2006-04-18 12:26:30.000000000 +0000 @@ -7,6 +7,7 @@ # from distutils.core import setup +from setuptools import setup try: # add download_url syntax to distutils
Adding "egg support" is only required in some specific cases: when another software uses the python module via an egg and when this egg support is not yet integrated upstream.