pybuild

       in order to build modules and extensions

SYNOPSIS
          pybuild [ACTION] [BUILD SYSTEM ARGUMENTS] [DIRECTORIES] [OPTIONS]

DEBHELPER COMMAND SEQUENCER INTEGRATION
       o build depend on dh-python,

       o 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),

       o add --buildsystem=pybuild to dh's arguments in debian/rules,

       o 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

       overriding test command with custom build plugin example:

          override_dh_auto_test:
                 PYBUILD_SYSTEM=custom \
                 PYBUILD_TEST_ARGS="command --with --options {build_dir}/" dh_auto_test

OPTIONS
          Most  options  can be set (in addition to command line) via environ-
          ment variables. PyBuild will check:

          o PYBUILD_OPTION_VERSIONED_INTERPRETER                         (f.e.
            PYBUILD_CLEAN_ARGS_python3.2)

          o PYBUILD_OPTION_INTERPRETER          (f.e.          PYBUILD_CONFIG-
            URE_ARGS_python3-dbg)

          o PYBUILD_OPTION (f.e. PYBUILD_INSTALL_ARGS)

   optional arguments
          -h, --help
                 show this help message and exit

          -v, --verbose
                 turn verbose mode on

          -q, --quiet
                 doesn't show external command's output


              --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

   TESTS
          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

   BUILD SYSTEM ARGUMENTS
          Additional  arguments  passed  to the build system.  --system=custom
          requires complete command.

              --before-clean COMMAND
                     invoked before the clean command

              --clean-args ARGUMENTS
                     arguments added to clean command generated by build  sys-
                     tem plugin

              --after-clean COMMAND
                     invoked after the clean command

              --before-configure COMMAND
                     invoked before the configure command
                     arguments added to build command generated by build  sys-
                     tem plugin

              --after-build COMMAND
                     invoked after the build command

              --before-install COMMAND
                     invoked before the install command

              --install-args ARGUMENTS
                     arguments  added  to  install  command generated by build
                     system plugin

              --after-install COMMAND
                     invoked after the install command

              --before-test COMMAND
                     invoked before the test command

              --test-args ARGUMENTS
                     arguments added to test command generated by build system
                     plugin

              --after-test COMMAND
                     invoked after the test command

   variables that can be used in ARGUMENTS and COMMAND
       o {version}  will be replaced with current Python version, you can also
         use {version.major}, {version.minor}, etc.

       o {interpreter} will be replaced with current interpreter, you can also
         use {interpreter.include_dir}

       o {dir} will be replaced with sources directory,

       o {destdir} will be replaced with destination directory,

       o {home_dir}  will  be  replaced  with  temporary HOME directory, where
         plugins  can  keep  their  data   (.pybuild/interpreter_version/   by
         default),

       o {build_dir} will be replaced with build directory

       o {install_dir} will be replaced with install directory.

       o {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.

   DIRECTORIES
          -d DIR, --dir DIR
                 set source files directory - base for other relative dirs [by
                 default: current working directory]
                 set installation directory [default: .../dist-packages]

          --name NAME
                 use this name to guess destination directories (depending  on
                 interpreter,        "foo"       sets       debian/python-foo,
                 debian/python3-foo, debian/python3-foo-dbg, etc.)

   variables that can be used in DIR
       o {version} will be replaced with current Python version,

       o {interpreter} will be replaced with selected interpreter.

   LIMITATIONS
          -s SYSTEM, --system SYSTEM
                 select a build system [default: auto-detection]

          -p VERSIONS, --pyver VERSIONS
                 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.

          -i INTERPRETER, --interpreter INTERPRETER
                 change interpreter [default: python{version}]

          --disable ITEMS
                 disable action, interpreter, version  or  any  mix  of  them.
                 Note  that  f.e.  python3  and  python3-dbg are two different
                 interpreters,   --disable   python3/test   doesn't    disable
                 python3-dbg's tests.

   disable examples
       o --disable test/python2.5-dbg - disables tests for python2.5-dbg

       o --disable '2.4 2.7' - disables all actions for version 2.4 and 2.7

       o PYBUILD_DISABLE_python2=1 - disables all actions for Python 2.X

       o PYBUILD_DISABLE_python3.4=test - disables tests for Python 3.3

       o PYBUILD_DISABLE=test/python3.4 - same as above

       o 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

SEE ALSO
       o dh_python2(1)

       o dh_python3(1)

       o http://deb.li/pybuild - most recent version of this document

AUTHOR
       Piotr Oarowski, 2012-2013
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2017 Hurricane Electric. All Rights Reserved.