# tox-debian-plugin

**Repository Path**: mirrors_balabit/tox-debian-plugin

## Basic Information

- **Project Name**: tox-debian-plugin
- **Description**: tox plugin to install debian package
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tox_DEBIAN

[![Build Status](https://travis-ci.org/balabit/tox-debian-plugin.svg)](https://travis-ci.org/balabit/tox-debian-plugin)

`tox_DEBIAN.py` is a [tox][tox] plugin which extracts [Debian][deb] packages
into the tox managed virtual environment.

  [tox]: https://testrun.org/tox/latest/
  [deb]: http://www.debian.org/

## Dependency

### Hook dependency

The plugin implements the `tox_testenv_install_deps` [pluggy][pluggy] hook,

  [pluggy]: https://pypi.python.org/pypi/pluggy

### External dependency

The plugin uses the `apt-get`, `dpkg` and `cp` tools.

### Test dependency

`tox_DEBIAN`, like `tox`, uses [py.test][pt] for test automatization.

  [pt]: http://pytest.org/latest/

## Syntax

The debian dependencies has to be listed in the `testenv` section
as `debian_deps` multi line option.

```ini
[testenv]
debian_deps =
  python3-ipaddr
  python3-yaml
```

Extra options can be defined for `apt-get` with the `apt_opts` option:

```ini
[testenv]
apt_opts=
  --allow-unauthenticated
debian_deps =
  python3-ipaddr
  python3-yaml
```

## Install

### Install tox

```sh
pip install tox
```

`tox` uses `RequirementParseError` from `pkg_resources`, therefore `setuptools`
might need to be upgraded:

```sh
pip install --upgrade setuptools
```

### Install `tox_DEBIAN`

```sh
pip install git+https://github.com/balabit/tox-debian-plugin.git
```

## Test

### Local `tox_DEBIAN` install

```sh
git clone https://github.com/balabit/tox-debian-plugin.git
pip install -e tox-debian-plugin
```

### Install `py.test`

```sh
pip install pytest
```

### Test run

```
cd tox-debian-plugin
py.test tests
```