Copy the committed lab 1 sources as-is: src/, student-tests/, bench/, Dockerfile, docker-compose.yml, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays in the lab 1 repository. Merge the new skeleton files with own sections: Makefile (lab 2 targets plus own run, docker, bench and common targets), .gitignore, .dockerignore and .env.example. Rename the image to mtusi-messenger:lab2 and point AGENTS.md at lab 2. The application is still the in-memory lab 1 implementation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
148 lines
4.9 KiB
Makefile
148 lines
4.9 KiB
Makefile
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 выше не менять)
|
||
# -------------------------
|
||
|
||
.PHONY: run_dev
|
||
run_dev:
|
||
APP__RUN_MODE=console uv run python -m src
|
||
|
||
# шаблоны копируются только если файла ещё нет: локальные значения
|
||
# не затираются
|
||
.PHONY: env_setup
|
||
env_setup:
|
||
@test -f .env || cp .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
|
||
DOCKER_IMAGE=mtusi-messenger:lab2
|
||
DOCKER_CONTAINER=mtusi-messenger-lab2
|
||
|
||
# без compose: команды README, контейнер на переднем плане;
|
||
# стоп — Ctrl+C или docker stop mtusi-messenger-lab2.
|
||
# env_setup создаёт недостающий .env: без него --env-file падает
|
||
.PHONY: run_no_compose
|
||
run_no_compose: env_setup
|
||
DOCKER_BUILDKIT=1 docker build -t $(DOCKER_IMAGE) .
|
||
docker run --rm --name $(DOCKER_CONTAINER) \
|
||
-p 127.0.0.1:$(APP_OUT_PORT):$(APP__PORT) \
|
||
--env-file .env $(DOCKER_IMAGE)
|
||
|
||
# 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
|
||
|
||
.PHONY: down
|
||
down:
|
||
$(DC) down
|
||
|
||
# без префикса "api-1 |": каждая строка — JSON
|
||
.PHONY: logs
|
||
logs:
|
||
$(DC) logs -f --no-log-prefix api
|
||
|
||
|
||
# -------------------------
|
||
# 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
|
||
|
||
.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"
|