[tox]

envlist =

test{,-oldestdeps,-olddeps,-devdeps}

build_docs

linkcheck

codestyle

requires =

setuptools >= 30.3.0

pip >= 19.3.1

isolated_build = true

[testenv]

# Pass through the following environemnt variables which may be needed for the CI

passenv = HOME,WINDIR,LC_ALL,LC_CTYPE,CC,CI

setenv =

devdeps: PIP_EXTRA_INDEX_URL = https://pypi.anaconda.org/scientific-python-nightly-wheels/simple

# Run the tests in a temporary directory to make sure that we don't import

# pyerfa from the source tree

changedir = .tmp/{envname}

# tox environments are constructued with so-called 'factors' (or terms)

# separated by hyphens, e.g. test-devdeps-cov. Lines below starting with factor:

# will only take effect if that factor is included in the environment name. To

# see a list of example environments that can be run, along with a description,

# run:

#

# tox -l -v

#

description =

run tests

devdeps: with the latest developer version of key dependencies

olddeps: with medium old versions of key dependencies

oldestdeps: with the oldest supported version of key dependencies

# The following provides some specific pinnings for key packages

deps =

oldestdeps: numpy==1.19.* # astropy LTS

olddeps: numpy==1.20.* # something potentially problematic (see gh-101)

devdeps: numpy>=0.0.dev0

# The following indicates which extras_require from setup.cfg will be installed

extras =

test

install_command =

!devdeps: python -I -m pip install

devdeps: python -I -m pip install -v --pre

commands =

pip freeze

python -c 'import erfa' # To give useful error message if liberfa is too old.

pytest --pyargs erfa {toxinidir}/docs {posargs}

[testenv:build_docs]

changedir = docs

description = invoke sphinx-build to build the HTML docs

extras = docs

commands =

pip freeze

sphinx-build -W -b html . _build/html

[testenv:linkcheck]

changedir = docs

description = check the links in the HTML docs

extras = docs

commands =

pip freeze

sphinx-build -W -b linkcheck . _build/html

[testenv:codestyle]

# We list the warnings/errors to check for here rather than in setup.cfg because

# we don't want these options to apply whenever anyone calls flake8 from the

# command-line or their code editor - in this case all warnings/errors should be

# checked for. The warnings/errors we check for here are:

# E101 - mix of tabs and spaces

# W191 - use of tabs

# W291 - trailing whitespace

# W292 - no newline at end of file

# W293 - trailing whitespace

# W391 - blank line at end of file

# E111 - 4 spaces per indentation level

# E112 - 4 spaces per indentation level

# E113 - 4 spaces per indentation level

# E301 - expected 1 blank line, found 0

# E302 - expected 2 blank lines, found 0

# E303 - too many blank lines (3)

# E304 - blank lines found after function decorator

# E305 - expected 2 blank lines after class or function definition

# E306 - expected 1 blank line before a nested definition

# E502 - the backslash is redundant between brackets

# E722 - do not use bare except

# E901 - SyntaxError or IndentationError

# E902 - IOError

# E999: SyntaxError -- failed to compile a file into an Abstract Syntax Tree

# F822: undefined name in __all__

# F823: local variable name referenced before assignment

skip_install = true

description = check code style, e.g. with flake8

deps = flake8

changedir = {toxinidir}

commands = flake8 erfa --count --select=E101,W191,W291,W292,W293,W391,E111,E112,E113,E30,E502,E722,E901,E902,E999,F822,F823