Split requirements into dev and lint dependencies

.github/workflows/lint.yml

@@ -25,9 +25,14 @@ jobs:
         with:
           python-version: "3.14"
           cache: "pip"
+          cache-dependency-path: |
+            requirements_common.txt
+            requirements_lint.txt
 
       - name: Install requirements
-        run: python3 -m pip install -r requirements.txt
+        run: |
+          python3 -m pip install -r requirements_common.txt
+          python3 -m pip install -r requirements_lint.txt
 
       - name: Lint
         run: python3 -m ruff check .

README.md

@@ -28,7 +28,9 @@ File | Purpose | Documentation
 `CONTRIBUTING.md` | Guidelines on how to contribute. | [Documentation](https://help.github.com/en/github/building-a-strong-community/setting-guidelines-for-repository-contributors)
 `LICENSE` | The license file for the project. | [Documentation](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/licensing-a-repository)
 `README.md` | The file you are reading now, should contain info about the integration, installation and configuration instructions. | [Documentation](https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax)
-`requirements.txt` | Python packages used for development/lint/testing this integration. | [Documentation](https://pip.pypa.io/en/stable/user_guide/#requirements-files)
+`requirements_dev.txt` | Python packages used for development/testing this integration (also installs lint tooling via `requirements_lint.txt`). | [Documentation](https://pip.pypa.io/en/stable/user_guide/#requirements-files)
+`requirements_lint.txt` | Python packages used to lint this integration (installed by the Lint CI job). | [Documentation](https://pip.pypa.io/en/stable/user_guide/#requirements-files)
+`requirements_common.txt` | Python packages common to CI and local dev, installed first so any pip upgrade completes before other dependencies (e.g. a modern pip). | [Documentation](https://pip.pypa.io/en/stable/user_guide/#requirements-files)
 
 ## Dependency updates
 

requirements_common.txt

@@ -0,0 +1 @@
+pip>=21.3.1

requirements.txt → requirements_dev.txt

@@ -1,4 +1,3 @@
+-r requirements_lint.txt
 colorlog==6.10.1
 homeassistant==2026.3.2
-pip>=21.3.1
-ruff==0.15.21

requirements_lint.txt

@@ -0,0 +1 @@
+ruff==0.15.21

scripts/setup

@@ -4,4 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-python3 -m pip install --requirement requirements.txt
+# Install common requirements (pip) first so any pip upgrade completes
+# before the rest of the dependencies are installed.
+python3 -m pip install --requirement requirements_common.txt
+python3 -m pip install --requirement requirements_dev.txt