Add 3D printing playbook

.editorconfig

@@ -14,7 +14,7 @@ ij_smart_tabs = false
 ij_visual_guides = 80, 120, 160
 ij_wrap_on_typing = false
 
-[*.yml]
+[*.yaml]
 indent_size = 2
 
 [*.md]

.gitignore

@@ -1,8 +1,8 @@
 # Ansible
 /.galaxy/
 *.retry
-group_vars/_*.yml
-group_vars/local.yml
+group_vars/_*.yaml
+group_vars/local.yaml
 .lock
 
 # Intellij

.mk/.mk-common-version

@@ -0,0 +1 @@
+leinardi/make-common@v1 a5d37077c784b7e0ded1faf17ce70ae97ec68f8c

.mk/help.mk

@@ -0,0 +1,16 @@
+ifndef MK_COMMON_HELP_INCLUDED
+MK_COMMON_HELP_INCLUDED := 1
+
+# Only set default if not already set
+ifeq ($(.DEFAULT_GOAL),)
+  .DEFAULT_GOAL := help
+endif
+
+.PHONY: help
+help: ## Show this help and usage
+	@awk 'BEGIN {FS=":.*##"} /^[a-zA-Z0-9_\/-]+:.*##/ { printf "%s:%s\n", $$1, $$2 }' $(MAKEFILE_LIST) \
+	  | sort \
+	  | awk 'BEGIN {FS=":"; print "\nTargets:"} { printf "  \033[36m%-24s\033[0m %s\n", $$1, $$2 }'
+	@echo ""
+
+endif  # MK_COMMON_HELP_INCLUDED

.mk/password.mk

@@ -0,0 +1,9 @@
+ifndef MK_COMMON_PASSWORD_INCLUDED
+MK_COMMON_PASSWORD_INCLUDED := 1
+
+.PHONY: password
+password: ## Generate a 99-character password (PostgreSQL compatible)
+	@echo "Generating a 99-character password (PostgreSQL compatible)..."
+	@env LC_ALL=C tr -dc 'A-Za-z0-9_.-+=,' < /dev/urandom | head -c 99; echo
+
+endif  # MK_COMMON_PASSWORD_INCLUDED

.mk/pre-commit.mk

@@ -0,0 +1,32 @@
+ifndef MK_COMMON_PRECOMMIT_INCLUDED
+MK_COMMON_PRECOMMIT_INCLUDED := 1
+
+.PHONY: check
+check: check-installed-pre-commit ## Run pre-commit on all files
+	@pre-commit run --all-files
+
+.PHONY: check-stage
+check-stage: check-installed-pre-commit ## Run pre-commit on the current staging area
+	@echo "Running pre-commit on current staging area..."
+	@pre-commit run
+
+.PHONY: pre-commit-install
+pre-commit-install: check-installed-pre-commit ## Install pre-commit git hook in this repo
+	@pre-commit install
+
+.PHONY: pre-commit-autoupdate
+pre-commit-autoupdate: check-installed-pre-commit ## Update pre-commit hook versions (immediate)
+	@pre-commit autoupdate
+
+.PHONY: check-installed-pre-commit
+check-installed-pre-commit: # Verify that pre-commit is installed, print install help otherwise
+	@if ! command -v pre-commit >/dev/null 2>&1; then \
+		echo "Error: pre-commit is not installed."; \
+		echo "Install it with:"; \
+		echo "  macOS:  brew install pre-commit"; \
+		echo "  Ubuntu: sudo apt install pre-commit"; \
+		echo "  (or)  pipx install pre-commit"; \
+		exit 1; \
+	fi
+
+endif  # MK_COMMON_PRECOMMIT_INCLUDED

.yamllint.yml → .yamllint.yaml

@@ -1,15 +1,20 @@
+---
 extends: default
 
 rules:
   braces:
-    min-spaces-inside: 1
+    min-spaces-inside: 0
     max-spaces-inside: 1
     min-spaces-inside-empty: 0
     max-spaces-inside-empty: 0
   brackets: disable
   comments:
     min-spaces-from-content: 1
+  comments-indentation: false
   document-start: disable
   indentation: disable
   line-length: disable
+  octal-values:
+    forbid-implicit-octal: true
+    forbid-explicit-octal: true
   truthy: disable

Makefile

@@ -1,115 +1,53 @@
-# https://www.gnu.org/software/make/manual/html_node/Phony-Targets.html
-.PHONY: check
-check: check-installed-pre-commit
-	@pre-commit run --all-files
+# Resolve repository root (Makefile can live anywhere)
+REPO_ROOT := $(shell git rev-parse --show-toplevel 2>/dev/null || pwd)
 
-.PHONY: check-stage
-check-stage: check-installed-pre-commit
-	@echo "Running pre-commit on current staging area..."
-	pre-commit run
+MK_COMMON_REPO        ?= leinardi/make-common
+MK_COMMON_VERSION     ?= v1
 
