Use nox for test automation (#89)

.github/workflows/ci.yaml

@@ -21,8 +21,6 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.6"
-          - "3.7"
           - "3.8"
           - "3.9"
           - "3.10"
@@ -36,9 +34,8 @@ jobs:
           architecture: x64
 
       - run: |
-          python -m venv venv
-          venv/bin/pip install -r requirements_test.txt
-          venv/bin/py.test tests/
+          pip install nox==2022.1.7 poetry==1.1.13
+          nox -rs tests
 
   coverage:
 
@@ -55,14 +52,8 @@ jobs:
           architecture: x64
 
       - run: |
-          python -m venv venv
-          venv/bin/pip install -r requirements_test.txt
-          venv/bin/py.test \
-            -s \
-            --verbose \
-            --cov-report term-missing \
-            --cov-report xml \
-            --cov=aioguardian tests
+          pip install nox==2022.1.7 poetry==1.1.13
+          nox -rs coverage
 
       - uses: codecov/codecov-action@v3
         with:

.gitignore

@@ -2,11 +2,11 @@
 .DS_Store
 .coverage
 .mypy_cache
-.tox/
+.nox
+.tox
 .venv
-__pycache__/
+__pycache__
 coverage.xml
-dist/
 docs/_build
 poetry.lock
 tags

aioguardian/errors.py

@@ -1,7 +1,10 @@
 """Define exception types for ``aioguardian``."""
 from __future__ import annotations
 
-from aioguardian.helpers.command import Command
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from aioguardian.helpers.command import Command
 
 ERROR_CODE_MAPPING = {
     3: "sensor_not_paired",

noxfile.py

@@ -0,0 +1,54 @@
+"""Define nox actions."""
+import tempfile
+from typing import Any
+
+import nox
+
+
+def install_with_constraints(session: nox.sessions.Session, *args: str, **kwargs: Any):
+    """Install PyPI packages based on pyproject.toml constraints."""
+    with tempfile.NamedTemporaryFile() as requirements:
+        session.run(
+            "poetry",
+            "export",
+            "--dev",
+            "--without-hashes",
+            "--format=requirements.txt",
+            f"--output={requirements.name}",
+            external=True,
+        )
+        session.install(f"--constraint={requirements.name}", *args, **kwargs)
+
+
+@nox.session
+def coverage(session: nox.sessions.Session) -> None:
+    """Run all tests."""
+    args = session.posargs or [
+        "-s",
+        "--cov=aioguardian",
+        "--cov-report=term-missing",
+        "--cov-report=xml",
+        "tests/",
+    ]
+    session.run("poetry", "install", "--no-dev", external=True)
+    install_with_constraints(
+        session, "aresponses", "pytest", "pytest-aiohttp", "pytest-cov"
+    )
+    session.run("pytest", *args)
+
+
+@nox.session
+def docs(session: nox.sessions.Session) -> None:
+    """Generate a local copy of the docs."""
+    session.run("poetry", "install", "--no-dev", external=True)
+    install_with_constraints(session, "Sphinx", "sphinx-rtd-theme")
+    session.run("sphinx-build", "./docs", "./docs/_build")
+
+
+@nox.session
+def tests(session: nox.sessions.Session) -> None:
+    """Run all tests."""
+    args = session.posargs or ["-s", "tests/"]
+    session.run("poetry", "install", "--no-dev", external=True)
+    install_with_constraints(session, "aresponses", "pytest", "pytest-aiohttp")
+    session.run("pytest", *args)

pyproject.toml

@@ -65,6 +65,7 @@ voluptuous = ">=0.11.7"
 [tool.poetry.dev-dependencies]
 Sphinx = "^4.0.0"
 asynctest = "^0.13.0"
+nox = "^2022.1.7"
 pre-commit = "^2.0.1"
 pytest = "^7.0.0"
 pytest-aiohttp = "^1.0.0"