chore: build, lint, and test the package with Nox

Author: paduszyk

.gitignore

@@ -1,5 +1,6 @@
 __pycache__/
 .mypy_cache/
+.nox/
 .pytest_cache/
 .ruff_cache/
 *.egg-info/

docs/README.md

@@ -2,6 +2,7 @@
 
 [![Pre-commit.ci](https://results.pre-commit.ci/badge/github/paduszyk/django-management-commands/main.svg)][pre-commit.ci]
 
+[![Nox](https://img.shields.io/badge/%f0%9f%a6%8a-Nox-d85e00)][nox]
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)][ruff]
 [![Mypy](https://img.shields.io/badge/type--checked-mypy-blue?logo=python)][mypy]
 [![Prettier](https://img.shields.io/badge/code_style-Prettier-1e2b33?logo=prettier)][prettier]
@@ -14,6 +15,7 @@ Released under the [MIT license][license].
 [conventional-commits]: https://www.conventionalcommits.org/
 [license]: https://github.com/paduszyk/django-management-commands/blob/main/LICENSE
 [mypy]: https://mypy.readthedocs.io
+[nox]: https://nox.thea.codes/
 [pre-commit.ci]: https://results.pre-commit.ci/latest/github/paduszyk/django-management-commands/main
 [prettier]: https://prettier.io
 [ruff]: https://docs.astral.sh/ruff/

noxfile.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+import re
+from functools import cache, partial
+from itertools import chain
+from typing import Any
+
+import nox
+
+DJANGO_PYTHONS = {
+    "4.2": [
+        "3.9",
+        "3.10",
+        "3.11",
+        "3.12",
+    ],
+    "5.0": [
+        "3.10",
+        "3.11",
+        "3.12",
+    ],
+    "5.1": [
+        "3.10",
+        "3.11",
+        "3.12",
+    ],
+}
+
+
+@cache
+def load_dev_dependencies() -> list[str]:
+    project: dict[str, Any] = nox.project.load_toml("pyproject.toml")["project"]
+
+    optional_dependencies: dict[str, list[str]] = project["optional-dependencies"]
+
+    return optional_dependencies["dev"]
+
+
+def match_dev_dependencies(*patterns: str) -> list[str]:
+    dev_dependencies = load_dev_dependencies()
+
+    return list(
+        chain.from_iterable(
+            filter(partial(re.match, pattern), dev_dependencies) for pattern in patterns
+        ),
+    )
+
+
+nox.options.sessions = ["ruff", "mypy", "pytest"]
+
+
+@nox.session(tags=["build"])
+@nox.parametrize(
+    "python",
+    [
+        "3.9",
+        "3.10",
+        "3.11",
+        "3.12",
+    ],
+)
+def build(session: nox.Session) -> None:
+    session.install("build")
+
+    session.run("python", "-m", "build")
+    session.run("rm", "-rf", "dist", external=True)
+
+
+@nox.session(tags=["lint"])
+@nox.parametrize(
+    "command",
+    [
+        "check",
+        "format",
+    ],
+)
+def ruff(session: nox.Session, command: str) -> None:
+    session.install(
+        *match_dev_dependencies(
+            r"^ruff ~=",
+        ),
+    )
+
+    extra_options = session.posargs or []
+
+    session.run("ruff", command, *extra_options, ".")
+
+
+@nox.session(tags=["lint"])
+def mypy(session: nox.Session) -> None:
+    session.install(
+        *match_dev_dependencies(
+            r"^django\-stubs\[compatible-mypy\] ~=",
+        ),
+        "-e",
+        ".",
+    )
+
+    extra_options = session.posargs or ["--ignore-missing-imports"]
+
+    session.run("mypy", *extra_options, ".")
+
+
+@nox.session(tags=["test"])
+@nox.parametrize(
+    ("django", "python"),
+    [
+        (django, python)
+        for django, pythons in DJANGO_PYTHONS.items()
+        for python in pythons
+    ],
+)
+def pytest(session: nox.Session, django: str) -> None:
+    session.install(
+        *match_dev_dependencies(
+            r"^pytest(-[\w\-]+)? ~=",
+        ),
+        f"django == {django}.*",
+        "-e",
+        ".",
+    )
+
+    extra_options = session.posargs or []
+
+    session.run("pytest", *extra_options)

pyproject.toml

@@ -43,6 +43,7 @@ dynamic = ["version"]
 [project.optional-dependencies]
 dev = [
   "django-stubs[compatible-mypy] ~= 5.0",
+  "nox == 2024.4.15",
   "pre-commit ~= 3.8",
   "pytest ~= 8.3",
   "pytest-custom-exit-code ~= 0.3",
@@ -103,6 +104,7 @@ ignore_missing_imports = true
 
 [[tool.mypy.overrides]]
 module = [
+  "noxfile",
   "tests.*",
 ]
 disallow_untyped_decorators = false