-.PHONY: check-master-changes
-check-master-changes: check-installed-pre-commit
-	@REF=; \
-	if git rev-parse --verify --quiet origin/master >/dev/null && \
-	   git merge-base --is-ancestor origin/master HEAD; then \
-	  REF=origin/master; \
-	elif git rev-parse --verify --quiet master >/dev/null && \
-	     git merge-base --is-ancestor master HEAD; then \
-	  REF=master; \
-	else \
-	  echo "Error: neither origin/master nor master is an ancestor of HEAD." >&2; \
-	  exit 1; \
-	fi; \
-	echo "Running pre-commit on new commits since $$REF..."; \
-	echo "pre-commit run --from-ref $$REF --to-ref HEAD"; \
-	pre-commit run --from-ref $$REF --to-ref HEAD
-
-# Task to run shellcheck on all shell scripts
-.PHONY: shellcheck
-shellcheck: check-installed-pre-commit check-installed-shellcheck
-	@echo "Running shellcheck..."
-	pre-commit run shellcheck --all-files
-
-# Task to run prettier on all .yml and .yaml files
-.PHONY: prettier
-prettier: check-installed-pre-commit
-	pre-commit run prettier-yaml --all-files
-
-# Task to run ansible-lint on all playbooks after prettier
-.PHONY: ansible-lint
-ansible-lint: check-installed-pre-commit
-	@echo "Running ansible-lint..."
-	pre-commit run ansible-lint --all-files
-
-.PHONY: actionlint
-actionlint: check-installed-pre-commit
-	@echo "Running actionlint..."
-	pre-commit run actionlint --all-files
+MK_COMMON_DIR         := $(REPO_ROOT)/.mk
+MK_COMMON_FILES       := help.mk pre-commit.mk password.mk
 
-# Task to run yamllint on all playbooks after prettier
-.PHONY: yamllint
-yamllint: check-installed-pre-commit
-	@echo "Running yamllint..."
-	pre-commit run yamllint --all-files
+MK_COMMON_BOOTSTRAP_SCRIPT := $(REPO_ROOT)/scripts/bootstrap-mk-common.sh
 
-.PHONY: check-installed-shellcheck
-check-installed-shellcheck:
-	@if ! command -v shellcheck >/dev/null 2>&1; then \
-		echo "Error: shellcheck is not installed."; \
-		echo "Install it with:"; \
-		echo "  macOS: brew install shellcheck"; \
-		echo "  Ubuntu: sudo apt-get install -y shellcheck"; \
-		exit 1; \
-	fi
+# Bootstrap: the script will self-update and fetch the selected .mk snippets
+MK_COMMON_BOOTSTRAP := $(shell "$(MK_COMMON_BOOTSTRAP_SCRIPT)" \
+  "$(MK_COMMON_REPO)" \
+  "$(MK_COMMON_VERSION)" \
+  "$(MK_COMMON_DIR)" \
+  "$(MK_COMMON_FILES)")
 
-.PHONY: check-installed-prettier
-check-installed-prettier:
-	@if ! command -v prettier >/dev/null 2>&1; then \
-		echo "Error: prettier is not installed."; \
-		echo "Install it with:"; \
-		echo "  macOS: brew install prettier"; \
-		echo "  Ubuntu: npm install --global prettier"; \
-		exit 1; \
-	fi
+# Include shared make logic
+include $(addprefix $(MK_COMMON_DIR)/,$(MK_COMMON_FILES))
 
-.PHONY: check-installed-pre-commit
-check-installed-pre-commit:
-	@if ! command -v pre-commit >/dev/null 2>&1; then \
-		echo "Error: pre-commit is not installed."; \
-		echo "Install it with:"; \
-		echo "  macOS: brew install pre-commit"; \
-		echo "  Ubuntu: pip install pre-commit"; \
-		exit 1; \
-	fi
+.PHONY: mk-common-update
+mk-common-update: ## Check for remote updates of shared .mk files
+	@echo "[mk] Checking for updates from $(MK_COMMON_REPO)@$(MK_COMMON_VERSION)"
+	MK_COMMON_UPDATE=1 "$(MK_COMMON_BOOTSTRAP_SCRIPT)" \
+	  "$(MK_COMMON_REPO)" \
+	  "$(MK_COMMON_VERSION)" \
+	  "$(MK_COMMON_DIR)" \
+	  "$(MK_COMMON_FILES)"
 
-.PHONY: install-pre-commit
-install-pre-commit: check-installed-pre-commit
-	@echo "Setting up pre-commit..."
-	pre-commit install
-
-# Task to generate group_vars/all.yml
 .PHONY: generate-group-vars
-generate-group-vars: check-installed-pre-commit
-	@echo "Generating group_vars/all.yml..."
+generate-group-vars: check-installed-pre-commit ## Generate inventory/group_vars/all.yaml
+	@echo "Generating inventory/group_vars/all.yaml..."
 	pre-commit run generate-group-vars --all-files
 
-# Task to run ansible-playbook with optional parameters like TAGS, LIMIT, EXTRA_VARS, OTHER_PARAMS
+
 .PHONY: install
-install: check-ansible
+install: check-ansible ## Run ansible-playbook with optional parameters
 	@echo "Running ansible-playbook with optional parameters..."
-	ansible-playbook ubuntu-setup.yml --ask-become-pass $(strip \
+	ansible-playbook playbooks/ubuntu-setup.yaml --ask-become-pass $(strip \
 	$(if $(TAGS),--tags=$(TAGS)) \
 	$(if $(LIMIT),--limit=$(LIMIT)) \
 	$(if $(EXTRA_VARS),--extra-vars="$(EXTRA_VARS)") \
 	$(if $(OTHER_PARAMS),$(OTHER_PARAMS)))
 
-# Check if ansible is installed, and run the ansible installation script if not
 .PHONY: check-ansible
-check-ansible:
+check-ansible: # Check if ansible is installed, and run the ansible installation script if not
 	@if ! command -v ansible >/dev/null 2>&1; then \
 		echo "Ansible is not installed, running setup script..."; \
-		sudo ./install_ansible.sh; \
+		./install_ansible.sh; \
 	else \
 		echo "Ansible is already installed."; \
 	fi