~mitya57/ubuntu/trusty/dh-python/tests-dependencies

« back to all changes in this revision

Viewing changes to dh_pypy.rst

  • Committer: Package Import Robot
  • Author(s): Piotr Ożarowski
  • Date: 2013-07-07 21:47:50 UTC
  • Revision ID: package-import@ubuntu.com-20130707214750-d6wmodmuzp78kt75
Tags: upstream-1.0~b1
Import upstream version 1.0~b1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
=========
 
2
 dh_pypy
 
3
=========
 
4
 
 
5
---------------------------------------------------------------------------------
 
6
calculates PyPy dependencies, adds maintainer scripts to byte compile files, etc.
 
7
---------------------------------------------------------------------------------
 
8
 
 
9
:Manual section: 1
 
10
:Author: Piotr Ożarowski, 2013
 
11
 
 
12
SYNOPSIS
 
13
========
 
14
  dh_pypy -p PACKAGE [-V [X.Y][-][A.B]] DIR [-X REGEXPR]
 
15
 
 
16
DESCRIPTION
 
17
===========
 
18
 
 
19
QUICK GUIDE FOR MAINTAINERS
 
20
---------------------------
 
21
 
 
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,
 
28
 
 
29
NOTES
 
30
-----
 
31
 
 
32
dependencies
 
33
~~~~~~~~~~~~
 
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).
 
42
 
 
43
private dirs
 
44
~~~~~~~~~~~~
 
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.
 
53
 
 
54
debug packages
 
55
~~~~~~~~~~~~~~
 
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
 
59
this feature.
 
60
 
 
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.
 
67
 
 
68
 
 
69
OPTIONS
 
70
=======
 
71
--version       show program's version number and exit
 
72
 
 
73
-h, --help      show help message and exit
 
74
 
 
75
--no-guessing-deps      disable guessing dependencies
 
76
 
 
77
--no-dbg-cleaning       do not remove any files from debug packages
 
78
 
 
79
--no-shebang-rewrite    do not rewrite shebangs
 
80
 
 
81
--skip-private  don't check private directories
 
82
 
 
83
-v, --verbose   turn verbose mode on
 
84
 
 
85
-i, --indep     act on architecture independent packages
 
86
 
 
87
-a, --arch      act on architecture dependent packages
 
88
 
 
89
-q, --quiet     be quiet
 
90
 
 
91
-p PACKAGE, --package=PACKAGE   act on the package named PACKAGE
 
92
 
 
93
-N NO_PACKAGE, --no-package=NO_PACKAGE  do not act on the specified package
 
94
 
 
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.
 
97
 
 
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)
 
101
 
 
102
--depends=DEPENDS       translate given requirements into Debian dependencies
 
103
  and add them to ${pypy:Depends}. Use it for missing items in requires.txt
 
104
 
 
105
--recommends=RECOMMENDS         translate given requirements into Debian dependencies
 
106
  and add them to ${pypy:Recommends}
 
107
 
 
108
--suggests=SUGGESTS     translate given requirements into Debian dependencies
 
109
  and add them to ${pypy:Suggests}
 
110
 
 
111
--shebang=COMMAND       use given command as shebang in scripts
 
112
 
 
113
--ignore-shebangs       do not translate shebangs into Debian dependencies
 
114
 
 
115
SEE ALSO
 
116
========
 
117
* /usr/share/doc/dh-python/README.PyDist
 
118
* pybuild(1)
 
119
* http://deb.li/dhpy - most recent version of this document