Add tox configuration for testing and linting across major python versions, coverage, and linting

Author: davidpirogov

PUBLISHING.md

@@ -61,6 +61,13 @@ The publish workflow uses GitHub environments with trusted publishing (no API to
 2. **Update changelog** (if exists) or create release notes
 
 3. **Run tests locally**:
+
+   To run all tests across all supported Python versions, coverage, linting, and static analysis, use:
+   ```bash
+   uv run tox
+   ```
+
+   To run specific tests use: 
    ```bash
    uv run pytest
    uv run ruff check .

pyproject.toml

@@ -8,6 +8,8 @@ authors = [
 ]
 requires-python = ">=3.8"
 dependencies = [
+    "tox>=4.25.0",
+    "tox-uv>=1.13.1",
     "typing-extensions>=4.0.0; python_version < '3.10'",
 ]
 license = { text = "MIT" }

tox.ini

@@ -0,0 +1,71 @@
+[tox]
+requires =
+    tox>=4
+envlist = py38, py39, py310, py311, py312, py313, py314, py314t, coverage, lint, format-check, type
+skip_missing_interpreters =
+    True
+
+[testenv]
+deps =
+    pytest>=7.4.0,<8.0.0
+    pytest-cov>=4.1.0
+    pytest-asyncio>=0.21.0,<0.24.0
+    pytest-mock>=3.11.0
+    pytest-timeout>=2.1.0
+    pytest-xdist>=3.3.0
+commands =
+    pytest
+
+[testenv:py]
+description = run tests with the current interpreter (used by CI)
+commands =
+    pytest
+
+[testenv:fix]
+description = run code formatter and linter (auto-fix)
+skip_install = true
+deps =
+    pre-commit-uv>=4.1.1
+commands =
+    pre-commit run --all-files --show-diff-on-failure
+
+[testenv:lint]
+description = run linter via ruff
+skip_install = true
+deps =
+    ruff>=0.14.2
+commands =
+    ruff check {posargs:src tests}
+
+[testenv:format]
+description = run formatter via ruff
+skip_install = true
+deps =
+    ruff>=0.14.2
+commands =
+    ruff format {posargs:src tests}
+
+[testenv:format-check]
+description = check code formatting via ruff
+skip_install = true
+deps =
+    ruff>=0.14.2
+commands =
+    ruff format --check {posargs:src tests}
+
+[testenv:type]
+description = run type checker via mypy
+deps =
+    mypy
+commands =
+    mypy {posargs:src}
+
+[testenv:dev]
+runner = uv-venv-lock-runner
+description = dev environment
+extras =
+    dev
+    test
+    type
+commands =
+    uv pip tree