Files
mtusi2026lab2/Makefile
T
ricoromaandClaude Opus 5.5 7b775a29a9 chore: carry over lab 1 solution into lab 2 skeleton
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>
2026-09-30 22:11:46 +03:00

148 lines
4.9 KiB
Makefile
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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"