.\" Man page generated from reStructeredText.
.
.TH DH_PYTHON3 1 "" "" ""
.SH NAME
dh_python3 \- calculates Python dependencies, adds maintainer scripts to byte compile files, etc.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
dh_python3 \-p PACKAGE [\-V [X.Y][\-][A.B]] DIR [\-X REGEXPR]
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.SS QUICK GUIDE FOR MAINTAINERS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
if necessary, describe supported Python 3 versions via X\-Python3\-Version field
in debian/control,
.IP \(bu 2
build\-depend on python3 or python3\-all or python3\-all\-dev,
.IP \(bu 2
build module/application using its standard build system,
remember to build extensions for all supported Python 3 versions (loop over
\fBpy3versions \-vr\fP),
.IP \(bu 2
install files to the \fIstandard\fP locations, add \fI\-\-install\-layout=deb\fP to
setup.py\(aqs install command if your package is using distutils,
.IP \(bu 2
add \fIpython3\fP to dh\(aqs \-\-with option, or:
.IP \(bu 2
\fIinclude /usr/share/cdbs/1/class/python\-distutils.mk\fP in debian/rules and
depend on \fIcdbs (>= 0.4.90)\fP, or:
.IP \(bu 2
call \fBdh_python3\fP in the \fIbinary\-*\fP target,
.IP \(bu 2
add \fI${python3:Depends}\fP to Depends
.UNINDENT
.UNINDENT
.UNINDENT
.SS NOTES
.SS dependencies
.sp
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).
.SS private dirs
.sp
\fI/usr/share/foo\fP, \fI/usr/share/games/foo\fP, \fI/usr/lib/foo\fP and
\fI/usr/lib/games/foo\fP private directories are scanned for Python files
by default (where \fIfoo\fP 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.
.SS debug packages
.sp
In binary packages which name ends with \fI\-dbg\fP, all files in
\fI/usr/lib/python3/dist\-packages/\fP directory
that have extensions different than \fIso\fP or \fIh\fP are removed by default.
Use \-\-no\-dbg\-cleaning option to disable this feature.
.SS overriding supported / default Python versions
.sp
If you want to override system\(aqs 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 \fIDEBPYTHON3_SUPPORTED\fP and/or \fIDEBPYTHON3_DEFAULT\fP env. variables.
.sp
Example: \fB3.2,3.3\fP limits the list of supported Python versions to Python 3.2
and Python 3.3.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-version
show program\(aqs version number and exit
.TP
.B \-h,  \-\-help
show help message and exit
.TP
.B \-\-no\-guessing\-deps
disable guessing dependencies
.TP
.B \-\-no\-dbg\-cleaning
do not remove any files from debug packages
.UNINDENT
.sp
\-\-no\-ext\-rename do not add magic tags nor multiarch tuples to extension file names
.INDENT 0.0
.TP
.B \-\-no\-shebang\-rewrite
do not rewrite shebangs
.TP
.B \-\-skip\-private
don\(aqt check private directories
.TP
.B \-v,  \-\-verbose
turn verbose mode on
.TP
.B \-i,  \-\-indep
act on architecture independent packages
.TP
.B \-a,  \-\-arch
act on architecture dependent packages
.TP
.B \-q,  \-\-quiet
be quiet
.TP
.BI \-p \ PACKAGE, \ \-\-package\fB= PACKAGE
act on the package named PACKAGE
.TP
.BI \-N \ NO_PACKAGE, \ \-\-no\-package\fB= NO_PACKAGE
do not act on the specified package
.TP
.BI \-V \ VRANGE
specify list of supported Python 3 versions. See
py3compile(1) for examples
.TP
.BI \-X \ REGEXPR, \ \-\-exclude\fB= REGEXPR
exclude items that match given REGEXPR. You may
use this option multiple times to build up a list of things to exclude.
.TP
.B \-\-compile\-all
compile all files from given private directory in postinst/rtupdate
not just the ones provided by the package (i.e. do not pass the \-\-package
parameter to py3compile/py3clean)
.TP
.BI \-\-depends\fB= DEPENDS
translate given requirements into Debian dependencies
and add them to ${python3:Depends}. Use it for missing items in requires.txt
.TP
.BI \-\-recommends\fB= RECOMMENDS
translate given requirements into Debian dependencies
and add them to ${python3:Recommends}
.TP
.BI \-\-suggests\fB= SUGGESTS
translate given requirements into Debian dependencies
and add them to ${python3:Suggests}
.TP
.BI \-\-requires\fB= FILENAME
translate requirements from given file(s) into Debian
dependencies and add them to ${python3:Depends}
.TP
.BI \-\-shebang\fB= COMMAND
use given command as shebang in scripts
.TP
.B \-\-ignore\-shebangs
do not translate shebangs into Debian dependencies
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
/usr/share/doc/python/python\-policy.txt.gz
.IP \(bu 2
/usr/share/doc/dh\-python/README.PyDist
.IP \(bu 2
pybuild(1)
.IP \(bu 2
py3compile(1), py3clean(1)
.IP \(bu 2
dh_python2(1), pycompile(1), pyclean(1)
.IP \(bu 2
\fI\%http://deb.li/dhp3\fP \- most recent version of this document
.UNINDENT
.SH AUTHOR
Piotr Ożarowski, 2012-2013
.\" Generated by docutils manpage writer.
.\" 
.