cratekeeper-cli/Makefile at main · timosur/cratekeeper-cli · 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
101
102
103
104
.DEFAULT_GOAL := help
SHELL := /bin/bash

# ── Paths ────────────────────────────────────────────────────────────
VENV      := .venv
BIN       := $(VENV)/bin
PYTHON    := $(BIN)/python
PIP       := $(BIN)/pip
PYTEST    := $(BIN)/pytest
RUFF      := $(BIN)/ruff
PKG_DIR   := .

# ── Python discovery (first available ≥3.11) ────────────────────────
SYSTEM_PYTHON := $(shell \
	for p in python3.13 python3.12 python3.11; do \
		cmd=$$(command -v $$p 2>/dev/null); \
		if [ -n "$$cmd" ]; then echo "$$cmd"; break; fi; \
	done \
)
ifeq ($(SYSTEM_PYTHON),)
SYSTEM_PYTHON := $(shell \
	for p in \
		/opt/homebrew/opt/python@3.13/bin/python3.13 \
		/opt/homebrew/opt/python@3.12/bin/python3.12 \
		/opt/homebrew/opt/python@3.11/bin/python3.11; do \
		if [ -x "$$p" ]; then echo "$$p"; break; fi; \
	done \
)
endif

# ── Targets ──────────────────────────────────────────────────────────

# ── DB backup config ─────────────────────────────────────────────────
BACKUP_DIR  := backups
DB_USER     := dj
DB_NAME     := djlib
BACKUP_FILE := $(BACKUP_DIR)/$(DB_NAME)_$(shell date +%Y%m%d_%H%M%S).sql

.PHONY: help venv install test lint format check db db-stop down db-backup db-restore docker-build docker-run spotify-auth clean

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2}'

$(VENV)/pyvenv.cfg:
	@if [ -z "$(SYSTEM_PYTHON)" ]; then \
		echo "ERROR: No Python ≥3.11 found. Install via pyenv or Homebrew."; exit 1; \
	fi
	@echo "Creating venv with $(SYSTEM_PYTHON)…"
	$(SYSTEM_PYTHON) -m venv $(VENV)
	$(PIP) install --upgrade pip

setup: $(VENV)/pyvenv.cfg ## Create .venv and install package + dev deps
	$(PIP) install -e "$(PKG_DIR)[dev]"
	@echo ""
	@echo "Done. Activate with:  source $(VENV)/bin/activate"

install: ## Re-install package + dev deps into existing venv
	$(PIP) install -e "$(PKG_DIR)[dev]"

test: ## Run pytest
	$(PYTEST) $(ARGS)

lint: ## Run ruff check
	$(RUFF) check $(PKG_DIR)

format: ## Run ruff format
	$(RUFF) format $(PKG_DIR)

check: lint test ## Lint + test

db: ## Start Postgres (docker compose)
	docker compose up -d db

db-stop: ## Stop all docker compose services
	docker compose down

down: db-stop ## Alias for db-stop

db-backup: ## Dump database to backups/<db>_<timestamp>.sql (db must be running)
	@mkdir -p $(BACKUP_DIR)
	@echo "Backing up $(DB_NAME) → $(BACKUP_FILE)"
	docker compose exec -T db pg_dump -U $(DB_USER) --no-password $(DB_NAME) > $(BACKUP_FILE)
	@echo "Done: $(BACKUP_FILE)"

db-restore: ## Restore from BACKUP=<file> (e.g. make db-restore BACKUP=backups/djlib_20260101_120000.sql)
	@if [ -z "$(BACKUP)" ]; then \
		echo "ERROR: specify a backup file: make db-restore BACKUP=backups/<file>.sql"; exit 1; \
	fi
	@if [ ! -f "$(BACKUP)" ]; then \
		echo "ERROR: $(BACKUP) not found"; exit 1; \
	fi
	@echo "Restoring $(DB_NAME) from $(BACKUP)…"
	docker compose exec -T db psql -U $(DB_USER) -d $(DB_NAME) < $(BACKUP)
	@echo "Done."

spotify-auth: ## Authenticate with Spotify (OAuth flow)
	./crate spotify-auth

clean: ## Remove .venv, caches, build artifacts
	rm -rf $(VENV)
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
	find . -type d -name .pytest_cache -exec rm -rf {} + 2>/dev/null || true
	rm -rf $(PKG_DIR)/build $(PKG_DIR)/dist $(PKG_DIR)/*.egg-info