Pin tox to latest version 2.9.1

tox is not pinned to a specific version.

I'm pinning it to the latest version 2.9.1 for now.

These links might come in handy: PyPI | Changelog | Docs

Changelog

2.9.1

Misc ^^^^

integrated new release process and fixed changelog rendering for pypi.org - by obestwalter <https://github.com/obestwalter>_.

2.9

2.9.0

Features ^^^^^^^^

tox --version now shows information about all registered plugins - by obestwalter <https://github.com/obestwalter> (544 <https://github.com/tox-dev/tox/issues/544>)

Bugfixes ^^^^^^^^

skip_install overrides usedevelop (usedevelop is an option to choose the installation type if the package is installed and skip_install determines if it should be installed at all) - by ferdonline <https://github.com/ferdonline> (571 <https://github.com/tox-dev/tox/issues/571>)

Misc ^^^^

635 <https://github.com/tox-dev/tox/issues/635> inherit from correct exception - by obestwalter <https://github.com/obestwalter> (635 <https://github.com/tox-dev/tox/issues/635>_).

spelling and escape sequence fixes - by scoop <https://github.com/scoop> (637 <https://github.com/tox-dev/tox/issues/637> and 638 <https://github.com/tox-dev/tox/issues/638>_).

add a badge to show build status of documentation on readthedocs.io - by obestwalter <https://github.com/obestwalter>_.

Improved Documentation ^^^^^^^^^^^^^^^^^^^^^^

add towncrier <https://github.com/hawkowl/towncrier> to allow adding changelog entries with the pull requests without generating merge conflicts; with this release notes are now grouped into four distinct collections: Features, Bugfixes, Improved Documentation and Deprecations and Removals. (614 <https://github.com/tox-dev/tox/issues/614>)

2.8.2

466 <https://github.com/tox-dev/tox/issues/466>_: stop env var leakage if popen failed with resultjson or redirect

2.8.1

pull request 599 <https://github.com/tox-dev/tox/pull/599>: fix problems with implementation of 515 <https://github.com/tox-dev/tox/issues/515>. Substitutions from other sections were not made anymore if they were not in envlist. Thanks to Clark Boylan (cboylan <https://github.com/cboylan>) for helping to get this fixed (pull request 597 <https://github.com/tox-dev/tox/pull/597>).

2.8

.. Everything below here is generated by towncrier <https://pypi.python.org/pypi/towncrier>_. It is generated once as part of the release process rendering fragments from the changelog folder. If necessary, the generated text can be edited afterwards to e.g. merge rc changes into the final release notes.

.. towncrier release notes start

2.8.0

276 <https://github.com/tox-dev/tox/issues/276>_: Remove easyinstall from docs (TL;DR: use pip). Thanks Martin Andrysík (sifuraz <https://github.com/sifuraz>).

301 <https://github.com/tox-dev/tox/issues/301>: Expand nested substitutions in tox.ini. Thanks vlaci <https://github.com/vlaci>. Thanks to Eli Collins (eli-collins <https://github.com/eli-collins>_) for creating a reproducer.

315 <https://github.com/tox-dev/tox/issues/315>: add --help and --version to helptox-quickstart. Thanks vlaci <https://github.com/vlaci>.

326 <https://github.com/tox-dev/tox/issues/326>: Fix OSError 'Not a directory' when creating env on Jython 2.7.0. Thanks Nick Douma (LordGaav <https://github.com/LordGaav>).

429 <https://github.com/tox-dev/tox/issues/429>: Forward MSYSTEM by default on Windows. Thanks Marius Gedminas (mgedmin <https://github.com/mgedmin>) for reporting this.

449 <https://github.com/tox-dev/tox/issues/449>: add multi platform example to the docs. Thanks Aleks Bunin (sashkab <https://github.com/sashkab>) and rndr <https://github.com/rndr>_.

474 <https://github.com/tox-dev/tox/issues/474>_: Start using setuptools_scm for tag based versioning.

484 <https://github.com/tox-dev/tox/issues/484>: Renamed py.test to pytest throughout the project. Thanks Slam (3lnc <https://github.com/3lnc>).

504 <https://github.com/tox-dev/tox/issues/504>: With -a: do not show additional environments header if there are none. Thanks rndr <https://github.com/rndr>.

515 <https://github.com/tox-dev/tox/issues/515>: Don't require environment variables in test environments where they are not used. Thanks André Caron (AndreLouisCaron <https://github.com/AndreLouisCaron>).

517 <https://github.com/tox-dev/tox/issues/517>_: Forward NUMBER_OF_PROCESSORS by default on Windows to fix multiprocessor.cpu_count(). Thanks André Caron (AndreLouisCaron <https://github.com/AndreLouisCaron>_).

518 <https://github.com/tox-dev/tox/issues/518>: Forward USERPROFILE by default on Windows. Thanks André Caron (AndreLouisCaron <https://github.com/AndreLouisCaron>).

pull request 528 <https://github.com/tox-dev/tox/pull/528>: Fix some of the warnings displayed by pytest 3.1.0. Thanks Bruno Oliveira (nicoddemus <https://github.com/nicoddemus>).

pull request 547 <https://github.com/tox-dev/tox/pull/547>: Add regression test for 137 <https://github.com/tox-dev/tox/issues/137>. Thanks Martin Andrysík (sifuraz <https://github.com/sifuraz>_).

