PYTHON ?= python3 BASE_URL ?= http://localhost:8080 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) .PHONY: help check validate test load test-persistence help: @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" check: $(PYTHON) scripts/check_contract.py validate: $(PYTHON) scripts/validate_openapi.py test: $(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS) load: $(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS) test-persistence: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) # ------------------------- # Приложение на хосте (свои цели; цели skeleton выше не менять) # ------------------------- # Postgres из compose и миграции, затем сервис на хосте: # 127.0.0.1:APP__PORT, reload по src/ .PHONY: run_dev run_dev: upgrade APP__RUN_MODE=console uv run python -m src # шаблоны копируются только если файла ещё нет: локальные значения # не затираются. В новый .env подставляется случайный пароль Postgres: # в шаблоне он пустой, общего пароля стенда в git нет .PHONY: env_setup env_setup: @test -f .env || sed "s/^POSTGRES_PASSWORD=$$/POSTGRES_PASSWORD=$$(openssl rand -hex 16)/" .env.example > .env @test -f config.toml || cp config_example.toml config.toml @echo "env ready: .env, config.toml" # ------------------------- # Docker targets # ------------------------- # порты — из того же .env, что читает compose; без .env — 8080 -include .env APP__PORT ?= 8080 APP_OUT_PORT ?= 8080 DC=docker compose # стенд: postgres -> migrate -> api. env_setup создаёт недостающие .env # и config.toml из шаблонов: без config.toml compose не запустится # (bind с create_host_path: false), без пароля — тоже .PHONY: run_docker run_docker: env_setup DOCKER_BUILDKIT=1 $(DC) build $(DC) up -d .PHONY: stop stop: $(DC) stop # контейнеры удаляются, volume с данными остаётся (удаление — wipe_data) .PHONY: down down: $(DC) down # без префикса "api-1 |": каждая строка — JSON .PHONY: logs logs: $(DC) logs -f --no-log-prefix api # ------------------------- # PostgreSQL и миграции # ------------------------- # Postgres стенда; --wait ждёт его healthcheck .PHONY: start_db start_db: env_setup $(DC) up -d --wait postgres .PHONY: stop_db stop_db: $(DC) stop postgres # миграции с хоста: 127.0.0.1:POSTGRES_OUT_PORT из .env .PHONY: upgrade upgrade: start_db uv run alembic upgrade head # новая ревизия autogenerate; база сначала доводится до head, иначе # autogenerate сравнит модели не с той схемой .PHONY: revision revision: upgrade @read -p "Сообщение миграции (англ., прошедшее время): " msg; \ uv run alembic revision --autogenerate -m "$$msg" # удалить контейнеры стенда и volume с данными: только после ввода yes .PHONY: wipe_data wipe_data: @read -p "Удалить все данные стенда (volume Postgres)? Введите yes: " answer; \ if [ "$$answer" = "yes" ]; then \ $(DC) down -v --remove-orphans; \ else \ echo "cancelled, nothing removed"; exit 1; \ fi # ------------------------- # Load benchmark (трек 1) # ------------------------- BENCH_LABEL ?= baseline # полная матрица, ~18 мин; метка не должна существовать; результаты — # evidence/bench/$(BENCH_LABEL)/, ход — строки в терминале и progress.json .PHONY: bench bench: uv run python bench/run.py --profile full --label $(BENCH_LABEL) # самопроверка стенда на малых размерах, ~1,5 мин; результат в git не идёт .PHONY: bench_quick bench_quick: uv run python bench/run.py --profile quick --label quick-$(shell date -u +%Y%m%dT%H%M%SZ) # разложение времени запроса внутри процесса в образе стенда, ~2 мин: # объясняет, куда уходит CPU, но не меряет; результат — # evidence/profile/$(BENCH_LABEL).txt, метки quick-* в git не идут .PHONY: bench_inproc bench_inproc: uv run python bench/inproc.py --label $(BENCH_LABEL) # дельта двух меток по ячейкам матрицы: BEFORE и AFTER обязательны, AA — # метка того же кода, что BEFORE, для уровня шума; результат — # evidence/compare/$(BEFORE)__$(AFTER).md .PHONY: bench_compare bench_compare: uv run python bench/compare.py --before "$(BEFORE)" --after "$(AFTER)" --aa "$(AA)" # «до» и «после» подряд в одной сессии, ~40 мин: bench и bench_inproc для # BEFORE, commit доказательств, git revert commit REAPPLY (возврат # откаченного изменения), затем то же для AFTER. Сам делает два коммита; # рабочее дерево должно быть чистым .PHONY: bench_ab bench_ab: uv run python bench/ab.py --before "$(BEFORE)" --after "$(AFTER)" --reapply "$(REAPPLY)" # ------------------------- # Common targets # ------------------------- # собственные black-box тесты против запущенного сервера (BASE_URL) .PHONY: student_test student_test: BASE_URL=$(BASE_URL) uv run pytest # образ на временной базе test_: сборка, миграции, отдельный # контейнер api на 127.0.0.1:TEST_APP_PORT, make test и make student_test, # затем уборка при любом исходе. KEEP_TEST_DB=1 оставляет базу для разбора. # $(PYTHON), а не uv run: uv повторно шлёт SIGINT, и Ctrl+C обрывал уборку .PHONY: test_isolated test_isolated: env_setup start_db $(PYTHON) student-tests/run_isolated.py $(if $(KEEP_TEST_DB),--keep-db,) .PHONY: lint lint: @ruff format . @echo "code formatted" @ruff check --fix . @echo "code checked and fixed if needed" @ruff format . @echo "code formatted" @ruff check --fix . @echo "code checked and fixed if needed"