tox.ini

[tox]
min_version = 4.0
requires =
    setuptools >= 30.3.0
    pip >= 21.0.1
    tox-pypi-filter >= 0.14
envlist =
    py{311,312,313,314}
    py314-devdeps
    py311-oldestdeps
    codestyle
    build_docs{,-notebooks}
    py314-{benchmarks,figure}
    py314-figure-devdeps

[testenv]
pypi_filter = https://raw.githubusercontent.com/sunpy/sunpy/main/.test_package_pins.txt
allowlist_externals=
    /bin/sh
# Run the tests in a temporary directory to make sure that we don't import
# the package from the source tree
change_dir = .tmp/{envname}
description =
    run tests
    oldestdeps: with the oldest supported version of key dependencies
    devdeps: with the latest developer version of key dependencies
pass_env =
    # A variable to tell tests we are on a CI system
    CI
    # Custom compiler locations (such as ccache)
    CC
    # Location of locales (needed by sphinx on some systems)
    LOCALE_ARCHIVE
    # If the user has set a LC override we should follow it
    LC_ALL
set_env =
    COVERAGE_FILE={toxinidir}/.coverage
    MPLBACKEND = agg
    COLUMNS = 180
    devdeps: PIP_EXTRA_INDEX_URL = https://pypi.anaconda.org/astropy/simple https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
    COVERAGE_FILE={toxinidir}/.coverage
deps =
    # For packages which publish nightly wheels this will pull the latest nightly
    devdeps: astropy>=0.0.dev0
    devdeps: numpy>=0.0.dev0
    devdeps: scipy>=0.0.dev0
    devdeps: matplotlib>=0.0.dev0
    devdeps: sunpy>=0.0.dev0
    devdeps: git+https://github.com/sunpy/ndcube
    devdeps: git+https://github.com/spacetelescope/gwcs
    devdeps: git+https://github.com/asdf-format/asdf
    devdeps: git+https://github.com/astropy/asdf-astropy
    devdeps: git+https://github.com/sunpy/mpl-animators
	devdeps: git+https://github.com/globus/globus-sdk-python
    # Autogenerate oldest dependencies from info in setup.cfg
    oldestdeps: minimum_dependencies
    figure-!devdeps: matplotlib==3.10.8
    figure-!devdeps: mpl-animators==1.2.4
    figure-!devdeps: astropy==7.2.0
    figure-!devdeps: ndcube==2.4.0
# The following indicates which extras_require will be installed
extras =
    tests
commands_pre =
    oldestdeps: minimum_dependencies dkist --filename requirements-min.txt
    # We need to pin down the pyparsing transitive dependency because of matplotlib
    oldestdeps: pip install -r requirements-min.txt pyparsing<3.3
    pip freeze --all --no-input
commands =
    figure: /bin/sh -c "mkdir -p ./figure_test_images; python -c 'import matplotlib as mpl; print(mpl.ft2font.__file__, mpl.ft2font.__freetype_version__, mpl.ft2font.__freetype_build_type__)' > ./figure_test_images/figure_version_info.txt"
    figure: /bin/sh -c "pip freeze >> ./figure_test_images/figure_version_info.txt"
    figure: /bin/sh -c "cat ./figure_test_images/figure_version_info.txt"
    figure: python -c "import dkist.tests.helpers as h; print(h.get_hash_library_name())"
    # To amend the pytest command for different factors you can add a line
    # which starts with a factor like `online: --remote-data=any \`
    # If you have no factors which require different commands this is all you need:
    pytest \
    -vvv \
    -r fEs \
    --pyargs dkist \
    --cov-report=xml \
    --cov=dkist \
    --cov-config={toxinidir}/.coveragerc \
    {toxinidir}/docs \
    online: --remote-data=any \
    !benchmarks: --benchmark-skip \
    benchmarks: -m benchmark \
    benchmarks: --benchmark-autosave \
    figure: -m "mpl_image_compare" \
    figure: --mpl \
    figure: --remote-data=any \
    figure: --mpl-generate-summary=html \
    figure: --mpl-baseline-path=https://raw.githubusercontent.com/DKISTDC/dkist-figure-tests/main/figures/{envname}/ \
    oldestdeps: -o asdf_schema_tests_enabled=false \
    {posargs}

[testenv:codestyle]
pypi_filter =
skip_install = true
description = Run all style and file checks with pre-commit
deps =
    pre-commit
commands =
    pre-commit install-hooks
    pre-commit run --color always --all-files --show-diff-on-failure

[testenv:build_docs{,-notebooks}]
description = invoke sphinx-build to build the HTML docs
change_dir =
    docs
extras =
    docs
commands =
    pip freeze --all --no-input
    sphinx-build \
    # Disable parallel here due to https://github.com/astropy/astropy/issues/14916
    -j 1 \
    --color \
    -W \
    --keep-going \
    -b html \
    -d _build/.doctrees \
    . \
    _build/html \
    !notebooks: -D nb_execution_mode=off \
    {posargs}
    python -c 'import pathlib; print("Documentation available under file://\{0\}".format(pathlib.Path(r"{toxinidir}") / "docs" / "_build" / "html" / "index.html"))'

[testenv:mypy]
description = Run the mypy static type checker
deps = mypy
commands = mypy {toxinidir}/dkist {posargs}

[testenv:dkist-inventory]
description = Run the dkist-inventory tests against this version of dkist
base_python = py313  # dkist-inventory is fussy about python version
extras = # we don't need dkist test extras
allowlist_externals = git, rm, bash
commands_pre =
    bash -c 'rm -rf dkist-inventory || true'
    git clone https://bitbucket.org/dkistdc/dkist-inventory.git
    python -m pip install "./dkist-inventory[test]" {toxinidir}
    pip freeze --all --no-input
commands =
    python -m pytest dkist-inventory {posargs}

[testenv:dkist-processing-common]
description = Run the dkist-processing-common tests against this version of dkist (requires running rabbitmq and redis servers)
base_python = py313  # dkist-inventory is fussy about python version
extras = # we don't need dkist test extras
allowlist_externals = git, rm, bash
commands_pre =
    bash -c 'rm -rf dkist-processing-common || true'
    git clone https://bitbucket.org/dkistdc/dkist-processing-common.git
    python -m pip install "./dkist-processing-common[test,asdf]" {toxinidir}
    pip freeze --all --no-input
commands =
    python -m pytest dkist-processing-common -m "not development" {posargs}