pull request 553 <https://github.com/tox-dev/tox/pull/553>: Add an XFAIL test to reproduce upstream bug 203 <https://github.com/tox-dev/tox/issues/203>. Thanks Bartolomé Sánchez Salado (bartsanchez <https://github.com/bartsanchez>_).

pull request 556 <https://github.com/tox-dev/tox/pull/556>: Report more meaningful errors on why virtualenv creation failed. Thanks vlaci <https://github.com/vlaci>. Also thanks to Igor Sadchenko (igor-sadchenko <https://github.com/igor-sadchenko>_) for pointing out a problem with that PR before it hit the masses ☺

pull request 575 <https://github.com/tox-dev/tox/pull/575>_: Add announcement doc to end all announcement docs (using only CHANGELOG and Github issues since 2.5 already).

pull request 580 <https://github.com/tox-dev/tox/pull/580>: Do not ignore Sphinx warnings anymore. Thanks Bernát Gábor (gaborbernat <https://github.com/gaborbernat>).

pull request 585 <https://github.com/tox-dev/tox/pull/585>: Expand documentation to explain pass through of flags from deps to pip (e.g. -rrequirements.txt, -cconstraints.txt). Thanks Alexander Loechel (loechel <https://github.com/loechel>).

pull request 588 <https://github.com/tox-dev/tox/pull/588>_: Run pytest wit xfail_strict and adapt affected tests.

2.7.0

pull request 450 <https://github.com/tox-dev/tox/pull/450>_: Stop after the first installdeps and first testenv create hooks succeed. This changes the default behaviour of tox_testenv_create and tox_testenv_install_deps to not execute other registered hooks when the first hook returns a result that is not None. Thanks Anthony Sottile (asottile <https://github.com/asottile>_).

271 <https://github.com/tox-dev/tox/issues/271> and 464 <https://github.com/tox-dev/tox/issues/464>: Improve environment information for users.

New command line parameter: -a show all defined environments - not just the ones defined in (or generated from) envlist.

New verbosity settings for -l and -a: show user defined descriptions of the environments. This also works for generated environments from factors by concatenating factor descriptions into a complete description.

Note that for backwards compatibility with scripts using the output of -l it's output remains unchanged.

