githome/Makefile at main · tamnd/githome · 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
GO       ?= go
BIN      := bin
PKGS     := ./...

# Local Postgres for the dual-dialect tests. podman is the default engine;
# override with COMPOSE="docker compose" to use docker. The DSN matches the one
# CI sets, so `make test-postgres` runs what the CI postgres leg runs.
COMPOSE      ?= podman compose
COMPOSE_FILE := docker/postgres/compose.yaml
PG_DSN       ?= postgres://githome:githome@localhost:5432/githome_test?sslmode=disable

.PHONY: all build test test-postgres lint vet fmt tidy gates clean pg-up pg-down pg-down-clean assets assets-check

all: build

# assets regenerates the embedded web front bundle: it runs the esbuild-based
# builder (no Node), which generates the theme CSS from the Go palettes, bundles
# and content-hashes the CSS and TS entries, and writes fe/assets/dist plus the
# manifest. Run it after editing anything under fe/assets/src.
assets:
	$(GO) run ./fe/assets/build

# assets-check re-runs the builder and fails if the committed dist tree or the
# generated CSS drifts from source, so the embedded assets stay reproducible.
assets-check: assets
	@if [ -n "$$(git status --porcelain -- fe/assets/dist fe/assets/src/css/themes.gen.css)" ]; then \
		echo "asset build is not reproducible: dist or generated CSS drifted from source"; \
		git status --porcelain -- fe/assets/dist fe/assets/src/css/themes.gen.css; \
		exit 1; \
	fi
	@echo "assets reproducible"

build:
	$(GO) build -o $(BIN)/githome ./cmd/githome
	$(GO) build -o $(BIN)/githome-migrate ./cmd/githome-migrate

test:
	$(GO) test $(PKGS)

# test-postgres runs the suite against a running local Postgres (make pg-up),
# so the Postgres dialect is exercised the way CI exercises it.
test-postgres:
	GITHOME_TEST_POSTGRES_DSN="$(PG_DSN)" $(GO) test $(PKGS)

# pg-up starts Postgres 18 and blocks until its health check passes.
pg-up:
	$(COMPOSE) -f $(COMPOSE_FILE) up -d --wait

# pg-down stops and removes the container but keeps the data volume.
pg-down:
	$(COMPOSE) -f $(COMPOSE_FILE) down

# pg-down-clean also drops the data volume for a clean slate.
pg-down-clean:
	$(COMPOSE) -f $(COMPOSE_FILE) down -v

vet:
	$(GO) vet $(PKGS)

lint:
	golangci-lint run

fmt:
	golangci-lint fmt

tidy:
	$(GO) mod tidy

# gates mirrors the cross-cutting CI checks so they can be run locally.
gates:
	@echo ">> no internal/ directories"
	@if git ls-files | grep -E '(^|/)internal/'; then echo "internal/ directory found"; exit 1; fi
	@echo ">> no leaked upstream hosts in served code (cassettes and tests exempt)"
	@files=$$(git ls-files '*.go' | grep -vE '(_test\.go|testdata/)'); \
	if [ -n "$$files" ] && printf '%s\n' $$files | xargs grep -nE 'api\.github\.com|//github\.com'; then \
		echo "upstream host referenced in served code"; exit 1; \
	fi
	@echo "gates ok"

clean:
	rm -rf $(BIN)