134 lines
4.6 KiB
INI
134 lines
4.6 KiB
INI
# Tox (https://tox.readthedocs.io) is a tool for running tests
|
|
# in multiple virtualenvs. This configuration file will run the tornado
|
|
# test suite on all supported python versions. To use it, "pip install tox"
|
|
# and then run "tox" from this directory.
|
|
#
|
|
# This configuration requires tox 1.8 or higher.
|
|
#
|
|
# Installation tips:
|
|
# When building pycurl on my macports-based setup, I need to either set the
|
|
# environment variable ARCHFLAGS='-arch x86_64' or use
|
|
# 'port install curl +universal' to get both 32- and 64-bit versions of
|
|
# libcurl.
|
|
[tox]
|
|
envlist =
|
|
# Basic configurations: Run the tests in both minimal installations
|
|
# and with all optional dependencies.
|
|
# (pypy3 doesn't have any optional deps yet)
|
|
{py35,py36,py37,pypy3},
|
|
{py35,py36,py37}-full,
|
|
|
|
# Also run the tests with each possible replacement of a default
|
|
# component (only one 3.x version unless there are known differences).
|
|
|
|
# Alternate HTTP clients.
|
|
py3-curl,
|
|
|
|
# Alternate Resolvers.
|
|
py3-full-caresresolver,
|
|
|
|
# Other configurations; see comments below.
|
|
py3-opt,
|
|
py3-{lang_c,lang_utf8},
|
|
|
|
# Ensure the sphinx build has no errors or warnings
|
|
py3-sphinx-docs,
|
|
# Run the doctests via sphinx (which covers things not run
|
|
# in the regular test suite and vice versa)
|
|
py3-sphinx-doctest,
|
|
|
|
py3-lint
|
|
py3-mypy
|
|
|
|
[testenv]
|
|
# Most of these are defaults, but if you specify any you can't fall back
|
|
# defaults for the others.
|
|
basepython =
|
|
py35: python3.5
|
|
py36: python3.6
|
|
py37: python3.7
|
|
pypy: pypy
|
|
pypy3: pypy3
|
|
py2: python2.7
|
|
py3: python3.7
|
|
|
|
deps =
|
|
# cpython-only deps: pycurl installs but curl_httpclient doesn't work;
|
|
# twisted mostly works but is a bit flaky under pypy.
|
|
{py35,py36,py37}-full: pycurl
|
|
py3: pycurl>=7.19.3.1
|
|
# twisted is cpython only.
|
|
{py35,py36,py37}-full: twisted
|
|
py3: twisted
|
|
{py3,py35,py36,py37}-full: pycares
|
|
sphinx: sphinx
|
|
sphinx: sphinx_rtd_theme
|
|
lint: flake8
|
|
|
|
setenv =
|
|
# The extension is mandatory on cpython.
|
|
{py3,py35,py36,py37}: TORNADO_EXTENSION=1
|
|
# In python 3, opening files in text mode uses a
|
|
# system-dependent encoding by default. Run the tests with "C"
|
|
# (ascii) and "utf-8" locales to ensure we don't have hidden
|
|
# dependencies on this setting.
|
|
lang_c: LANG=C
|
|
lang_utf8: LANG=en_US.utf-8
|
|
# tox's parser chokes if all the setenv entries are conditional.
|
|
DUMMY=dummy
|
|
{py3,py35,py36,py37}-no-ext: TORNADO_EXTENSION=0
|
|
|
|
# All non-comment lines but the last must end in a backslash.
|
|
# Tox filters line-by-line based on the environment name.
|
|
commands =
|
|
python \
|
|
# py3*: -b turns on an extra warning when calling
|
|
# str(bytes), and -bb makes it an error.
|
|
-bb \
|
|
# Python's optimized mode disables the assert statement, so
|
|
# run the tests in this mode to ensure we haven't fallen into
|
|
# the trap of relying on an assertion's side effects or using
|
|
# them for things that should be runtime errors.
|
|
opt: -O \
|
|
-m tornado.test.runtests \
|
|
# Note that httpclient_test is always run with both client
|
|
# implementations; this flag controls which client all the
|
|
# other tests use.
|
|
curl: --httpclient=tornado.curl_httpclient.CurlAsyncHTTPClient \
|
|
caresresolver: --resolver=tornado.platform.caresresolver.CaresResolver \
|
|
{posargs:}
|
|
|
|
# python will import relative to the current working directory by default,
|
|
# so cd into the tox working directory to avoid picking up the working
|
|
# copy of the files (especially important for the speedups module).
|
|
changedir = {toxworkdir}
|
|
|
|
# tox 1.6 passes --pre to pip by default, which currently has problems
|
|
# installing pycurl (https://github.com/pypa/pip/issues/1405).
|
|
# Remove it (it's not a part of {opts}) to only install real releases.
|
|
install_command = pip install {opts} {packages}
|
|
|
|
[testenv:py3-sphinx-docs]
|
|
changedir = docs
|
|
# For some reason the extension fails to load in this configuration,
|
|
# but it's not really needed for docs anyway.
|
|
setenv = TORNADO_EXTENSION=0
|
|
commands =
|
|
sphinx-build -q -E -n -W -b html . {envtmpdir}/html
|
|
|
|
[testenv:py3-sphinx-doctest]
|
|
changedir = docs
|
|
setenv = TORNADO_EXTENSION=0
|
|
# No -W for doctests because that disallows tests with empty output.
|
|
commands =
|
|
sphinx-build -q -E -n -b doctest . {envtmpdir}/doctest
|
|
|
|
[testenv:py3-lint]
|
|
commands = flake8 {posargs:}
|
|
changedir = {toxinidir}
|
|
|
|
[testenv:py3-mypy]
|
|
commands = mypy {posargs:tornado}
|
|
changedir = {toxinidir}
|
|
deps = mypy
|