5
---------------------------------------------------------------------------------
6
calculates PyPy dependencies, adds maintainer scripts to byte compile files, etc.
7
---------------------------------------------------------------------------------
10
:Author: Piotr Ożarowski, 2013
14
dh_pypy -p PACKAGE [-V [X.Y][-][A.B]] DIR [-X REGEXPR]
19
QUICK GUIDE FOR MAINTAINERS
20
---------------------------
22
* build-depend on pypy and dh-python,
23
* add `${pypy:Depends}` to Depends
24
* build module/application using its standard build system,
25
* install files to the standard locations,
26
* add `pypy` to dh's --with option, or:
27
* call ``dh_pypy`` in the `binary-*` target,
34
dh_pypy tries to translate Python dependencies from requires.txt file to
35
Debian dependencies. Use debian/pypydist-overrides or --no-guessing-deps option
36
to override it if the guess is incorrect. If you want dh_pypy to generate
37
more strict dependencies (f.e. to avoid ABI problems) create
38
debian/pypy-foo.pydist file. See /usr/share/doc/dh-python/README.PyDist
39
for more information. If the pydist file contains PEP386 flag or set of (uscan
40
like) rules, dh_pypy will make the depedency versioned (version requirements
41
are ignored by default).
45
`/usr/share/foo`, `/usr/share/games/foo`, `/usr/lib/foo` and
46
`/usr/lib/games/foo` private directories are scanned for Python files by
47
default (where `foo` is binary package name). If your package is shipping
48
Python files in some other directory, add another dh_pypy call in debian/rules
49
with directory name as an argument - you can use different set of options in
50
this call. If you need to change options for a private directory that is
51
checked by default, invoke dh_pypy with --skip-private option and add another
52
call with a path to this directory and new options.
56
In binary packages which name ends with `-dbg`, all files in
57
`/usr/lib/pypy/dist-packages/` directory that have extensions different than
58
`so` or `h` are removed by default. Use --no-dbg-cleaning option to disable
61
overriding supported / default PyPy versions
62
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
63
If you want to override system's list of supported PyPy versions or the
64
default one (f.e. to build a package that includes symlinks for older version
65
of PyPy or compile .py files only for given interpreter version), you can do
66
that via `DEBPYPY_SUPPORTED` and/or `DEBPYPY_DEFAULT` env. variables.
71
--version show program's version number and exit
73
-h, --help show help message and exit
75
--no-guessing-deps disable guessing dependencies
77
--no-dbg-cleaning do not remove any files from debug packages
79
--no-shebang-rewrite do not rewrite shebangs
81
--skip-private don't check private directories
83
-v, --verbose turn verbose mode on
85
-i, --indep act on architecture independent packages
87
-a, --arch act on architecture dependent packages
91
-p PACKAGE, --package=PACKAGE act on the package named PACKAGE
93
-N NO_PACKAGE, --no-package=NO_PACKAGE do not act on the specified package
95
-X REGEXPR, --exclude=REGEXPR exclude items that match given REGEXPR. You may
96
use this option multiple times to build up a list of things to exclude.
98
--compile-all compile all files from given private directory in postinst/rtupdate
99
not just the ones provided by the package (i.e. do not pass the --package
100
parameter to py3compile/py3clean)
102
--depends=DEPENDS translate given requirements into Debian dependencies
103
and add them to ${pypy:Depends}. Use it for missing items in requires.txt
105
--recommends=RECOMMENDS translate given requirements into Debian dependencies
106
and add them to ${pypy:Recommends}
108
--suggests=SUGGESTS translate given requirements into Debian dependencies
109
and add them to ${pypy:Suggests}
111
--shebang=COMMAND use given command as shebang in scripts
113
--ignore-shebangs do not translate shebangs into Debian dependencies
117
* /usr/share/doc/dh-python/README.PyDist
119
* http://deb.li/dhpy - most recent version of this document