.\" Man page generated from reStructuredText.
.
.TH DH-VIRTUALENV 1 "" "" "DebHelper"
.SH NAME
dh-virtualenv \- deploy a Python package in a self-contained virtualenv
.
.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
.sp
\fBdh_virtualenv\fP [\fIOPTIONS\fP]
.SH DESCRIPTION
.sp
\fBdh\-virtualenv\fP is a tool that aims to combine Debian packaging with
self\-contained virtualenv based Python deployments. To do this, the
package extends debhelper\(aqs sequence by providing a new command in
sequence, \fBdh_virtualenv\fP, which effectively replaces following
commands from the sequence:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBdh_auto_install\fP
.IP \(bu 2
\fBdh_python2\fP
.IP \(bu 2
\fBdh_pycentral\fP
.IP \(bu 2
\fBdh_pysupport\fP
.UNINDENT
.UNINDENT
.UNINDENT
.sp
In the sequence the \fBdh_virtualenv\fP is inserted right after
\fBdh_perl\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-p \ PACKAGE\fP,\fB \ \-\-package\fB= PACKAGE
Act on the package named PACKAGE
.TP
.BI \-N \ PACKAGE\fP,\fB \ \-\-no\-package\fB= PACKAGE
Do not act on the specified PACKAGE
.TP
.B \-v\fP,\fB  \-\-verbose
Turn on verbose mode.
.TP
.B \-\-extra\-index\-url
Pass extra index URL to pip
.TP
.BI \-\-preinstall\fB= PACKAGE
Preinstall a PACKAGE before running pip.
.TP
.BI \-\-pip\-tool\fB= PIP_TOOL
Tool used to install requirements.
.TP
.B \-\-extra\-pip\-arg
Extra arg for the pip executable.
.TP
.B \-\-extra\-virtualenv\-arg
Extra arg for the virtualenv executable.
.TP
.B \-\-index\-url
Base URL for PyPI server.
.TP
.B \-\-setuptools
Use setuptools instead of distribute.
.TP
.BI \-\-install\-suffix\fB= SUFFIX
Override virttualenv installation suffix
.TP
.B \-\-upgrade\-pip
Force upgrade pip in virtualenv
.TP
.BI \-\-requirements\fB= FILE
Use FILE for requirements
.TP
.B \-\-setuptools\-test
Run \fIsetup.py test\fP upon build.
.TP
.BI \-\-python\fB= PATH
Use Python interpreter at PATH
.TP
.B \-\-builtin\-venv
Use built\-in venv of Python 3
.TP
.B \-\-skip\-install
Don\(aqt run \fBpip install .\fP
.UNINDENT
.SH QUICK GUIDE FOR MAINTAINERS
.INDENT 0.0
.IP 1. 3
Build depend on \fIpython\fP or \fIpython\-all\fP and \fIdh\-virtualenv\fP
.IP 2. 3
Add \fI${python:Depends}\fP to Depends
.IP 3. 3
Add \fIpython\-virtualenv\fP to dh\(aqs \fI\-\-with\fP option
.UNINDENT
.SH SEE ALSO
.sp
Online documentation can be found at
\fI\%https://dh\-virtualenv.readthedocs.io/en/latest\fP\&.
.sp
This package should also ship with the complete documentation under
\fI/usr/share/doc/dh\-virtualenv\fP\&.
.SH AUTHOR
Jyrki Pulliainen / Spotify AB <jyrki@spotify.com>
.SH COPYRIGHT
Copyright (C) 2013, Spotify AB. Licensed under
the GNU General Public License version 2 or later
.\" Generated by docutils manpage writer.
.