1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
|
=========
dh_pypy
=========
---------------------------------------------------------------------------------
calculates PyPy dependencies, adds maintainer scripts to byte compile files, etc.
---------------------------------------------------------------------------------
:Manual section: 1
:Author: Piotr Ożarowski, 2013
SYNOPSIS
========
dh_pypy -p PACKAGE [-V [X.Y][-][A.B]] DIR [-X REGEXPR]
DESCRIPTION
===========
QUICK GUIDE FOR MAINTAINERS
---------------------------
* build-depend on pypy and dh-python,
* add `${pypy:Depends}` to Depends
* build module/application using its standard build system,
* install files to the standard locations,
* add `pypy` to dh's --with option, or:
* call ``dh_pypy`` in the `binary-*` target,
NOTES
-----
dependencies
~~~~~~~~~~~~
dh_pypy tries to translate Python dependencies from requires.txt file to
Debian dependencies. Use debian/pypydist-overrides or --no-guessing-deps option
to override it if the guess is incorrect. If you want dh_pypy to generate
more strict dependencies (f.e. to avoid ABI problems) create
debian/pypy-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_pypy 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_pypy 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 for a private directory that is
checked by default, invoke dh_pypy 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/pypy/dist-packages/` directory that have extensions different than
`so` or `h` are removed by default. Use --no-dbg-cleaning option to disable
this feature.
overriding supported / default PyPy versions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you want to override system's list of supported PyPy versions or the
default one (f.e. to build a package that includes symlinks for older version
of PyPy or compile .py files only for given interpreter version), you can do
that via `DEBPYPY_SUPPORTED` and/or `DEBPYPY_DEFAULT` env. variables.
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
-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/rtupdate
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 ${pypy:Depends}. Use it for missing items in requires.txt
--recommends=RECOMMENDS translate given requirements into Debian dependencies
and add them to ${pypy:Recommends}
--suggests=SUGGESTS translate given requirements into Debian dependencies
and add them to ${pypy:Suggests}
--requires=FILENAME translate requirements from given file(s) into Debian
dependencies and add them to ${pypy:Depends}
--shebang=COMMAND use given command as shebang in scripts
--ignore-shebangs do not translate shebangs into Debian dependencies
SEE ALSO
========
* /usr/share/doc/dh-python/README.PyDist
* pybuild(1)
* http://deb.li/dhpy - most recent version of this document
|