Thanks Bernát Gábor (gaborbernat <https://github.com/gaborbernat>_).

464 <https://github.com/tox-dev/tox/issues/464>_: Fix incorrect egg-info location for modified packagedir in setup.py. Thanks Selim Belhaouane (selimb <https://github.com/selimb>).

431 <https://github.com/tox-dev/tox/issues/431>: Add 'LANGUAGE' to default passed environment variables. Thanks Paweł Adamczak (pawelad <https://github.com/pawelad>).

455 <https://github.com/tox-dev/tox/issues/455>: Add a Vagrantfile with a customized Arch Linux box for local testing. Thanks Oliver Bestwalter (obestwalter <https://github.com/obestwalter>).

454 <https://github.com/tox-dev/tox/issues/454>: Revert pull request 407 <https://github.com/tox-dev/tox/pull/407>, empty commands is not treated as an error. Thanks Anthony Sottile (asottile <https://github.com/asottile>_).

446 <https://github.com/tox-dev/tox/issues/446>: (infrastructure) Travis CI tests for tox now also run on OS X now. Thanks Jason R. Coombs (jaraco <https://github.com/jaraco>).

2.6.0

add "alwayscopy" config option to instruct virtualenv to always copy files instead of symlinking. Thanks Igor Duarte Cardoso (igordcard <https://github.com/igordcard>_).

pass setenv variables to setup.py during a usedevelop install. Thanks Eli Collins (eli-collins <https://github.com/eli-collins>_).

replace all references to testrun.org with readthedocs ones. Thanks Oliver Bestwalter (obestwalter <https://github.com/obestwalter>_).

fix 323 <https://github.com/tox-dev/tox/issues/323> by avoiding virtualenv14 is not used on py32 (although we don't officially support py32). Thanks Jason R. Coombs (jaraco <https://github.com/jaraco>).

add Python 3.6 to envlist and CI. Thanks Andrii Soldatenko (andriisoldatenko <https://github.com/andriisoldatenko>_).

fix glob resolution from TOX_TESTENVPASSENV env variable Thanks Allan Feldman (a-feld <https://github.com/a-feld>).

2.5.0

slightly backward incompatible: fix 310 <https://github.com/tox-dev/tox/issues/310>: the {posargs} substitution now properly preserves the tox command line positional arguments. Positional arguments with spaces are now properly handled. NOTE: if your tox invocation previously used extra quoting for positional arguments to work around 310 <https://github.com/tox-dev/tox/issues/310>, you need to remove the quoting. Example: tox -- "'some string'" has to now be written simply as tox -- "some string" thanks holger krekel. You can set minversion = 2.5.0 in the [tox] section of tox.ini to make sure people using your tox.ini use the correct version.

fix 359 <https://github.com/tox-dev/tox/issues/359>: add COMSPEC to default passenv on windows. Thanks anthrotype <https://github.com/anthrotype>.

add support for py36 and py37 and add py36-dev and py37(nightly) to travis builds of tox. Thanks John Vandenberg.

fix 348 <https://github.com/tox-dev/tox/issues/348>: add py2 and py3 as default environments pointing to "python2" and "python3" basepython executables. Also fix 347 <https://github.com/tox-dev/tox/issues/347> by updating the list of default envs in the tox basic example. Thanks Tobias McNulty.

make "-h" and "--help-ini" options work even if there is no tox.ini, thanks holger krekel.

add {:} substitution, which is replaced with os-specific path separator, thanks Lukasz Rogalski.

fix 305 <https://github.com/tox-dev/tox/issues/305>_: downloadcache test env config is now ignored as pip-8 does caching by default. Thanks holger krekel.

output from install command in verbose (-vv) mode is now printed to console instead of being redirected to file, thanks Lukasz Rogalski

fix 399 <https://github.com/tox-dev/tox/issues/399>_. Make sure {envtmpdir} is created if it doesn't exist at the start of a testenvironment run. Thanks Manuel Jacob.

fix 316 <https://github.com/tox-dev/tox/issues/316>_: Lack of commands key in ini file is now treated as an error. Reported virtualenv status is 'nothing to do' instead of 'commands succeeded', with relevant error message displayed. Thanks Lukasz Rogalski.

2.4.1

fix 380 <https://github.com/tox-dev/tox/issues/380>_: properly perform substitution again. Thanks Ian Cordasco.

2.4.0

remove PYTHONPATH from environment during the install phase because a tox-run should not have hidden dependencies and the test commands will also not see a PYTHONPATH. If this causes unforeseen problems it may be reverted in a bugfix release. Thanks Jason R. Coombs.

fix 352 <https://github.com/tox-dev/tox/issues/352>_: prevent a configuration where envdir==toxinidir and refine docs to warn people about changing "envdir". Thanks Oliver Bestwalter and holger krekel.

fix 375 <https://github.com/tox-dev/tox/issues/375>, fix 330 <https://github.com/tox-dev/tox/issues/330>: warn against tox-setup.py integration as "setup.py test" should really just test with the current interpreter. Thanks Ronny Pfannschmidt.

fix 302 <https://github.com/tox-dev/tox/issues/302>_: allow cross-testenv substitution where we substitute with {x,y} generative syntax. Thanks Andrew Pashkin.

fix 212 <https://github.com/tox-dev/tox/issues/212>_: allow escaping curly brace chars "{" and "}" if you need the chars "{" and "}" to appear in your commands or other ini values. Thanks John Vandenberg.

addresses 66 <https://github.com/tox-dev/tox/issues/66>_: add --workdir option to override where tox stores its ".tox" directory and all of the virtualenv environment. Thanks Danring.

introduce per-venv list_dependencies_command which defaults to "pip freeze" to obtain the list of installed packages. Thanks Ted Shaw, Holger Krekel.

close 66 <https://github.com/tox-dev/tox/issues/66>_: add documentation to jenkins page on how to avoid "too long shebang" lines when calling pip from tox. Note that we can not use "python -m pip install X" by default because the latter adds the CWD and pip will think X is installed if it is there. "pip install X" does not do that.

new list_dependencies_command to influence how tox determines which dependencies are installed in a testenv.

(experimental) New feature: When a search for a config file fails, tox tries loading setup.cfg with a section prefix of "tox".

fix 275 <https://github.com/tox-dev/tox/issues/275>_: Introduce hooks tox_runtest_pre``` and tox_runtest_post`` which run before and after the tests of a venv, respectively. Thanks to Matthew Schinckel and itxaka serrano.

fix 317 <https://github.com/tox-dev/tox/issues/317>_: evaluate minversion before tox config is parsed completely. Thanks Sachi King for the PR.

added the "extras" environment option to specify the extras to use when doing the sdist or develop install. Contributed by Alex Grönholm.

use pytest-catchlog instead of pytest-capturelog (latter is not maintained, uses deprecated pytest API)

2.3.2

fix 314 <https://github.com/tox-dev/tox/issues/314>_: fix command invocation with .py scripts on windows.

fix 279 <https://github.com/tox-dev/tox/issues/279>_: allow cross-section substitution when the value contains posargs. Thanks Sachi King for the PR.

2.3.1

fix 294 <https://github.com/tox-dev/tox/issues/294>_: re-allow cross-section substitution for setenv.

2.3.0

DEPRECATE use of "indexservers" in tox.ini. It complicates the internal code and it is recommended to rather use the devpi system for managing indexes for pip.

fix 285 <https://github.com/tox-dev/tox/issues/285>_: make setenv processing fully lazy to fix regressions of tox-2.2.X and so that we can now have testenv attributes like "basepython" depend on environment variables that are set in a setenv section. Thanks Nelfin for some tests and initial work on a PR.

allow "" in commands. This is slightly incompatible with commands sections that used a comment after a "\" line continuation. Thanks David Stanek for the PR.

fix 289 <https://github.com/tox-dev/tox/issues/289>_: fix build_sphinx target, thanks Barry Warsaw.

fix 252 <https://github.com/tox-dev/tox/issues/252>_: allow environment names with special characters. Thanks Julien Castets for initial PR and patience.

introduce experimental tox_testenv_create(venv, action) and tox_testenv_install_deps(venv, action) hooks to allow plugins to do additional work on creation or installing deps. These hooks are experimental mainly because of the involved "venv" and session objects whose current public API is not fully guranteed.

internal: push some optional object creation into tests because tox core doesn't need it.

2.2.1

fix bug where {envdir} substitution could not be used in setenv if that env value is then used in {basepython}. Thanks Florian Bruhin.

2.2.0

fix 265 <https://github.com/tox-dev/tox/issues/265>_ and add LD_LIBRARY_PATH to passenv on linux by default because otherwise the python interpreter might not start up in certain configurations (redhat software collections). Thanks David Riddle.

fix 246 <https://github.com/tox-dev/tox/issues/246>_: fix regression in config parsing by reordering such that {envbindir} can be used again in tox.ini. Thanks Olli Walsh.

fix 99 <https://github.com/tox-dev/tox/issues/99>_: the {env:...} substitution now properly uses environment settings from the setenv section. Thanks Itxaka Serrano.

fix 281 <https://github.com/tox-dev/tox/issues/281>_: make --force-dep work when urls are present in dependency configs. Thanks Glyph Lefkowitz for reporting.

fix 174 <https://github.com/tox-dev/tox/issues/174>_: add new ignore_outcome testenv attribute which can be set to True in which case it will produce a warning instead of an error on a failed testenv command outcome. Thanks Rebecka Gulliksson for the PR.

fix 280 <https://github.com/tox-dev/tox/issues/280>_: properly skip missing interpreter if {envsitepackagesdir} is present in commands. Thanks BB:ceridwenv

2.1.1

fix platform skipping for detox

report skipped platforms as skips in the summary

2.1.0

fix 258 <https://github.com/tox-dev/tox/issues/258>, fix 248 <https://github.com/tox-dev/tox/issues/248>, fix 253 <https://github.com/tox-dev/tox/issues/253>_: for non-test commands (installation, venv creation) we pass in the full invocation environment.

remove experimental --set-home option which was hardly used and hackily implemented (if people want home-directory isolation we should figure out a better way to do it, possibly through a plugin)

fix 259 <https://github.com/tox-dev/tox/issues/259>_: passenv is now a line-list which allows to intersperse comments. Thanks stefano-m.

allow envlist to be a multi-line list, to intersperse comments and have long envlist settings split more naturally. Thanks Andre Caron.

introduce a TOX_TESTENV_PASSENV setting which is honored when constructing the set of environment variables for test environments. Thanks Marc Abramowitz for pushing in this direction.

2.0.2

fix 247 <https://github.com/tox-dev/tox/issues/247>_: tox now passes the LANG variable from the tox invocation environment to the test environment by default.

add SYSTEMDRIVE into default passenv on windows to allow pip6 to work. Thanks Michael Krause.

2.0.1

fix wheel packaging to properly require argparse on py26.

2.0.0

(new) introduce environment variable isolation: tox now only passes the PATH and PIP_INDEX_URL variable from the tox invocation environment to the test environment and on Windows also SYSTEMROOT, PATHEXT, TEMP and TMP whereas on unix additionally TMPDIR is passed. If you need to pass through further environment variables you can use the new passenv setting, a space-separated list of environment variable names. Each name can make use of fnmatch-style glob patterns. All environment variables which exist in the tox-invocation environment will be copied to the test environment.

a new --help-ini option shows all possible testenv settings and their defaults.

(new) introduce a way to specify on which platform a testenvironment is to execute: the new per-venv "platform" setting allows to specify a regular expression which is matched against sys.platform. If platform is set and doesn't match the platform spec in the test environment the test environment is ignored, no setup or tests are attempted.

(new) add per-venv "ignore_errors" setting, which defaults to False. If True, a non-zero exit code from one command will be ignored and further commands will be executed (which was the default behavior in tox < 2.0). If False (the default), then a non-zero exit code from one command will abort execution of commands for that environment.

show and store in json the version dependency information for each venv

remove the long-deprecated "distribute" option as it has no effect these days.

fix 233 <https://github.com/tox-dev/tox/issues/233>_: avoid hanging with tox-setuptools integration example. Thanks simonb.

fix 120 <https://github.com/tox-dev/tox/issues/120>_: allow substitution for the commands section. Thanks Volodymyr Vitvitski.

fix 235 <https://github.com/tox-dev/tox/issues/235>_: fix AttributeError with --installpkg. Thanks Volodymyr Vitvitski.

tox has now somewhat pep8 clean code, thanks to Volodymyr Vitvitski.

fix 240 <https://github.com/tox-dev/tox/issues/240>_: allow to specify empty argument list without it being rewritten to ".". Thanks Daniel Hahler.

introduce experimental (not much documented yet) plugin system based on pytest's externalized "pluggy" system. See tox/hookspecs.py for the current hooks.

introduce parser.add_testenv_attribute() to register an ini-variable for testenv sections. Can be used from plugins through the tox_add_option hook.

rename internal files -- tox offers no external API except for the experimental plugin hooks, use tox internals at your own risk.

DEPRECATE distshare in documentation

1.9.2

backout ability that --force-dep substitutes name/versions in requirement files due to various issues. This fixes 228 <https://github.com/tox-dev/tox/issues/228>, fixes 230 <https://github.com/tox-dev/tox/issues/230>, fixes 231 <https://github.com/tox-dev/tox/issues/231>_ which popped up with 1.9.1.

1.9.1

use a file instead of a pipe for command output in "--result-json". Fixes some termination issues with python2.6.

allow --force-dep to override dependencies in "-r" requirements files. Thanks Sontek for the PR.

fix 227 <https://github.com/tox-dev/tox/issues/227>_: use "-m virtualenv" instead of "-mvirtualenv" to make it work with pyrun. Thanks Marc-Andre Lemburg.

1.9.0

fix 193 <https://github.com/tox-dev/tox/issues/193>_: Remove --pre from the default install_command; by default tox will now only install final releases from PyPI for unpinned dependencies. Use pip_pre = true in a testenv or the --pre command-line option to restore the previous behavior.

fix 199 <https://github.com/tox-dev/tox/issues/199>_: fill resultlog structure ahead of virtualenv creation

refine determination if we run from Jenkins, thanks Borge Lanes.

echo output to stdout when --report-json is used

fix 11 <https://github.com/tox-dev/tox/issues/11>_: add a skip_install per-testenv setting which prevents the installation of a package. Thanks Julian Krause.

fix 124 <https://github.com/tox-dev/tox/issues/124>_: ignore command exit codes; when a command has a "-" prefix, tox will ignore the exit code of that command

fix 198 <https://github.com/tox-dev/tox/issues/198>_: fix broken envlist settings, e.g. {py26,py27}{-lint,}

fix 191 <https://github.com/tox-dev/tox/issues/191>_: lessen factor-use checks

1.8.1

fix 190 <https://github.com/tox-dev/tox/issues/190>_: allow setenv to be empty.

allow escaping curly braces with "\". Thanks Marc Abramowitz for the PR.

allow "." names in environment names such that "py27-django1.7" is a valid environment name. Thanks Alex Gaynor and Alex Schepanovski.

report subprocess exit code when execution fails. Thanks Marius Gedminas.

1.8.0

new multi-dimensional configuration support. Many thanks to Alexander Schepanovski for the complete PR with docs. And to Mike Bayer and others for testing and feedback.

fix 148 <https://github.com/tox-dev/tox/issues/148>_: remove "__PYVENV_LAUNCHER__" from os.environ when starting subprocesses. Thanks Steven Myint.

fix 152 <https://github.com/tox-dev/tox/issues/152>_: set VIRTUAL_ENV when running test commands, thanks Florian Ludwig.

better report if we can't get version_info from an interpreter executable. Thanks Floris Bruynooghe.

1.7.2

fix 150 <https://github.com/tox-dev/tox/issues/150>_: parse {posargs} more like we used to do it pre 1.7.0. The 1.7.0 behaviour broke a lot of OpenStack projects. See PR85 and the issue discussions for (far) more details, hopefully resulting in a more refined behaviour in the 1.8 series. And thanks to Clark Boylan for the PR.

fix 59 <https://github.com/tox-dev/tox/issues/59>_: add a config variable skip-missing-interpreters as well as command line option --skip-missing-interpreters which won't fail the build if Python interpreters listed in tox.ini are missing. Thanks Alexandre Conrad for PR104.

fix 164 <https://github.com/tox-dev/tox/issues/164>_: better traceback info in case of failing test commands. Thanks Marc Abramowitz for PR92.

support optional env variable substitution, thanks Morgan Fainberg for PR86.

limit python hashseed to 1024 on Windows to prevent possible memory errors. Thanks March Schlaich for the PR90.

1.7.1

fix 162 <https://github.com/tox-dev/tox/issues/162>_: don't list python 2.5 as compatibiliy/supported

fix 158 <https://github.com/tox-dev/tox/issues/158> and fix 155 <https://github.com/tox-dev/tox/issues/155>: windows/virtualenv properly works now: call virtualenv through "python -m virtualenv" with the same interpreter which invoked tox. Thanks Chris Withers, Ionel Maries Cristian.

1.7.0

don't lookup "pip-script" anymore but rather just "pip" on windows as this is a pip implementation detail and changed with pip-1.5. It might mean that tox-1.7 is not able to install a different pip version into a virtualenv anymore.

drop Python2.5 compatibility because it became too hard due to the setuptools-2.0 dropping support. tox now has no support for creating python2.5 based environments anymore and all internal special-handling has been removed.

merged PR81: new option --force-dep which allows to override tox.ini specified dependencies in setuptools-style. For example "--force-dep 'django<1.6'" will make sure that any environment using "django" as a dependency will get the latest 1.5 release. Thanks Bruno Oliveria for the complete PR.

merged PR125: tox now sets "PYTHONHASHSEED" to a random value and offers a "--hashseed" option to repeat a test run with a specific seed. You can also use --hashsheed=noset to instruct tox to leave the value alone. Thanks Chris Jerdonek for all the work behind this.

fix 132 <https://github.com/tox-dev/tox/issues/132>_: removing zip_safe setting (so it defaults to false) to allow installation of tox via easy_install/eggs. Thanks Jenisys.

fix 126 <https://github.com/tox-dev/tox/issues/126>: depend on virtualenv>=1.11.2 so that we can rely (hopefully) on a pip version which supports --pre. (tox by default uses to --pre). also merged in PR84 so that we now call "virtualenv" directly instead of looking up interpreters. Thanks Ionel Maries Cristian. This also fixes 140 <https://github.com/tox-dev/tox/issues/140>.

fix 130 <https://github.com/tox-dev/tox/issues/130>_: you can now set install_command=easy_install {opts} {packages} and expect it to work for repeated tox runs (previously it only worked when always recreating). Thanks jenisys for precise reporting.

fix 129 <https://github.com/tox-dev/tox/issues/129>_: tox now uses Popen(..., universal_newlines=True) to force creation of unicode stdout/stderr streams. fixes a problem on specific platform configs when creating virtualenvs with Python3.3. Thanks Jorgen Schäfer or investigation and solution sketch.

fix 128 <https://github.com/tox-dev/tox/issues/128>_: enable full substitution in install_command, thanks for the PR to Ronald Evers

rework and simplify "commands" parsing and in particular posargs substitutions to avoid various win32/posix related quoting issues.

make sure that the --installpkg option trumps any usedevelop settings in tox.ini or

introduce --no-network to tox's own test suite to skip tests requiring networks

introduce --sitepackages to force sitepackages=True in all environments.

fix 105 <https://github.com/tox-dev/tox/issues/105>_ -- don't depend on an existing HOME directory from tox tests.

1.6.1

fix 119 <https://github.com/tox-dev/tox/issues/119>_: {envsitepackagesdir} is now correctly computed and has a better test to prevent regression.

fix 116 <https://github.com/tox-dev/tox/issues/116>_: make 1.6 introduced behaviour of changing to a per-env HOME directory during install activities dependent on "--set-home" for now. Should re-establish the old behaviour when no option is given.

fix 118 <https://github.com/tox-dev/tox/issues/118>_: correctly have two tests use realpath(). Thanks Barry Warsaw.

fix test runs on environments without a home directory (in this case we use toxinidir as the homedir)

fix 117 <https://github.com/tox-dev/tox/issues/117>_: python2.5 fix: don't use --insecure option because its very existence depends on presence of "ssl". If you want to support python2.5/pip1.3.1 based test environments you need to install ssl and/or use PIP_INSECURE=1 through setenv. section.

fix 102 <https://github.com/tox-dev/tox/issues/102>_: change to {toxinidir} when installing dependencies. this allows to use relative path like in "-rrequirements.txt".

1.6.0

fix 35 <https://github.com/tox-dev/tox/issues/35>_: add new EXPERIMENTAL "install_command" testenv-option to configure the installation command with options for dep/pkg install. Thanks Carl Meyer for the PR and docs.

fix 91 <https://github.com/tox-dev/tox/issues/91>_: python2.5 support by vendoring the virtualenv-1.9.1 script and forcing pip<1.4. Also the default [py25] environment modifies the default installer_command (new config option) to use pip without the "--pre" option which was introduced with pip-1.4 and is now required if you want to install non-stable releases. (tox defaults to install with "--pre" everywhere).

during installation of dependencies HOME is now set to a pseudo location ({envtmpdir}/pseudo-home). If an index url was specified a .pydistutils.cfg file will be written with an index_url setting so that packages defining setup_requires dependencies will not silently use your HOME-directory settings or https://pypi.python.org/pypi.

fix 1 <https://github.com/tox-dev/tox/issues/1>_: empty setup files are properly detected, thanks Anthon van der Neuth

remove toxbootstrap.py for now because it is broken.

fix 109 <https://github.com/tox-dev/tox/issues/109> and fix 111 <https://github.com/tox-dev/tox/issues/111>: multiple "-e" options are now combined (previously the last one would win). Thanks Anthon van der Neut.

add --result-json option to write out detailed per-venv information into a json report file to be used by upstream tools.

add new config options usedevelop and skipsdist as well as a command line option --develop to install the package-under-test in develop mode. thanks Monty Tailor for the PR.

always unset PYTHONDONTWRITEBYTE because newer setuptools doesn't like it

if a HOMEDIR cannot be determined, use the toxinidir.

refactor interpreter information detection to live in new tox/interpreters.py file, tests in tests/test_interpreters.py.

1.5.0

fix 104 <https://github.com/tox-dev/tox/issues/104>_: use setuptools by default, instead of distribute, now that setuptools has distribute merged.

make sure test commands are searched first in the virtualenv

re-fix 2 <https://github.com/tox-dev/tox/issues/2>_ - add whitelist_externals to be used in [testenv*] sections, allowing to avoid warnings for commands such as make, used from the commands value.

fix 97 <https://github.com/tox-dev/tox/issues/97>_ - allow substitutions to reference from other sections (thanks Krisztian Fekete)

fix 92 <https://github.com/tox-dev/tox/issues/92>_ - fix {envsitepackagesdir} to actually work again

show (test) command that is being executed, thanks Lukasz Balcerzak

re-license tox to MIT license

depend on virtualenv-1.9.1

rename README.txt to README.rst to make bitbucket happier

1.4.3

use pip-script.py instead of pip.exe on win32 to avoid the lock exe file on execution issue (thanks Philip Thiem)

introduce -l|--listenv option to list configured environments (thanks Lukasz Balcerzak)

fix downloadcache determination to work according to docs: Only make pip use a download cache if PIP_DOWNLOAD_CACHE or a downloadcache=PATH testenv setting is present. (The ENV setting takes precedence)

fix 84 <https://github.com/tox-dev/tox/issues/84>_ - pypy on windows creates a bin not a scripts venv directory (thanks Lukasz Balcerzak)

experimentally introduce --installpkg=PATH option to install a package rather than create/install an sdist package. This will still require and use tox.ini and tests from the current working dir (and not from the remote package).

substitute {envsitepackagesdir} with the package installation directory (closes 72 <https://github.com/tox-dev/tox/issues/72>_) (thanks g2p)

issue 70 <https://github.com/tox-dev/tox/issues/70>_ remove PYTHONDONTWRITEBYTECODE workaround now that virtualenv behaves properly (thanks g2p)

merged tox-quickstart command, contributed by Marc Abramowitz, which generates a default tox.ini after asking a few questions

fix 48 <https://github.com/tox-dev/tox/issues/48>_ - win32 detection of pypy and other interpreters that are on PATH (thanks Gustavo Picon)

fix grouping of index servers, it is now done by name instead of indexserver url, allowing to use it to separate dependencies into groups even if using the same default indexserver.

look for "tox.ini" files in parent dirs of current dir (closes 34 <https://github.com/tox-dev/tox/issues/34>_)

the "py" environment now by default uses the current interpreter (sys.executable) make tox' own setup.py test execute tests with it (closes 46 <https://github.com/tox-dev/tox/issues/46>_)

change tests to not rely on os.path.expanduser (closes 60 <https://github.com/tox-dev/tox/issues/60>), also make mock session return args[1:] for more precise checking (closes 61 <https://github.com/tox-dev/tox/issues/61>) thanks to Barry Warsaw for both.

1.4.2

fix some tests which fail if /tmp is a symlink to some other place

"python setup.py test" now runs tox tests via tox :) also added an example on how to do it for your project.

1.4.1

fix 41 <https://github.com/tox-dev/tox/issues/41>_ better quoting on windows - you can now use "<" and ">" in deps specifications, thanks Chris Withers for reporting

1.4

fix 26 <https://github.com/tox-dev/tox/issues/26>_ - no warnings on absolute or relative specified paths for commands

fix 33 <https://github.com/tox-dev/tox/issues/33>_ - commentchars are ignored in key-value settings allowing for specifying commands like: python -c "import sys ; print sys" which would formerly raise irritating errors because the ";" was considered a comment

tweak and improve reporting

refactor reporting and virtualenv manipulation to be more accessible from 3rd party tools

support value substitution from other sections with the {[section]key} syntax

fix 29 <https://github.com/tox-dev/tox/issues/29>_ - correctly point to pytest explanation for importing modules fully qualified

fix 32 <https://github.com/tox-dev/tox/issues/32>_ - use --system-site-packages and don't pass --no-site-packages

add python3.3 to the default env list, so early adopters can test

drop python2.4 support (you can still have your tests run on

fix the links/checkout howtos in the docs python-2.4, just tox itself requires 2.5 or higher.

1.3

fix: allow to specify wildcard filesystem paths when specifying dependencies such that tox searches for the highest version

fix issue 21 <https://github.com/tox-dev/tox/issues/21>_: clear PIP_REQUIRES_VIRTUALENV which avoids pip installing to the wrong environment, thanks to bb's streeter

make the install step honour a testenv's setenv setting (thanks Ralf Schmitt)

1.2

remove the virtualenv.py that was distributed with tox and depend on >=virtualenv-1.6.4 (possible now since the latter fixes a few bugs that the inlining tried to work around)

fix 10 <https://github.com/tox-dev/tox/issues/10>_: work around UnicodeDecodeError when invoking pip (thanks Marc Abramowitz)

fix a problem with parsing {posargs} in tox commands (spotted by goodwill)

fix the warning check for commands to be installed in testenvironment (thanks Michael Foord for reporting)

1.1

fix 5 <https://github.com/tox-dev/tox/issues/5>_ - don't require argparse for python versions that have it

fix 6 <https://github.com/tox-dev/tox/issues/6>_ - recreate virtualenv if installing dependencies failed

fix 3 <https://github.com/tox-dev/tox/issues/3>_ - fix example on frontpage

fix 2 <https://github.com/tox-dev/tox/issues/2>_ - warn if a test command does not come from the test environment

fixed/enhanced: except for initial install always call "-U --no-deps" for installing the sdist package to ensure that a package gets upgraded even if its version number did not change. (reported on TIP mailing list and IRC)

inline virtualenv.py (1.6.1) script to avoid a number of issues, particularly failing to install python3 environments from a python2 virtualenv installation.

rework and enhance docs for display on readthedocs.org

1.0

move repository and toxbootstrap links to https://bitbucket.org/hpk42/tox

fix 7 <https://github.com/tox-dev/tox/issues/7>_: introduce a "minversion" directive such that tox bails out if it does not have the correct version.

fix 24 <https://github.com/tox-dev/tox/issues/24>_: introduce a way to set environment variables for for test commands (thanks Chris Rose)

fix 22 <https://github.com/tox-dev/tox/issues/22>_: require virtualenv-1.6.1, obsoleting virtualenv5 (thanks Jannis Leidel) and making things work with pypy-1.5 and python3 more seamlessly

toxbootstrap.py (used by jenkins build slaves) now follows the latest release of virtualenv

fix 20 <https://github.com/tox-dev/tox/issues/20>_: document format of URLs for specifying dependencies

fix 19 <https://github.com/tox-dev/tox/issues/19>_: substitute Hudson for Jenkins everywhere following the renaming of the project. NOTE: if you used the special [tox:hudson] section it will now need to be named [tox:jenkins].

fix issue 23 / apply some ReST fixes

change the positional argument specifier to use {posargs:} syntax and fix issues 15 <https://github.com/tox-dev/tox/issues/15> and 10 <https://github.com/tox-dev/tox/issues/10> by refining the argument parsing method (Chris Rose)

remove use of inipkg lazy importing logic - the namespace/imports are anyway very small with tox.

fix a fspath related assertion to work with debian installs which uses symlinks

show path of the underlying virtualenv invocation and bootstrap virtualenv.py into a working subdir

added a CONTRIBUTORS file

0.9

fix pip-installation mixups by always unsetting PIP_RESPECT_VIRTUALENV (thanks Armin Ronacher)

1 <https://github.com/tox-dev/tox/issues/1>_: Add a toxbootstrap.py script for tox, thanks to Sridhar Ratnakumar

added support for working with different and multiple PyPI indexservers.

new option: -r|--recreate to force recreation of virtualenv

depend on py>=1.4.0 which does not contain or install the py.test anymore which is now a separate distribution "pytest".

show logfile content if there is an error (makes CI output more readable)

0.8

work around a virtualenv limitation which crashes if PYTHONDONTWRITEBYTECODE is set.

run pip/easy installs from the environment log directory, avoids naming clashes between env names and dependencies (thanks ronny)

require a more recent version of py lib

refactor and refine config detection to work from a single file and to detect the case where a python installation overwrote an old one and resulted in a new executable. This invalidates the existing virtualenvironment now.

change all internal source to strip trailing whitespaces

0.7

use virtualenv5 (my own fork of virtualenv3) for now to create python3 environments, fixes a couple of issues and makes tox more likely to work with Python3 (on non-windows environments)

add sitepackages option for testenv sections so that environments can be created with access to globals (default is not to have access, i.e. create environments with --no-site-packages.

addressing 4 <https://github.com/tox-dev/tox/issues/4>_: always prepend venv-path to PATH variable when calling subprocesses

fix 2 <https://github.com/tox-dev/tox/issues/2>_: exit with proper non-zero return code if there were errors or test failures.

added unittest2 examples contributed by Michael Foord

only allow 'True' or 'False' for boolean config values (lowercase / uppercase is irrelevant)

recreate virtualenv on changed configurations

0.6

fix OSX related bugs that could cause the caller's environment to get screwed (sorry). tox was using the same file as virtualenv for tracking the Python executable dependency and there also was confusion wrt links. this should be fixed now.

fix long description, thanks Michael Foord

0.5

initial release

================== How to release tox

This matches the current model that can be summarized as this:

tox has no long lived branches.

Pull requests get integrated into master by members of the project when they feel confident that this could be part of the next release. Small fix ups might be done right after merge instead of disscussing back and forth to get minor problems fixed, to keep the workflow simple.

Normal releases: done from master when enough changes have accumaluted (whatever that means at any given point in time).

"Special" releases: (in seldom cases when master has moved on and is not in a state where a quick release should be done from that state): the current release tag is checked out, the necessary fixes are cherry picked and a package with a patch release increase is built from that state. This is not very clean but seems good enough at the moment as it does not happen very often. If it does happen more often, this needs some rethinking (and rather into the direction of making less buggy releases than complicating release development/release process).

HOWTO

Prerequisites

Push rights for https://github.com/tox-dev/tox

Release rights for https://pypi.org/project/tox/

[optional] An account on https://devpi.net to upload the package under test

A system with either tox + bash <https://www.gnu.org/software/bash/> or vagrant <https://github.com/tox-dev/tox/blob/master/Vagrantfile> (which contains tox + bash)

Accountability: if you cut a release that breaks the CI builds of projects using tox, you are expected to fix this within a reasonable time frame (hours/days - not weeks/months) - if you don't feel quite capable of doing this yet, partner up with a more experienced member of the team and make sure they got your back if things break.

pypi/devpi configuration

note: this is in a state of flux due to changes in pypi infrastructure and depending whether devpi push can be used or not. Please keep this updated according to current process

Current process pypi upload packages from dist/ via twine.

If you want to use the scripts in task/ you need a .pypirc with a correctly configured pypi section (see below). Otherwise just upload the release package which ever way you see fit.

[pypi] section in .pypirc should look somehow like this:

.. code-block:: ini

[pypi] ;repository=https://pypi.python.org/pypi ;repository=https://upload.pypi.io/legacy/ username=<your username> password=<your password>

to get info about the workflow invoke::

tox -e tpra

and you get a help message like::

workflow: /home/oliver/work/tox/tox/tasks/pra.sh <command> [arg] prep <version> upload <devpi username> devpi-cloud-test <devpi username> (optional) release

... and go from there.

The script executes the necessary actions and asks for confirmation to go on before committing or tagging stuff. So there is no danger to dry run the process, as long as you don't call the final release command with packages in your dist/* - if you managed to screw things up entirely there is always git reset --hard HEAD at your service.

note: **prais short for "personal release assistant" :) - if you want to see what this involves or rather do everything by hand, please read the scripts intasks <https://github.com/tox-dev/tox/tree/master/tasks>`_.

Get started with devpi cloud test

Configure a repository as per-instructions on devpi-cloud-test to test the package on Travis and AppVeyor_. All test environments should pass.

If you don't want or can't do the cloud test step ...

Run from multiple machines::

devpi use https://devpi.net/<your devpi user name>/dev devpi test tox==<VERSION>

Check that tests pass for relevant combinations with::

devpi list tox

.. _devpi-cloud-test: https://github.com/obestwalter/devpi-cloud-test .. _AppVeyor: https://www.appveyor.com/ .. _Travis: https://travis-ci.org

Got merge conflicts? Close this PR and delete the branch. I'll create a new PR for you.

Happy merging! 🤖

meejah / txtorcon

Pin tox to latest version 2.9.1 #262

Changelog

2.9.1

2.9

2.9.0

2.8.2

2.8.1

2.8

2.8.0

2.7.0

2.6.0

2.5.0

2.4.1

2.4.0

2.3.2

2.3.1

2.3.0

2.2.1

2.2.0

2.1.1

2.1.0

2.0.2

2.0.1

2.0.0

1.9.2

1.9.1

1.9.0

1.8.1

1.8.0

1.7.2

1.7.1

1.7.0

1.6.1

1.6.0

1.5.0

1.4.3

1.4.2

1.4.1

1.4

1.3

1.2

1.1

1.0

0.9

0.8

0.7

0.6

0.5

================== How to release tox

HOWTO

Prerequisites

pypi/devpi configuration

Get started with devpi cloud test

If you don't want or can't do the cloud test step ...

Codecov Report