Invokes various build systems for requested python versions in order to build modules and extensions
pybuild [ACTION] [BUILD SYSTEM ARGUMENTS] [DIRECTORIES] [OPTIONS]
build depend on dh-python,
build depend on python3-all, python-all-dbg, pypy, etc. (for all supported Python interpreters, pybuild will use it to create a list of interpreters to build for),
add --buildsystem=pybuild to dh's arguments in debian/rules,
if more than one binary package is build: add debian/python-foo.install files, or export PYBUILD_NAME=modulename (modulename will be used to guess binary package prefixes), or export PYBUILD_DESTDIR env. variables in debian/rules
debian/rules file example:
#! /usr/bin/make -f
export PYBUILD_NAME=foo
%:
dh $@ --with python2,python3 --buildsystem=pybuild
Most options can be set (in addition to command line) via environment variables. PyBuild will check:
PYBUILD_OPTION_VERSIONED_INTERPRETER (f.e. PYBUILD_CLEAN_ARGS_python3.2)
PYBUILD_OPTION_INTERPRETER (f.e. PYBUILD_CONFIGURE_ARGS_python3-dbg)
PYBUILD_OPTION (f.e. PYBUILD_INSTALL_ARGS)
-h, --help
show this help message and exit
-v, --verbose
turn verbose mode on
-q, --quiet
doesn't show external command's output
-qq,--really-quiet
be quiet
--version
show program's version number and exit
The default is to build, install and test the library using detected build system version by version. Selecting one of following actions, will invoke given action for all versions - one by one - which (contrary to the default action) in some build systems can overwrite previous results.
--detect
return the name of detected build system
--clean
clean files using auto-detected build system specific methods
--configure
invoke configure step for all requested Python versions
--build
invoke build step for all requested Python versions
--install
invoke install step for all requested Python versions
--test
invoke tests for auto-detected build system
--list-systems
list available build systems and exit
unittest's discover from standard library (available in Python 2.7 and >= 3.2) is used in test step by default.
--test-nose
use nose module in test step, remember to add python-nose and/or python3-nose to Build-Depends
--test-pytest
use pytest module in test step, remember to add python-pytest and/or python3-pytest to Build-Depends
--test-tox
use tox command in test step, remember to add python-tox to Build-Depends. Requires tox.ini file
Additional arguments passed to the build system. --system=custom requires complete command.
--before-cleanCOMMAND
invoked before the clean command
--clean-argsARGUMENTS
arguments added to clean command generated by build system plugin
--after-cleanCOMMAND
invoked after the clean command
--before-configureCOMMAND
invoked before the configure command
--configure-argsARGUMENTS
arguments added to configure command generated by build system plugin
--after-configureCOMMAND
invoked after the configure command
--before-buildCOMMAND
invoked before the build command
--build-argsARGUMENTS
arguments added to build command generated by build system plugin
--after-buildCOMMAND
invoked after the build command
--before-installCOMMAND
invoked before the install command
--install-argsARGUMENTS
arguments added to install command generated by build system plugin
--after-installCOMMAND
invoked after the install command
--before-testCOMMAND
invoked before the test command
--test-argsARGUMENTS
arguments added to test command generated by build system plugin
--after-testCOMMAND
invoked after the test command
{version} will be replaced with current Python version, you can also use {version.major}, {version.minor}, etc.
{interpreter} will be replaced with current interpreter, you can also use {interpreter.include_dir}
{dir} will be replaced with sources directory,
{destdir} will be replaced with destination directory,
{home_dir} will be replaced with temporary HOME directory, where plugins can keep their data (.pybuild/interpreter_version/ by default),
{build_dir} will be replaced with build directory
{install_dir} will be replaced with install directory.
{package} will be replaced with suggested package name, if --name (or PYBUILD_NAME) is set to foo, this variable will be replaced to python-foo, python3-foo or pypy-foo depending on interpreter which is used in given iteration.
-dDIR,--dirDIR
set source files directory - base for other relative dirs [by default: current working directory]
--dest-dirDIR
set destination directory [default: debian/tmp]
--ext-dest-dirDIR
set destination directory for .so files
--ext-patternPATTERN
regular expression for files that should be moved if --ext-destdir is set [default: .so(.[^/]*)?$]
--install-dirDIR
set installation directory [default: .../dist-packages]
--nameNAME
use this name to guess destination directories (depending on interpreter, "foo" sets debian/python-foo, debian/python3-foo, debian/python3-foo-dbg, etc.)
{version} will be replaced with current Python version,
{interpreter} will be replaced with selected interpreter.
-sSYSTEM,--systemSYSTEM
select a build system [default: auto-detection]
-pVERSIONS,--pyverVERSIONS
build for Python VERSIONS. This option can be used multiple times. Versions can be separated by space character. The default is all Python 3.X supported versions.
-iINTERPRETER,--interpreterINTERPRETER
change interpreter [default: python{version}]
--disableITEMS
disable action, interpreter, version or any mix of them. Note that f.e. python3 and python3-dbg are two different interpreters, --disable test/python3 doesn't disable python3-dbg's tests.
--disable test/python2.5-dbg - disables tests for python2.5-dbg
--disable '2.4 2.7' - disables all actions for version 2.4 and 2.7
PYBUILD_DISABLE_python2=1 - disables all actions for Python 2.X
PYBUILD_DISABLE_python3.3=test - disables tests for Python 3.3
PYBUILD_DISABLE=test/python3.3 - same as above
PYBUILD_DISABLE=configure/python3 2.4 pypy - disables configure action for all python3 interpreters, all actions for version 2.4, and all actions for pypy
https://wiki.debian.org/Python/Pybuild
http://deb.li/pybuild - most recent version of this document
Piotr Ożarowski, 2012-2013