Metadata-Version: 2.1
Name: tox-DEBIAN
Version: 0.3
Summary: debian package installer tox plugin
Home-page: UNKNOWN
License: MIT license
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Framework :: tox
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Testing
Requires-Python: ~=3.5
Description-Content-Type: text/markdown
Requires-Dist: tox (<4.0,>=3.0)

# tox_DEBIAN

[![Build Status](https://travis-ci.com/tpazderka/tox-debian-plugin.svg)](https://travis-ci.com/tpazderka/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 tox_DEBIAN
```

## Test

### Local `tox_DEBIAN` install

```sh
git clone https://github.com/tpazderka/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
```


