A docker image for running Python test suite in multiple Python versions (2.6 - 3.5, pypy) using tox without actually installing tox and all Python versions.
| OS Version | Python Versions | Travis CI | Docker Hub |
|---|---|---|---|
| Ubuntu Trusty | Python 2.6-3.5, pypy |  |
  |
No need to install tox or Python, just run:
docker pull realcundo/dtox
docker run --rm -it -v $PWD:/src:ro realcundo/dtoxThis will read tox.ini from the local directory ($PWD) and run tox inside the container.
Handy alias to run dtox as a drop-in replacement of tox:
alias dtox='docker run --rm -it -v "$PWD":/src:ro realcundo/dtox "$PWD"'Two forms are available:
docker run --rm -it -v $PWD:/src:ro realcundo/dtoxdocker run --rm -it -v $PWD:/src:ro realcundo/dtox <$WORK_DIR> [<tox-arg1>] [<tox-arg2>] [...]The fomer simply runs tox inside /code directory.
To specify different directory and/or pass in parameters, second form must be used. The first argument is always interpreted as a working directory.
Tox is run as a normal user (testuser) and not as root.
docker run --rm -it -v $PWD:/src:ro realcundo/dtoxThis will copy contents of current directory to /code and run tox.
docker run --rm -it -v $PWD:/src:ro realcundo/dtox $PWDor if you have the alias, simply:
dtoxThis will create $PWD path inside the container and run tox. Useful if tests depend on specific path/location or when exception stacktrace file names and paths matter.
docker run --rm -it -v $PWD:/src:ro realcundo/dtox /code --helpor:
dtox --helpThis will create use /code or $PWD path inside the container and pass --help argument to tox. You can of course pass in any parameter, not just --help.
- ability to fetch data/artifacts from the container (probably by mapping
/code) - images based on other OSes (currently only Ubuntu Trusty)
- preserving
pip/toxcaches between runs to speed up test runs
- source code: https://github.com/realcundo/dtox
- docker hub: https://hub.docker.com/r/realcundo/dtox