tox.ini

[tox]
skipsdist = true
envlist = py{37,38,39,310}, flake8, dist, manifest, docs, binder

[gh-actions]
python =
    3.7: py37
    3.8: py38, dist
    3.9: py39
    3.10: py310

# Linters
[testenv:flake8]
skip_install = true
deps = flake8
commands = flake8 papermill --count --show-source --statistics

# Manifest
[testenv:manifest]
skip_install = true
deps = check-manifest
commands = check-manifest
ignore =
    .readthedocs.yaml

# Docs
[testenv:docs]
description = invoke sphinx-build to build the HTML docs
deps =
    .[dev]
    .[azure]
    -r docs/requirements.txt
extras = docs
commands =
    sphinx-build -d "{toxworkdir}/docs_doctree" docs "{toxworkdir}/docs_out" --color -W -bhtml {posargs}
    python -c 'import pathlib; print("documentation available under file://\{0\}".format(pathlib.Path(r"{toxworkdir}") / "docs_out" / "index.html"))'

# Binder
[testenv:binder]
description = ensure /binder/*ipynb are runnable
deps =
    -r binder/requirements.txt
commands = python -c "import glob; import papermill as pm; [pm.execute_notebook(input, '{toxworkdir}/out.ipynb', parameters=\{'binder_dir':'binder'\}) for input in glob.glob('binder/**/*.ipynb')]"

# Distro
[testenv:dist]
skip_install = true
# Have to use /bin/bash or the `*` will cause that argument to get quoted by the tox command line...
commands =
    python setup.py sdist --dist-dir={distdir} bdist_wheel --dist-dir={distdir}
    /bin/bash -c 'python -m pip install -U --force-reinstall {distdir}/papermill*.whl'
    /bin/bash -c 'python -m pip install -U --force-reinstall --no-deps {distdir}/papermill*.tar.gz'

# Black
[testenv:black]
description = apply black linter with desired rules
basepython = python3.8
deps =
    black
commands = black -S -l 100 .

[testenv]
# disable Python's hash randomization for tests that stringify dicts, etc
setenv =
    PYTHONHASHSEED = 0
    AWS_ACCESS_KEY_ID=foobar_key
    AWS_SECRET_ACCESS_KEY=foobar_secret
passenv = *
basepython =
    py37: python3.7
    py38: python3.8
    py39: python3.9
    py310: python3.10
    flake8: python3.8
    manifest: python3.8
    dist: python3.8
    docs: python3.8
    binder: python3.8
    black: python3.8
deps = .[dev]
commands = pytest -v --maxfail=2 --cov=papermill -W always {posargs}