tox.ini

[tox]
envlist = py,coverage-report,typing,lint,docs,docs-linkcheck
isolated_build = True

[testenv]
description = Run pytest against {envname}.
deps =
    holdup < 3
extras =
    dev
    aiohttp
    httpx
    pydantic
    aiokafka
allowlist_externals =
    docker
setenv =
    KAFKA_BROKER_URL=localhost:9092
    SCHEMA_REGISTRY_URL=http://localhost:8081
commands =
    docker compose up -d
    holdup -t 60 -T 5 -i 1 -n http://localhost:8081/subjects
    coverage run -m pytest {posargs}
    docker compose down

[testenv:coverage-report]
description = Compile coverage from each test run.
skip_install = true
deps = coverage[toml]>=5.0.2
depends =
    py
commands =
    coverage combine
    coverage report

[testenv:typing]
description = Run mypy.
commands =
    mypy src/kafkit tests

[testenv:lint]
description = Lint codebase by running pre-commit (Black, isort, Flake8).
skip_install = true
deps = pre-commit
commands = pre-commit run --all-files

[testenv:docs]
description = Build documentation (HTML) with Sphinx.
commands =
    sphinx-build --keep-going -n -W -T -b html -d {envtmpdir}/doctrees docs docs/_build/html

[testenv:docs-linkcheck]
description = Check links in the documentation.
commands =
    sphinx-build --keep-going -n -W -T -b linkcheck -d {envtmpdir}/doctrees docs docs/_build/linkcheck