nagara/justfile at main · catalysync/nagara · 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
105
106
107
108
109
# Common dev commands. Install `just` (https://github.com/casey/just) then
# run e.g. `just dev`, `just test`, `just check`.

set shell := ["bash", "-cu"]
set dotenv-load := false

# Default — list available recipes.
default:
    @just --list --unsorted

# ── Setup ───────────────────────────────────────────────────────────────

# Sync deps + bring up local services. One-shot bootstrap from a fresh clone.
bootstrap:
    uv sync --all-groups
    docker compose up -d postgres redis minio minio-setup
    @echo ""
    @echo "Bootstrapped. Start the app with: just dev"

# ── Run ─────────────────────────────────────────────────────────────────

# Run the API with hot reload.
dev:
    uv run uvicorn nagara.main:app --reload --host 127.0.0.1 --port 8000

# Run the API exactly the way the Docker image runs it (no reload).
serve:
    uv run uvicorn nagara.main:app --host 0.0.0.0 --port 8000

# ── Quality ─────────────────────────────────────────────────────────────

# Format Python sources.
format:
    uv run ruff format

# Lint (with auto-fix where possible).
lint:
    uv run ruff check --fix

# Type-check.
typecheck:
    uv run ty check

# Run the tests against the currently-configured Postgres (expects it running).
test:
    uv run pytest

# Run the suite with branch coverage; HTML at htmlcov/index.html.
coverage:
    uv run pytest --cov --cov-report=term-missing --cov-report=html

# Bring up postgres + redis via compose, run the suite, tear down.
test-integration:
    ./scripts/test-integration.sh

# Regenerate the TypeScript client from the backend's OpenAPI spec (no server needed).
generate-client:
    ./scripts/generate-client.sh

# Print every Settings field + default as TOML. Pipe to a file for a starting config.
config-dump:
    uv run python scripts/config-dump.py

# Rewrite docs/config-reference.md from the Settings model.
config-docs:
    uv run python scripts/generate-config-docs.py

# All checks — what CI runs. Run before pushing.
check:
    uv run ruff format --check
    uv run ruff check
    uv run ty check
    uv run pytest

# ── Database ────────────────────────────────────────────────────────────

# Apply all pending migrations against the configured database.
migrate:
    uv run alembic upgrade head

# Generate a new auto-detected migration. Pass a description: `just makemigration "add users"`.
makemigration desc:
    uv run alembic revision --autogenerate -m "{{desc}}"

# Roll the database back one revision.
downgrade:
    uv run alembic downgrade -1

# Drop + recreate the database. DESTRUCTIVE — local dev only.
db-reset:
    docker compose down postgres
    docker volume rm nagara_postgres_data || true
    docker compose up -d postgres
    @echo "Waiting for postgres…" && sleep 3
    just migrate

# ── Docker ──────────────────────────────────────────────────────────────

# Build the production-ish image locally.
docker-build:
    docker build -t nagara:local .

# Bring up the full app stack in containers.
docker-up:
    docker compose --profile app up -d --build

# Stop and clean up the local stack.
docker-down:
    docker compose --profile app down