Add mypy (#3958)

Author: andrew-codechimp

.github/workflows/lint.yaml

@@ -7,14 +7,14 @@ on:
     paths:
       - '**.py' # Run if pushed commits include a change to a Python (.py) file.
       - '.github/workflows/lint.yaml' # Run if pushed commits include a change to a github actions workflow file.
-      - '.pyproject.toml' # Run if project configuration file changes.
+      - 'pyproject.toml' # Run if project configuration file changes.
   pull_request:
     branches:
       - "main"
     paths:
       - '**.py' # Run if pushed commits include a change to a Python (.py) file.
       - '.github/workflows/lint.yaml' # Run if pushed commits include a change to a github actions workflow file.
-      - '.pyproject.toml' # Run if project configuration file changes.
+      - 'pyproject.toml' # Run if project configuration file changes.
   workflow_dispatch:
 
 jobs:
@@ -34,3 +34,24 @@ jobs:
         uses: astral-sh/ruff-action@v3
         with:
           args: format --check --diff
+
+  mypy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run mypy
+        run: uv run mypy custom_components/battery_notes/ --check-untyped-defs

pyproject.toml

@@ -29,6 +29,7 @@ Changelog = "https://github.com/andrew-codechimp/HA-Battery-Notes/releases"
 dev = [
     "colorlog",
     "homeassistant==2025.9.0",
+    "mypy",
     "ruff",
 ]
 
@@ -156,7 +157,7 @@ follow_imports = "normal"
 ignore_missing_imports = true
 
 # be strict
-# check_untyped_defs = true
+check_untyped_defs = true
 # disallow_any_generics = true
 # disallow_incomplete_defs = true
 # disallow_subclassing_any = true

scripts/lint

@@ -4,4 +4,10 @@ set -euo pipefail
 # Move to project root
 cd "$(dirname "$0")/.."
 
+echo "Running ruff check..."
 uv run ruff check . --fix
+
+echo "Running mypy type checking..."
+uv run mypy custom_components/battery_notes/ --check-untyped-defs
+
+echo "Lint completed successfully!"