chore: added a tox.ini file for easier local testing against all Python versions

Author: noirbizarre

CONTRIBUTING.md

@@ -75,6 +75,20 @@ pdm run test
 
 The test suite is still simple and needs expansion! Please help write more test cases.
 
+!!! note
+    You can also run your test suite against all supported Python version using `tox` with the `tox-pdm` plugin.
+    You can either run it by yourself with:
+ 
+    ```shell
+    tox
+    ```
+ 
+    or from `pdm` with:
+ 
+    ```shell
+    pdm run tox
+    ```
+
 ### Code style
 
 PDM uses `pre-commit` for linting. Install `pre-commit` first, then:

docs/mkdocs.yml

@@ -58,6 +58,7 @@ nav:
       - dev/benchmark.md
 
 markdown_extensions:
+  - admonition
   - pymdownx.highlight:
       linenums: true
   - pymdownx.superfences

news/1160.misc.md

@@ -0,0 +1 @@
+Provides a `tox.ini` file for easier local testing against all Python versions.

pyproject.toml

@@ -64,6 +64,7 @@ version = {use_scm = true}
 pre_release = "python tasks/max_versions.py"
 release = "python tasks/release.py"
 test = "pytest"
+tox = "tox"
 doc = {shell = "cd docs && mkdocs serve", help = "Start the dev server for doc preview"}
 lint = "pre-commit run --all-files"
 complete = {call = "tasks.complete:main", help = "Create autocomplete files for bash and fish"}
@@ -77,6 +78,10 @@ test = [
     "pytest-mock",
     "pytest-xdist>=1.31.0",
 ]
+tox = [
+    "tox",
+    "tox-pdm",
+]
 doc = [
     "mkdocs>=1.1",
     "mkdocs-material>=7.3",

tox.ini

@@ -0,0 +1,13 @@
+[tox]
+envlist = py3{7,8,9,10,11}, lint
+passenv = LD_PRELOAD
+isolated_build = True
+
+[testenv]
+groups = test
+commands = test {posargs}
+
+[testenv:lint]
+groups = lint
+skip_install = true
+commands = lint