GoogleFindMy-HA/Makefile at main · jleinenbach/GoogleFindMy-HA · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.PHONY: bootstrap-base-deps bootstrap-doctoc clean clean-wheelhouse doctoc install-ha-stubs lint test-ha test-single test-stubs wheelhouse

VENV ?= .venv
PYTHON ?= python3
NPM ?= npm
PYTEST_ARGS ?=
PYTEST_COV_FLAGS ?= --cov-report=term-missing
SKIP_WHEELHOUSE_REFRESH ?= 0
WHEELHOUSE ?= .wheelhouse
WHEELHOUSE_SENTINEL := $(WHEELHOUSE)/.requirements-dev.stamp
BOOTSTRAP_SENTINEL := .bootstrap/homeassistant-preinstall.stamp
# Remove DOCTOC_SENTINEL via `make clean` to force a DocToc reinstall when the cached dev dependency changes.
DOCTOC_SENTINEL := .bootstrap/doctoc-preinstall.stamp
NPM_CACHE ?= .npm-cache

clean:
	@python script/clean_pycache.py
	@if [ -f "$(BOOTSTRAP_SENTINEL)" ]; then \
		echo "[make clean] Removing Home Assistant bootstrap sentinel"; \
		rm -f "$(BOOTSTRAP_SENTINEL)"; \
	fi
	@if [ -f "$(DOCTOC_SENTINEL)" ]; then \
		echo "[make clean] Removing DocToc bootstrap sentinel"; \
		rm -f "$(DOCTOC_SENTINEL)"; \
	fi

lint:
	@ruff check . --fix

bootstrap-doctoc:
	@mkdir -p .bootstrap
	@echo "[make bootstrap-doctoc] Installing DocToc dev dependency (cached via $(NPM_CACHE))"
	@$(NPM) ci --prefer-offline --no-fund --no-audit --cache $(NPM_CACHE) --include=dev
	@touch $(DOCTOC_SENTINEL)

doctoc: bootstrap-doctoc
	@echo "[make doctoc] Regenerating AGENTS.md table of contents"
	@$(NPM) run doctoc -- AGENTS.md

wheelhouse: $(WHEELHOUSE_SENTINEL)
	@echo "[make wheelhouse] Wheel cache is ready at $(WHEELHOUSE)"

clean-wheelhouse:
	@if [ -d "$(WHEELHOUSE)" ]; then \
		echo "[make clean-wheelhouse] Removing cached wheels in $(WHEELHOUSE)"; \
		rm -rf "$(WHEELHOUSE)"; \
	else \
		echo "[make clean-wheelhouse] No wheel cache present"; \
	fi

install-ha-stubs:
	@echo "[make install-ha-stubs] Installing Home Assistant pytest dependencies"
	@$(PYTHON) -m pip install --upgrade -r requirements-ha-stubs.txt

test-stubs:
	@echo "[make test-stubs] Installing Home Assistant test dependencies"
	@$(PYTHON) -m pip install --upgrade homeassistant pytest-homeassistant-custom-component

test-single:
	@echo "[make test-single] Ensuring Home Assistant test dependencies are installed"
	@$(MAKE) test-stubs
	@echo "[make test-single] Running pytest $(PYTEST_ARGS) $(TEST)"
	@$(PYTHON) -m pytest $(PYTEST_ARGS) $(TEST)

bootstrap-base-deps: $(BOOTSTRAP_SENTINEL)
	@echo "[make bootstrap-base-deps] Home Assistant base dependencies are ready"

$(BOOTSTRAP_SENTINEL):
	@mkdir -p $(dir $(BOOTSTRAP_SENTINEL))
	@echo "[make bootstrap-base-deps] Pre-installing Home Assistant base dependencies"
	@$(PYTHON) -m pip install --upgrade homeassistant pytest-homeassistant-custom-component
	@touch $(BOOTSTRAP_SENTINEL)

$(WHEELHOUSE_SENTINEL): requirements-dev.txt
	@mkdir -p $(WHEELHOUSE)
	@if [ "$(SKIP_WHEELHOUSE_REFRESH)" = "1" ] && find "$(WHEELHOUSE)" -mindepth 1 -maxdepth 1 -type f >/dev/null 2>&1; then \
		echo "[make wheelhouse] Reusing existing wheel cache in $(WHEELHOUSE)"; \
	else \
		echo "[make wheelhouse] Downloading development wheels into $(WHEELHOUSE)"; \
		echo "[make wheelhouse] Hint: set SKIP_WHEELHOUSE_REFRESH=1 to reuse the cache on future make test-ha runs"; \
		$(PYTHON) -m pip download --requirement requirements-dev.txt --dest $(WHEELHOUSE) --exists-action=i; \
	fi
	@touch $(WHEELHOUSE_SENTINEL)

$(VENV)/bin/activate: requirements-dev.txt $(WHEELHOUSE_SENTINEL) $(BOOTSTRAP_SENTINEL)
	@$(PYTHON) -m venv $(VENV)
	@$(VENV)/bin/pip install --find-links=$(WHEELHOUSE) -r requirements-dev.txt
	@touch $(VENV)/bin/activate

test-ha: $(VENV)/bin/activate
	@echo "[make test-ha] Running targeted Home Assistant regression smoke tests"
	@. $(VENV)/bin/activate && pytest $(PYTEST_ARGS) \
		tests/test_entity_recovery_manager.py \
		tests/test_homeassistant_callback_stub_helper.py
	@echo "[make test-ha] Executing full-suite coverage run (see pytest_output.log for details)"
	@bash -o pipefail -c ". $(VENV)/bin/activate && pytest -q --cov $(PYTEST_COV_FLAGS) $${PYTEST_ARGS:+$${PYTEST_ARGS} } 2>&1 | tee pytest_output.log"

test-unload: $(VENV)/bin/activate
	@echo "[make test-unload] Running parent unload rollback regression suite"
	@. $(VENV)/bin/activate && pytest -q $(PYTEST_ARGS) tests/test_unload_subentry_cleanup.py