Something went wrong. Try again.
Read-only ActivityPub → atproto bridge for the threadiverse using Coves lexicons
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160GOLANGCI_LINT_VERSION := v2.15.0GOLANGCI_LINT := go run github.com/golangci/golangci-lint/v2/cmd/golangci-lint@$(GOLANGCI_LINT_VERSION)
.PHONY: help build run test test-db-up test-db-down db-migrate db-migrate-down dev-up dev-down plc-up plc-down jetstream-up jetstream-down lint fmt fmt-check clean e2e e2e-up e2e-test e2e-logs e2e-down check-lexicons
.DEFAULT_GOAL := help
CYAN := \033[36mRESET := \033[0mGREEN := \033[32mYELLOW := \033[33mRED := \033[31m
COMPOSE := docker compose -f docker-compose.dev.ymlE2E_COMPOSE := docker compose -f docker-compose.e2e.yml
DEV_DATABASE_URL ?= postgres://tidepool:tidepool@localhost:5442/tidepool_dev?sslmode=disableTEST_DATABASE_URL ?= postgres://tidepool_test:tidepool_test@localhost:5443/tidepool_test?sslmode=disable
##@ General
help: ## Show this help message @echo "" @echo "$(CYAN)Tidepool Development Commands$(RESET)" @echo "" @awk 'BEGIN {FS = ":.*##"; printf "Usage: make $(CYAN)<target>$(RESET)\n"} \ /^[a-zA-Z_-]+:.*?##/ { printf " $(CYAN)%-15s$(RESET) %s\n", $$1, $$2 } \ /^##@/ { printf "\n$(YELLOW)%s$(RESET)\n", substr($$0, 5) }' $(MAKEFILE_LIST) @echo ""
##@ Build & Run
build: ## Build the tidepool binary @echo "$(GREEN)Building tidepool...$(RESET)" @go build -tags nodynamic -o tidepool ./cmd/tidepool @echo "$(GREEN)✓ Build complete: ./tidepool$(RESET)"
run: ## Run tidepool against the dev database (requires: make dev-up) @go run -tags nodynamic ./cmd/tidepool
##@ Local Development
dev-up: ## Start the dev database (port 5442) @echo "$(GREEN)Starting Tidepool dev database...$(RESET)" @$(COMPOSE) up -d --wait postgres @echo "$(GREEN)✓ PostgreSQL (dev) on localhost:5442$(RESET)"
dev-down: ## Stop all dev services (including the test database, PLC, and Jetstream) @echo "$(YELLOW)Stopping Tidepool dev stack...$(RESET)" @$(COMPOSE) --profile test --profile plc --profile jetstream down --remove-orphans @echo "$(GREEN)✓ Stopped$(RESET)"
plc-up: ## Start the local PLC directory (port 3002; first run builds did-method-plc) @echo "$(GREEN)Starting local PLC directory (first run takes several minutes)...$(RESET)" @$(COMPOSE) --profile plc up -d --wait postgres-plc plc-directory @echo "$(GREEN)✓ PLC directory on http://localhost:3002$(RESET)"
plc-down: ## Stop the local PLC directory @$(COMPOSE) --profile plc stop plc-directory postgres-plc @echo "$(GREEN)✓ PLC directory stopped$(RESET)"
jetstream-up: ## Start Jetstream against the local bridge (run `make run` first; ws on :6018) @echo "$(GREEN)Starting Jetstream pointed at the local bridge firehose...$(RESET)" @$(COMPOSE) --profile jetstream up -d jetstream @echo "$(GREEN)✓ Jetstream on ws://localhost:6018/subscribe (metrics :6019)$(RESET)"
jetstream-down: ## Stop the Jetstream container @$(COMPOSE) --profile jetstream stop jetstream @echo "$(GREEN)✓ Jetstream stopped$(RESET)"
##@ Database Management
db-migrate: ## Apply migrations to the dev database (goose CLI) @echo "$(GREEN)Running migrations...$(RESET)" @goose -dir internal/db/migrations postgres "$(DEV_DATABASE_URL)" up @echo "$(GREEN)✓ Migrations complete$(RESET)"
db-migrate-down: ## Roll back the last migration on the dev database @echo "$(YELLOW)Rolling back last migration...$(RESET)" @goose -dir internal/db/migrations postgres "$(DEV_DATABASE_URL)" down @echo "$(GREEN)✓ Rollback complete$(RESET)"
##@ Testing
test-db-up: ## Start the test database (port 5443) @echo "$(GREEN)Starting test database...$(RESET)" @$(COMPOSE) --profile test up -d --wait postgres-test @echo "$(GREEN)✓ PostgreSQL (test) on localhost:5443$(RESET)"
test-db-down: ## Stop the test database @$(COMPOSE) --profile test stop postgres-test @echo "$(GREEN)✓ Test database stopped$(RESET)"
test: test-db-up ## Run the test suite against real postgres (migrations run in-process) @echo "$(GREEN)Running tests (store tests migrate the test database themselves)...$(RESET)" @TIDEPOOL_TEST_DATABASE_URL="$(TEST_DATABASE_URL)" go test -tags nodynamic ./... @echo "$(GREEN)✓ Tests complete$(RESET)"
##@ End-to-end (real Lemmy + PLC + Jetstream)
e2e: ## Full e2e run: build + start the stack, run the suite, tear down (-v) @echo "$(GREEN)Starting e2e stack (first run builds Lemmy from source — grab a coffee)...$(RESET)" @up_status=0; $(E2E_COMPOSE) up -d --build --wait --wait-timeout 600 || up_status=$$?; \ if [ $$up_status -ne 0 ]; then \ echo "$(RED)✗ e2e stack failed to come up (exit $$up_status); recent logs:$(RESET)" >&2; \ $(E2E_COMPOSE) logs --tail=100 || true; \ echo "$(YELLOW)Tearing down half-started e2e stack...$(RESET)"; \ $(E2E_COMPOSE) down -v --remove-orphans || true; \ exit $$up_status; \ fi; \ echo "$(GREEN)Stack healthy; running e2e suite...$(RESET)"; \ status=0; go test -tags e2e,nodynamic -count=1 -timeout 20m ./tests/e2e/... || status=$$?; \ echo "$(YELLOW)Tearing down e2e stack...$(RESET)"; \ down_status=0; $(E2E_COMPOSE) down -v --remove-orphans || down_status=$$?; \ if [ $$down_status -ne 0 ]; then \ echo "$(RED)✗ WARNING: e2e teardown failed (exit $$down_status) — the stack may still be running; try 'make e2e-down'$(RESET)" >&2; \ fi; \ if [ $$status -ne 0 ]; then exit $$status; fi; \ exit $$down_status
e2e-up: ## Start the e2e stack and leave it running (for iterating on tests) @$(E2E_COMPOSE) up -d --build --wait --wait-timeout 600 @echo "$(GREEN)✓ e2e stack up: tidepool 127.0.0.1:8092, DNS 127.0.0.1:$(or $(TIDEPOOL_E2E_DNS_PORT),5380) (UDP/TCP), lemmy 127.0.0.1:8541, relay 127.0.0.1:2480, reference pds 127.0.0.1:3081, jetstream 127.0.0.1:6028$(RESET)"
e2e-test: ## Run the e2e suite against an already-running stack (make e2e-up) @go test -tags e2e,nodynamic -count=1 -v -timeout 20m ./tests/e2e/...
e2e-logs: ## Tail all e2e stack logs @$(E2E_COMPOSE) logs -f
e2e-down: ## Tear down the e2e stack and its volumes @$(E2E_COMPOSE) down -v --remove-orphans @echo "$(GREEN)✓ e2e stack removed$(RESET)"
##@ Code Quality
check-lexicons: ## Verify vendored lexicons match the manifest (and ~/Code/coves when present) @./scripts/check-lexicons.sh
GO_FMT_PATHS ?= .
fmt: ## Format Go code with the .golangci.yml formatters (GO_FMT_FILE=path formats one file) @if [ -n "$$GO_FMT_FILE" ]; then $(GOLANGCI_LINT) fmt -- "$$GO_FMT_FILE"; else $(GOLANGCI_LINT) fmt $(GO_FMT_PATHS); fi
fmt-check: ## Check Go formatting against the .golangci.yml formatters @$(GOLANGCI_LINT) fmt --diff $(GO_FMT_PATHS) || { echo "$(YELLOW)Run 'make fmt' to fix$(RESET)"; exit 1; } @echo "$(GREEN)✓ All files formatted$(RESET)"
lint: fmt-check ## Run golangci-lint (includes format check) @echo "$(GREEN)Running linter...$(RESET)" @$(GOLANGCI_LINT) run ./... @echo "$(GREEN)✓ Linting complete$(RESET)"
##@ Cleanup
clean: ## Remove build artifacts @rm -f tidepool @go clean @echo "$(GREEN)✓ Clean complete$(RESET)"