chore: refactor Makefile to speed up development environment bootstrapping

[skip ci]

Author: remdub

.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+---
+default_stages:
+  - pre-commit
+  - pre-push
+repos:
+  - repo: 'https://github.com/pre-commit/pre-commit-hooks'
+    rev: v5.0.0
+    hooks:
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: check-yaml
+  - repo: 'https://github.com/asottile/yesqa'
+    rev: v1.5.0
+    hooks:
+      - id: yesqa
+  - repo: 'https://github.com/adrienverge/yamllint'
+    rev: v1.37.1
+    hooks:
+      - id: yamllint
+        args: ['-d', 'relaxed']
+  - repo: 'https://github.com/jorisroovers/gitlint.git'
+    rev: v0.19.1
+    hooks:
+      - id: gitlint
+        stages:
+          - commit-msg
+  - repo: local
+    hooks:
+      - id: check-dockerfile
+        name: 'Check dockerfile'
+        entry: 'bash -c "docker run --rm -i hadolint/hadolint < Dockerfile"'
+        pass_filenames: false
+        language: system
+        types:
+          - dockerfile

.python-version

@@ -0,0 +1 @@
+3.12

Makefile

@@ -1,37 +1,48 @@
-#!/usr/bin/make
-all: buildout
+VENV_FOLDER=.venv
 
-IMAGE_NAME=smartweb/events:latest
+ifeq (, $(shell which uv ))
+  $(error "[ERROR] The 'uv' command is missing from your PATH. Install it from: https://docs.astral.sh/uv/getting-started/installation/")
+endif
 
-buildout.cfg:
-	ln -fs dev.cfg buildout.cfg
+.PHONY: help
+help: ## Display this help message
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
-bin/buildout: bin/pip buildout.cfg
-	bin/uv pip install -r requirements.txt
+.PHONY: install
+install: $(VENV_FOLDER)/bin/buildout .git/hooks/pre-commit ## Install development environment
+	$(VENV_FOLDER)/bin/buildout
 
-buildout: bin/instance
+.PHONY: start
+start: bin/instance .git/hooks/pre-commit ## Start the instance
+	bin/instance fg
 
-bin/instance: bin/buildout
-	bin/buildout
+.PHONY: cleanall
+cleanall: ## Clean development environment
+	rm -fr .git/hooks/pre-commit .installed.cfg .mr.developer.cfg .venv bin buildout.cfg develop-eggs downloads eggs include lib lib64 local parts pyvenv.cfg
 
-bin/pip:
-	python3.12 -m venv .
-	bin/pip install uv
+.PHONY: upgrade-steps
+upgrade-steps: ## Run upgrade steps
+	bin/instance -O Plone run scripts/run_portal_upgrades.py
 
-run: bin/instance
-	bin/instance fg
+.PHONY: lint
+lint: ## Run pre-commit hooks
+	uvx pre-commit run --all
 
-cleanall:
-	rm -fr develop-eggs downloads eggs parts .installed.cfg lib lib64 include bin .mr.developer.cfg local/ share/
+.venv:
+	@echo "Creating virtual environment with uv"
+	uv venv
 
-upgrade-steps:
-	bin/instance -O plone run scripts/run_portal_upgrades.py
+buildout.cfg:
+	ln -fs dev.cfg buildout.cfg
 
-docker-image: 
-	docker build --pull --no-cache -t $(IMAGE_NAME) .
+$(VENV_FOLDER)/bin/buildout: .venv buildout.cfg
+	@echo "Installing requirements with uv pip interface"
+	uv pip install -r requirements.txt
 
-test-image:
-	echo "test to do"
+bin/instance: $(VENV_FOLDER)/bin/buildout
+	@echo "Bootstrapping environment with buildout"
+	$(VENV_FOLDER)/bin/buildout
 
-lint:
-	pre-commit run --all
+.git/hooks/pre-commit: .venv
+	@echo "Installing pre-commit hooks"
+	uvx pre-commit install