dh_python3 man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

DH_PYTHON3(1)							 DH_PYTHON3(1)

NAME
       dh_python3 - calculates Python dependencies, adds maintainer scripts to
       byte compile files, etc.

SYNOPSIS
	  dh_python3 -p PACKAGE [-V [X.Y][-][A.B]] DIR [-X REGEXPR]

DESCRIPTION
   QUICK GUIDE FOR MAINTAINERS
	  · if	necessary,  describe   supported   Python   3	versions   via
	    X-Python3-Version field in debian/control,

	  · build-depend on python3 or python3-all or python3-all-dev,

	  · build module/application using its standard build system, remember
	    to build extensions for all supported Python 3 versions (loop over
	    py3versions -vr),

	  · install  files to the standard locations, add --install-layout=deb
	    to setup.py's install command if your package is using distutils,

	  · add python3 to dh's --with option, or:

	  · include	  /usr/share/cdbs/1/class/python-distutils.mk	    in
	    debian/rules and depend on cdbs (>= 0.4.90), or:

	  · call dh_python3 in the binary-* target,

	  · add ${python3:Depends} to Depends

   NOTES
   dependencies
       dh_python3  tries  to  translate	 Python dependencies from requires.txt
       file  to	  Debian   dependencies.   Use	 debian/py3dist-overrides   or
       --no-guessing-deps  option to override it if the guess is incorrect. If
       you want dh_python3 to generate more strict dependencies (f.e. to avoid
       ABI    problems)	   create    debian/python3-foo.pydist	  file.	   See
       /usr/share/doc/dh-python/README.PyDist for  more	 information.  If  the
       pydist  file  contains  PEP386  flag  or	 set  of  (uscan  like) rules,
       dh_python3 will make the depedency versioned (version requirements  are
       ignored by default).

   private dirs
       /usr/share/foo,	     /usr/share/games/foo,	 /usr/lib/foo	   and
       /usr/lib/games/foo private directories are scanned for Python files  by
       default (where foo is binary package name). If your package is shipping
       Python files in some other directory, add another  dh_python3  call  in
       debian/rules with directory name as an argument - you can use different
       set of options in this call. If you need to change options (f.e. a list
       of supported Python 3 versions) for a private directory that is checked
       by default,  invoke  dh_python3	with  --skip-private  option  and  add
       another call with a path to this directory and new options.

   debug packages
       In   binary   packages	which  name  ends  with	 -dbg,	all  files  in
       /usr/lib/python3/dist-packages/ directory that have extensions  differ‐
       ent  than so or h are removed by default.  Use --no-dbg-cleaning option
       to disable this feature.

   overriding supported / default Python versions
       If you want to override system's list of supported Python  versions  or
       the  default  one  (f.e.	 to build a package that includes symlinks for
       older version of Python or compile .py files only for given interpreter
       version),   you	 can   do   that   via	 DEBPYTHON3_SUPPORTED	and/or
       DEBPYTHON3_DEFAULT env. variables.

       Example: 3.2,3.3 limits the list of supported Python versions to Python
       3.2 and Python 3.3.

OPTIONS
       --version
	      show program's version number and exit

       -h, --help
	      show help message and exit

       --no-guessing-deps
	      disable guessing dependencies

       --no-dbg-cleaning
	      do not remove any files from debug packages

       --no-ext-rename do not add magic tags nor multiarch tuples to extension
       file names

       --no-shebang-rewrite
	      do not rewrite shebangs

       --skip-private
	      don't check private directories

       -v, --verbose
	      turn verbose mode on

       -i, --indep
	      act on architecture independent packages

       -a, --arch
	      act on architecture dependent packages

       -q, --quiet
	      be quiet

       -p PACKAGE, --package=PACKAGE
	      act on the package named PACKAGE

       -N NO_PACKAGE, --no-package=NO_PACKAGE
	      do not act on the specified package

       -V VRANGE
	      specify list of supported Python 3 versions.  See	 py3compile(1)
	      for examples

       -X REGEXPR, --exclude=REGEXPR
	      exclude  items that match given REGEXPR. You may use this option
	      multiple times to build up a list of things to exclude.

       --compile-all
	      compile all files from given private directory in postinst/rtup‐
	      date not just the ones provided by the package (i.e. do not pass
	      the --package parameter to py3compile/py3clean)

       --depends=DEPENDS
	      translate given requirements into Debian	dependencies  and  add
	      them   to	 ${python3:Depends}.  Use  it  for  missing  items  in
	      requires.txt

       --recommends=RECOMMENDS
	      translate given requirements into Debian	dependencies  and  add
	      them to ${python3:Recommends}

       --suggests=SUGGESTS
	      translate	 given	requirements  into Debian dependencies and add
	      them to ${python3:Suggests}

       --requires=FILENAME
	      translate requirements from given file(s) into Debian  dependen‐
	      cies and add them to ${python3:Depends}

       --shebang=COMMAND
	      use given command as shebang in scripts

       --ignore-shebangs
	      do not translate shebangs into Debian dependencies

SEE ALSO
       · /usr/share/doc/python/python-policy.txt.gz

       · /usr/share/doc/dh-python/README.PyDist

       · pybuild(1)

       · py3compile(1), py3clean(1)

       · dh_python2(1), pycompile(1), pyclean(1)

       · http://deb.li/dhp3 - most recent version of this document

AUTHOR
       Piotr Ożarowski, 2012-2013

								 DH_PYTHON3(1)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net