ci: add ruff + mypy + pytest

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        python-version: "3.12"
+    - name: Install dependencies
+      run: uv sync
+    - name: Lint (ruff)
+      run: uv run ruff check .
+    - name: Typecheck (mypy)
+      run: uv run mypy *.py
+    - name: Test (pytest)
+      run: uv run pytest -q

analyze_stats.py

@@ -120,13 +120,13 @@ def test_load_all():
 @click.option("--resample", default="1D")
 @click.option("--title")
 def main(
-    column: str = None,
-    save: str = None,
-    since: datetime = None,
+    column: str | None = None,
+    save: str | None = None,
+    since: datetime | None = None,
     per_day: bool = False,
     per_week: bool = False,
     resample: str = "1D",
-    title: str = None,
+    title: str | None = None,
 ):
     n_plots = 2 if per_day or per_week else 1
 

collect_stats.py

@@ -36,7 +36,7 @@ def github_get_all(path: str) -> list:
     releases a single request would silently truncate the list.
     """
     items: list = []
-    url = f"https://api.github.com{path}"
+    url: str | None = f"https://api.github.com{path}"
     while url:
         response = requests.get(url, headers=_github_headers(), timeout=30)
         response.raise_for_status()

pyproject.toml

@@ -18,3 +18,19 @@ dependencies = [
 # trying to install a non-existent "aw-stats" package. uv reads [project] above.
 [tool.poetry]
 package-mode = false
+
+[dependency-groups]
+dev = [
+    "mypy>=1.19.1",
+    "pytest>=8.4.2",
+    "ruff>=0.15.21",
+]
+
+[tool.mypy]
+# Third-party libs here (pandas, matplotlib, google-auth, …) ship partial or no
+# stubs; this repo is scripts, not a typed library — keep the check lightweight.
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+# The smoke tests (test_load*) live inside analyze_stats.py, not a test_*.py file.
+python_files = ["test_*.py", "analyze_stats.py"]