UPDATE-PYTHON-MODULES

Section: Maintenance Commands (8)
Updated: 18 Feb 2009
Index Return to Main Contents

NAME

update-python-modules - byte-compile python modules

SYNOPSIS

update-python-modules [options] [package.public [...]]

DESCRIPTION

The update-python-modules command is part of the python-support bundle.

update-python-modules is responsible for the byte-compilation of python modules. When used in byte-compilation mode, it will byte-compile modules references in the files given on the command line. When used in installation mode, it will byte-compile them once for each installed python version, and will make them available for all of them.

At each invocation, with or without arguments, update-python-modules will check for installed python versions, and will build or remove modules according to new or removed versions since the last time it was run.

ARGUMENTS

Arguments must be files or directories located in the /usr/share/python-support directory. Depending on their extension, they are treated differently.

package.public: A file listing public modules to install for each version. These modules must lie in /usr/share/pyshared or /usr/lib/pyshared.
package.private: A file listing private modules to byte-compile for one Python version.
package/: A legacy directory hierarchy of public modules. The C extensions and portions that change with the Python version are to be found in /usr/lib/python-support/pythonX.Y/package/.
package.dirs: A legacy file listing directories where to find private modules.

OPTIONS

-h, --help: Show summary of options.
-v, --verbose: Detail all actions while they are performed.
-b, --bytecompile: Only accept to work on private modules. When given this option, update-python-modules will fail if passed references to public modules.
-i, --install: Only accept to work on public modules. When given this option, update-python-modules will fail if passed references to public modules.
-c, --clean: Clean modules instead of installing them.
-a, --rebuild-all: Rebuild all private modules. This is necessary when the default python version was changed, for example. .TP -f, --force-rebuild-all Clean all modules (public and private), and rebuild them.

FILES

/usr/lib/pymodules/pythonX.Y/: These directories contain the byte-compiled modules for version pythonX.Y.

AUTHOR

Josselin Mouette <joss@debian.org>.