tox.ini

###############################################################################
# 📦  tox.ini - multi-interpreter test matrix powered by uv                   #
###############################################################################
#
#  ➡  Why tox-uv?
#      - one-shot lock-file-free dependency resolution (⚡ fast)
#      - identical logic on macOS / Linux / Windows
#      - ultra-small virtualenvs under ~/.cache/uv/venv
#
#  ➡  Quickstart
#      uv pip install tox tox-uv                     # install once
#      tox -p auto                                   # run whole matrix
#
#  ➡  Environments
#      py311 / py312 / py313            →  doctest + unit tests (pytest)
#
###############################################################################

#############################
# Core tox configuration
#############################
[tox]
requires = tox>=4, tox-uv    # 🔗 plugin discovery happens through this
envlist  = py311, py312, py313
skip_missing_interpreters = true     # dev machines that miss 3.13-dev

# uv configuration for Python installation
uv_python_preference = only-managed  # Only use uv-managed Python versions

#########################################
# GitHub-Actions / Azure DevOps mapping
#########################################
[gh-actions]
python =
    3.11: py311
    3.12: py312
    3.13: py313

#####################################################################
# 🔬 Default test environment                                         #
# Every pyXY uses the same definition; only the interpreter differs. #
#####################################################################
[testenv]                       #  <-- inherited by py311 / py312 / py313
runner       = uv-venv-runner   #  tox-uv: create venv via 'uv venv'
package      = uv-editable      #  install our package *editable* with 'uv pip'
extras       = dev              #  pulls in pytest, coverage, ruff, ...
description  = Run doctest and unit tests with {basepython}
commands     =
    python -m pytest --doctest-modules mcpgateway/ --tb=short -q
    python -m pytest --maxfail=0 --disable-warnings -v --ignore=tests/fuzz --ignore=tests/playwright

# Python 3.13 specific environment - exclude packages that don't support 3.13 yet
[testenv:py313]
runner       = uv-venv-runner
package      = skip
deps =
    # Install the package manually without dev extras
    -e .
    # Install core dependencies without problematic packages
    aiohttp>=3.12.15
    alembic>=1.16.5
    argon2-cffi>=25.1.0
    copier>=9.10.1
    cryptography>=45.0.7
    fastapi>=0.116.1
    filelock>=3.19.1
    gunicorn>=23.0.0
    httpx>=0.28.1
    httpx[http2]>=0.28.1
    jinja2>=3.1.6
    jq>=1.10.0
    jsonpath-ng>=1.7.0
    jsonschema>=4.25.1
    mcp>=1.13.1
    oauthlib>=3.3.1
    parse>=1.20.2
    psutil>=7.0.0
    pydantic>=2.11.7
    pydantic[email]>=2.11.7
    pydantic-settings>=2.10.1
    pyjwt>=2.10.1
    python-json-logger>=3.3.0
    PyYAML>=6.0.2
    requests-oauthlib>=2.0.0
    sqlalchemy>=2.0.43
    sse-starlette>=3.0.2
    starlette>=0.47.3
    typer>=0.17.4
    uvicorn>=0.35.0
    zeroconf>=0.147.2
    # Test dependencies
    pytest>=8.4.2
    pytest-asyncio>=1.1.0
    pytest-cov>=6.2.1
    pytest-env>=1.1.5
    coverage>=7.10.6
    chuk-mcp-runtime>=0.6.5
    # Skip pytype, libcst and other packages that don't support Python 3.13 yet
description  = Run doctest and unit tests with Python 3.13 (excluding unsupported packages)
commands     =
    python -m pytest --doctest-modules mcpgateway/ --tb=short -q
    python -m pytest --maxfail=0 --disable-warnings -v --ignore=tests/fuzz --ignore=tests/playwright

passenv =
    DATABASE_URL
    MCPGATEWAY_*           # <-- commonly used by this repo's tests
    AUTH_*                 #
    CACHE_*                #
setenv =
    PYTHONWARNINGS = ignore::DeprecationWarning

##########################
# 🧹  Code style & lint
##########################
[testenv:lint]
runner       = uv-venv-runner
skip_install = true             # linting doesn't need our package importable
extras       = dev
description  = Static-analysis (ruff + black -check + isort -check + bandit)
commands =
    ruff check .
    black --check .
    isort --check-only .
    bandit -r mcpgateway -n 5
    pre-commit run --all-files --show-diff-on-failure

###################################
# 🔍  Strict static type checking
###################################
[testenv:type]
runner       = uv-venv-runner
skip_install = true
extras       = dev
description  = Mypy strict type-checking
commands =
    mypy mcpgateway tests --install-types --non-interactive

################################
# 📦  Build sdist + universal wheel
################################
[testenv:pkg]
runner       = uv-venv-runner
skip_install = true
deps = build                             # minimal requirement for PEP 517 build
description  = Build wheel + sdist via uv
commands =
    python3 -m build --sdist --wheel --outdir {toxworkdir}/dist

###############################################################################
# ☑︎  Advanced uv knobs (optional - uncomment if you need them)
###############################################################################
# [testenv]
# uv_seed = true                  # ⤷ inject pip/setuptools/wheel (legacy builds)
# uv_resolution = lowest          # ⤷ lowest, lowest-direct, highest (default)
# system_site_packages = false    # ⤷ give env access to global site-pkgs
#
# [testenv:lock-example]
# runner    = uv-venv-lock-runner #  use uv.lock + uv sync
# extras    = dev                 #  install [dev] extras listed in uv.lock
###############################################################################