fix(make): improve targets and prerequisites to avoid running a recipe unnecessarily

Author: jenstroeger

Makefile

@@ -7,6 +7,10 @@ SHELL := bash
 PACKAGE_NAME := package
 PACKAGE_VERSION := $(shell python -c $$'try: import $(PACKAGE_NAME); print($(PACKAGE_NAME).__version__);\nexcept: print("unknown");')
 
+# Files that this package depends on are in the src/ folder, so collect them
+# all into a list.
+PACKAGE_DEPS := $(shell find src/$(PACKAGE_NAME) -type f -not -path "*/__pycache__/*")
+
 # This variable contains the first goal that matches any of the listed goals
 # here, else it contains an empty string. The net effect is to filter out
 # whether this current run of `make` requires a Python virtual environment
@@ -106,7 +110,8 @@ upgrade-quiet:
 
 # Generate a Software Bill of Materials (SBOM).
 .PHONY: sbom
-sbom: requirements
+sbom: requirements dist/$(PACKAGE_NAME)-$(PACKAGE_VERSION)-sbom.json
+dist/$(PACKAGE_NAME)-$(PACKAGE_VERSION)-sbom.json:
 	cyclonedx-py --force --requirements --format json --output dist/$(PACKAGE_NAME)-$(PACKAGE_VERSION)-sbom.json
 
 # Generate a requirements.txt file containing version and integrity hashes for all
@@ -119,8 +124,8 @@ sbom: requirements
 # We also want to make sure that this package itself is added to the requirements.txt
 # file, and if possible even with proper hashes.
 .PHONY: requirements
-requirements: requirements.txt
-requirements.txt: pyproject.toml
+requirements: requirements.txt dist/$(PACKAGE_NAME)-$(PACKAGE_VERSION)-requirements.txt
+requirements.txt dist/$(PACKAGE_NAME)-$(PACKAGE_VERSION)-requirements.txt: .venv/upgraded-on
 	echo -n "" > requirements.txt
 	for pkg in $$(python -m pip freeze --local --disable-pip-version-check --exclude-editable); do \
 	  pkg=$${pkg//[$$'\r\n']}; \
@@ -160,14 +165,18 @@ check-lint:
 	pre-commit run pylint --all-files
 check-mypy:
 	pre-commit run mypy --all-files
-check:
+check: .venv/checked-on
+.venv/checked-on: $(PACKAGE_DEPS)
 	pre-commit run --all-files
+	echo "Automatically generated by Python Package Makefile on $$(date '+%Y-%m-%d %H:%M:%S %z')." > .venv/checked-on
 
 # Run all unit tests. The --files option avoids stashing but passes files; however,
 # the hook setup itself does not pass files to pytest (see .pre-commit-config.yaml).
 .PHONY: test
-test:
+test: check .venv/tested-on
+.venv/tested-on: $(PACKAGE_DEPS)
 	pre-commit run pytest --hook-stage push --files tests/
+	echo "Automatically generated by Python Package Makefile on $$(date '+%Y-%m-%d %H:%M:%S %z')." > .venv/tested-on
 
 # Build a source distribution package and a binary wheel distribution artifact.
 # When building these artifacts, we need the environment variable SOURCE_DATE_EPOCH