Tox

-------------------

- 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.

-------------------

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

-------------------

- 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)

-------------------

- 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.

-------------------

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

-------------------

- 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 guaranteed.

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