Remove tox, add optional scripts/test-multi-py.py for multi-version testing

- Remove tox and tox-gh from test dependencies
- Remove all [tool.tox*] configuration sections
- Remove .tox from bandit exclude (keep in gitignore)
- Add include_multiversion_testing option (default: no)
- Add scripts/test-multi-py.py for local multi-version testing using uv
- Add .venv-test-*/ to gitignore for test environments

The new test-multi-py.py script provides a simpler alternative to tox:
- Uses uv to create version-specific virtual environments
- Supports parallel test execution with --parallel flag
- Accepts pytest arguments after -- separator
- Includes cleanup options for test environments

GitHub Actions already runs tests directly via matrix builds,
making tox redundant for CI purposes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: deeenes

cookiecutter.json

@@ -72,6 +72,10 @@
         "no",
         "yes"
     ],
+    "include_multiversion_testing": [
+        "no",
+        "yes"
+    ],
     "__year": "{% now 'utc', '%Y' %}",
     "_extensions": [
         "cookiecutter.extensions.TimeExtension"

hooks/post_gen_project.py

@@ -5,13 +5,17 @@
 
 # Get the cookiecutter variables
 include_security_workflow = '{{ cookiecutter.include_security_workflow }}'
+include_multiversion_testing = '{{ cookiecutter.include_multiversion_testing }}'
 
 # Files/directories to remove based on options
 REMOVE_PATHS = []
 
 if include_security_workflow == 'no':
     REMOVE_PATHS.append('.github/workflows/ci-security.yml')
 
+if include_multiversion_testing == 'no':
+    REMOVE_PATHS.append('scripts')
+
 
 def remove_path(path):
     """Remove a file or directory if it exists."""

{{cookiecutter.project_slug}}/.github/workflows/ci-security.yml

@@ -13,4 +13,4 @@ jobs:
         -   name: Install Bandit
             run: pip install bandit
         -   name: Run Bandit
-            run: bandit -r . --exclude venv,.venv,.tox --skip B101
+            run: bandit -r . --exclude venv,.venv --skip B101

{{cookiecutter.project_slug}}/.gitignore

@@ -17,6 +17,7 @@ __pycache__/
 *.pyc
 *.kate-swp
 /.tox/
+/.venv-test-*/
 /.idea/
 /.pytest_cache/
 /.cache/

{{cookiecutter.project_slug}}/pyproject.toml

@@ -47,8 +47,6 @@ security = [
 tests = [
     "pytest>=6.0",
     "pytest-cov",
-    "tox>=3.20.1",
-    "tox-gh>=1.5.0",
     "coverage>=6.0",
     "codecov-cli>=10.2.0",
     "diff_cover",
@@ -63,7 +61,7 @@ Repository = "{{ cookiecutter.project_repo }}"
 
 
 [tool.bandit]
-exclude_dirs = [".venv", "venv", ".tox", "build", "dist"]
+exclude_dirs = [".venv", "venv", "build", "dist"]
 skips = [
     "B101"  # Name: assert_used
 ]
@@ -195,109 +193,3 @@ section-order = [
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
-
-[tool.tox]
-envlist = [
-    "covclean",
-    "lint",
-    "py{39,310,311,312,313}",
-    "coverage",
-    "readme",
-    "docs"
-]
-isolated_build = true
-min_version = "3.20.0"
-skip_missing_interpreters = true
-
-[tool.tox.envs]
-base_python = [
-    "py39: python3.9",
-    "py310: python3.10",
-    "py311: python3.11",
-    "py312: python3.12",
-    "py313: python3.13"
-]
-commands = [
-    "pytest --cov --cov-append --cov-config={toxinidir}/.coveragerc --ignore docs/ {posargs:-vv {env:_PYTEST_TOX_POSARGS:}}"
-]
-deps = [
-    ".[tests]"
-]
-passenv = "TOXENV,CI,CODECOV_*,GITHUB_ACTIONS"
-platform = [
-    "linux: linux",
-    "macos: (macos|osx|darwin)"
-]
-usedevelop = true
-
-[tool.tox.envs.clean-docs]
-allowlist_externals = ["rm"]
-changedir = "{toxinidir}/docs"
-commands = [
-    "rm -rf site"
-]
-description = "Clean the documentation artifacts."
-skip_install = true
-
-[tool.tox.envs.covclean]
-commands = [
-    "coverage erase"
-]
-deps = [".[tests]"]
-description = "Clean coverage files."
-skip_install = true
-
-[tool.tox.envs.coverage]
-commands = [
-    "coverage report --omit=\"tox/*\"",
-    "coverage xml --omit=\"tox/*\" -o {toxinidir}/coverage.xml",
-    "diff-cover --compare-branch origin/main {toxinidir}/coverage.xml"
-]
-depends = "py{39,310,311,312,313}"
-deps = [".[tests]"]
-description = "Report the coverage difference."
-parallel_show_output = true
-skip_install = true
-
-[tool.tox.envs.docs]
-allowlist_externals = ["uv"]
-commands = [
-    "uv sync --extra docs",
-    "uv run mkdocs build",
-    "python -c 'import pathlib; print(f\"Documentation is available under:\", pathlib.Path(f\"{toxinidir}\") / \"site\" / \"index.html\")'"
-]
-description = "Build the documentation."
-skip_install = true
-
-[tool.tox.envs.lint]
-commands = [
-    "pre-commit run --all-files --show-diff-on-failure {posargs:}"
-]
-deps = [".[dev]"]
-description = "Perform linting."
-skip_install = true
-
-[tool.tox.envs.py313]
-setenv = "_PYTEST_TOX_POSARGS=--log-cli-level=ERROR"
-
-[tool.tox.envs.readme]
-allowlist_externals = ["uv"]
-commands = [
-    "uv build --wheel --out-dir {envtmpdir}/build",
-    "twine check {envtmpdir}/build/*"
-]
-deps = [".[dev]"]
-description = "Check if README renders on PyPI."
-skip_install = true
-
-[tool.tox-gh-actions]
-env = [
-    "py313: covclean, lint, coverage, readme, docs"
-]
-python = [
-    "3.9: py39",
-    "3.10: py310",
-    "3.11: py311",
-    "3.12: py312",
-    "3.13: py313"
-]