DH-VIRTUALENV(1)

📦
version 1.2.2 · 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 dh-virtualenv(1) 💖

okay bestie, sit DOWN, because we're about to talk about the most iconic little debhelper addon in the game — this is dh-virtualenv, straight out of the DebHelper manual, section 1. 🎀

✨ NAME ✨

dh-virtualenv — deploy a Python package in a self-contained virtualenv 🦋

🌸 SYNOPSIS 🌸

dh_virtualenv [OPTIONS]

💅 DESCRIPTION 💅

So like, dh-virtualenv is a tool that's literally trying to do the mashup of the century: Debian packaging meets self-contained virtualenv based Python deployments. 🫶

The way it pulls this off? It extends debhelper's sequence by adding a brand new command into the sequence, dh_virtualenv, and that command effectively replaces these commands from the sequence:

  • dh_auto_install
  • dh_python2
  • dh_pycentral
  • dh_pysupport

And in the sequence, dh_virtualenv gets inserted right after dh_perl. periodt. 👑

⭐ OPTIONS ⭐

  • -p PACKAGE, --package=PACKAGE — act on the package named PACKAGE
  • -N PACKAGE, --no-package=PACKAGE — do not act on the specified PACKAGE
  • -v, --verbose — turn on verbose mode, bestie
  • --extra-index-url — pass extra index URL to pip
  • --preinstall=PACKAGE — preinstall a PACKAGE before running pip
  • --pip-tool=PIP_TOOL — tool used to install requirements
  • --extra-pip-arg — extra arg for the pip executable
  • --extra-virtualenv-arg — extra arg for the virtualenv executable
  • --index-url — base URL for PyPI server
  • --setuptools — use setuptools instead of distribute
  • --install-suffix=SUFFIX — override virtualenv installation suffix
  • --upgrade-pip — force upgrade pip in virtualenv
  • --requirements=FILE — use FILE for requirements
  • --setuptools-test — run setup.py test upon build
  • --python=PATH — use Python interpreter at PATH
  • --builtin-venv — use built-in venv of Python 3
  • --skip-install — don't run pip install .

🧚 QUICK GUIDE FOR MAINTAINERS 🧚

okay this part is for the maintainers, but I got you, it's short and sweet:

  1. Build depend on python or python-all and dh-virtualenv
  2. Add ${python:Depends} to Depends
  3. Add python-virtualenv to dh's --with option

🌈 SEE ALSO 🌈

Online documentation can be found at https://dh-virtualenv.readthedocs.io/en/latest. 📚

This package should also ship with the complete documentation under /usr/share/doc/dh-virtualenv.

💜 AUTHOR 💜

Jyrki Pulliainen / Spotify AB <jyrki@spotify.com>

Copyright (C) 2013, Spotify AB. Licensed under the GNU General Public License version 2 or later.

ngl, that's a whole lot of license energy but it's important, bestie. 💖

and that's the whole page, fr fr — this was DH-VIRTUALENV(1) from the DebHelper manual, page 1, and honestly? iconic. slay. go build something. 👑✨🎀🦋

📦 where this page comes from