diff --git a/.env.example b/.env.example index d32b9be0..d5774b0f 100644 --- a/.env.example +++ b/.env.example @@ -6,8 +6,7 @@ APP_ENV=lab SESSION_TTL_SECONDS=3600 # Choose credentials locally. File paths contain no secret values. DATABASE_URL_FILE=/run/secrets/database_url -# Optional on 3, required use on 4 in lab2; Redis OR Valkey: SESSION_STORE=postgres -CACHE_URL_FILE=/run/secrets/cache_url API_REPLICAS=2 IDEMPOTENCY_TTL_SECONDS=86400 +CURSOR_SECRET_FILE=/run/secrets/cursor_secret diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..ab272d34 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,23 @@ +FROM python:3.12.12-slim + +ENV PYTHONDONTWRITEBYTECODE=1 \ + PYTHONUNBUFFERED=1 + +WORKDIR /app + +RUN pip install --no-cache-dir uv==0.11.28 + +COPY pyproject.toml uv.lock ./ +RUN uv sync --frozen --no-dev --no-install-project + +COPY src ./src +COPY migrations ./migrations + +USER 65534:65534 + +EXPOSE 8080 + +HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \ + CMD ["/app/.venv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2).read()"] + +CMD ["/app/.venv/bin/python", "-m", "src.main"] diff --git a/Makefile b/Makefile index 5d86d171..f86721e5 100644 --- a/Makefile +++ b/Makefile @@ -4,10 +4,10 @@ CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) -.PHONY: help check validate test load test-persistence test-failover +.PHONY: help check validate test load test-persistence test-failover test-rolling track1 help: - @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" + @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes; test-rolling: sequential API replacement; track1: Level 5 benchmark on isolated port 8081" check: $(PYTHON) scripts/check_contract.py @@ -28,3 +28,9 @@ test-persistence: test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +test-rolling: + $(PYTHON) student-tests/rolling_update.py --base-url "$(BASE_URL)" $(TLS_ARGS) + +track1: + scripts/run-track1.sh diff --git a/REPORT.md b/REPORT.md index c2679005..155c98c3 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,151 @@ # Отчёт — лабораторная 3 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO +- Автор, группа: Матвей Козырев, БВТ2301 +- Целевая оценка: 5; трек 1 «Цена масштабирования» - Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Использованные библиотеки: FastAPI, Uvicorn, asyncpg, argon2-cffi, Docker Compose, HAProxy. До исправления замечаний 16.10.2026 использовался Nginx. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Docker Engine с Docker Compose v2 и OpenSSL. Секреты создаются локально и не попадают в Git. + +```sh +mkdir -p secrets +openssl rand -hex 32 -out secrets/postgres_password +awk '{printf "postgresql://messenger:%s@postgres:5432/messenger\\n", $0}' secrets/postgres_password > secrets/database_url +openssl rand -hex 32 -out secrets/cursor_secret +chmod 700 secrets +chmod 600 secrets/postgres_password secrets/database_url secrets/cursor_secret +docker compose --env-file .env.example config --quiet +docker compose --env-file .env.example up -d --build --wait +make test +``` + +Точка входа — `http://localhost:8080`; API и PostgreSQL не публикуют порты на host. Обычная остановка `docker compose down` сохраняет volume. Удаление учебных данных — отдельная команда `docker compose down -v`. + +Для rolling update: + +```sh +make test-rolling +``` + +Для эксперимента уровня 5: + +```sh +make track1 +``` + +Последняя команда использует отдельный Compose project `mtusi2026lab3bench`, отдельный PostgreSQL volume и порт `8081`; основной стенд на `8080` она не меняет. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +```text +Клиент → HAProxy load_balancer → api-a / api-b → PostgreSQL +``` -## Доказательства критериев +PostgreSQL — общий источник истины для пользователей, сессий, чатов, сообщений и idempotency records. API не хранит локального состояния, от которого зависит корректность. `X-Instance-Id` берётся из hostname контейнера. Общий Docker secret задаёт ключ подписи курсоров, поэтому курсор одной реплики проверяется другой. `Idempotency-Key` хранится в PostgreSQL в области user + method + path + key; создание сообщения и запись результата происходят в одной транзакции. -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +HAProxy проверяет каждую API-реплику через `GET /health/ready` каждые 2 с: только статус 200 считается успехом. Одна неуспешная проверка исключает backend (`fall=1`), две успешные возвращают его (`rise=2`). Timeout проверки — 2 с, соединения — 1 с. Ожидаемое обнаружение отказа — следующий интервал плюс время проверки (около 4–5 с с учётом соединения, без гарантии времени планирования ОС). Проверки работают независимо от Docker health status и клиентского трафика. DNS обновляется через Docker resolver. Конфигурация: [haproxy.cfg](infra/haproxy.cfg); механизм: [HAProxy health checks](https://www.haproxy.com/documentation/haproxy-configuration-tutorials/reliability/health-checks/). + +API healthcheck выполняется каждые 5 с, имеет timeout 3 с, `retries=12` и `start_period=10 с`. Uvicorn получает до 8 с на graceful shutdown; контейнеру задан `stop_grace_period=10 с`. В HAProxy не включён повтор уже отправленных POST по HTTP-ошибкам: это защищает регистрации от неявного повторения. + +Лимиты основной конфигурации: API — по 0,5 CPU / 256 MiB; PostgreSQL — 0,75 CPU / 512 MiB; LB — 0,25 CPU / 128 MiB. [Замер docker inspect от 14.10](evidence/resource-limits-2026-10-14.txt) относится к прежнему Nginx; лимиты сохранены в [compose.yaml](compose.yaml). + +Миграции выполняет отдельный одноразовый сервис `migrate` до API. Миграции `001`, `002` и `003` additive: предыдущая версия API не зависит от добавленной таблицы идемпотентности, а новая стартует после завершения migrate. + +## Проверка уровня 3 и 4 + +Следующая таблица содержит исторические результаты 14.10.2026 для Nginx. Регрессии после замены LB описаны в разделе «Исправления по ревью». + +| Проверка | Команда | Результат | Доказательство | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Публичный API-сценарий | `make test` | PASS | [smoke](evidence/smoke-2026-10-14.txt) | +| Общая идемпотентность | `python3 student-tests/idempotency_concurrency.py` | 16 конкурентных повторов вернули одно сообщение; в истории одна запись | [idempotency](evidence/idempotency-concurrency-2026-10-14.txt) | +| Сохранность после restart | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | PASS; сессия и данные сохранены | [persistence](evidence/persistence-2026-10-14.txt) | +| Отказ `api-b` | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` | 130 успешных записей, 0 ошибок, восстановление 0,765 с | [failover api-b](evidence/failover-api-b-2026-10-14.txt) | +| Отказ `api-a` | Повтор после восстановления `api-b` | 129 успешных записей, 0 ошибок, восстановление 0,567 с | [failover api-a](evidence/failover-api-a-2026-10-14.txt) | +| Rolling update под записью | `make test-rolling` | 380 успешных записей, 0 ошибок, заменены обе API-реплики | [rolling update](evidence/rolling-update-2026-10-14.txt) | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +RPS failover-сценариев: `130 / 15 = 8,667 RPS` для `api-b` и `129 / 15 = 8,600 RPS` для `api-a`. Rolling update длился 12,239 с: `380 / 12,239 = 31,048 RPS`. Это показатели проверок отказа, не capacity-тест. -## Эксперименты и отказы +## Уровень 5, трек 1 — цена масштабирования -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Приведённые ниже данные и график получены 14.10.2026 с Nginx на версии `f2c4395`. Они не являются замерами HAProxy. После исправления readiness текущая команда `make track1` запускает HAProxy с активными проверками; для сравнения новой конфигурации требуется отдельная серия измерений. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +### Гипотеза + +При фиксированных суммарных ресурсах API (2 CPU / 1024 MiB) деление сервиса на две или четыре реплики не даст роста throughput, если PostgreSQL с лимитом 0,75 CPU станет ограничивающим компонентом. Увеличение только API-бюджета до 4 CPU / 2048 MiB также не должно помочь, пока лимит PostgreSQL не меняется. + +### Методика + +Для эксперимента добавлен [compose.benchmark.yaml](compose.benchmark.yaml). Он создаёт отдельный проект `mtusi2026lab3bench`: LB опубликован на `:8081`, PostgreSQL использует отдельный volume, API масштабируется параметром `--scale`. + +Скрипт [student-tests/track1_benchmark.py](student-tests/track1_benchmark.py) для каждой точки: + +1. удаляет только временный volume benchmark-проекта; +2. запускает PostgreSQL, миграцию, заданное число API и LB; +3. запускает [tests/load.py](tests/load.py): 32 параллельных closed-loop клиента в течение 15 секунд отправляют POST сообщений без автоматических повторов; +4. примерно раз в секунду сохраняет `docker stats` всех benchmark-контейнеров; +5. записывает конфигурацию, метрики нагрузки и сэмплы ресурсов в JSON. + +Порядок серий определён в [scripts/run-track1.sh](scripts/run-track1.sh). График строит [student-tests/render_track1_svg.py](student-tests/render_track1_svg.py). Все первичные данные находятся в [evidence/track1/raw](evidence/track1/raw). + +### Результаты + +Во всех точках используются одинаковые нагрузка и БД: 32 клиента, 15 секунд, POST сообщения; PostgreSQL — 0,75 CPU / 512 MiB, Nginx — 0,25 CPU / 128 MiB. RPS — число только успешно завершённых POST в секунду. + +| Серия | API-реплики | CPU/RAM одной API | Суммарно API CPU/RAM | Успешные RPS | Ошибки | p95, мс | PostgreSQL CPU: среднее / максимум | LB CPU: среднее / максимум | Первичные данные | +| --- | ---: | --- | --- | ---: | ---: | ---: | --- | --- | --- | +| fixed-1 | 1 | 2 / 1024 MiB | 2 / 1024 MiB | 815,779 | 0 | 81,883 | 55,7% / 74,0% | 8,0% / 12,0% | [fixed-1.json](evidence/track1/raw/fixed-1.json) | +| fixed-2 | 2 | 1 / 512 MiB | 2 / 1024 MiB | 580,271 | 0 | 99,430 | 60,0% / 75,4% | 9,8% / 15,6% | [fixed-2.json](evidence/track1/raw/fixed-2.json) | +| fixed-4 | 4 | 0,5 / 256 MiB | 2 / 1024 MiB | 530,744 | 0 | 103,385 | 59,7% / 77,2% | 8,6% / 15,1% | [fixed-4.json](evidence/track1/raw/fixed-4.json) | +| growth-2 | 2 | 2 / 1024 MiB | 4 / 2048 MiB | 576,230 | 0 | 98,983 | 63,1% / 76,6% | 9,6% / 15,3% | [growth-2.json](evidence/track1/raw/growth-2.json) | +| growth-4 | 4 | 1 / 512 MiB | 4 / 2048 MiB | 503,443 | 0 | 103,761 | 69,2% / 77,3% | 9,6% / 16,7% | [growth-4.json](evidence/track1/raw/growth-4.json) | + +![График successful RPS](evidence/track1/scale.svg) + +### Анализ saturation point + +1. При фиксированном API-бюджете максимальный результат показала одна реплика: 815,779 RPS. Две и четыре реплики показали 580,271 и 530,744 RPS соответственно. +2. Увеличение API-бюджета с 2 CPU / 1024 MiB до 4 CPU / 2048 MiB не увеличило RPS для многорепличных конфигураций: `580,271 → 576,230` для двух реплик и `530,744 → 503,443` для четырёх. +3. Во всех многорепличных сериях максимум PostgreSQL находится около его лимита 0,75 CPU: 75,4–77,3%. Максимум CPU Nginx — 16,7%, что ниже его лимита 0,25 CPU; данные не подтверждают насыщение LB. +4. В `fixed-4` нагрузку получают все API-контейнеры: их средний CPU составляет 24,4%, 24,8%, 28,5% и 27,2%; эти значения сохранены в [fixed-4.json](evidence/track1/raw/fixed-4.json). Поэтому отсутствие роста не объясняется маршрутизацией трафика на единственную реплику. + +Следовательно, в этой измеренной конфигурации наиболее подтверждённое ограничение — CPU PostgreSQL. Добавление API после этой точки не повышает throughput, потому что каждая операция записи использует общую БД. + +### Подтверждённое улучшение + +Для данного профиля улучшенной конфигурацией стала одна API-реплика с 2 CPU / 1024 MiB вместо четырёх API по 0,5 CPU / 256 MiB при одинаковом суммарном бюджете. Расчёт по successful RPS: + +```text +(815,779 − 530,744) / 530,744 × 100 = 53,7% +``` + +Это улучшение подтверждено первичными данными [fixed-1.json](evidence/track1/raw/fixed-1.json) и [fixed-4.json](evidence/track1/raw/fixed-4.json), но не является универсальным правилом: на каждую точку выполнен один запуск. ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Нагрузочный генератор closed-loop; он может быть ограничен клиентом и допускает coordinated omission. Latency в JSON относится только к успешным операциям. +- Каждая точка длится 15 секунд и выполнена один раз. Для статистического вывода нужны повторы, более длинные прогоны и доверительные интервалы. +- `docker stats` снимается примерно раз в секунду: этого достаточно для наблюдения CPU-лимита, но недостаточно для анализа SQL, lock waits и ожиданий пула соединений. +- PostgreSQL и HAProxy существуют в одном экземпляре. Стенд не заявляет выживание отказа host, LB или PostgreSQL. + +## Исправления по ревью 16.10.2026 + +Результаты: [review-regressions-2026-10-16.txt](evidence/review-regressions-2026-10-16.txt). Новые регрессии, smoke, идемпотентность и persistence прошли. Rolling update: 318 успешных записей и 1 ошибка за 12,26 с; подтверждённые сообщения сохранены. Краткая ошибка до обнаружения остановленной реплики допустима, отсутствие ошибок во время замены не заявляется. + +- Bearer с не-ASCII символами отклоняется до вычисления ASCII-хеша: 401, `WWW-Authenticate: Bearer …`, контрактный Error. +- Ошибки декодирования тела, которые FastAPI передаёт как HTTPException, преобразуются в Error. Для байта FF в JSON: 400, `invalid_request`, одинаковый request ID в теле и заголовке. +- Вместо passive-only Nginx применяется HAProxy с активным опросом готовности. Проверка зависимости от БД исключает API, даже если её процесс и `/health/live` продолжают работать. + +Воспроизведение: + +```sh +docker compose up -d --build --wait +python3 student-tests/review_regressions.py +python3 student-tests/readiness_failover.py +make test +make test-rolling +``` + +[readiness_failover.py](student-tests/readiness_failover.py) временно запрещает подключения IP api-a через pg_hba, закрывает её существующие подключения, проверяет 503 у api-a и 200 у api-b, затем выполняет 40 liveness-запросов и 20 регистраций через LB. В блоке finally восстанавливает исходный pg_hba, после чего проверяет возврат обеих реплик в балансировку. Запускать на учебном стенде, отдельно от других тестов отказа. diff --git a/compose.benchmark.yaml b/compose.benchmark.yaml new file mode 100644 index 00000000..43570f4d --- /dev/null +++ b/compose.benchmark.yaml @@ -0,0 +1,102 @@ +x-api: &api + build: + context: . + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + APP_ENV: benchmark + DATABASE_URL_FILE: /run/secrets/database_url + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + CURSOR_SECRET_FILE: /run/secrets/cursor_secret + secrets: + - database_url + - cursor_secret + depends_on: + migrate: + condition: service_completed_successfully + expose: + - "8080" + healthcheck: + test: ["CMD", "/app/.venv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2).read()"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 10s + deploy: + resources: + limits: + cpus: "${BENCH_API_CPUS}" + memory: ${BENCH_API_MEMORY} + +services: + postgres: + image: postgres:17.6-alpine + environment: + POSTGRES_DB: messenger + POSTGRES_USER: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: + - postgres_password + volumes: + - postgres_data:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 5s + deploy: + resources: + limits: + cpus: "${BENCH_DB_CPUS:-0.75}" + memory: ${BENCH_DB_MEMORY:-512M} + + migrate: + build: + context: . + command: ["/app/.venv/bin/python", "-m", "src.migrate"] + environment: + DATABASE_URL_FILE: /run/secrets/database_url + CURSOR_SECRET_FILE: /run/secrets/cursor_secret + secrets: + - database_url + - cursor_secret + depends_on: + postgres: + condition: service_healthy + + api: + <<: *api + + load_balancer: + image: haproxy:3.0.11-alpine + ports: + - "8081:8080" + volumes: + - ./infra/haproxy.benchmark.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + depends_on: + api: + condition: service_healthy + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 5s + deploy: + resources: + limits: + cpus: "${BENCH_LB_CPUS:-0.25}" + memory: ${BENCH_LB_MEMORY:-128M} + +secrets: + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + cursor_secret: + file: ./secrets/cursor_secret + +volumes: + postgres_data: diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..27ffa2de --- /dev/null +++ b/compose.yaml @@ -0,0 +1,114 @@ +x-api: &api + build: + context: . + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + APP_ENV: lab3 + DATABASE_URL_FILE: /run/secrets/database_url + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + CURSOR_SECRET_FILE: /run/secrets/cursor_secret + secrets: + - database_url + - cursor_secret + depends_on: + migrate: + condition: service_completed_successfully + expose: + - "8080" + stop_grace_period: 10s + healthcheck: + test: ["CMD", "/app/.venv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2).read()"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 10s + deploy: + resources: + limits: + cpus: "0.50" + memory: 256M + +services: + postgres: + image: postgres:17.6-alpine + environment: + POSTGRES_DB: messenger + POSTGRES_USER: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: + - postgres_password + volumes: + - postgres_data:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 5s + deploy: + resources: + limits: + cpus: "0.75" + memory: 512M + + migrate: + build: + context: . + command: ["/app/.venv/bin/python", "-m", "src.migrate"] + environment: + DATABASE_URL_FILE: /run/secrets/database_url + CURSOR_SECRET_FILE: /run/secrets/cursor_secret + secrets: + - database_url + - cursor_secret + depends_on: + postgres: + condition: service_healthy + restart: "no" + deploy: + resources: + limits: + cpus: "0.25" + memory: 128M + + api-a: + <<: *api + + api-b: + <<: *api + + load_balancer: + image: haproxy:3.0.11-alpine + ports: + - "8080:8080" + volumes: + - ./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + depends_on: + api-a: + condition: service_healthy + api-b: + condition: service_healthy + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 5s + deploy: + resources: + limits: + cpus: "0.25" + memory: 128M + +secrets: + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + cursor_secret: + file: ./secrets/cursor_secret + +volumes: + postgres_data: diff --git a/evidence/failover-api-a-2026-10-14.txt b/evidence/failover-api-a-2026-10-14.txt new file mode 100644 index 00000000..a843e5f7 --- /dev/null +++ b/evidence/failover-api-a-2026-10-14.txt @@ -0,0 +1,6 @@ +$ make test-failover ACTION_SCRIPT=scripts/stop-one.sh +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 129, "failed_attempts": 0, "first_recovery_seconds": 0.567} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. + +After the hook, `docker compose ps` showed api-b running and api-a stopped. api-a was then started and reached health=healthy. diff --git a/evidence/failover-api-b-2026-10-14.txt b/evidence/failover-api-b-2026-10-14.txt new file mode 100644 index 00000000..c178b59d --- /dev/null +++ b/evidence/failover-api-b-2026-10-14.txt @@ -0,0 +1,6 @@ +$ make test-failover ACTION_SCRIPT=scripts/stop-one.sh +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 130, "failed_attempts": 0, "first_recovery_seconds": 0.765} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. + +After the hook, `docker compose ps` showed api-a running and api-b stopped. api-b was then started and reached health=healthy. diff --git a/evidence/idempotency-concurrency-2026-10-14.txt b/evidence/idempotency-concurrency-2026-10-14.txt new file mode 100644 index 00000000..524a921b --- /dev/null +++ b/evidence/idempotency-concurrency-2026-10-14.txt @@ -0,0 +1,2 @@ +$ python3 student-tests/idempotency_concurrency.py +PASS: concurrent idempotency through load balancer diff --git a/evidence/persistence-2026-10-14.txt b/evidence/persistence-2026-10-14.txt new file mode 100644 index 00000000..adae54c9 --- /dev/null +++ b/evidence/persistence-2026-10-14.txt @@ -0,0 +1,4 @@ +$ make test-persistence ACTION_SCRIPT=scripts/restart.sh +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:8080" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/resource-limits-2026-10-14.txt b/evidence/resource-limits-2026-10-14.txt new file mode 100644 index 00000000..4a6c887b --- /dev/null +++ b/evidence/resource-limits-2026-10-14.txt @@ -0,0 +1,5 @@ +$ docker inspect --format '{{.Name}} cpu_nano={{.HostConfig.NanoCpus}} memory_bytes={{.HostConfig.Memory}}' +/mtusi2026lab3-api-a-1 cpu_nano=500000000 memory_bytes=268435456 +/mtusi2026lab3-api-b-1 cpu_nano=500000000 memory_bytes=268435456 +/mtusi2026lab3-postgres-1 cpu_nano=750000000 memory_bytes=536870912 +/mtusi2026lab3-load_balancer-1 cpu_nano=250000000 memory_bytes=134217728 diff --git a/evidence/review-regressions-2026-10-16.txt b/evidence/review-regressions-2026-10-16.txt new file mode 100644 index 00000000..5c474cd2 --- /dev/null +++ b/evidence/review-regressions-2026-10-16.txt @@ -0,0 +1,30 @@ +Review fixes, 2026-10-16. API behind haproxy:3.0.11-alpine. + +$ python3 student-tests/review_regressions.py +PASS: non-ASCII Bearer returns 401/challenge; malformed JSON returns contract Error/400 + +$ python3 student-tests/readiness_failover.py +PASS: api-a ready=503, api-b ready=200; 40/40 live and 20/20 registrations use api-b +PASS: database access restored; both API replicas returned to LB + +$ make test +PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. + +$ python3 student-tests/idempotency_concurrency.py +PASS: concurrent idempotency through load balancer + +$ make test-rolling +{"instances_before": 2, "instances_after": 2, "successful_writes": 318, "failed_writes": 1, "elapsed_seconds": 12.26, "successful_rps": 25.938, "successful_latency_ms": {"p50": 6.652, "p95": 13.944, "p99": 50.718}} +PASS: sequential API replacement preserved writes through load balancer + +$ make test-persistence ACTION_SCRIPT=scripts/restart.sh +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. + +$ make check +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. + +$ make validate PYTHON=.venv/bin/python +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. + +Final docker compose ps: api-a, api-b, load_balancer and postgres healthy. +Historical track1 results were NOT rerun and refer to Nginx, not HAProxy. diff --git a/evidence/rolling-update-2026-10-14.txt b/evidence/rolling-update-2026-10-14.txt new file mode 100644 index 00000000..a26547a9 --- /dev/null +++ b/evidence/rolling-update-2026-10-14.txt @@ -0,0 +1,4 @@ +$ make test-rolling +python3 student-tests/rolling_update.py --base-url "http://localhost:8080" +{"instances_before": 2, "instances_after": 2, "successful_writes": 380, "failed_writes": 0, "elapsed_seconds": 12.239, "successful_rps": 31.048, "successful_latency_ms": {"p50": 6.288, "p95": 12.973, "p99": 55.053}} +PASS: sequential API replacement preserved writes through load balancer diff --git a/evidence/smoke-2026-10-14.txt b/evidence/smoke-2026-10-14.txt new file mode 100644 index 00000000..a7a0052c --- /dev/null +++ b/evidence/smoke-2026-10-14.txt @@ -0,0 +1,3 @@ +$ make test +python3 tests/smoke.py --base-url "http://localhost:8080" +PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/track1/raw/fixed-1.json b/evidence/track1/raw/fixed-1.json new file mode 100644 index 00000000..ab66794c --- /dev/null +++ b/evidence/track1/raw/fixed-1.json @@ -0,0 +1,262 @@ +{ + "label": "fixed-1", + "topology": { + "api_replicas": 1, + "api_cpu_per_replica": "2.0", + "api_memory_per_replica": "1024M", + "api_cpu_total": 2.0, + "api_memory_total_mib": 1024, + "database_cpu": "0.75", + "database_memory": "512M", + "load_balancer_cpu": "0.25", + "load_balancer_memory": "128M" + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 15.0, + "elapsed_seconds": 15.067, + "concurrency": 32, + "successful_requests": 12291, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 815.779, + "successful_latency_ms": { + "p50": 31.692, + "p95": 81.883, + "p99": 99.112 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + }, + "docker_stats_samples": [ + { + "at_seconds": 49856.203, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "98.16%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.66%", + "MemUsage": "47.73MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.25MB / 3.9MB", + "PIDs": "30" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "9.78%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.69%", + "MemUsage": "11.12MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "2.28MB / 2.41MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 58.5MB", + "CPUPerc": "29.31%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "9.86%", + "MemUsage": "50.51MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "1.05MB / 793kB", + "PIDs": "16" + } + ] + }, + { + "at_seconds": 49859.232, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "108.66%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.70%", + "MemUsage": "48.17MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "9.17MB / 11.1MB", + "PIDs": "30" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "12.00%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.93%", + "MemUsage": "11.43MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "6.49MB / 6.79MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 89MB", + "CPUPerc": "65.14%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "10.31%", + "MemUsage": "52.8MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "6.56MB / 4.96MB", + "PIDs": "16" + } + ] + }, + { + "at_seconds": 49862.267, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "82.08%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.77%", + "MemUsage": "48.81MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "12.7MB / 15.4MB", + "PIDs": "30" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.96%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.95%", + "MemUsage": "11.46MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "9.01MB / 9.36MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 140MB", + "CPUPerc": "73.64%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "10.87%", + "MemUsage": "55.66MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "12.8MB / 9.68MB", + "PIDs": "16" + } + ] + }, + { + "at_seconds": 49865.301, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "64.17%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.77%", + "MemUsage": "48.86MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "18MB / 22MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.09%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.66%", + "MemUsage": "11.09MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "12.9MB / 13.3MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 153MB", + "CPUPerc": "73.96%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "11.10%", + "MemUsage": "56.85MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "15.3MB / 11.6MB", + "PIDs": "16" + } + ] + }, + { + "at_seconds": 49868.334, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "59.01%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.76%", + "MemUsage": "48.77MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "20.3MB / 25MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "7.07%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.89%", + "MemUsage": "11.38MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "15.4MB / 15.8MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 176MB", + "CPUPerc": "73.72%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "11.66%", + "MemUsage": "59.7MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "19.5MB / 14.8MB", + "PIDs": "16" + } + ] + }, + { + "at_seconds": 49871.369, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "13.04%", + "Container": "3102616c2229fa51599408feade99a8b100221c2010bbef189a109ba08c9945e", + "ID": "3102616c2229", + "MemPerc": "4.74%", + "MemUsage": "48.54MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "22.6MB / 27.9MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "1.85%", + "Container": "171664a94f65c834d5a4aed6788677526142ddc3e4b2479685fc473b1054bf05", + "ID": "171664a94f65", + "MemPerc": "8.20%", + "MemUsage": "10.5MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "16.3MB / 16.7MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 183MB", + "CPUPerc": "18.52%", + "Container": "25ad43fd92ecbefa3123612afe34cc47b99e94fc12c5c8d9835f4ce82a8f9a63", + "ID": "25ad43fd92ec", + "MemPerc": "11.63%", + "MemUsage": "59.54MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "20.6MB / 15.7MB", + "PIDs": "16" + } + ] + } + ], + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second." +} diff --git a/evidence/track1/raw/fixed-2.json b/evidence/track1/raw/fixed-2.json new file mode 100644 index 00000000..04ccc417 --- /dev/null +++ b/evidence/track1/raw/fixed-2.json @@ -0,0 +1,328 @@ +{ + "label": "fixed-2", + "topology": { + "api_replicas": 2, + "api_cpu_per_replica": "1.0", + "api_memory_per_replica": "512M", + "api_cpu_total": 2.0, + "api_memory_total_mib": 1024, + "database_cpu": "0.75", + "database_memory": "512M", + "load_balancer_cpu": "0.25", + "load_balancer_memory": "128M" + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 15.0, + "elapsed_seconds": 15.031, + "concurrency": 32, + "successful_requests": 8722, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 580.271, + "successful_latency_ms": { + "p50": 66.028, + "p95": 99.43, + "p99": 110.211 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + }, + "docker_stats_samples": [ + { + "at_seconds": 49950.007, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "57.55%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "8.73%", + "MemUsage": "44.71MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "1.55MB / 1.86MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "57.76%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "8.64%", + "MemUsage": "44.25MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "1.16MB / 1.38MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "15.61%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "9.23%", + "MemUsage": "11.82MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "1.9MB / 1.97MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 56.8MB", + "CPUPerc": "47.28%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "14.31%", + "MemUsage": "73.27MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "824kB / 632kB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 49953.036, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "46.48%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "8.78%", + "MemUsage": "44.96MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.21MB / 3.86MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "57.48%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "8.77%", + "MemUsage": "44.91MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "2.93MB / 3.5MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "13.20%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "9.02%", + "MemUsage": "11.54MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "4.92MB / 5.05MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 80MB", + "CPUPerc": "75.25%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "14.74%", + "MemUsage": "75.46MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "6.1MB / 4.73MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 49956.072, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "38.38%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "9.02%", + "MemUsage": "46.18MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "6.03MB / 7.28MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "41.71%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "8.90%", + "MemUsage": "45.55MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "3.97MB / 4.74MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "11.49%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "8.99%", + "MemUsage": "11.51MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "6.72MB / 6.87MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 110MB", + "CPUPerc": "75.42%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "15.16%", + "MemUsage": "77.61MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "9.24MB / 7.19MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 49959.112, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "51.47%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "8.99%", + "MemUsage": "46.03MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "7.14MB / 8.62MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "35.08%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "8.97%", + "MemUsage": "45.93MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "5.67MB / 6.78MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "9.03%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "9.04%", + "MemUsage": "11.57MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "9.53MB / 9.71MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 122MB", + "CPUPerc": "74.80%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "15.35%", + "MemUsage": "78.59MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "11.8MB / 9.17MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 49962.154, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "35.06%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "9.14%", + "MemUsage": "46.79MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "8.63MB / 10.4MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "33.37%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "9.03%", + "MemUsage": "46.21MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "6.7MB / 8MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "9.19%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "9.10%", + "MemUsage": "11.65MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "10.7MB / 10.9MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 128MB", + "CPUPerc": "75.30%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "15.49%", + "MemUsage": "79.31MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "13.2MB / 10.3MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 49965.205, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.29%", + "Container": "ea1aa235fcefcecfb8ac05be6d656bb9e5df6138bf761180c1b94c48b533de0f", + "ID": "ea1aa235fcef", + "MemPerc": "9.04%", + "MemUsage": "46.29MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "9.59MB / 11.6MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "4.63%", + "Container": "5cbbc0046dc1aeac6d9fd2dbea66268aa1c64ee8af76301972ee6f1987574df2", + "ID": "5cbbc0046dc1", + "MemPerc": "9.02%", + "MemUsage": "46.2MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "7.08MB / 8.46MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.00%", + "Container": "079b10b046fd16613076c6a14068871e3059723c27b8ae82fdb66363469dd49d", + "ID": "079b10b046fd", + "MemPerc": "8.30%", + "MemUsage": "10.62MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "11.9MB / 12.1MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 135MB", + "CPUPerc": "11.96%", + "Container": "a4acbfe434715cea38be5be954db7dc98738ff6098957c911e006fbbd34a2cd9", + "ID": "a4acbfe43471", + "MemPerc": "15.52%", + "MemUsage": "79.46MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "14.7MB / 11.5MB", + "PIDs": "26" + } + ] + } + ], + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second." +} diff --git a/evidence/track1/raw/fixed-4.json b/evidence/track1/raw/fixed-4.json new file mode 100644 index 00000000..9fce46cb --- /dev/null +++ b/evidence/track1/raw/fixed-4.json @@ -0,0 +1,460 @@ +{ + "label": "fixed-4", + "topology": { + "api_replicas": 4, + "api_cpu_per_replica": "0.5", + "api_memory_per_replica": "256M", + "api_cpu_total": 2.0, + "api_memory_total_mib": 1024, + "database_cpu": "0.75", + "database_memory": "512M", + "load_balancer_cpu": "0.25", + "load_balancer_memory": "128M" + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 15.0, + "elapsed_seconds": 15.043, + "concurrency": 32, + "successful_requests": 7984, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 530.744, + "successful_latency_ms": { + "p50": 77.811, + "p95": 103.385, + "p99": 148.349 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + }, + "docker_stats_samples": [ + { + "at_seconds": 50011.66, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "10.92%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "41.54%", + "MemUsage": "106.3MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "5.54kB / 3.62kB", + "PIDs": "7" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "7.17%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "16.85%", + "MemUsage": "43.13MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "19.5kB / 21.5kB", + "PIDs": "9" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "27.10%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "16.76%", + "MemUsage": "42.91MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "18.8kB / 12.9kB", + "PIDs": "8" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "29.05%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "16.75%", + "MemUsage": "42.88MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "22.2kB / 17.7kB", + "PIDs": "8" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.79%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "8.16%", + "MemUsage": "10.45MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "37kB / 36.9kB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 53.1MB", + "CPUPerc": "7.44%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "13.91%", + "MemUsage": "71.24MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "59.4kB / 46.4kB", + "PIDs": "38" + } + ] + }, + { + "at_seconds": 50014.717, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "40.67%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "17.25%", + "MemUsage": "44.16MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "1.13MB / 1.35MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "42.75%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "22.36%", + "MemUsage": "57.25MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "938kB / 1.12MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "35.06%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "17.09%", + "MemUsage": "43.75MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "718kB / 853kB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "40.03%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "17.33%", + "MemUsage": "44.36MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "1.17MB / 1.41MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "15.05%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "9.05%", + "MemUsage": "11.59MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "3.05MB / 3.08MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 65MB", + "CPUPerc": "74.15%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "20.67%", + "MemUsage": "105.8MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "3.8MB / 2.97MB", + "PIDs": "40" + } + ] + }, + { + "at_seconds": 50017.772, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "25.86%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "17.39%", + "MemUsage": "44.51MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "2.02MB / 2.43MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "29.49%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "17.37%", + "MemUsage": "44.48MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "1.62MB / 1.94MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "28.21%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "17.32%", + "MemUsage": "44.34MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "1.7MB / 2.04MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "28.33%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "17.43%", + "MemUsage": "44.61MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "1.83MB / 2.21MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "11.36%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "9.05%", + "MemUsage": "11.59MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "5.49MB / 5.53MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 74.3MB", + "CPUPerc": "73.81%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "20.96%", + "MemUsage": "107.3MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "6.77MB / 5.34MB", + "PIDs": "40" + } + ] + }, + { + "at_seconds": 50020.818, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "34.36%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "21.01%", + "MemUsage": "53.8MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "2.58MB / 3.11MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "33.33%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "17.31%", + "MemUsage": "44.31MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "2.29MB / 2.73MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "26.22%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "17.28%", + "MemUsage": "44.23MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "2.73MB / 3.27MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "28.90%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "17.48%", + "MemUsage": "44.74MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "2.93MB / 3.52MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "10.15%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "9.33%", + "MemUsage": "11.94MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "7.71MB / 7.75MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 99.3MB", + "CPUPerc": "77.21%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "21.83%", + "MemUsage": "111.8MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "9.47MB / 7.5MB", + "PIDs": "41" + } + ] + }, + { + "at_seconds": 50023.862, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "21.34%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "17.50%", + "MemUsage": "44.8MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.48MB / 4.18MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "21.42%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "17.60%", + "MemUsage": "45.06MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "2.81MB / 3.34MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "21.12%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "17.38%", + "MemUsage": "44.48MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "3.38MB / 4.05MB", + "PIDs": "10" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "23.01%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "17.41%", + "MemUsage": "44.57MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "3.38MB / 4.05MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.97%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "9.13%", + "MemUsage": "11.69MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "9.5MB / 9.53MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 106MB", + "CPUPerc": "74.17%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "21.96%", + "MemUsage": "112.4MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "11.6MB / 9.26MB", + "PIDs": "41" + } + ] + }, + { + "at_seconds": 50026.913, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "13.36%", + "Container": "c9de83048557f4f3543fff6b1ae45c4ff32258e55b34bfa97c186b7ed2db6313", + "ID": "c9de83048557", + "MemPerc": "17.50%", + "MemUsage": "44.8MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "4.05MB / 4.87MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "14.44%", + "Container": "ab974c7d1209ff627e057a2b45da1468f6ebf5d93ca84ec43fdc3d42c045aed0", + "ID": "ab974c7d1209", + "MemPerc": "17.34%", + "MemUsage": "44.39MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "3.28MB / 3.91MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "33.24%", + "Container": "29fb69623a889b2c6931dc563d9df922e706a7d3688cf8d828455686a170a643", + "ID": "29fb69623a88", + "MemPerc": "17.28%", + "MemUsage": "44.23MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "3.81MB / 4.56MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "13.81%", + "Container": "2289c938a185fe8e13260275c1b52459e605081714ec62488805a1cd4054e395", + "ID": "2289c938a185", + "MemPerc": "17.65%", + "MemUsage": "45.19MiB / 256MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "4.17MB / 4.99MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "5.36%", + "Container": "cefdec1749029335b719a085966911e628cd1451e4a9cc4ebe09e1f5fb285896", + "ID": "cefdec174902", + "MemPerc": "8.54%", + "MemUsage": "10.93MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "11MB / 11.1MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 112MB", + "CPUPerc": "51.47%", + "Container": "ee1f8206bc6cde738ff4f2f6c7d3921d14ce88c5ab28444ea20b365494e11272", + "ID": "ee1f8206bc6c", + "MemPerc": "22.74%", + "MemUsage": "116.4MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "13.5MB / 10.8MB", + "PIDs": "42" + } + ] + } + ], + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second." +} diff --git a/evidence/track1/raw/growth-2.json b/evidence/track1/raw/growth-2.json new file mode 100644 index 00000000..66c7540d --- /dev/null +++ b/evidence/track1/raw/growth-2.json @@ -0,0 +1,328 @@ +{ + "label": "growth-2", + "topology": { + "api_replicas": 2, + "api_cpu_per_replica": "2.0", + "api_memory_per_replica": "1024M", + "api_cpu_total": 4.0, + "api_memory_total_mib": 2048, + "database_cpu": "0.75", + "database_memory": "512M", + "load_balancer_cpu": "0.25", + "load_balancer_memory": "128M" + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 15.0, + "elapsed_seconds": 15.103, + "concurrency": 32, + "successful_requests": 8703, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 576.23, + "successful_latency_ms": { + "p50": 65.856, + "p95": 98.983, + "p99": 107.718 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + }, + "docker_stats_samples": [ + { + "at_seconds": 50062.647, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "56.68%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.38%", + "MemUsage": "44.87MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "1.27MB / 1.5MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "73.97%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.37%", + "MemUsage": "44.71MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "685kB / 816kB", + "PIDs": "10" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "15.35%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "8.85%", + "MemUsage": "11.33MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "2.08MB / 2.15MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 65.3MB", + "CPUPerc": "75.66%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "14.45%", + "MemUsage": "73.98MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "2.61MB / 2.01MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 50065.676, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "56.61%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.43%", + "MemUsage": "45.38MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.03MB / 3.62MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "54.95%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.41%", + "MemUsage": "45.19MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "4.06MB / 4.9MB", + "PIDs": "13" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "12.50%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "8.83%", + "MemUsage": "11.3MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "5.06MB / 5.19MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 77.3MB", + "CPUPerc": "76.58%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "14.60%", + "MemUsage": "74.75MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "5.22MB / 4.04MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 50068.716, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "40.76%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.45%", + "MemUsage": "45.62MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "4.08MB / 4.87MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "38.86%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.50%", + "MemUsage": "46.11MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "5.97MB / 7.22MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "10.41%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "8.98%", + "MemUsage": "11.49MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "7.53MB / 7.69MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 112MB", + "CPUPerc": "74.63%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "15.10%", + "MemUsage": "77.32MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "9.3MB / 7.23MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 50071.768, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "49.39%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.49%", + "MemUsage": "46MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "5.37MB / 6.41MB", + "PIDs": "19" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "49.20%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.54%", + "MemUsage": "46.53MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "7.11MB / 8.6MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "10.81%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "8.83%", + "MemUsage": "11.3MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "8.92MB / 9.09MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 124MB", + "CPUPerc": "75.31%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "15.29%", + "MemUsage": "78.3MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "11.8MB / 9.2MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 50074.811, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "34.36%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.52%", + "MemUsage": "46.33MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "6.48MB / 7.73MB", + "PIDs": "16" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "34.82%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.58%", + "MemUsage": "46.92MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "9.01MB / 10.9MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.61%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "9.02%", + "MemUsage": "11.55MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "11.3MB / 11.5MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 134MB", + "CPUPerc": "74.73%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "15.41%", + "MemUsage": "78.92MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "13.9MB / 10.9MB", + "PIDs": "26" + } + ] + }, + { + "at_seconds": 50077.862, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "1.44%", + "Container": "08a18866aedbba35e2d2f3feacb76ea5ab6c7df873d53de2ad25d6b12e0f3a5b", + "ID": "08a18866aedb", + "MemPerc": "4.53%", + "MemUsage": "46.39MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "7.17MB / 8.55MB", + "PIDs": "15" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "1.09%", + "Container": "2fde0e88d902b817e869695cc08d8e55d9cec4c9102457a5ef556ea2f4556dd3", + "ID": "2fde0e88d902", + "MemPerc": "4.56%", + "MemUsage": "46.66MiB / 1GiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "9.46MB / 11.5MB", + "PIDs": "14" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.00%", + "Container": "2f83ab1f449fb22b899b06e01cf4b4873da2df789f38e8dbd69bfef358f2e3d0", + "ID": "2f83ab1f449f", + "MemPerc": "8.71%", + "MemUsage": "11.15MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "11.9MB / 12.1MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 137MB", + "CPUPerc": "1.63%", + "Container": "e5422dd2da87c184f50cc39e4055b2feaf81f3e7cfd417ac79a51ca27f708fb3", + "ID": "e5422dd2da87", + "MemPerc": "15.54%", + "MemUsage": "79.59MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "14.6MB / 11.5MB", + "PIDs": "26" + } + ] + } + ], + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second." +} diff --git a/evidence/track1/raw/growth-4.json b/evidence/track1/raw/growth-4.json new file mode 100644 index 00000000..56f28864 --- /dev/null +++ b/evidence/track1/raw/growth-4.json @@ -0,0 +1,460 @@ +{ + "label": "growth-4", + "topology": { + "api_replicas": 4, + "api_cpu_per_replica": "1.0", + "api_memory_per_replica": "512M", + "api_cpu_total": 4.0, + "api_memory_total_mib": 2048, + "database_cpu": "0.75", + "database_memory": "512M", + "load_balancer_cpu": "0.25", + "load_balancer_memory": "128M" + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 15.0, + "elapsed_seconds": 15.106, + "concurrency": 32, + "successful_requests": 7605, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 503.443, + "successful_latency_ms": { + "p50": 80.463, + "p95": 103.761, + "p99": 114.564 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + }, + "docker_stats_samples": [ + { + "at_seconds": 50109.046, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "34.69%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.58%", + "MemUsage": "43.95MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "498kB / 591kB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "37.96%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.50%", + "MemUsage": "43.53MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "344kB / 406kB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "34.55%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.55%", + "MemUsage": "43.76MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "496kB / 591kB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "24.06%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.46%", + "MemUsage": "43.33MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "65kB / 69.7kB", + "PIDs": "10" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "16.72%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "9.15%", + "MemUsage": "11.71MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "1.26MB / 1.28MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 58MB", + "CPUPerc": "74.68%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "19.64%", + "MemUsage": "100.6MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "1.61MB / 1.26MB", + "PIDs": "38" + } + ] + }, + { + "at_seconds": 50112.08, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "44.21%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.63%", + "MemUsage": "44.16MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "1.47MB / 1.77MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "46.08%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.61%", + "MemUsage": "44.1MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "1.05MB / 1.25MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "28.28%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.58%", + "MemUsage": "43.93MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "1.19MB / 1.42MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "45.04%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.60%", + "MemUsage": "44.04MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "1.41MB / 1.69MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "13.11%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "9.13%", + "MemUsage": "11.69MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "3.85MB / 3.88MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 68.5MB", + "CPUPerc": "76.54%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "21.85%", + "MemUsage": "111.9MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "4.77MB / 3.79MB", + "PIDs": "42" + } + ] + }, + { + "at_seconds": 50115.128, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "27.65%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.68%", + "MemUsage": "44.43MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "2.08MB / 2.49MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "27.69%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.58%", + "MemUsage": "43.95MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "1.53MB / 1.81MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "25.25%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.75%", + "MemUsage": "44.78MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "2.33MB / 2.8MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "26.16%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.62%", + "MemUsage": "44.16MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "1.99MB / 2.38MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "10.39%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "8.71%", + "MemUsage": "11.15MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "6.17MB / 6.19MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 74.5MB", + "CPUPerc": "74.06%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "22.00%", + "MemUsage": "112.7MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "6.73MB / 5.35MB", + "PIDs": "42" + } + ] + }, + { + "at_seconds": 50118.171, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "37.90%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.73%", + "MemUsage": "44.72MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "2.8MB / 3.36MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "25.12%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.76%", + "MemUsage": "44.84MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "2.27MB / 2.68MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "24.38%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.75%", + "MemUsage": "44.81MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "3.04MB / 3.64MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "23.76%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.81%", + "MemUsage": "45.12MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "2.97MB / 3.55MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "9.31%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "8.86%", + "MemUsage": "11.34MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "8.06MB / 8.07MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 101MB", + "CPUPerc": "77.26%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "22.37%", + "MemUsage": "114.5MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "9.87MB / 7.9MB", + "PIDs": "42" + } + ] + }, + { + "at_seconds": 50121.23, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "20.43%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.78%", + "MemUsage": "44.93MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.64MB / 4.35MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "23.91%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.78%", + "MemUsage": "44.96MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "2.76MB / 3.25MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "20.60%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.78%", + "MemUsage": "44.98MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "3.68MB / 4.39MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "20.78%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.82%", + "MemUsage": "45.15MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "3.38MB / 4.04MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "8.19%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "9.06%", + "MemUsage": "11.6MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "9.74MB / 9.74MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 107MB", + "CPUPerc": "74.34%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "22.54%", + "MemUsage": "115.4MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "11.9MB / 9.56MB", + "PIDs": "42" + } + ] + }, + { + "at_seconds": 50124.275, + "containers": [ + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.34%", + "Container": "1bde062cfba194c45b14228152938bbc9c004eee37b0157c687b401a2e6c4b5a", + "ID": "1bde062cfba1", + "MemPerc": "8.83%", + "MemUsage": "45.21MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-1", + "NetIO": "3.92MB / 4.68MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.35%", + "Container": "4fcb51f8e179a8c6551f0b525aac3d2fadcc39759bc7c00cd2b6e63c4c27f8fa", + "ID": "4fcb51f8e179", + "MemPerc": "8.74%", + "MemUsage": "44.73MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-2", + "NetIO": "3.01MB / 3.55MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.36%", + "Container": "af470a1de18ee088b35c87cedcaa05f9c636243f35821aa47cb8fbe4366de1a7", + "ID": "af470a1de18e", + "MemPerc": "8.78%", + "MemUsage": "44.97MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-3", + "NetIO": "3.97MB / 4.75MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.33%", + "Container": "73979dc9a0ec84166945eec696afcadc95b1ce2ad790708f968aa562a8d53605", + "ID": "73979dc9a0ec", + "MemPerc": "8.84%", + "MemUsage": "45.27MiB / 512MiB", + "Name": "mtusi2026lab3bench-api-4", + "NetIO": "3.85MB / 4.6MB", + "PIDs": "12" + }, + { + "BlockIO": "0B / 0B", + "CPUPerc": "0.00%", + "Container": "c2d50c6e8f3f09a418ff6d9555d4d6f2314ce63295b4c581e03a5ef02cfa1298", + "ID": "c2d50c6e8f3f", + "MemPerc": "8.51%", + "MemUsage": "10.89MiB / 128MiB", + "Name": "mtusi2026lab3bench-load_balancer-1", + "NetIO": "10.5MB / 10.5MB", + "PIDs": "11" + }, + { + "BlockIO": "0B / 110MB", + "CPUPerc": "38.04%", + "Container": "95fe3cc1dc5a7cbf961a8395acd1e4aa3fdcb25b8d5a2ddd5ba23164bb87ccdd", + "ID": "95fe3cc1dc5a", + "MemPerc": "22.70%", + "MemUsage": "116.2MiB / 512MiB", + "Name": "mtusi2026lab3bench-postgres-1", + "NetIO": "12.8MB / 10.3MB", + "PIDs": "42" + } + ] + } + ], + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second." +} diff --git a/evidence/track1/scale.svg b/evidence/track1/scale.svg new file mode 100644 index 00000000..a2defdda --- /dev/null +++ b/evidence/track1/scale.svg @@ -0,0 +1,10 @@ + + + +Track 1: successful RPS (closed-loop POST, concurrency 32) +Blue: fixed API total 2 CPU / 1024 MiB. Green: API total 4 CPU / 2048 MiB. +0200400600800 + +815.8fixed-1p95 81.9 ms580.3fixed-2p95 99.4 ms530.7fixed-4p95 103.4 ms576.2growth-2p95 99.0 ms503.4growth-4p95 103.8 ms +Data: evidence/track1/raw/*.json. Each point uses a fresh database volume; DB limit 0.75 CPU / 512 MiB. + diff --git a/infra/haproxy.benchmark.cfg b/infra/haproxy.benchmark.cfg new file mode 100644 index 00000000..d9fca206 --- /dev/null +++ b/infra/haproxy.benchmark.cfg @@ -0,0 +1,34 @@ +global + log stdout format raw local0 + +defaults + mode http + log global + option httplog + option forwardfor + timeout connect 1s + timeout client 30s + timeout server 10s + timeout check 2s + retries 2 + +resolvers docker + nameserver dns 127.0.0.11:53 + resolve_retries 3 + timeout resolve 1s + timeout retry 1s + hold valid 2s + hold obsolete 2s + +frontend http + bind :8080 + default_backend api + +backend api + balance roundrobin + option httpchk + http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host localhost + http-check expect status 200 + default-server check inter 2s fall 1 rise 2 resolvers docker resolve-prefer ipv4 init-addr libc,none + server-template api 4 api:8080 + diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg new file mode 100644 index 00000000..00f0b6c7 --- /dev/null +++ b/infra/haproxy.cfg @@ -0,0 +1,35 @@ +global + log stdout format raw local0 + +defaults + mode http + log global + option httplog + option forwardfor + timeout connect 1s + timeout client 30s + timeout server 10s + timeout check 2s + retries 2 + +resolvers docker + nameserver dns 127.0.0.11:53 + resolve_retries 3 + timeout resolve 1s + timeout retry 1s + hold valid 2s + hold obsolete 2s + +frontend http + bind :8080 + default_backend api + +backend api + balance roundrobin + option httpchk + http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host localhost + http-check expect status 200 + default-server check inter 2s fall 1 rise 2 resolvers docker resolve-prefer ipv4 init-addr libc,none + server api-a api-a:8080 + server api-b api-b:8080 + diff --git a/infra/nginx.benchmark.conf b/infra/nginx.benchmark.conf new file mode 100644 index 00000000..5acf10c8 --- /dev/null +++ b/infra/nginx.benchmark.conf @@ -0,0 +1,26 @@ +# Historical configuration used for evidence/track1/raw from 2026-10-14. +# Current compose.benchmark.yaml uses haproxy.benchmark.cfg. +upstream messenger_api { + zone messenger_api 64k; + resolver 127.0.0.11 valid=2s ipv6=off; + resolver_timeout 1s; + least_conn; + server api:8080 resolve max_fails=1 fail_timeout=2s; + keepalive 16; +} + +server { + listen 8080; + + location / { + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header Connection ""; + proxy_connect_timeout 1s; + proxy_read_timeout 5s; + proxy_next_upstream error timeout http_502 http_503 http_504; + proxy_next_upstream_tries 2; + proxy_pass http://messenger_api; + } +} diff --git a/infra/nginx.conf b/infra/nginx.conf new file mode 100644 index 00000000..a5ddb273 --- /dev/null +++ b/infra/nginx.conf @@ -0,0 +1,27 @@ +# Historical configuration used for evidence dated 2026-10-14. +# Current compose.yaml uses haproxy.cfg with active readiness checks. +upstream messenger_api { + zone messenger_api 64k; + resolver 127.0.0.11 valid=2s ipv6=off; + resolver_timeout 1s; + least_conn; + server api-a:8080 resolve max_fails=1 fail_timeout=2s; + server api-b:8080 resolve max_fails=1 fail_timeout=2s; + keepalive 16; +} + +server { + listen 8080; + + location / { + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header Connection ""; + proxy_connect_timeout 1s; + proxy_read_timeout 5s; + proxy_next_upstream error timeout http_502 http_503 http_504; + proxy_next_upstream_tries 2; + proxy_pass http://messenger_api; + } +} diff --git a/migrations/001_initial.sql b/migrations/001_initial.sql new file mode 100644 index 00000000..c03d5fd9 --- /dev/null +++ b/migrations/001_initial.sql @@ -0,0 +1,37 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username varchar(32) NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name varchar(100) NOT NULL CHECK (char_length(btrim(display_name)) > 0), + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title varchar(100) NOT NULL CHECK (char_length(btrim(title)) > 0), + created_at timestamptz NOT NULL DEFAULT now() +); + +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE RESTRICT, + PRIMARY KEY (chat_id, user_id) +); +CREATE INDEX chat_members_user_chat_idx ON chat_members (user_id, chat_id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users(id) ON DELETE RESTRICT, + text varchar(4000) NOT NULL CHECK (char_length(btrim(text)) > 0), + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX messages_chat_created_id_idx ON messages (chat_id, created_at, id); + +CREATE TABLE sessions ( + token_hash char(64) PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + expires_at timestamptz NOT NULL, + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX sessions_expiry_idx ON sessions (expires_at); diff --git a/migrations/002_history_cache_version.sql b/migrations/002_history_cache_version.sql new file mode 100644 index 00000000..7b7972c1 --- /dev/null +++ b/migrations/002_history_cache_version.sql @@ -0,0 +1 @@ +ALTER TABLE chats ADD COLUMN history_version bigint NOT NULL DEFAULT 0; diff --git a/migrations/003_idempotency.sql b/migrations/003_idempotency.sql new file mode 100644 index 00000000..7fcf6650 --- /dev/null +++ b/migrations/003_idempotency.sql @@ -0,0 +1,12 @@ +CREATE TABLE idempotency_records ( + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + method varchar(8) NOT NULL, + path text NOT NULL, + idempotency_key varchar(128) NOT NULL, + request_hash char(64) NOT NULL, + message_id uuid REFERENCES messages(id) ON DELETE RESTRICT, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (user_id, method, path, idempotency_key) +); + +CREATE INDEX idempotency_records_created_at_idx ON idempotency_records (created_at); diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 00000000..988cea4c --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,12 @@ +[project] +name = "mtusi2026lab3" +version = "0.1.0" +description = "MTUSI high-load messenger, laboratory 3" +readme = "README.md" +requires-python = ">=3.12" +dependencies = [ + "argon2-cffi==25.1.0", + "asyncpg==0.31.0", + "fastapi==0.141.1", + "uvicorn==0.40.0", +] diff --git a/scripts/explain_history.sh b/scripts/explain_history.sh new file mode 100755 index 00000000..cec693a3 --- /dev/null +++ b/scripts/explain_history.sh @@ -0,0 +1,35 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." + +docker compose exec -T postgres psql -U messenger -d messenger -v ON_ERROR_STOP=1 <<'SQL' +INSERT INTO users (id, username, display_name, password_hash) +VALUES ('aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa', 'plan_user', 'Plan user', 'not-used') +ON CONFLICT (id) DO NOTHING; + +INSERT INTO chats (id, title) +VALUES ('bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb', 'Plan history') +ON CONFLICT (id) DO NOTHING; + +INSERT INTO chat_members (chat_id, user_id) +VALUES ('bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb', 'aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa') +ON CONFLICT DO NOTHING; + +INSERT INTO messages (id, chat_id, sender_id, text, created_at) +SELECT + ('00000000-0000-4000-8000-' || lpad(item::text, 12, '0'))::uuid, + 'bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb', + 'aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa', + 'plan message ' || item, + '2026-01-01T00:00:00Z'::timestamptz + item * interval '1 microsecond' +FROM generate_series(1, 10000) AS item +ON CONFLICT (id) DO NOTHING; + +ANALYZE messages; +EXPLAIN (ANALYZE, BUFFERS) +SELECT id, chat_id, sender_id, text, created_at +FROM messages +WHERE chat_id = 'bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb' +ORDER BY created_at, id +LIMIT 50; +SQL diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..e0d9abaa --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,7 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +docker compose restart postgres +docker compose up -d --wait postgres +docker compose restart api-a api-b load_balancer +docker compose up -d --wait api-a api-b load_balancer diff --git a/scripts/rolling-update.sh b/scripts/rolling-update.sh new file mode 100755 index 00000000..8c47717f --- /dev/null +++ b/scripts/rolling-update.sh @@ -0,0 +1,10 @@ +#!/bin/sh +set -eu + +# Equivalent to a rolling update for this two-replica Compose topology. +# Build the image separately; this hook only replaces one healthy API process at a time. +cd "$(dirname "$0")/.." + +for service in api-a api-b; do + docker compose up -d --no-deps --force-recreate --wait "$service" +done diff --git a/scripts/run-track1.sh b/scripts/run-track1.sh new file mode 100755 index 00000000..dd3eca4c --- /dev/null +++ b/scripts/run-track1.sh @@ -0,0 +1,13 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." + +# 1/2/4 replicas: identical total budget of 2 vCPU and 1024 MiB for all APIs. +python3 student-tests/track1_benchmark.py --label fixed-1 --replicas 1 --api-cpus 2.0 --api-memory 1024M +python3 student-tests/track1_benchmark.py --label fixed-2 --replicas 2 --api-cpus 1.0 --api-memory 512M +python3 student-tests/track1_benchmark.py --label fixed-4 --replicas 4 --api-cpus 0.5 --api-memory 256M + +# Resource-growth series: 4 vCPU and 2048 MiB for all APIs. +python3 student-tests/track1_benchmark.py --label growth-2 --replicas 2 --api-cpus 2.0 --api-memory 1024M +python3 student-tests/track1_benchmark.py --label growth-4 --replicas 4 --api-cpus 1.0 --api-memory 512M +python3 student-tests/render_track1_svg.py diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 00000000..befd6cfb --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,18 @@ +#!/bin/sh +set -eu + +: "${TARGET_INSTANCE_ID:?test provides target API instance alias}" +cd "$(dirname "$0")/.." + +for service in api-a api-b; do + container="$(docker compose ps -q "$service")" + [ -n "$container" ] || continue + hostname="$(docker inspect --format '{{.Config.Hostname}}' "$container")" + if [ "$hostname" = "$TARGET_INSTANCE_ID" ]; then + docker compose stop "$service" + exit 0 + fi +done + +printf '%s\n' 'TARGET_INSTANCE_ID does not match a running API replica' >&2 +exit 2 diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/src/__init__.py @@ -0,0 +1 @@ + diff --git a/src/config.py b/src/config.py new file mode 100644 index 00000000..f68a8b0c --- /dev/null +++ b/src/config.py @@ -0,0 +1,117 @@ +from dataclasses import dataclass +import os +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] +_CONFIGURATION_KEYS = { + "APP_HOST", + "APP_PORT", + "APP_ENV", + "DATABASE_URL", + "DATABASE_URL_FILE", + "SESSION_TTL_SECONDS", + "IDEMPOTENCY_TTL_SECONDS", + "INSTANCE_ID", + "CURSOR_SECRET", + "CURSOR_SECRET_FILE", +} + + +@dataclass(frozen=True, slots=True) +class Settings: + """Проверенная конфигурация запуска HTTP-сервера.""" + + host: str + port: int + environment: str + database_url: str + session_ttl_seconds: int + idempotency_ttl_seconds: int + instance_id: str + cursor_secret: bytes + + +def load_settings(env_file: Path = ROOT / ".env") -> Settings: + """Читает разрешённые ключи .env, не заменяя явно переданное окружение.""" + + if env_file.is_file(): + for raw_line in env_file.read_text(encoding="utf-8").splitlines(): + line = raw_line.strip() + if not line or line.startswith("#"): + continue + key, separator, value = line.partition("=") + if not separator or key not in _CONFIGURATION_KEYS: + continue + value = value.strip() + if len(value) >= 2 and value[0] == value[-1] and value[0] in {"'", '"'}: + value = value[1:-1] + os.environ.setdefault(key, value) + + def value(name: str, default: str = "") -> str: + return os.environ.get(name, default).strip() + + def number(name: str, default: int) -> int: + try: + result = int(value(name, str(default))) + except ValueError as error: + raise ValueError(f"{name} должен быть целым числом") from error + if result < 1: + raise ValueError(f"{name} должен быть положительным") + return result + + def url(name: str, file_name: str, prefixes: tuple[str, ...]) -> str: + result = value(name) + path = value(file_name) + if path: + try: + result = Path(path).read_text(encoding="utf-8").strip() + except OSError as error: + raise ValueError(f"{file_name} недоступен") from error + if result and not result.startswith(prefixes): + raise ValueError(f"{name} содержит неверный URL") + return result + + def secret(name: str, file_name: str) -> bytes: + result = value(name) + path = value(file_name) + if path: + try: + result = Path(path).read_text(encoding="utf-8").strip() + except OSError as error: + raise ValueError(f"{file_name} недоступен") from error + encoded = result.encode("utf-8") + if len(encoded) < 32: + raise ValueError(f"{name} должен содержать не менее 32 байт") + return encoded + + host = value("APP_HOST", "0.0.0.0") + environment = value("APP_ENV", "lab") + if not host: + raise ValueError("APP_HOST не может быть пустым") + if not environment: + raise ValueError("APP_ENV не может быть пустым") + port = number("APP_PORT", 8080) + if port > 65535: + raise ValueError("APP_PORT должен находиться в диапазоне 1..65535") + database_url = url( + "DATABASE_URL", "DATABASE_URL_FILE", ("postgresql://", "postgres://") + ) + if not database_url: + raise ValueError("Нужен PostgreSQL DATABASE_URL или DATABASE_URL_FILE") + instance_id = value("INSTANCE_ID") or os.uname().nodename + if not instance_id: + raise ValueError("INSTANCE_ID не может быть пустым") + idempotency_ttl_seconds = number("IDEMPOTENCY_TTL_SECONDS", 86400) + if idempotency_ttl_seconds < 86400: + raise ValueError("IDEMPOTENCY_TTL_SECONDS должен быть не менее 86400") + return Settings( + host=host, + port=port, + environment=environment, + database_url=database_url, + session_ttl_seconds=number("SESSION_TTL_SECONDS", 3600), + idempotency_ttl_seconds=idempotency_ttl_seconds, + instance_id=instance_id, + cursor_secret=secret("CURSOR_SECRET", "CURSOR_SECRET_FILE"), + ) diff --git a/src/cursor.py b/src/cursor.py new file mode 100644 index 00000000..5dd8eab3 --- /dev/null +++ b/src/cursor.py @@ -0,0 +1,81 @@ +import base64 +from datetime import UTC, datetime +import hashlib +import hmac +import json +from uuid import UUID + + +_secret: bytes | None = None + + +class CursorError(ValueError): + """Недопустимый, повреждённый или применённый не к тому ресурсу курсор.""" + + +def configure_secret(secret: bytes) -> None: + """Устанавливает общий для всех реплик ключ подписи курсоров.""" + global _secret + if len(secret) < 32: + raise ValueError("cursor secret must contain at least 32 bytes") + _secret = secret + + +def signing_secret() -> bytes: + if _secret is None: + raise RuntimeError("cursor secret has not been configured") + return _secret + + +def _encode_bytes(value: bytes) -> str: + return base64.urlsafe_b64encode(value).decode().rstrip("=") + + +def _decode_bytes(value: str) -> bytes: + try: + return base64.urlsafe_b64decode(value + "=" * (-len(value) % 4)) + except (ValueError, UnicodeEncodeError) as error: + raise CursorError from error + + +def encode_cursor(scope: str, created_at: datetime, item_id: str) -> str: + payload = json.dumps( + { + "scope": scope, + "created_at": created_at.astimezone(UTC) + .isoformat() + .replace("+00:00", "Z"), + "id": item_id, + }, + separators=(",", ":"), + sort_keys=True, + ).encode() + signature = hmac.new(signing_secret(), payload, hashlib.sha256).digest() + return _encode_bytes(payload) + "." + _encode_bytes(signature) + + +def decode_cursor(cursor: str, expected_scope: str) -> tuple[datetime, str]: + try: + encoded_payload, encoded_signature = cursor.split(".") + payload = _decode_bytes(encoded_payload) + signature = _decode_bytes(encoded_signature) + except ValueError as error: + raise CursorError from error + + expected_signature = hmac.new(signing_secret(), payload, hashlib.sha256).digest() + if not hmac.compare_digest(signature, expected_signature): + raise CursorError + + try: + data = json.loads(payload) + if set(data) != {"scope", "created_at", "id"}: + raise CursorError + if data["scope"] != expected_scope: + raise CursorError + item_id = str(UUID(data["id"])) + created_at = datetime.fromisoformat(data["created_at"].replace("Z", "+00:00")) + if created_at.tzinfo is None: + raise CursorError + return created_at.astimezone(UTC), item_id + except (TypeError, ValueError, KeyError) as error: + raise CursorError from error diff --git a/src/errors.py b/src/errors.py new file mode 100644 index 00000000..258d6996 --- /dev/null +++ b/src/errors.py @@ -0,0 +1,12 @@ +"""Ошибки, которые преобразуются в контрактные HTTP-ответы.""" + + +class ApiError(Exception): + + def __init__( + self, status_code: int, code: str, message: str, headers: dict[str, str] | None = None + ) -> None: + self.status_code = status_code + self.code = code + self.message = message + self.headers = headers or {} diff --git a/src/main.py b/src/main.py new file mode 100644 index 00000000..cd876651 --- /dev/null +++ b/src/main.py @@ -0,0 +1,161 @@ +import logging +import sys +import time +from contextlib import asynccontextmanager +from uuid import uuid4 + +from fastapi import FastAPI, Request +from fastapi.exceptions import RequestValidationError +import uvicorn +from starlette.responses import JSONResponse, Response +from starlette.exceptions import HTTPException + +from .errors import ApiError +from .cursor import configure_secret +from .models import ErrorDetails, ErrorResponse +from .config import load_settings +from .routes import router +from .storage.postgres import PostgresStore + + +def logger(name: str) -> logging.Logger: + result = logging.getLogger(name) + if result.handlers: + return result + handler = logging.StreamHandler(sys.stdout) + handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(name)s %(message)s")) + result.addHandler(handler) + result.setLevel(logging.INFO) + result.propagate = False + return result + + +access_logger = logger("messenger.access") + + +@asynccontextmanager +async def lifespan(application: FastAPI): + settings = load_settings() + configure_secret(settings.cursor_secret) + store = PostgresStore(settings.database_url) + await store.connect() + application.state.store = store + application.state.settings = settings + application.state.accepting_requests = True + try: + yield + finally: + application.state.accepting_requests = False + await store.close() + + +app = FastAPI( + title="MTUSI Messenger", + version="1.3.0", + redoc_url=None, + lifespan=lifespan, +) + + +@app.middleware("http") +async def add_request_id(request: Request, call_next) -> Response: + """Добавляет ID запроса и пишет безопасную строку access-лога.""" + + request.state.request_id = str(uuid4()) + started_at = time.monotonic() + status_code = 500 + try: + response = await call_next(request) + status_code = response.status_code + response.headers["X-Request-Id"] = request.state.request_id + response.headers["X-Instance-Id"] = request.app.state.settings.instance_id + return response + finally: + access_logger.info( + "request_id=%s method=%s path=%s status=%s elapsed_ms=%.3f", + request.state.request_id, + request.method, + request.url.path, + status_code, + (time.monotonic() - started_at) * 1000, + ) + + +def error_response( + request: Request, status_code: int, code: str, message: str, headers: dict[str, str] | None = None +) -> JSONResponse: + request_id = request.state.request_id + body = ErrorResponse( + error=ErrorDetails(code=code, message=message, request_id=request_id) + ) + # Неожиданная ошибка обрабатывается за пределами HTTP-middleware. + # Поэтому её ответ тоже должен сам получить заголовок из контракта. + return JSONResponse( + status_code=status_code, + content=body.model_dump(), + headers={ + "X-Request-Id": request_id, + "X-Instance-Id": request.app.state.settings.instance_id, + **(headers or {}), + }, + ) + + +@app.exception_handler(ApiError) +async def handle_api_error(request: Request, error: ApiError) -> JSONResponse: + """Преобразует контролируемую ошибку API в стандартный JSON-ответ.""" + + return error_response(request, error.status_code, error.code, error.message, error.headers) + + +@app.exception_handler(RequestValidationError) +async def handle_validation_error( + request: Request, error: RequestValidationError +) -> JSONResponse: + """Преобразует ошибки JSON и Pydantic в обязательный ответ 400.""" + + return error_response(request, 400, "invalid_request", "Некорректный запрос") + + +@app.exception_handler(HTTPException) +async def handle_http_error(request: Request, error: HTTPException) -> JSONResponse: + """Включает ошибки декодирования тела, возникающие до Pydantic.""" + codes = { + 400: "invalid_request", + 401: "unauthorized", + 403: "forbidden", + 404: "not_found", + 405: "method_not_allowed", + 503: "unavailable", + } + code = codes.get(error.status_code, "internal_error") + return error_response( + request, error.status_code, code, + "Некорректный запрос" if error.status_code < 500 else "Ошибка сервера", + error.headers, + ) + + +@app.exception_handler(Exception) +async def handle_unexpected_error(request: Request, error: Exception) -> JSONResponse: + """Не раскрывает внутренние детали при непредвиденной ошибке приложения.""" + + return error_response(request, 500, "internal_error", "Внутренняя ошибка сервера") + + +app.include_router(router) + + +def main() -> None: + settings = load_settings() + uvicorn.run( + app, + host=settings.host, + port=settings.port, + access_log=False, + timeout_graceful_shutdown=8, + ) + + +if __name__ == "__main__": + main() diff --git a/src/migrate.py b/src/migrate.py new file mode 100644 index 00000000..4376e8d6 --- /dev/null +++ b/src/migrate.py @@ -0,0 +1,18 @@ +import asyncio + +from .config import load_settings +from .storage.postgres import PostgresStore + + +async def run() -> None: + settings = load_settings() + store = PostgresStore(settings.database_url) + await store.connect() + try: + await store.migrate() + finally: + await store.close() + + +if __name__ == "__main__": + asyncio.run(run()) diff --git a/src/models.py b/src/models.py new file mode 100644 index 00000000..095ec1a2 --- /dev/null +++ b/src/models.py @@ -0,0 +1,116 @@ +from datetime import datetime +from uuid import UUID + +from pydantic import BaseModel, ConfigDict, Field, field_validator + +class CreateUserRequest(BaseModel): + model_config = ConfigDict(extra="forbid", strict=True) + + username: str = Field(min_length=3, max_length=32, pattern=r"^[a-z0-9_]{3,32}$") + display_name: str = Field(min_length=1, max_length=100) + password: str = Field(min_length=12, max_length=128) + + @field_validator("display_name") + @classmethod + def display_name_must_not_be_whitespace(cls, value: str) -> str: + """Не допускает обязательное имя, состоящее только из пробелов.""" + + if not value.strip(): + raise ValueError("display_name не может состоять только из пробелов") + return value + + +class CreateChatRequest(BaseModel): + model_config = ConfigDict(extra="forbid") + + title: str = Field(min_length=1, max_length=100) + member_ids: list[UUID] = Field(min_length=1, max_length=100) + + @field_validator("title") + @classmethod + def title_must_not_be_whitespace(cls, value: str) -> str: + """Не допускает обязательное название, состоящее только из пробелов.""" + + if not value.strip(): + raise ValueError("title не может состоять только из пробелов") + return value + + +class ChatPageResponse(BaseModel): + model_config = ConfigDict(extra="forbid") + + items: list["Chat"] + next_cursor: str | None + + +class CreateMessageRequest(BaseModel): + model_config = ConfigDict(extra="forbid", strict=True) + + text: str = Field(min_length=1, max_length=4000) + + @field_validator("text") + @classmethod + def text_must_not_be_whitespace(cls, value: str) -> str: + """Не допускает сообщение, состоящее только из пробельных символов.""" + + if not value.strip(): + raise ValueError("text не может состоять только из пробелов") + return value + + +class MessagePageResponse(BaseModel): + model_config = ConfigDict(extra="forbid") + + items: list["Message"] + next_cursor: str | None + + +class ErrorDetails(BaseModel): + model_config = ConfigDict(extra="forbid") + + code: str + message: str + request_id: str + + +class ErrorResponse(BaseModel): + model_config = ConfigDict(extra="forbid") + + error: ErrorDetails + + +class User(BaseModel): + model_config = ConfigDict(extra="forbid") + + id: UUID + username: str + display_name: str + created_at: datetime + + +class Chat(BaseModel): + model_config = ConfigDict(extra="forbid") + + id: UUID + title: str + member_ids: list[UUID] + created_at: datetime + + +class Message(BaseModel): + model_config = ConfigDict(extra="forbid") + + id: UUID + chat_id: UUID + sender_id: UUID + text: str + created_at: datetime + + +class Session(BaseModel): + model_config = ConfigDict(extra="forbid") + + token: str = Field(min_length=32) + token_type: str = "Bearer" + expires_at: datetime + user: User diff --git a/src/routes.py b/src/routes.py new file mode 100644 index 00000000..c07e4056 --- /dev/null +++ b/src/routes.py @@ -0,0 +1,181 @@ +import base64 +import re +from datetime import datetime +from uuid import UUID + +from fastapi import APIRouter, Depends, Header, Query, Request, Response + +from .cursor import CursorError, decode_cursor, encode_cursor +from .errors import ApiError +from .storage.postgres import PostgresStore +from .models import ( + Chat, + ChatPageResponse, + CreateChatRequest, + CreateMessageRequest, + CreateUserRequest, + Message, + MessagePageResponse, + Session, + User, +) + +router = APIRouter() +BEARER_CHALLENGE = {"WWW-Authenticate": 'Bearer realm="messenger"'} +BASIC_CHALLENGE = {"WWW-Authenticate": 'Basic realm="messenger", charset="UTF-8"'} +IDEMPOTENCY_KEY = re.compile(r"^[A-Za-z0-9._:-]{1,128}$") + +def get_store(request: Request) -> PostgresStore: + return request.app.state.store + + +async def get_current_user( + authorization: str | None = Header(default=None), + store: PostgresStore = Depends(get_store), +) -> dict: + if authorization is None or not authorization.startswith("Bearer "): + raise ApiError(401, "unauthorized", "Требуется Bearer-сессия", BEARER_CHALLENGE) + token = authorization[7:] + if not token or not token.isascii() or token.strip() != token: + raise ApiError(401, "unauthorized", "Требуется Bearer-сессия", BEARER_CHALLENGE) + user = await store.user_for_token(token) + if user is None: + raise ApiError(401, "unauthorized", "Недействительная сессия", BEARER_CHALLENGE) + return user + +def parse_basic(authorization: str | None) -> tuple[str, str]: + if authorization is None or not authorization.startswith("Basic "): + raise ApiError(401, "unauthorized", "Неверные учётные данные", BASIC_CHALLENGE) + try: + decoded = base64.b64decode(authorization[6:], validate=True) + username_bytes, password_bytes = decoded.split(b":", 1) + username = username_bytes.decode("ascii") + password = password_bytes.decode("utf-8") + except (UnicodeDecodeError, ValueError) as error: + raise ApiError(401, "unauthorized", "Неверные учётные данные", BASIC_CHALLENGE) from error + if not username or not (12 <= len(password) <= 128): + raise ApiError(401, "unauthorized", "Неверные учётные данные", BASIC_CHALLENGE) + return username, password + + +def cursor_position(cursor: str | None, scope: str) -> tuple[datetime, UUID] | None: + if cursor is None: + return None + try: + created_at, item_id = decode_cursor(cursor, scope) + return created_at, UUID(item_id) + except (CursorError, ValueError) as error: + raise ApiError(400, "invalid_request", "Некорректный cursor") from error + + +def next_page_cursor(rows: list[dict], limit: int, scope: str) -> str | None: + if len(rows) <= limit: + return None + last = rows[limit - 1] + return encode_cursor(scope, last["created_at"], str(last["id"])) + +@router.get("/health/live") +async def liveness() -> dict[str, str]: + return {"status": "ok"} + +@router.get("/health/ready") +async def readiness(request: Request, store: PostgresStore = Depends(get_store)) -> dict[str, str]: + if not request.app.state.accepting_requests: + raise ApiError(503, "unavailable", "API завершает работу") + await store.ready() + return {"status": "ok"} + +@router.post("/api/v1/users", response_model=User, status_code=201) +async def register_user( + payload: CreateUserRequest, store: PostgresStore = Depends(get_store) +) -> dict: + return await store.create_user(payload.username, payload.display_name, payload.password) + +@router.post("/api/v1/auth/sessions", response_model=Session, status_code=201) +async def create_session( + request: Request, + authorization: str | None = Header(default=None), + store: PostgresStore = Depends(get_store), +) -> dict: + if await request.body(): + raise ApiError(400, "invalid_request", "Тело запроса не требуется") + username, password = parse_basic(authorization) + user = await store.authenticate(username, password) + if user is None: + raise ApiError(401, "unauthorized", "Неверные учётные данные", BASIC_CHALLENGE) + return await store.create_session(user, request.app.state.settings.session_ttl_seconds) + +@router.delete("/api/v1/auth/sessions/current", status_code=204) +async def revoke_session( + authorization: str | None = Header(default=None), + store: PostgresStore = Depends(get_store), + user: dict = Depends(get_current_user), +) -> Response: + del user + await store.revoke_session(authorization[7:]) + return Response(status_code=204) + +@router.get("/api/v1/users/me", response_model=User) +async def current_user(user: dict = Depends(get_current_user)) -> dict: + return user + +@router.post("/api/v1/chats", response_model=Chat, status_code=201) +async def create_chat( + payload: CreateChatRequest, + user: dict = Depends(get_current_user), + store: PostgresStore = Depends(get_store), +) -> dict: + return await store.create_chat(user["id"], payload.title, payload.member_ids) + +@router.get("/api/v1/chats", response_model=ChatPageResponse) +async def list_chats( + user: dict = Depends(get_current_user), + store: PostgresStore = Depends(get_store), + limit: int = Query(default=50, ge=1, le=100), + cursor: str | None = Query(default=None, min_length=1), +) -> ChatPageResponse: + scope = "chats:" + str(user["id"]) + rows = await store.list_chats_for_member(user["id"], cursor_position(cursor, scope), limit) + page = rows[:limit] + return ChatPageResponse(items=page, next_cursor=next_page_cursor(rows, limit, scope)) + +@router.get("/api/v1/chats/{chat_id}", response_model=Chat) +async def get_chat( + chat_id: UUID, + user: dict = Depends(get_current_user), + store: PostgresStore = Depends(get_store), +) -> dict: + return await store.get_chat_for_member(chat_id, user["id"]) + +@router.post("/api/v1/chats/{chat_id}/messages", response_model=Message, status_code=201) +async def create_message( + chat_id: UUID, + payload: CreateMessageRequest, + request: Request, + idempotency_key: str | None = Header(default=None, alias="Idempotency-Key"), + user: dict = Depends(get_current_user), + store: PostgresStore = Depends(get_store), +) -> dict: + if idempotency_key is None or IDEMPOTENCY_KEY.fullmatch(idempotency_key) is None: + raise ApiError(400, "invalid_request", "Некорректный Idempotency-Key") + return await store.create_message_idempotent( + chat_id, + user["id"], + payload.text, + idempotency_key, + request.app.state.settings.idempotency_ttl_seconds, + ) + +@router.get("/api/v1/chats/{chat_id}/messages", response_model=MessagePageResponse) +async def list_messages( + chat_id: UUID, + user: dict = Depends(get_current_user), + store: PostgresStore = Depends(get_store), + limit: int = Query(default=50, ge=1, le=100), + cursor: str | None = Query(default=None, min_length=1), +) -> MessagePageResponse: + scope = "messages:" + str(chat_id) + after = cursor_position(cursor, scope) + rows = await store.list_messages_for_member(chat_id, user["id"], after, limit) + page = rows[:limit] + return MessagePageResponse(items=page, next_cursor=next_page_cursor(rows, limit, scope)) diff --git a/src/storage/__init__.py b/src/storage/__init__.py new file mode 100644 index 00000000..e2e04193 --- /dev/null +++ b/src/storage/__init__.py @@ -0,0 +1,2 @@ +"""Слой in-memory хранения для приложения первой лабораторной работы.""" +"""Persistent storage adapters.""" diff --git a/src/storage/postgres.py b/src/storage/postgres.py new file mode 100644 index 00000000..67b8f815 --- /dev/null +++ b/src/storage/postgres.py @@ -0,0 +1,288 @@ +from datetime import datetime +from hashlib import sha256 +import json +from pathlib import Path +from secrets import token_urlsafe +from uuid import UUID, uuid4 + +import asyncpg +from argon2 import PasswordHasher +from argon2.exceptions import InvalidHashError, VerificationError + +from ..errors import ApiError + + +ROOT = Path(__file__).resolve().parents[2] +MIGRATIONS = ROOT / "migrations" +PASSWORD_HASHER = PasswordHasher() +DB_ERRORS = (asyncpg.PostgresError, asyncpg.InterfaceError, OSError) + + +class PostgresStore: + def __init__(self, database_url: str) -> None: + self._database_url = database_url + self._pool: asyncpg.Pool | None = None + + async def connect(self) -> None: + try: + self._pool = await asyncpg.create_pool( + self._database_url, min_size=1, max_size=10, command_timeout=5 + ) + except DB_ERRORS as error: + raise RuntimeError("PostgreSQL is unavailable") from error + + async def close(self) -> None: + if self._pool is not None: + await self._pool.close() + + @property + def pool(self) -> asyncpg.Pool: + if self._pool is None: + raise RuntimeError("PostgreSQL pool has not been initialized") + return self._pool + + async def migrate(self) -> None: + async with self.pool.acquire() as connection: + await connection.execute( + "CREATE TABLE IF NOT EXISTS schema_migrations (version text PRIMARY KEY, applied_at timestamptz NOT NULL DEFAULT now())" + ) + for migration in sorted(MIGRATIONS.glob("*.sql")): + applied = await connection.fetchval( + "SELECT 1 FROM schema_migrations WHERE version = $1", migration.name + ) + if applied: + continue + async with connection.transaction(): + await connection.execute(migration.read_text(encoding="utf-8")) + await connection.execute( + "INSERT INTO schema_migrations (version) VALUES ($1)", migration.name + ) + + @staticmethod + def _user(row: asyncpg.Record) -> dict: + return { + "id": row["id"], + "username": row["username"], + "display_name": row["display_name"], + "created_at": row["created_at"], + } + + @staticmethod + def _chat(row: asyncpg.Record) -> dict: + return { + "id": row["id"], + "title": row["title"], + "member_ids": row["member_ids"], + "created_at": row["created_at"], + } + + @staticmethod + def _message(row: asyncpg.Record) -> dict: + return { + "id": row["id"], + "chat_id": row["chat_id"], + "sender_id": row["sender_id"], + "text": row["text"], + "created_at": row["created_at"], + } + + async def ready(self) -> None: + try: + await self.pool.fetchval("SELECT 1") + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + + async def create_user(self, username: str, display_name: str, password: str) -> dict: + try: + row = await self.pool.fetchrow( + "INSERT INTO users (id, username, display_name, password_hash) VALUES ($1, $2, $3, $4) RETURNING id, username, display_name, created_at", + uuid4(), + username, + display_name, + PASSWORD_HASHER.hash(password), + ) + except asyncpg.UniqueViolationError as error: + raise ApiError(409, "conflict", "Username уже занят") from error + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return self._user(row) + + async def authenticate(self, username: str, password: str) -> dict | None: + try: + row = await self.pool.fetchrow( + "SELECT id, username, display_name, created_at, password_hash FROM users WHERE username = $1", + username, + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + if row is None: + return None + try: + valid = PASSWORD_HASHER.verify(row["password_hash"], password) + except (InvalidHashError, VerificationError): + valid = False + return self._user(row) if valid else None + + async def create_session(self, user: dict, ttl_seconds: int) -> dict: + token = token_urlsafe(32) + token_hash = sha256(token.encode("ascii")).hexdigest() + try: + row = await self.pool.fetchrow( + "INSERT INTO sessions (token_hash, user_id, expires_at) VALUES ($1, $2, now() + $3 * interval '1 second') RETURNING expires_at", + token_hash, + user["id"], + ttl_seconds, + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return {"token": token, "token_type": "Bearer", "expires_at": row["expires_at"], "user": user} + + async def user_for_token(self, token: str) -> dict | None: + if not token.isascii(): + return None + token_hash = sha256(token.encode("ascii")).hexdigest() + try: + row = await self.pool.fetchrow( + "SELECT u.id, u.username, u.display_name, u.created_at FROM sessions s JOIN users u ON u.id = s.user_id WHERE s.token_hash = $1 AND s.expires_at > now()", + token_hash, + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return self._user(row) if row else None + + async def revoke_session(self, token: str) -> None: + try: + await self.pool.execute( + "DELETE FROM sessions WHERE token_hash = $1", sha256(token.encode("ascii")).hexdigest() + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + + async def create_chat(self, creator_id: UUID, title: str, member_ids: list[UUID]) -> dict: + if len(member_ids) != len(set(member_ids)) or creator_id not in member_ids: + raise ApiError(400, "invalid_request", "Некорректный список участников") + try: + async with self.pool.acquire() as connection, connection.transaction(): + existing = await connection.fetchval( + "SELECT count(*) FROM users WHERE id = ANY($1::uuid[])", member_ids + ) + if existing != len(member_ids): + raise ApiError(400, "invalid_request", "Один или несколько участников не существуют") + row = await connection.fetchrow( + "INSERT INTO chats (id, title) VALUES ($1, $2) RETURNING id, title, created_at", + uuid4(), + title, + ) + await connection.executemany( + "INSERT INTO chat_members (chat_id, user_id) VALUES ($1, $2)", + [(row["id"], member_id) for member_id in member_ids], + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return { + "id": row["id"], + "title": row["title"], + "member_ids": member_ids, + "created_at": row["created_at"], + } + + async def get_chat_for_member(self, chat_id: UUID, user_id: UUID) -> dict: + try: + row = await self.pool.fetchrow( + "SELECT c.id, c.title, c.created_at, array_agg(cm_all.user_id ORDER BY cm_all.user_id) AS member_ids FROM chats c JOIN chat_members mine ON mine.chat_id = c.id AND mine.user_id = $2 JOIN chat_members cm_all ON cm_all.chat_id = c.id WHERE c.id = $1 GROUP BY c.id", + chat_id, + user_id, + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + if row is None: + raise ApiError(404, "not_found", "Чат не найден") + return self._chat(row) + + async def list_chats_for_member( + self, user_id: UUID, after: tuple[datetime, UUID] | None, limit: int + ) -> list[dict]: + query = "SELECT c.id, c.title, c.created_at, array_agg(cm_all.user_id ORDER BY cm_all.user_id) AS member_ids FROM chats c JOIN chat_members mine ON mine.chat_id = c.id AND mine.user_id = $1 JOIN chat_members cm_all ON cm_all.chat_id = c.id" + args: list = [user_id] + if after is not None: + query += " WHERE (c.created_at, c.id) > ($2, $3)" + args.extend(after) + query += " GROUP BY c.id ORDER BY c.created_at, c.id LIMIT $" + str(len(args) + 1) + args.append(limit + 1) + try: + rows = await self.pool.fetch(query, *args) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return [self._chat(row) for row in rows] + + async def create_message_idempotent( + self, chat_id: UUID, sender_id: UUID, text: str, idempotency_key: str, ttl_seconds: int + ) -> dict: + """Создаёт сообщение и фиксирует результат retry в одной транзакции.""" + path = f"/api/v1/chats/{chat_id}/messages" + request_hash = sha256( + json.dumps({"text": text}, ensure_ascii=False, separators=(",", ":"), sort_keys=True).encode("utf-8") + ).hexdigest() + try: + async with self.pool.acquire() as connection, connection.transaction(): + member = await connection.fetchval( + "SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", chat_id, sender_id + ) + if member is None: + raise ApiError(404, "not_found", "Чат не найден") + await connection.execute( + "DELETE FROM idempotency_records WHERE created_at <= now() - $1 * interval '1 second'", ttl_seconds + ) + claimed = await connection.fetchrow( + "INSERT INTO idempotency_records (user_id, method, path, idempotency_key, request_hash) " + "VALUES ($1, 'POST', $2, $3, $4) ON CONFLICT DO NOTHING RETURNING message_id", + sender_id, path, idempotency_key, request_hash, + ) + if claimed is None: + recorded = await connection.fetchrow( + "SELECT request_hash, message_id FROM idempotency_records " + "WHERE user_id = $1 AND method = 'POST' AND path = $2 AND idempotency_key = $3 FOR UPDATE", + sender_id, path, idempotency_key, + ) + if recorded is None: + raise ApiError(503, "unavailable", "Не удалось получить результат идемпотентного запроса") + if recorded["request_hash"] != request_hash: + raise ApiError(409, "conflict", "Idempotency-Key использован с другим телом") + if recorded["message_id"] is None: + raise ApiError(503, "unavailable", "Не удалось получить результат идемпотентного запроса") + row = await connection.fetchrow( + "SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE id = $1", recorded["message_id"] + ) + if row is None: + raise ApiError(503, "unavailable", "Не удалось получить сохранённое сообщение") + return self._message(row) + row = await connection.fetchrow( + "INSERT INTO messages (id, chat_id, sender_id, text) VALUES ($1, $2, $3, $4) " + "RETURNING id, chat_id, sender_id, text, created_at", + uuid4(), chat_id, sender_id, text, + ) + await connection.execute( + "UPDATE idempotency_records SET message_id = $1 WHERE user_id = $2 AND method = 'POST' " + "AND path = $3 AND idempotency_key = $4", + row["id"], sender_id, path, idempotency_key, + ) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return self._message(row) + + async def list_messages_for_member( + self, chat_id: UUID, user_id: UUID, after: tuple[datetime, UUID] | None, limit: int + ) -> list[dict]: + await self.get_chat_for_member(chat_id, user_id) + query = "SELECT id, chat_id, sender_id, text, created_at FROM messages WHERE chat_id = $1" + args: list = [chat_id] + if after is not None: + query += " AND (created_at, id) > ($2, $3)" + args.extend(after) + query += " ORDER BY created_at, id LIMIT $" + str(len(args) + 1) + args.append(limit + 1) + try: + rows = await self.pool.fetch(query, *args) + except DB_ERRORS as error: + raise ApiError(503, "unavailable", "PostgreSQL недоступен") from error + return [self._message(row) for row in rows] diff --git a/student-tests/idempotency_concurrency.py b/student-tests/idempotency_concurrency.py new file mode 100755 index 00000000..fcf958f4 --- /dev/null +++ b/student-tests/idempotency_concurrency.py @@ -0,0 +1,32 @@ +#!/usr/bin/env python3 +"""Один ключ одновременно через LB создаёт ровно одно сообщение.""" +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path +import sys +import uuid + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, check, run # noqa: E402 + + +def main() -> None: + client = Client() + alice, _bob, _eve, chat = client.bootstrap() + key = uuid.uuid4().hex + text = "concurrent idempotency " + key + + def send(_number: int): + return Client().message(alice, chat, text, key=key)["json"] + + with ThreadPoolExecutor(max_workers=16) as pool: + replies = list(pool.map(send, range(16))) + check(all(reply == replies[0] for reply in replies), "replays returned different messages") + + path = "/api/v1/chats/" + chat["id"] + "/messages?limit=100" + history = client.call("GET", path, actor=alice, schema="MessagePage")["json"]["items"] + check(sum(message["id"] == replies[0]["id"] for message in history) == 1, "concurrent retries created duplicates") + print("PASS: concurrent idempotency through load balancer") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/readiness_failover.py b/student-tests/readiness_failover.py new file mode 100644 index 00000000..cdb6c0a6 --- /dev/null +++ b/student-tests/readiness_failover.py @@ -0,0 +1,89 @@ +#!/usr/bin/env python3 +"""Запрет БД только для api-a через pg_hba; восстановление в finally.""" +import ipaddress +import json +from pathlib import Path +import subprocess +import sys +import time +import uuid + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / "tests")) +from client import Client, check, run + + +def compose(*args): + return subprocess.check_output(["docker", "compose", *args], cwd=ROOT, text=True).strip() + + +def sql(statement): + return compose("exec", "-T", "postgres", "psql", "-U", "messenger", "-d", + "messenger", "-v", "ON_ERROR_STOP=1", "-Atc", statement) + + +def ready(service): + code = """import urllib.request, urllib.error +try: + print(urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=7).status) +except urllib.error.HTTPError as error: + print(error.code) +""" + return compose("exec", "-T", service, "/app/.venv/bin/python", "-c", code) + + +def main(): + client = Client() + container = json.loads(subprocess.check_output( + ["docker", "inspect", compose("ps", "-q", "api-a")], text=True))[0] + addresses = list(container["NetworkSettings"]["Networks"].values()) + check(len(addresses) == 1, "test expects one API network") + address = str(ipaddress.IPv4Address(addresses[0]["IPAddress"])) + bad_id = container["Config"]["Hostname"] + before = {client.call("GET", "/health/live")["headers"]["X-Instance-Id"] for _ in range(40)} + check(len(before) == 2 and bad_id in before, "both API replicas must be reachable") + check(ready("api-a") == ready("api-b") == "200", "both APIs must be ready") + # Сохраняем исходный pg_hba; чужую оставшуюся резервную копию не перезаписываем. + compose("exec", "-T", "postgres", "sh", "-ec", + 'test ! -e "$PGDATA/pg_hba.conf.readiness-backup"; ' + 'cp -p "$PGDATA/pg_hba.conf" "$PGDATA/pg_hba.conf.readiness-backup"') + try: + compose("exec", "-T", "postgres", "sh", "-ec", + '{ printf "host all all %s/32 reject\\n" "$1"; ' + 'cat "$PGDATA/pg_hba.conf.readiness-backup"; } > "$PGDATA/pg_hba.conf"', + "sh", address) + sql("SELECT pg_reload_conf()") + time.sleep(0.5) + sql(f"SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE client_addr = '{address}'::inet") + check(ready("api-a") == "503", "api-a must be unready") + check(ready("api-b") == "200", "api-b must remain ready") + # 2s interval + 2s check timeout, с запасом на планировщик Docker Desktop. + time.sleep(6) + for _ in range(40): + result = client.call("GET", "/health/live", 200) + check(result["headers"]["X-Instance-Id"] != bad_id, "LB selected unready api-a") + for _ in range(20): + result = client.call("POST", "/api/v1/users", 201, body={ + "username": "r_" + uuid.uuid4().hex[:16], + "display_name": "Readiness regression", + "password": "Test-password-" + uuid.uuid4().hex, + }, schema="User") + check(result["headers"]["X-Instance-Id"] != bad_id, "registration reached api-a") + print("PASS: api-a ready=503, api-b ready=200; 40/40 live and 20/20 registrations use api-b") + finally: + compose("exec", "-T", "postgres", "sh", "-ec", + 'mv "$PGDATA/pg_hba.conf.readiness-backup" "$PGDATA/pg_hba.conf"') + sql("SELECT pg_reload_conf()") + deadline = time.monotonic() + 20 + while time.monotonic() < deadline: + observed = {client.call("GET", "/health/live")["headers"]["X-Instance-Id"] for _ in range(10)} + if observed == before: + check(ready("api-a") == "200", "restored api-a must be ready") + print("PASS: database access restored; both API replicas returned to LB") + return + time.sleep(0.5) + raise AssertionError("api-a did not return to LB") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/readiness_unavailable.py b/student-tests/readiness_unavailable.py new file mode 100644 index 00000000..cf4bffa1 --- /dev/null +++ b/student-tests/readiness_unavailable.py @@ -0,0 +1,16 @@ +#!/usr/bin/env python3 +"""Проверка 503 readiness при остановленном PostgreSQL.""" +from pathlib import Path +import sys + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, run # noqa: E402 + + +def main() -> None: + Client().call("GET", "/health/ready", 503) + print("PASS: readiness rejects unavailable PostgreSQL") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/render_track1_svg.py b/student-tests/render_track1_svg.py new file mode 100755 index 00000000..58000f49 --- /dev/null +++ b/student-tests/render_track1_svg.py @@ -0,0 +1,52 @@ +#!/usr/bin/env python3 +"""Renders Track 1 raw JSON results into a small dependency-free SVG chart.""" +import json +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] +ORDER = ["fixed-1", "fixed-2", "fixed-4", "growth-2", "growth-4"] +COLORS = {"fixed": "#2563eb", "growth": "#16a34a"} + + +def main() -> None: + raw = ROOT / "evidence" / "track1" / "raw" + values = [] + for label in ORDER: + data = json.loads((raw / f"{label}.json").read_text(encoding="utf-8")) + values.append((label, data["load"]["successful_rps"], data["load"]["successful_latency_ms"]["p95"])) + maximum = max(value for _, value, _ in values) + width, height, bottom, chart_height = 820, 430, 355, 270 + bars = [] + for index, (label, rps, p95) in enumerate(values): + x = 70 + index * 145 + bar_height = round(rps / maximum * chart_height) + y = bottom - bar_height + color = COLORS["fixed" if label.startswith("fixed") else "growth"] + bars.append( + f'' + f'{rps:.1f}' + f'{label}' + f'p95 {p95:.1f} ms' + ) + ticks = [] + for value in range(0, int(maximum) + 100, 200): + y = bottom - round(value / maximum * chart_height) + ticks.append(f'{value}') + svg = f''' + + +Track 1: successful RPS (closed-loop POST, concurrency 32) +Blue: fixed API total 2 CPU / 1024 MiB. Green: API total 4 CPU / 2048 MiB. +{''.join(ticks)} + +{''.join(bars)} +Data: evidence/track1/raw/*.json. Each point uses a fresh database volume; DB limit 0.75 CPU / 512 MiB. +''' + destination = ROOT / "evidence" / "track1" / "scale.svg" + destination.write_text(svg + "\n", encoding="utf-8") + print(destination.relative_to(ROOT)) + + +if __name__ == "__main__": + main() diff --git a/student-tests/review_regressions.py b/student-tests/review_regressions.py new file mode 100644 index 00000000..7e2bba78 --- /dev/null +++ b/student-tests/review_regressions.py @@ -0,0 +1,32 @@ +#!/usr/bin/env python3 +"""Регрессии ревью: не-ASCII Bearer и невалидная кодировка JSON через LB.""" +from pathlib import Path +import sys + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, arguments, check, run + + +def main(): + args = arguments(__doc__) + client = Client(args.base_url, args.ca_file) + for path in ("/api/v1/users/me", "/api/v1/auth/sessions/current"): + method = "DELETE" if path.endswith("/current") else "GET" + result = client.call(method, path, 401, + headers={"Authorization": "Bearer é"}, schema="Error") + check(result["headers"].get("WWW-Authenticate", "").startswith("Bearer"), + "missing Bearer challenge") + check(result["json"]["error"]["code"] == "unauthorized", "wrong error code") + check(result["json"]["error"]["request_id"] == result["headers"]["X-Request-Id"], + "request IDs differ") + for raw in (b"\xff", b"{", b'{"username":'): + result = client.call("POST", "/api/v1/users", 400, raw=raw, + headers={"Content-Type": "application/json"}, schema="Error") + check(result["json"]["error"]["code"] == "invalid_request", "wrong JSON error code") + check(result["json"]["error"]["request_id"] == result["headers"]["X-Request-Id"], + "request IDs differ") + print("PASS: non-ASCII Bearer returns 401/challenge; malformed JSON returns contract Error/400") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/rolling_update.py b/student-tests/rolling_update.py new file mode 100755 index 00000000..fcd35444 --- /dev/null +++ b/student-tests/rolling_update.py @@ -0,0 +1,100 @@ +#!/usr/bin/env python3 +"""Проверяет поочерёдную замену двух API-реплик под записью через LB.""" +import json +import os +from pathlib import Path +import statistics +import subprocess +import sys +import time +import uuid +from urllib.parse import quote + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, Failure, arguments, check, run # noqa: E402 + + +ROOT = Path(__file__).resolve().parents[1] + + +def history(client: Client, actor: dict, chat: dict) -> list[dict]: + path = "/api/v1/chats/" + chat["id"] + "/messages?limit=100" + messages, cursors = [], set() + while True: + page = client.call("GET", path, actor=actor, schema="MessagePage")["json"] + messages.extend(page["items"]) + cursor = page["next_cursor"] + if cursor is None: + return messages + check(cursor not in cursors, "history cursor cycle after rolling update") + cursors.add(cursor) + path = "/api/v1/chats/" + chat["id"] + "/messages?limit=100&cursor=" + quote(cursor, safe="") + + +def main() -> None: + args = arguments("Sequential API replacement under writes") + action = ROOT / "scripts" / "rolling-update.sh" + check(action.is_file() and os.access(action, os.X_OK), "rolling-update.sh must be executable") + client = Client(args.base_url, args.ca_file, timeout=2) + alice, _bob, _eve, chat = client.bootstrap() + + before = { + client.call("GET", "/api/v1/users/me", actor=alice, schema="User")["headers"]["X-Instance-Id"] + for _ in range(40) + } + check(len(before) >= 2, "less than two API instances observed before rolling update") + + process = subprocess.Popen([str(action)], cwd=ROOT) + started = time.monotonic() + latencies, failures, successful = [], 0, 0 + confirmed_ids = [] + try: + while process.poll() is None: + check(time.monotonic() - started < 90, "rolling update hook exceeded 90 seconds") + key = uuid.uuid4().hex + began = time.monotonic() + try: + message = client.message(alice, chat, "rolling-" + key, key=key)["json"] + successful += 1 + confirmed_ids.append(message["id"]) + latencies.append(time.monotonic() - began) + except Failure: + failures += 1 + time.sleep(0.02) + check(process.wait(timeout=5) == 0, "rolling update hook failed") + finally: + if process.poll() is None: + process.terminate() + process.wait(timeout=5) + + after = { + client.call("GET", "/api/v1/users/me", actor=alice, schema="User")["headers"]["X-Instance-Id"] + for _ in range(40) + } + check(len(after) >= 2, "less than two API instances observed after rolling update") + check(before.isdisjoint(after), "old API instance remained after sequential replacement") + check(successful > 0, "no writes succeeded during rolling update") + stored_ids = {message["id"] for message in history(client, alice, chat)} + check(all(message_id in stored_ids for message_id in confirmed_ids), "confirmed write lost during rolling update") + + elapsed = time.monotonic() - started + ordered = sorted(latencies) + def percentile(fraction: float) -> float | None: + if not ordered: + return None + return round(1000 * ordered[max(0, int(len(ordered) * fraction + 0.999999) - 1)], 3) + + print(json.dumps({ + "instances_before": len(before), + "instances_after": len(after), + "successful_writes": successful, + "failed_writes": failures, + "elapsed_seconds": round(elapsed, 3), + "successful_rps": round(successful / elapsed, 3), + "successful_latency_ms": {"p50": percentile(0.50), "p95": percentile(0.95), "p99": percentile(0.99)}, + }, ensure_ascii=False)) + print("PASS: sequential API replacement preserved writes through load balancer") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/session_expiry.py b/student-tests/session_expiry.py new file mode 100644 index 00000000..37e29fb8 --- /dev/null +++ b/student-tests/session_expiry.py @@ -0,0 +1,20 @@ +#!/usr/bin/env python3 +"""Проверка expiry; запускается при SESSION_TTL_SECONDS=2.""" +from pathlib import Path +import sys +import time + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, check, run # noqa: E402 + + +def main() -> None: + client = Client() + actor = client.user("expiry") + time.sleep(3) + client.call("GET", "/api/v1/users/me", 401, actor=actor) + print("PASS: expired Bearer session was rejected") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/track1_benchmark.py b/student-tests/track1_benchmark.py new file mode 100755 index 00000000..d2a08bd3 --- /dev/null +++ b/student-tests/track1_benchmark.py @@ -0,0 +1,101 @@ +#!/usr/bin/env python3 +"""One reproducible point for Lab 3, Level 5, Track 1.""" +import argparse +import json +import os +from pathlib import Path +import subprocess +import sys +import threading +import time + + +ROOT = Path(__file__).resolve().parents[1] +COMPOSE = ["docker", "compose", "-p", "mtusi2026lab3bench", "-f", "compose.benchmark.yaml"] + + +def command(arguments: list[str], environment: dict[str, str] | None = None) -> subprocess.CompletedProcess: + return subprocess.run(arguments, cwd=ROOT, env=environment, check=True, text=True) + + +def compose(arguments: list[str], environment: dict[str, str] | None = None) -> subprocess.CompletedProcess: + return command(COMPOSE + arguments, environment) + + +def stats(container_ids: list[str]) -> list[dict]: + if not container_ids: + return [] + output = subprocess.check_output( + ["docker", "stats", "--no-stream", "--format", "{{json .}}", *container_ids], + cwd=ROOT, + text=True, + ) + return [json.loads(line) for line in output.splitlines() if line.strip()] + + +def main() -> None: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--label", required=True) + parser.add_argument("--replicas", type=int, required=True) + parser.add_argument("--api-cpus", required=True) + parser.add_argument("--api-memory", required=True) + parser.add_argument("--duration", type=float, default=15) + parser.add_argument("--concurrency", type=int, default=32) + parser.add_argument("--keep", action="store_true", help="Do not remove the isolated benchmark stack") + args = parser.parse_args() + if args.replicas < 1 or args.duration < 1 or args.concurrency < 1: + parser.error("replicas, duration and concurrency must be positive") + + output = ROOT / "evidence" / "track1" / "raw" / f"{args.label}.json" + output.parent.mkdir(parents=True, exist_ok=True) + environment = os.environ.copy() + environment.update({"BENCH_API_CPUS": args.api_cpus, "BENCH_API_MEMORY": args.api_memory}) + compose(["down", "--volumes", "--remove-orphans"], environment) + try: + compose(["up", "--build", "--detach", "--wait", "--scale", f"api={args.replicas}"], environment) + container_ids = subprocess.check_output( + COMPOSE + ["ps", "-q"], cwd=ROOT, env=environment, text=True + ).split() + samples: list[dict] = [] + loading = subprocess.Popen( + [ + sys.executable, "tests/load.py", "--base-url", "http://localhost:8081", + "--duration", str(args.duration), "--concurrency", str(args.concurrency), + "--output", str(output.with_suffix(".load.json")), + ], + cwd=ROOT, + ) + while loading.poll() is None: + samples.append({"at_seconds": round(time.monotonic(), 3), "containers": stats(container_ids)}) + time.sleep(1) + if loading.wait() != 0: + raise SystemExit("load generator failed") + load = json.loads(output.with_suffix(".load.json").read_text(encoding="utf-8")) + report = { + "label": args.label, + "topology": { + "load_balancer_image": "haproxy:3.0.11-alpine", + "api_replicas": args.replicas, + "api_cpu_per_replica": args.api_cpus, + "api_memory_per_replica": args.api_memory, + "api_cpu_total": round(args.replicas * float(args.api_cpus), 3), + "api_memory_total_mib": args.replicas * int(args.api_memory.removesuffix("M")), + "database_cpu": environment.get("BENCH_DB_CPUS", "0.75"), + "database_memory": environment.get("BENCH_DB_MEMORY", "512M"), + "load_balancer_cpu": environment.get("BENCH_LB_CPUS", "0.25"), + "load_balancer_memory": environment.get("BENCH_LB_MEMORY", "128M"), + }, + "load": load, + "docker_stats_samples": samples, + "method": "Fresh PostgreSQL volume for this point; closed-loop POST messages, no automatic retries; Docker stats sampled about once a second.", + } + output.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") + output.with_suffix(".load.json").unlink(missing_ok=True) + print(json.dumps({"saved": str(output.relative_to(ROOT)), "load": load}, ensure_ascii=False, indent=2)) + finally: + if not args.keep: + compose(["down", "--volumes", "--remove-orphans"], environment) + + +if __name__ == "__main__": + main() diff --git a/uv.lock b/uv.lock new file mode 100644 index 00000000..8f32b55f --- /dev/null +++ b/uv.lock @@ -0,0 +1,426 @@ +version = 1 +revision = 3 +requires-python = ">=3.12" +resolution-markers = [ + "python_full_version >= '3.14'", + "python_full_version < '3.14'", +] + +[[package]] +name = "annotated-doc" +version = "0.0.5" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/5a/8e/38aa427ed5402449e226975b649c5dc73ccadfefeb95e6aecb8f8ea4b6b6/annotated_doc-0.0.5.tar.gz", hash = "sha256:c7e58ce09192557605d8bbd92836d7e1d520ac9580096042c0bfd197efacf1bb", size = 10758, upload-time = "2026-07-28T13:50:58.129Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3e/30/e900b21425a860e195f32e37657aa1f7c7f2b1bfb26f03ca209b90933c06/annotated_doc-0.0.5-py3-none-any.whl", hash = "sha256:117bac03a25ede5df5440e855b32d556049ca169ead221505badf432fed4b101", size = 5302, upload-time = "2026-07-28T13:50:57.239Z" }, +] + +[[package]] +name = "annotated-types" +version = "0.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/5f/56/a8120250d128bed162cd73c76d45f6ef9991f3e068f62a8ee060afa3104a/annotated_types-0.8.0.tar.gz", hash = "sha256:13b2beaad985e05e2d6407ee4c4f35590b11f8d693a258a561055cac8f64cab7", size = 15893, upload-time = "2026-07-23T20:16:13.995Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/99/91/8acff4f5e50511b911bbccb72b8628a49c68ce14148cd9f6431094859a90/annotated_types-0.8.0-py3-none-any.whl", hash = "sha256:f072f4d804ea359e4eaf198b1af7a8b0943881a87f31bb764f8bf219bb9419e0", size = 13427, upload-time = "2026-07-23T20:16:12.938Z" }, +] + +[[package]] +name = "anyio" +version = "4.15.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "idna" }, + { name = "typing-extensions", marker = "python_full_version < '3.15'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/a9/d2/f4d173e22df740bc37b1db102b386ba719b66e95b0f0d751f556b387e6d2/anyio-4.15.1.tar.gz", hash = "sha256:9f28306018cbd6d329e64a36d58256edff76dd996fe423bc957326e578b82a94", size = 276966, upload-time = "2026-09-05T10:42:39.44Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/12/b8/4bd346e22b28902df4d651910f5242c28d84e4a5c2435ca5c3f797ed7e2e/anyio-4.15.1-py3-none-any.whl", hash = "sha256:6152fdbbf9a77fdec97731721bebf7c4c44f7c29b424b0065826173efc7ed101", size = 132079, upload-time = "2026-09-05T10:42:37.923Z" }, +] + +[[package]] +name = "argon2-cffi" +version = "25.1.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "argon2-cffi-bindings" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/0e/89/ce5af8a7d472a67cc819d5d998aa8c82c5d860608c4db9f46f1162d7dab9/argon2_cffi-25.1.0.tar.gz", hash = "sha256:694ae5cc8a42f4c4e2bf2ca0e64e51e23a040c6a517a85074683d3959e1346c1", size = 45706, upload-time = "2025-06-03T06:55:32.073Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/4f/d3/a8b22fa575b297cd6e3e3b0155c7e25db170edf1c74783d6a31a2490b8d9/argon2_cffi-25.1.0-py3-none-any.whl", hash = "sha256:fdc8b074db390fccb6eb4a3604ae7231f219aa669a2652e0f20e16ba513d5741", size = 14657, upload-time = "2025-06-03T06:55:30.804Z" }, +] + +[[package]] +name = "argon2-cffi-bindings" +version = "26.1.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cffi" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/0b/43/bb8b6e8708d49a5ab36781333af092d9f483b198a2710d01281204640055/argon2_cffi_bindings-26.1.0.tar.gz", hash = "sha256:63505c71542a44b68b1e38060450fb006404170da375feb31af153e7f9c6205d", size = 1790807, upload-time = "2026-08-20T07:44:22.492Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e7/d2/0ae991f1b2181e5be49007c574710a800ad36c2978683addb3e67c474e55/argon2_cffi_bindings-26.1.0-cp310-abi3-macosx_11_0_arm64.whl", hash = "sha256:21ca0396fe5ec995dd54431c32698189666f9224810acfa752e50d2bd94d9df2", size = 25521, upload-time = "2026-08-20T07:32:43.019Z" }, + { url = "https://files.pythonhosted.org/packages/7e/e4/ad91d8297638aa2258aad4501c306aca99480dfe76ccd638173fa3702db9/argon2_cffi_bindings-26.1.0-cp310-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:78de2d65e0b9ea7ce9d1b1c3e87297b2d7305a02c266ee2a2d6910daddd7ee69", size = 27177, upload-time = "2026-08-20T07:32:44.158Z" }, + { url = "https://files.pythonhosted.org/packages/6f/86/5363df11b86d02cf3662208e7406496327649cc90eb365bf6f4e8a54a41f/argon2_cffi_bindings-26.1.0-cp310-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:27f1821903e2ceadcb88ec2b45ef190897b7682449c772f4d9b53e42c520cf29", size = 26597, upload-time = "2026-08-20T07:32:45.172Z" }, + { url = "https://files.pythonhosted.org/packages/f4/b5/a14dcc592652347dad23ee93b278a4da5d2a25c9ed3ebd10d68eea823a4f/argon2_cffi_bindings-26.1.0-cp310-abi3-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d88e5f7e60f28ae0b0cc6b2f16c43e87cd642a196a86f85e0d8bb6fe016fc16d", size = 27403, upload-time = "2026-08-20T07:32:46.13Z" }, + { url = "https://files.pythonhosted.org/packages/b3/81/b4a20d4902af7f796390bf9245ff83c5217dfa7367efa1d14986956c482b/argon2_cffi_bindings-26.1.0-cp310-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:34b7d9c24a4165a2c61cc8ae11d44d48c9ce2830fb536cb7914e11fdd9962728", size = 27132, upload-time = "2026-08-20T07:32:47.13Z" }, + { url = "https://files.pythonhosted.org/packages/7e/1b/c8de358af07b1c490e0fcb863ef98e46ddb486e45567aca5a60bd68d9daa/argon2_cffi_bindings-26.1.0-cp310-abi3-musllinux_1_2_riscv64.whl", hash = "sha256:224865cbbcb7a2bd1356741dff12b0134df726b6d44bb7b500df8e303cbd9e81", size = 27588, upload-time = "2026-08-20T07:32:48.087Z" }, + { url = "https://files.pythonhosted.org/packages/48/2f/7ee62a6e79f9309f9d9982d301b22a00010adb580c05c8109b94d7b33de0/argon2_cffi_bindings-26.1.0-cp310-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:ffff613aaa9ce6236766e2fc6dc560bb5abde7a2e2416e3db1f9ae395a2b4dd4", size = 26785, upload-time = "2026-08-20T07:32:48.977Z" }, + { url = "https://files.pythonhosted.org/packages/e9/10/960d0ee93d4897741bcaf4799c697dae2d81499f66fd1ed042a7dd54c1f4/argon2_cffi_bindings-26.1.0-cp310-abi3-win32.whl", hash = "sha256:a86c069c91a747a2c4e5c51473590aeb48172fff9b2130d23729a42d98665ecb", size = 23898, upload-time = "2026-08-20T07:32:50.114Z" }, + { url = "https://files.pythonhosted.org/packages/6d/3a/0cc14a05810e6add9bce5e87693334baa2222de5f647fa31781885b6573f/argon2_cffi_bindings-26.1.0-cp310-abi3-win_amd64.whl", hash = "sha256:2c36ff87b5dfaa477d0bd51e9d7f6abdae7c8955d2983c97419085d842154b3e", size = 25730, upload-time = "2026-08-20T07:32:51.091Z" }, + { url = "https://files.pythonhosted.org/packages/4e/db/d83cf2af140547f0b9cdaece05b2dc2dcbf991be4667331d073eff771435/argon2_cffi_bindings-26.1.0-cp310-abi3-win_arm64.whl", hash = "sha256:f9c4420a7a864fe1b86ce35befc95b8e39fb852493b81cf798671ddc265de638", size = 24478, upload-time = "2026-08-20T07:32:52.111Z" }, + { url = "https://files.pythonhosted.org/packages/bb/5f/f652055e18d2627e2eed94c7f31a792127cfe38df786635395d742321674/argon2_cffi_bindings-26.1.0-cp313-cp313-pyemscripten_2025_0_wasm32.whl", hash = "sha256:af11ac37a7c53dc16cb7950a6190851b0870fe218b6c60c0bb7ac355234e3083", size = 15434, upload-time = "2026-08-20T07:32:53.143Z" }, + { url = "https://files.pythonhosted.org/packages/76/38/de696045960f5b846d428c0fb6c130ed3da87aac2af209b05c193815404c/argon2_cffi_bindings-26.1.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:db0fcd827ca61622a01b220aadfbece01939acf53888f2cb98cd93e9b1e2c97e", size = 15449, upload-time = "2026-08-20T07:32:54.075Z" }, + { url = "https://files.pythonhosted.org/packages/91/0a/c25af768f6b75a5a71e31207f87c540656b2808c015260444a22763221ad/argon2_cffi_bindings-26.1.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:28524438cd3e723f25412f63d4fd516ff5bae9ae5aa56acbe2a1404398a0cf31", size = 25683, upload-time = "2026-08-20T07:32:55.05Z" }, + { url = "https://files.pythonhosted.org/packages/a8/7e/be212c751ab0bcea7f646615f933bf262e8e50b3f7bef32f861d0a2d066b/argon2_cffi_bindings-26.1.0-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac82fc756a446b6ccd7139ce70efa9d8bbe541e7ad579a12dcb52764b7175c5f", size = 27311, upload-time = "2026-08-20T07:32:56.166Z" }, + { url = "https://files.pythonhosted.org/packages/a6/ee/f84b28e4afd13d3cac36c1d8fa8c239d2dc2c51cd978d02ee5d5ad98d9bb/argon2_cffi_bindings-26.1.0-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6a4e68eed961a8de6928d1c17ff3dc2a547e0e923c17f8f1cd79fb7bc9502f98", size = 26771, upload-time = "2026-08-20T07:32:57.206Z" }, + { url = "https://files.pythonhosted.org/packages/21/c3/95c07a023691ecd529da9cb6a8f0779e13ebc1bdfaa86d145fdc1c6e7e79/argon2_cffi_bindings-26.1.0-cp314-cp314t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:151dfaad9de753f4af2a7854e707e4784f2acc434340ade64239c5b104b2d605", size = 27568, upload-time = "2026-08-20T07:32:58.361Z" }, + { url = "https://files.pythonhosted.org/packages/e6/31/3a18e31406d8694b4d6a31573c3e572fff6bed318bb744453eb653766d22/argon2_cffi_bindings-26.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:061a6919145bbf282ebf1f9c59d3135d4833c25313c8595c0d68cf7712ddfce2", size = 27280, upload-time = "2026-08-20T07:32:59.343Z" }, + { url = "https://files.pythonhosted.org/packages/0b/39/d4be4577e178b2397aa5b5575c8a309bf0da2afe05fe0c72c8f398662d63/argon2_cffi_bindings-26.1.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:62ff20cd130c956c7c9144d5fe35228f98b51c579b2439e988b27ef93e16c02a", size = 27776, upload-time = "2026-08-20T07:33:00.325Z" }, + { url = "https://files.pythonhosted.org/packages/71/47/78f4dd96f7411339f723b96fe24039c1bd5835102b8a5ba71ac4ec712ac7/argon2_cffi_bindings-26.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:19423e5d7ac1cc354baab59eaabf18db2ec04ef6593b5abe5a34f323c4a8f87a", size = 26932, upload-time = "2026-08-20T07:33:01.272Z" }, + { url = "https://files.pythonhosted.org/packages/3b/cd/96bfd37434cc0a848a9066c291d84b28846c4c9ea289ed9866b1164d622b/argon2_cffi_bindings-26.1.0-cp314-cp314t-win32.whl", hash = "sha256:4f84cdd868978d7b7350a566c254042d44216d9e37f241f3a6d3b1dfebeede35", size = 24878, upload-time = "2026-08-20T07:33:02.189Z" }, + { url = "https://files.pythonhosted.org/packages/f1/42/d8b6810abd9b1bd2f47ebbccf460da59c9f32e94888bea4f7b137d998797/argon2_cffi_bindings-26.1.0-cp314-cp314t-win_amd64.whl", hash = "sha256:2b741888c93147444fdfc851abd81cc207f37f7f7da42062a00deb3888e57da8", size = 26656, upload-time = "2026-08-20T07:33:03.222Z" }, + { url = "https://files.pythonhosted.org/packages/a9/d1/095d95eaf2ed1d9f77268cf3291bde148c6cd56121f8db2c74c1ba618a0e/argon2_cffi_bindings-26.1.0-cp314-cp314t-win_arm64.whl", hash = "sha256:6ab674f668d5962a3a4136ae0812519b0f1586874263723a32181d60d64137e1", size = 25378, upload-time = "2026-08-20T07:33:04.332Z" }, + { url = "https://files.pythonhosted.org/packages/66/cb/214092c39c4dbcb72cf98b12234ddac2221f8fe2c0acf29c6a70fa83be53/argon2_cffi_bindings-26.1.0-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:1d98e33bd8bd67d7206c124e200bf2229c4cfa8c9c19f7b44a897f0fc71837eb", size = 25683, upload-time = "2026-08-20T07:33:05.337Z" }, + { url = "https://files.pythonhosted.org/packages/83/e5/02015b83e9b05ccb85ff2ced424cf6e83a12d3810bc7f66d679a92b69ffb/argon2_cffi_bindings-26.1.0-cp315-cp315t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ccaf0a46cbb380f1fd102a874e32aa629fd3cb0c0e94f4943fa1f6d5edc5dac6", size = 27310, upload-time = "2026-08-20T07:33:06.344Z" }, + { url = "https://files.pythonhosted.org/packages/c3/4a/85e612787d0796878b3b4f6bd53dcd5484b6fe7b64cc6fc7b6e6a04cf835/argon2_cffi_bindings-26.1.0-cp315-cp315t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f0c3103fcff20183e593459cfea6e012281c0e76ae3ed8b5565ad1b92eac3990", size = 26771, upload-time = "2026-08-20T07:33:07.429Z" }, + { url = "https://files.pythonhosted.org/packages/f6/84/ccb003b6f9969820e87656398f4d49c857def71a85ca1588a0e809afd7ce/argon2_cffi_bindings-26.1.0-cp315-cp315t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c49e853a3bef9dd10329f31f702e7fa9b5c58229ff9c2ff6d069efaf09177c08", size = 27569, upload-time = "2026-08-20T07:33:08.598Z" }, + { url = "https://files.pythonhosted.org/packages/88/07/c26b76debf0998ee08fbe947ab2058ac5de37d4b9d46b06c17abaa6c4ce9/argon2_cffi_bindings-26.1.0-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:6376d4b3aca039375ca8bf92f770da0ec424a1ce3a37077a8d3c557411aa56ca", size = 27279, upload-time = "2026-08-20T07:33:09.518Z" }, + { url = "https://files.pythonhosted.org/packages/ee/0d/ead6ddc029f91bc9b9390686dad3c808ab08100d348f6266b5f93f8970ee/argon2_cffi_bindings-26.1.0-cp315-cp315t-musllinux_1_2_riscv64.whl", hash = "sha256:9bacedc04b0402837586a17f0919e3dfdd95291f441f1f56bd80ec274c2840a1", size = 27774, upload-time = "2026-08-20T07:33:10.728Z" }, + { url = "https://files.pythonhosted.org/packages/7d/47/c108530d9eb86036b78d3af4de28b83b4a2d9a70512bd10ff8e59966aab4/argon2_cffi_bindings-26.1.0-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:76ae29acace5d33355344612844d588e19deaaba4639d8bb01601e4b1418ef36", size = 26933, upload-time = "2026-08-20T07:33:11.661Z" }, + { url = "https://files.pythonhosted.org/packages/a9/02/0bfc59e781c89acf64c31c388aade9d9d1c1ea38aa1ba1292fe07f607fe9/argon2_cffi_bindings-26.1.0-cp315-cp315t-win32.whl", hash = "sha256:df612391feca41c44d20118f3b88d1b86419465cd1f5496859f715ca60ec2210", size = 24875, upload-time = "2026-08-20T07:33:12.616Z" }, + { url = "https://files.pythonhosted.org/packages/61/c7/c3e46068cddffccecb8ad94d71135e9bf62bbc789589e7dfadc7c6f59214/argon2_cffi_bindings-26.1.0-cp315-cp315t-win_amd64.whl", hash = "sha256:1a0a29ed86960e44eaace7e081bdfab4f08b012fd96ec8edba71e2ad020939e4", size = 26655, upload-time = "2026-08-20T07:33:13.521Z" }, + { url = "https://files.pythonhosted.org/packages/f4/ca/18b9c8c45fecf34b9100ec6d7946057f14a158f2eaa20ea123a3e82351cb/argon2_cffi_bindings-26.1.0-cp315-cp315t-win_arm64.whl", hash = "sha256:d157ddfab1e8b21f2f1dedda9c09645d98b5ed0b667b0626be600a345d426440", size = 25376, upload-time = "2026-08-20T07:33:14.491Z" }, +] + +[[package]] +name = "asyncpg" +version = "0.31.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/fe/cc/d18065ce2380d80b1bcce927c24a2642efd38918e33fd724bc4bca904877/asyncpg-0.31.0.tar.gz", hash = "sha256:c989386c83940bfbd787180f2b1519415e2d3d6277a70d9d0f0145ac73500735", size = 993667, upload-time = "2025-11-24T23:27:00.812Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2a/a6/59d0a146e61d20e18db7396583242e32e0f120693b67a8de43f1557033e2/asyncpg-0.31.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b44c31e1efc1c15188ef183f287c728e2046abb1d26af4d20858215d50d91fad", size = 662042, upload-time = "2025-11-24T23:25:49.578Z" }, + { url = "https://files.pythonhosted.org/packages/36/01/ffaa189dcb63a2471720615e60185c3f6327716fdc0fc04334436fbb7c65/asyncpg-0.31.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0c89ccf741c067614c9b5fc7f1fc6f3b61ab05ae4aaa966e6fd6b93097c7d20d", size = 638504, upload-time = "2025-11-24T23:25:51.501Z" }, + { url = "https://files.pythonhosted.org/packages/9f/62/3f699ba45d8bd24c5d65392190d19656d74ff0185f42e19d0bbd973bb371/asyncpg-0.31.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:12b3b2e39dc5470abd5e98c8d3373e4b1d1234d9fbdedf538798b2c13c64460a", size = 3426241, upload-time = "2025-11-24T23:25:53.278Z" }, + { url = "https://files.pythonhosted.org/packages/8c/d1/a867c2150f9c6e7af6462637f613ba67f78a314b00db220cd26ff559d532/asyncpg-0.31.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:aad7a33913fb8bcb5454313377cc330fbb19a0cd5faa7272407d8a0c4257b671", size = 3520321, upload-time = "2025-11-24T23:25:54.982Z" }, + { url = "https://files.pythonhosted.org/packages/7a/1a/cce4c3f246805ecd285a3591222a2611141f1669d002163abef999b60f98/asyncpg-0.31.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3df118d94f46d85b2e434fd62c84cb66d5834d5a890725fe625f498e72e4d5ec", size = 3316685, upload-time = "2025-11-24T23:25:57.43Z" }, + { url = "https://files.pythonhosted.org/packages/40/ae/0fc961179e78cc579e138fad6eb580448ecae64908f95b8cb8ee2f241f67/asyncpg-0.31.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:bd5b6efff3c17c3202d4b37189969acf8927438a238c6257f66be3c426beba20", size = 3471858, upload-time = "2025-11-24T23:25:59.636Z" }, + { url = "https://files.pythonhosted.org/packages/52/b2/b20e09670be031afa4cbfabd645caece7f85ec62d69c312239de568e058e/asyncpg-0.31.0-cp312-cp312-win32.whl", hash = "sha256:027eaa61361ec735926566f995d959ade4796f6a49d3bde17e5134b9964f9ba8", size = 527852, upload-time = "2025-11-24T23:26:01.084Z" }, + { url = "https://files.pythonhosted.org/packages/b5/f0/f2ed1de154e15b107dc692262395b3c17fc34eafe2a78fc2115931561730/asyncpg-0.31.0-cp312-cp312-win_amd64.whl", hash = "sha256:72d6bdcbc93d608a1158f17932de2321f68b1a967a13e014998db87a72ed3186", size = 597175, upload-time = "2025-11-24T23:26:02.564Z" }, + { url = "https://files.pythonhosted.org/packages/95/11/97b5c2af72a5d0b9bc3fa30cd4b9ce22284a9a943a150fdc768763caf035/asyncpg-0.31.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c204fab1b91e08b0f47e90a75d1b3c62174dab21f670ad6c5d0f243a228f015b", size = 661111, upload-time = "2025-11-24T23:26:04.467Z" }, + { url = "https://files.pythonhosted.org/packages/1b/71/157d611c791a5e2d0423f09f027bd499935f0906e0c2a416ce712ba51ef3/asyncpg-0.31.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:54a64f91839ba59008eccf7aad2e93d6e3de688d796f35803235ea1c4898ae1e", size = 636928, upload-time = "2025-11-24T23:26:05.944Z" }, + { url = "https://files.pythonhosted.org/packages/2e/fc/9e3486fb2bbe69d4a867c0b76d68542650a7ff1574ca40e84c3111bb0c6e/asyncpg-0.31.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0e0822b1038dc7253b337b0f3f676cadc4ac31b126c5d42691c39691962e403", size = 3424067, upload-time = "2025-11-24T23:26:07.957Z" }, + { url = "https://files.pythonhosted.org/packages/12/c6/8c9d076f73f07f995013c791e018a1cd5f31823c2a3187fc8581706aa00f/asyncpg-0.31.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bef056aa502ee34204c161c72ca1f3c274917596877f825968368b2c33f585f4", size = 3518156, upload-time = "2025-11-24T23:26:09.591Z" }, + { url = "https://files.pythonhosted.org/packages/ae/3b/60683a0baf50fbc546499cfb53132cb6835b92b529a05f6a81471ab60d0c/asyncpg-0.31.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0bfbcc5b7ffcd9b75ab1558f00db2ae07db9c80637ad1b2469c43df79d7a5ae2", size = 3319636, upload-time = "2025-11-24T23:26:11.168Z" }, + { url = "https://files.pythonhosted.org/packages/50/dc/8487df0f69bd398a61e1792b3cba0e47477f214eff085ba0efa7eac9ce87/asyncpg-0.31.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:22bc525ebbdc24d1261ecbf6f504998244d4e3be1721784b5f64664d61fbe602", size = 3472079, upload-time = "2025-11-24T23:26:13.164Z" }, + { url = "https://files.pythonhosted.org/packages/13/a1/c5bbeeb8531c05c89135cb8b28575ac2fac618bcb60119ee9696c3faf71c/asyncpg-0.31.0-cp313-cp313-win32.whl", hash = "sha256:f890de5e1e4f7e14023619399a471ce4b71f5418cd67a51853b9910fdfa73696", size = 527606, upload-time = "2025-11-24T23:26:14.78Z" }, + { url = "https://files.pythonhosted.org/packages/91/66/b25ccb84a246b470eb943b0107c07edcae51804912b824054b3413995a10/asyncpg-0.31.0-cp313-cp313-win_amd64.whl", hash = "sha256:dc5f2fa9916f292e5c5c8b2ac2813763bcd7f58e130055b4ad8a0531314201ab", size = 596569, upload-time = "2025-11-24T23:26:16.189Z" }, + { url = "https://files.pythonhosted.org/packages/3c/36/e9450d62e84a13aea6580c83a47a437f26c7ca6fa0f0fd40b6670793ea30/asyncpg-0.31.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:f6b56b91bb0ffc328c4e3ed113136cddd9deefdf5f79ab448598b9772831df44", size = 660867, upload-time = "2025-11-24T23:26:17.631Z" }, + { url = "https://files.pythonhosted.org/packages/82/4b/1d0a2b33b3102d210439338e1beea616a6122267c0df459ff0265cd5807a/asyncpg-0.31.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:334dec28cf20d7f5bb9e45b39546ddf247f8042a690bff9b9573d00086e69cb5", size = 638349, upload-time = "2025-11-24T23:26:19.689Z" }, + { url = "https://files.pythonhosted.org/packages/41/aa/e7f7ac9a7974f08eff9183e392b2d62516f90412686532d27e196c0f0eeb/asyncpg-0.31.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:98cc158c53f46de7bb677fd20c417e264fc02b36d901cc2a43bd6cb0dc6dbfd2", size = 3410428, upload-time = "2025-11-24T23:26:21.275Z" }, + { url = "https://files.pythonhosted.org/packages/6f/de/bf1b60de3dede5c2731e6788617a512bc0ebd9693eac297ee74086f101d7/asyncpg-0.31.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9322b563e2661a52e3cdbc93eed3be7748b289f792e0011cb2720d278b366ce2", size = 3471678, upload-time = "2025-11-24T23:26:23.627Z" }, + { url = "https://files.pythonhosted.org/packages/46/78/fc3ade003e22d8bd53aaf8f75f4be48f0b460fa73738f0391b9c856a9147/asyncpg-0.31.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19857a358fc811d82227449b7ca40afb46e75b33eb8897240c3839dd8b744218", size = 3313505, upload-time = "2025-11-24T23:26:25.235Z" }, + { url = "https://files.pythonhosted.org/packages/bf/e9/73eb8a6789e927816f4705291be21f2225687bfa97321e40cd23055e903a/asyncpg-0.31.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ba5f8886e850882ff2c2ace5732300e99193823e8107e2c53ef01c1ebfa1e85d", size = 3434744, upload-time = "2025-11-24T23:26:26.944Z" }, + { url = "https://files.pythonhosted.org/packages/08/4b/f10b880534413c65c5b5862f79b8e81553a8f364e5238832ad4c0af71b7f/asyncpg-0.31.0-cp314-cp314-win32.whl", hash = "sha256:cea3a0b2a14f95834cee29432e4ddc399b95700eb1d51bbc5bfee8f31fa07b2b", size = 532251, upload-time = "2025-11-24T23:26:28.404Z" }, + { url = "https://files.pythonhosted.org/packages/d3/2d/7aa40750b7a19efa5d66e67fc06008ca0f27ba1bd082e457ad82f59aba49/asyncpg-0.31.0-cp314-cp314-win_amd64.whl", hash = "sha256:04d19392716af6b029411a0264d92093b6e5e8285ae97a39957b9a9c14ea72be", size = 604901, upload-time = "2025-11-24T23:26:30.34Z" }, + { url = "https://files.pythonhosted.org/packages/ce/fe/b9dfe349b83b9dee28cc42360d2c86b2cdce4cb551a2c2d27e156bcac84d/asyncpg-0.31.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:bdb957706da132e982cc6856bb2f7b740603472b54c3ebc77fe60ea3e57e1bd2", size = 702280, upload-time = "2025-11-24T23:26:32Z" }, + { url = "https://files.pythonhosted.org/packages/6a/81/e6be6e37e560bd91e6c23ea8a6138a04fd057b08cf63d3c5055c98e81c1d/asyncpg-0.31.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:6d11b198111a72f47154fa03b85799f9be63701e068b43f84ac25da0bda9cb31", size = 682931, upload-time = "2025-11-24T23:26:33.572Z" }, + { url = "https://files.pythonhosted.org/packages/a6/45/6009040da85a1648dd5bc75b3b0a062081c483e75a1a29041ae63a0bf0dc/asyncpg-0.31.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:18c83b03bc0d1b23e6230f5bf8d4f217dc9bc08644ce0502a9d91dc9e634a9c7", size = 3581608, upload-time = "2025-11-24T23:26:35.638Z" }, + { url = "https://files.pythonhosted.org/packages/7e/06/2e3d4d7608b0b2b3adbee0d0bd6a2d29ca0fc4d8a78f8277df04e2d1fd7b/asyncpg-0.31.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e009abc333464ff18b8f6fd146addffd9aaf63e79aa3bb40ab7a4c332d0c5e9e", size = 3498738, upload-time = "2025-11-24T23:26:37.275Z" }, + { url = "https://files.pythonhosted.org/packages/7d/aa/7d75ede780033141c51d83577ea23236ba7d3a23593929b32b49db8ed36e/asyncpg-0.31.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:3b1fbcb0e396a5ca435a8826a87e5c2c2cc0c8c68eb6fadf82168056b0e53a8c", size = 3401026, upload-time = "2025-11-24T23:26:39.423Z" }, + { url = "https://files.pythonhosted.org/packages/ba/7a/15e37d45e7f7c94facc1e9148c0e455e8f33c08f0b8a0b1deb2c5171771b/asyncpg-0.31.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:8df714dba348efcc162d2adf02d213e5fab1bd9f557e1305633e851a61814a7a", size = 3429426, upload-time = "2025-11-24T23:26:41.032Z" }, + { url = "https://files.pythonhosted.org/packages/13/d5/71437c5f6ae5f307828710efbe62163974e71237d5d46ebd2869ea052d10/asyncpg-0.31.0-cp314-cp314t-win32.whl", hash = "sha256:1b41f1afb1033f2b44f3234993b15096ddc9cd71b21a42dbd87fc6a57b43d65d", size = 614495, upload-time = "2025-11-24T23:26:42.659Z" }, + { url = "https://files.pythonhosted.org/packages/3c/d7/8fb3044eaef08a310acfe23dae9a8e2e07d305edc29a53497e52bc76eca7/asyncpg-0.31.0-cp314-cp314t-win_amd64.whl", hash = "sha256:bd4107bb7cdd0e9e65fae66a62afd3a249663b844fa34d479f6d5b3bef9c04c3", size = 706062, upload-time = "2025-11-24T23:26:44.086Z" }, +] + +[[package]] +name = "cffi" +version = "2.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pycparser", marker = "implementation_name != 'PyPy'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/9e/ef/008a1939e372c06329a3fce4279c02f328488f3526744906eeec3da7ad5f/cffi-2.1.1.tar.gz", hash = "sha256:dd31f52ea1086513bb9df30f8fcee9b8918323ae067a3d5b78bc826a000712be", size = 530807, upload-time = "2026-08-03T21:21:18.939Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/10/69/43965eccfdead3b9220015fd1320e117be8c6ed01a62ffab76eeb752f5d5/cffi-2.1.1-cp312-cp312-macosx_10_15_x86_64.whl", hash = "sha256:c8c69575568085ba0b1b10c0249d779a214aea6f6522e949a0fc9fb0fcb449d0", size = 184821, upload-time = "2026-08-03T21:19:44.887Z" }, + { url = "https://files.pythonhosted.org/packages/54/7d/16e5a096677b5e313ca80cd5e5170efa3ea44624a82bb111925522da64b1/cffi-2.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f81b3b8f3d4e343550fa4baa0e479bba9f2d29ce9c2e9b51d1ce1718d7442fcf", size = 184719, upload-time = "2026-08-03T21:19:46.129Z" }, + { url = "https://files.pythonhosted.org/packages/56/e6/8941622732edec876dd17d0453dce07317ae96db34f2ec1436c9d3785986/cffi-2.1.1-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:811bd1e21d32de12efca32393a0ab3f5133b54fce9bd44b8bd77ab07da14bf6a", size = 214799, upload-time = "2026-08-03T21:19:47.218Z" }, + { url = "https://files.pythonhosted.org/packages/44/de/f98430906df1545ffde0d543dd124a7a439bc2cd32b36b9c53f805df7333/cffi-2.1.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:68e62fe11f30d5ca8289242866f0a5291402d8529ca2178ab8afc5c9694ae890", size = 222389, upload-time = "2026-08-03T21:19:48.331Z" }, + { url = "https://files.pythonhosted.org/packages/6a/5b/717f1526b9957b34456313c31645c5b82b8fb5c3fe9e4752999be7128bfc/cffi-2.1.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:4a7c934f7360e8cd64fe9efadcbd10c7c6364f531e432b9a4bf5ccbc9e0e8b50", size = 210249, upload-time = "2026-08-03T21:19:49.543Z" }, + { url = "https://files.pythonhosted.org/packages/64/b3/f8aa4f3e34986c7e4ec45072d1b1b9dd295b6b18007b45518d79726dd725/cffi-2.1.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:3143d81e29e1e20a9ce10901ec369012947876596f75a222235965f2b7ae832e", size = 208775, upload-time = "2026-08-03T21:19:50.918Z" }, + { url = "https://files.pythonhosted.org/packages/b1/db/dceb9dd5b231e1da801793f8acc9f3c52a7e1afe40bb1aae37e02b0faad5/cffi-2.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c1453022f490d2459a11819d83ad1d586e9ff65a12ac3e705ffebd46d3685dcf", size = 221822, upload-time = "2026-08-03T21:19:52.054Z" }, + { url = "https://files.pythonhosted.org/packages/a0/d2/6cd24ae3be000a634109c247d1475d62e5616d0dc78c82770942ec384248/cffi-2.1.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:208f941bb9d18e768138677f0a6d2ce01f590df56043dda1df1535ac57c88517", size = 225232, upload-time = "2026-08-03T21:19:53.109Z" }, + { url = "https://files.pythonhosted.org/packages/cb/52/3fa190537004dd7f0ab860a6dc7c0175b8667f68d1e618a46f5498d30250/cffi-2.1.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:210019b6c7cf07f081b4c54635c8cf744377001350e29cc0f81c4377b4797735", size = 223597, upload-time = "2026-08-03T21:19:54.515Z" }, + { url = "https://files.pythonhosted.org/packages/80/fb/0bb75b7039588c074b37ae99f40d9bfddf990ecb2fbc346ebccd2e56b9be/cffi-2.1.1-cp312-cp312-win32.whl", hash = "sha256:046bfc24911b37851ee1b51aab8bffe713d89c68c6a057b09484ce9fd5f69b4e", size = 175292, upload-time = "2026-08-03T21:19:55.566Z" }, + { url = "https://files.pythonhosted.org/packages/d9/79/615cc094e2fb508cade7de88d3b4f6c4ec2bab695c97bce9153dc65aadf5/cffi-2.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:f53e442b08449d42821fa4a4fba000095af9f62742a500f978a9f557ec44339a", size = 185919, upload-time = "2026-08-03T21:19:56.89Z" }, + { url = "https://files.pythonhosted.org/packages/70/c6/d0ea84713fe46b243a436a18fcd47d639732747e21635c8a27191b06dc30/cffi-2.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:7bde5e4cc5c10140859842b9d383af292b22639a4dffb725314baf45968cef80", size = 180093, upload-time = "2026-08-03T21:19:58.155Z" }, + { url = "https://files.pythonhosted.org/packages/9d/f4/035513d4117049066b4779dc3b7c0c0fdad175fa13731c9f4003f1cd1478/cffi-2.1.1-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:b5bdfd1c873d4e093aabc0ca84c4ca6dbc4f752afb5c86f146d9742580c9da2e", size = 194248, upload-time = "2026-08-03T21:19:59.399Z" }, + { url = "https://files.pythonhosted.org/packages/76/af/2aeb4dbb5fc41a04161ae9ff1518de7cec08e164f44a8ce6a4cf7fd2cd1d/cffi-2.1.1-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:31348097ff5bbe827ccc41795d4dd099d9f0625e7def00ee653c137a490c2a6c", size = 196908, upload-time = "2026-08-03T21:20:00.746Z" }, + { url = "https://files.pythonhosted.org/packages/a7/46/2e5fdde8555706dd98139a910ca11be02809f3f605ce956f655d0214e100/cffi-2.1.1-cp313-cp313-macosx_10_15_x86_64.whl", hash = "sha256:9d2055050ea716bd38b7f7f1579c275386646b4894c155a3e2f3cd62ed41b7c6", size = 184805, upload-time = "2026-08-03T21:20:02.02Z" }, + { url = "https://files.pythonhosted.org/packages/55/41/4c7042f317b9217502988f0873af87e16ad606dc20f84e546e3e6ce9764c/cffi-2.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:19ee6127ee34de7d83ce3d371ebc5ed91addbdcc39f9ab15ce4eb35a4e534971", size = 184764, upload-time = "2026-08-03T21:20:03.141Z" }, + { url = "https://files.pythonhosted.org/packages/43/1f/1c3d90d91811c8f86ced9ed637956c54bfe5b79ca98fe976d7f8c8979f6b/cffi-2.1.1-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:6a8dddef476fab96d066d578fc88526767b836ab5ab21754e1d5bf3879c31c7c", size = 214722, upload-time = "2026-08-03T21:20:04.377Z" }, + { url = "https://files.pythonhosted.org/packages/37/6f/3b5ce4c3b2192d250f04908f2bfd91ef34552ec8f7716a5d4abdb8d67bb2/cffi-2.1.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f16c709686a78c727bbbf059f92b0bf41c6fc60deec706d2dc19f529175a6125", size = 222369, upload-time = "2026-08-03T21:20:05.544Z" }, + { url = "https://files.pythonhosted.org/packages/02/10/4b3c75dde3d9663c9e02ba05c2668b954f671d4bbe346413ca8c696b295a/cffi-2.1.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:fcd22650c908d7b7da162bbfaab594a1227a15d1643a98c68b122ac642fa2264", size = 210175, upload-time = "2026-08-03T21:20:06.75Z" }, + { url = "https://files.pythonhosted.org/packages/df/62/14f74b9543e605d17701dc797b815958b8bb70b7624ce1b832ddad48ed6c/cffi-2.1.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:aa9511c62d14da7aacc9b4bf51f3f697a621e83b2d6919008243c3aad168eea3", size = 208670, upload-time = "2026-08-03T21:20:08.04Z" }, + { url = "https://files.pythonhosted.org/packages/95/95/86342356ff5953b3fb06f7ef7c5bee212d45e770abc7218d451b9148313c/cffi-2.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:a931079504ecc49efed7744c476a5c343a92fabf66dec2db95edb1b2fdc770e2", size = 221824, upload-time = "2026-08-03T21:20:09.274Z" }, + { url = "https://files.pythonhosted.org/packages/eb/ff/7b3429ff53aafe931ed8a5fc69f481bbef7ba6de87ddcbb63d08f483f613/cffi-2.1.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a2d7755bef5a12ed488f4ef1f1b69ee9191d7396083b755a5d2295f6edb4768b", size = 225148, upload-time = "2026-08-03T21:20:10.7Z" }, + { url = "https://files.pythonhosted.org/packages/34/34/a95870b9221e09cf4f2ce3178b1a210abdfe63a1bd357da940418d7b8d15/cffi-2.1.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:e0bcb7e0f677f543555d2adff3bf19c05f66cdb4796e5ff602442ab2fe3c4ef7", size = 223564, upload-time = "2026-08-03T21:20:12.165Z" }, + { url = "https://files.pythonhosted.org/packages/70/ea/839b50531021a647fb5e929f72cf97bc1ff702b5472166164b5b6e76b851/cffi-2.1.1-cp313-cp313-win32.whl", hash = "sha256:334644fbac4eff73d985a17a91226df55d0f394160c4cfb880e084c8f7161cac", size = 175263, upload-time = "2026-08-03T21:20:13.559Z" }, + { url = "https://files.pythonhosted.org/packages/60/a6/8b149b2c3f2e11aaa1618ef64500b45f50f22c57a977a4dff1aff1f91042/cffi-2.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:1aa5645c30469b09530c4ebca77ebf8f17618293c58f8549cb1a543a50236e7d", size = 185688, upload-time = "2026-08-03T21:20:14.69Z" }, + { url = "https://files.pythonhosted.org/packages/01/9a/11f687cb39d6a3504060d5242f04f48c735afb4d3d533958a20594890cb2/cffi-2.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:63bbfd5ded17c4840ac07cd8f1c21ba9d9708141f840b324f422f41b207e3973", size = 180078, upload-time = "2026-08-03T21:20:15.917Z" }, + { url = "https://files.pythonhosted.org/packages/d3/7b/d6bbf82b8b96e7391438898c42f5bd96dd02030fd5b64937d248220003e2/cffi-2.1.1-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:7dbb61fe3a7699468030f71bbe5f8a0e326a151daa91beb11a6fc1f980c55e1c", size = 194064, upload-time = "2026-08-03T21:20:17.148Z" }, + { url = "https://files.pythonhosted.org/packages/94/e6/bcc91b283be94735e268487a054004f0aa19947b6348fa367db53230abc8/cffi-2.1.1-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:f24fb43132a4c6b4cb4eb029492919b2db645be6808d738f244fd146c03c32cb", size = 196720, upload-time = "2026-08-03T21:20:18.268Z" }, + { url = "https://files.pythonhosted.org/packages/d9/99/c4b0c17cacdc9c3b8f280026286a9826d6a208c0f047591a3c3ce99b91fd/cffi-2.1.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:d28630f5854ab07ab1fd4aba756de52326c82e6be15d414b12793f1975048b54", size = 184964, upload-time = "2026-08-03T21:20:19.708Z" }, + { url = "https://files.pythonhosted.org/packages/b3/a9/9db617d05d7367c1ad0ab00b3aa6e6f9281edd689b4ee9ea0e5a84e89c97/cffi-2.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:661c298b4821edebead0c91edd2b00374d67ad7c5a1f7a91d4442633b79d6a72", size = 184962, upload-time = "2026-08-03T21:20:20.833Z" }, + { url = "https://files.pythonhosted.org/packages/67/b8/b42132ca113dc567d37684437b46ca1dafc885902b02a110a02d5b511857/cffi-2.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:58acb8ab8e295e6c5ea12f888cbb13cf21511ef2a3303a23f4325c29d17fe5c1", size = 222328, upload-time = "2026-08-03T21:20:22.118Z" }, + { url = "https://files.pythonhosted.org/packages/80/10/c5c0cbf0a657aecf59ef511409734230bf556f05a0d6c9eed7aa5c0a0166/cffi-2.1.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:456a61fa52d579ebf9df2e9552ead5129855dbaff6c1e5a9b1bc408809bdc062", size = 209985, upload-time = "2026-08-03T21:20:23.401Z" }, + { url = "https://files.pythonhosted.org/packages/d5/6c/bfa0b87b03b9238148beca990292843c9396ba069b54496596594173de7b/cffi-2.1.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:a4f00aa42f75d6e4595e8866e748cc1705adc0cddfeb2ca86d0d03993d63ba03", size = 208530, upload-time = "2026-08-03T21:20:24.628Z" }, + { url = "https://files.pythonhosted.org/packages/e9/02/4e7d553a7ac4b4238b38b3c1b80d486e9d4436f8d2acbf87a0997fe3f402/cffi-2.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b0431303acaea1089ad4b3e9ce4e6518193def1118d4073ca848635ee4ea2e96", size = 221525, upload-time = "2026-08-03T21:20:25.758Z" }, + { url = "https://files.pythonhosted.org/packages/82/1d/a4aaf9babd75acb4d5f223bff71533bee748dd770a382619a798960ee9ba/cffi-2.1.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:64faea20f4e2613363a1a9b9c7dd73058f3ecd00133a511e72ad7c511658f527", size = 225053, upload-time = "2026-08-03T21:20:26.985Z" }, + { url = "https://files.pythonhosted.org/packages/81/10/5dc0e7bdd18e22107054288283380fc97a06ae3f1656a106908d666a3c88/cffi-2.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5c58fe613dc5e5336357eff555824a314d8e43282600435c8d1cb6a7a2fedd13", size = 223213, upload-time = "2026-08-03T21:20:28.277Z" }, + { url = "https://files.pythonhosted.org/packages/0b/e9/d0061c364cde06ee43168a0d076ac1da512cbc380d44767b844ba34fe2b6/cffi-2.1.1-cp314-cp314-win32.whl", hash = "sha256:1a18a57b58cfb21fc28d72e876acf10eaed67a1ed96226f92af4df681d571c4c", size = 177682, upload-time = "2026-08-03T21:20:44.288Z" }, + { url = "https://files.pythonhosted.org/packages/a7/06/1c3e01e3ba14c39f6d10bfbac52753b7e22259e38088e5cfe1d704918690/cffi-2.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:3222ba5d678f80a030e6afbcc33dc1ae5cb45facabb61cee2c7016b8432fde48", size = 187949, upload-time = "2026-08-03T21:20:45.623Z" }, + { url = "https://files.pythonhosted.org/packages/87/5b/da4e39efe18eeb89cf580ea9cfc66b6a7c3eadb808fc0cc1d3a295cb5a5d/cffi-2.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:ab36d55f9ed2d067327667c2fea18dda018eb628dd6347aa01dda6cf1f5d3836", size = 182947, upload-time = "2026-08-03T21:20:46.955Z" }, + { url = "https://files.pythonhosted.org/packages/23/59/40338bf421c5accea1d45158170c87006ef1cd371b05c077e76476949728/cffi-2.1.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:7750c6449dff7864bb9bb27ddfb0267756189201a3afc911d82b3caacd70dfc3", size = 188504, upload-time = "2026-08-03T21:20:29.495Z" }, + { url = "https://files.pythonhosted.org/packages/7d/47/5ecf1023850036e674c77ec4de86182d309ae344e39e7cba984b7df5d647/cffi-2.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:0beceaabe56af686895136a2de78db54ecd8e4046b236b8fd6d6cb61389e9bf2", size = 188259, upload-time = "2026-08-03T21:20:31.291Z" }, + { url = "https://files.pythonhosted.org/packages/2a/9c/92934c3bea9f785b23eba304538c0b4d37a2a96d2431eb3a1bc87a11aa19/cffi-2.1.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:49cbc70e6542d4ccccb936558d1064a8012541e78f821f955cff24e357776c94", size = 223864, upload-time = "2026-08-03T21:20:32.571Z" }, + { url = "https://files.pythonhosted.org/packages/4d/45/ba4c93527bc38616a8bd36488acb69a2212d60486794f0c1f318949bbb76/cffi-2.1.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:e2d65b31f36619cda3999b78b2aa9632e76b78448e7a56fc4240824200e7c4fc", size = 211538, upload-time = "2026-08-03T21:20:33.808Z" }, + { url = "https://files.pythonhosted.org/packages/80/e9/b6ef565e452acb932fb0cb5443f44a78efbd1233e566f02b5a83855e9115/cffi-2.1.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:28907ab9bfb6aa13184cfc17c6b8e1023c5ab6fd7076d8c20a35e59fe04f8f29", size = 210688, upload-time = "2026-08-03T21:20:34.974Z" }, + { url = "https://files.pythonhosted.org/packages/9a/95/eff5f0cee78d2eabc7eebffec40d3fc1876b5f3c95582e018bb4b99601f2/cffi-2.1.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:51b31d1c98274844cfd7838ce00bfc27c7423a4dc00fc0772fc3331c2cc90676", size = 223803, upload-time = "2026-08-03T21:20:36.564Z" }, + { url = "https://files.pythonhosted.org/packages/fa/01/579d39fb8bef00a335a23d83757b44feb24cd6345a2c451b64cb67b9c362/cffi-2.1.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5e7cecbaadb83884793e05828cee59b210b24583b9c7425d0ba6a754fe22eb4e", size = 226763, upload-time = "2026-08-03T21:20:37.816Z" }, + { url = "https://files.pythonhosted.org/packages/8d/b0/0b44f47c60b01b57b6e2bbd92343f13a85a1d93bc46ccf6e47e244acd99c/cffi-2.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:25792eac27877609e7bb06d42ff88278a6624fff2ba9bbb523c09616b117e80f", size = 225688, upload-time = "2026-08-03T21:20:38.959Z" }, + { url = "https://files.pythonhosted.org/packages/eb/d2/3b7176cb570a1d3e27faf67b72f591af508036e0d8b2be2ef9af9e8c84bb/cffi-2.1.1-cp314-cp314t-win32.whl", hash = "sha256:8ef53b2de9bcb9197d31854256575d59dbac0cba72ac627bb291ef5eceb74be4", size = 182868, upload-time = "2026-08-03T21:20:40.388Z" }, + { url = "https://files.pythonhosted.org/packages/56/78/31f00c1bcd97c9bbf55f1bfdf5bc809a5de8887473e90bb9960dca825e80/cffi-2.1.1-cp314-cp314t-win_amd64.whl", hash = "sha256:616f097f2fe415bc92a247f02e11f634e1f9e9a83d327e3c915c15089c87869e", size = 194104, upload-time = "2026-08-03T21:20:41.725Z" }, + { url = "https://files.pythonhosted.org/packages/7b/1b/58496f2ed0a35de575250c02a43ab3cc2c04d494a88fed31c1cabc0fd176/cffi-2.1.1-cp314-cp314t-win_arm64.whl", hash = "sha256:ad2c86c495b899d862ea0f4b42891b8713a3bd45dd4105c7fd51c2a72f39f3a5", size = 186402, upload-time = "2026-08-03T21:20:43.042Z" }, + { url = "https://files.pythonhosted.org/packages/c1/8f/9ebe220eab48a093d1a5a5e339ab0dc7316eef3bb04d63c42f0251b61f50/cffi-2.1.1-cp315-cp315-ios_13_0_arm64_iphoneos.whl", hash = "sha256:dddad92b554513a31f272570678ba307fb9f618f05e3d4a5eacafff9eae03e1d", size = 194043, upload-time = "2026-08-03T21:20:48.179Z" }, + { url = "https://files.pythonhosted.org/packages/ff/69/844bad3ece306c4782c2ecb93597035b6690d48704b803914c199da1e8b3/cffi-2.1.1-cp315-cp315-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:da0e573f9f97159390c89d9f1a9e41908b66d408cc5b58d08cf3847d844c531b", size = 196737, upload-time = "2026-08-03T21:20:49.457Z" }, + { url = "https://files.pythonhosted.org/packages/1b/8a/af668013284634733f02d683458a0728739c7d6ddb5e14cb0c20832266fe/cffi-2.1.1-cp315-cp315-macosx_10_15_x86_64.whl", hash = "sha256:fb92203a88b3d3053034db775110081c49d28be6551923805e039924093761e4", size = 184933, upload-time = "2026-08-03T21:20:50.639Z" }, + { url = "https://files.pythonhosted.org/packages/0c/75/2f5207ff6d1a613133b23a5203cc0c2a628313b5eb3974d7956ae3c57950/cffi-2.1.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2ae64be792b8966f2c69538199728b290e34726562896df1e5dc8ffd8d8188e8", size = 185002, upload-time = "2026-08-03T21:20:52.173Z" }, + { url = "https://files.pythonhosted.org/packages/e2/31/9e1313b0a6e30e91b3b3d3fff51ae99c857c07738e3afcce1f7334e1b7ab/cffi-2.1.1-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:507a24c282e0f42f8ed737cf048572cbf580468da5555764a8331735e9c736b6", size = 222271, upload-time = "2026-08-03T21:20:53.462Z" }, + { url = "https://files.pythonhosted.org/packages/50/e3/f6234a833e6e08c7007003074723c406559eecf9b48dfc97471e5a8eb7a0/cffi-2.1.1-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:246fa40ce8645a614ff682e0b70f37134e460eaf93a775e0cbe3cca585a67a80", size = 209919, upload-time = "2026-08-03T21:20:54.783Z" }, + { url = "https://files.pythonhosted.org/packages/0d/fc/5f74e293fced6edb51af3a46c4ccf6c23c9943774ecb375ddbd522c76add/cffi-2.1.1-cp315-cp315-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:471cee653ae88de62096552e6d24ccb4a5adb8c8c9f10b5054d0122c15bf2779", size = 208529, upload-time = "2026-08-03T21:20:56.066Z" }, + { url = "https://files.pythonhosted.org/packages/44/16/29e6d01b388bef055ecd6ca8244b3f4d336bd09e92d5d892187b9601084e/cffi-2.1.1-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:aeae0e330c9f6acd681f647d46cefd30c29f93e3392882e792e82080c9691399", size = 221630, upload-time = "2026-08-03T21:20:57.336Z" }, + { url = "https://files.pythonhosted.org/packages/a4/18/fa7f1f6857d5eb88a4ca99ffcbfb7c387a287ccc154c64a73e86314745d7/cffi-2.1.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:42a494cee34437f05546455144f2b5d9ac09b1face62bcfce597d2e521066688", size = 225134, upload-time = "2026-08-03T21:20:58.675Z" }, + { url = "https://files.pythonhosted.org/packages/e0/9f/e8e3dfa04a1b4c241f8c91faacad872b4d4efd051d49764ad4e2fd4b9fea/cffi-2.1.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:cc572dace3f60ef98d7b12ff411d20f5362feb31a0439eab0085bbfd349982d7", size = 223197, upload-time = "2026-08-03T21:20:59.968Z" }, + { url = "https://files.pythonhosted.org/packages/f8/7e/8debeb04f1ab9fe2a6963964cd6f1aaf7192627b83926586a6a4e089c9fa/cffi-2.1.1-cp315-cp315-win32.whl", hash = "sha256:4f42141fc14250de6dde5ee7ea4432be017252d91f19c5ad043c084cea629cac", size = 177683, upload-time = "2026-08-03T21:21:14.901Z" }, + { url = "https://files.pythonhosted.org/packages/e0/31/5158704cc474ab65c1647932e88be78dc0873f47130e253be38bcaf13d01/cffi-2.1.1-cp315-cp315-win_amd64.whl", hash = "sha256:e6e8cff14d6fb0be70a09c0bdc58096f501952d04624ebf867e0e56da2df8960", size = 187897, upload-time = "2026-08-03T21:21:16.108Z" }, + { url = "https://files.pythonhosted.org/packages/cc/4b/b3a2da8570c704ffc0f9762cdc3ec0f02c8573798e0b5cf7f11c82bbb70f/cffi-2.1.1-cp315-cp315-win_arm64.whl", hash = "sha256:27350daa11d4f10c540e6e89dada4c54feb7256ad03e9a4dc075ebad7ba360d1", size = 182935, upload-time = "2026-08-03T21:21:17.271Z" }, + { url = "https://files.pythonhosted.org/packages/d0/ef/5443574510a1207e6f6bc38ba6e1f1de36cb48fef07b2728bb896a21f430/cffi-2.1.1-cp315-cp315t-macosx_10_15_x86_64.whl", hash = "sha256:c26608d2222fb1e94487e4a387d85f13eb55d5ed725cb25a0c589ac4ee60e7bc", size = 188464, upload-time = "2026-08-03T21:21:01.163Z" }, + { url = "https://files.pythonhosted.org/packages/7e/ae/a56fa8c4686ad50e148fcbc8d3ae0d03915ff5c30d795058988c24118cef/cffi-2.1.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:4be96343e422f2dfcd12ab5c9f5aebe03f82f737c6bffeca6830b3875cb44aab", size = 188262, upload-time = "2026-08-03T21:21:02.382Z" }, + { url = "https://files.pythonhosted.org/packages/53/b2/6187f46f2912276a3ae284076109cc5c8680482f11f766ccf26db4a86427/cffi-2.1.1-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:937c0052c05a31ca1daf18de3158eed4dbfcb9cc107adbea227728d647be701e", size = 223779, upload-time = "2026-08-03T21:21:03.553Z" }, + { url = "https://files.pythonhosted.org/packages/8a/f6/c3ad28bd19f77047a03084424fbd4cbe997303267c14423737324be0385d/cffi-2.1.1-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:df423d40ee8654634421812bc3b196da3f9bd7d32929da813f8394c4348a5358", size = 211520, upload-time = "2026-08-03T21:21:04.863Z" }, + { url = "https://files.pythonhosted.org/packages/a0/cd/ccac9013a5bd9fd764de118674ab9c805b5ca10c19270d90ee273f8b2240/cffi-2.1.1-cp315-cp315t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:a730a083190634c65cca36ba5f489531576ebd79bcd5c8e172130f6453127231", size = 210673, upload-time = "2026-08-03T21:21:06.223Z" }, + { url = "https://files.pythonhosted.org/packages/52/86/2976131c639aead931c5bee5aba67e4b09fbeb8018b6f282f70803f923a7/cffi-2.1.1-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:363e05fa78e15116c3c32c210ee36884fd6b9afa6d440e47112c3bd511d64cb6", size = 223835, upload-time = "2026-08-03T21:21:07.539Z" }, + { url = "https://files.pythonhosted.org/packages/ac/0c/33a7aeab2f9c76918c52e084beb39c570db3588133412929e8ec06fab90b/cffi-2.1.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:770de9db11e84213beec501cfcaa013b019820ca881e03344dea5844f7876d94", size = 226705, upload-time = "2026-08-03T21:21:08.774Z" }, + { url = "https://files.pythonhosted.org/packages/e3/26/2cde30fdde421130bfc18f70395731a6e6b2053c6a1978a5258ff04e72fa/cffi-2.1.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:7da0c5eff80f0197f3b3d1232ec5a682a9325f4ae9016a78f5f5ca35f9ced1f5", size = 225539, upload-time = "2026-08-03T21:21:09.911Z" }, + { url = "https://files.pythonhosted.org/packages/6d/cd/a361394c94b2129d604bb846f624a8e88255a3ee33129c434a00d715e64f/cffi-2.1.1-cp315-cp315t-win32.whl", hash = "sha256:06c72bb76605a4b0cd0aad6930b69d4baf7dd5d806cfc409b824191099700e66", size = 182707, upload-time = "2026-08-03T21:21:11.226Z" }, + { url = "https://files.pythonhosted.org/packages/9b/b5/ba2b299993c26577d529b6ae29841f9e15b9fcf004d65f423f4fcf94ade9/cffi-2.1.1-cp315-cp315t-win_amd64.whl", hash = "sha256:d9c275eaacd24aa73f94ffd6de08fc3f932424d8b6c376f4bed7cde376fe7bc3", size = 193772, upload-time = "2026-08-03T21:21:12.39Z" }, + { url = "https://files.pythonhosted.org/packages/aa/29/35e016098c814cd93de9cd320c66b5bfba14dc6ecedd3cb518fa7c408c69/cffi-2.1.1-cp315-cp315t-win_arm64.whl", hash = "sha256:d18e5ac0f2f03f4f518d3e23db0f0cad7faa1da8620e9c09461d443bbf6e6692", size = 186360, upload-time = "2026-08-03T21:21:13.636Z" }, +] + +[[package]] +name = "click" +version = "8.5.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/0e/7fa0ef50764b67090eca4114772a2abf8b6148198475e54c660b97caeee6/click-8.5.0.tar.gz", hash = "sha256:ba0d2089de75ea0310e2dde03160e6ca10009947fb95a182f9b54021bb272e34", size = 382235, upload-time = "2026-08-26T13:33:14.56Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/58/50/6c0d534c5f134586a8e1ba4e330569e32f057e33372ae556463212fb4cd3/click-8.5.0-py3-none-any.whl", hash = "sha256:255bc9599cf7748b4b1a446ccc735421bd08a2ae529a8b88597d3de5664ee360", size = 125251, upload-time = "2026-08-26T13:33:12.928Z" }, +] + +[[package]] +name = "fastapi" +version = "0.141.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "annotated-doc" }, + { name = "pydantic" }, + { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/8a/02/91e3416a8fdd715abb903a952a6bec7cdd8d14eed55d415fc8595524c319/fastapi-0.141.1.tar.gz", hash = "sha256:e8822fc40db1e1858054d7a949a888695bc9bdce70139178e33bd2871a453ca1", size = 425799, upload-time = "2026-07-29T17:18:05.568Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cb/03/10388a42375ee7e4ac9b94eb2c5c569c8b5795e377e701c9ac3ad63de890/fastapi-0.141.1-py3-none-any.whl", hash = "sha256:bfb91aa2d334c61cb35ba9a116fc123b3d3df31640b801cf57a7a78ec3f603b3", size = 131954, upload-time = "2026-07-29T17:18:04.364Z" }, +] + +[[package]] +name = "h11" +version = "0.16.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" }, +] + +[[package]] +name = "idna" +version = "3.20" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f5/08/8eea9d4b8302028f3abb2c0813953f7aec26d33b7a8960ed760e65ff29fa/idna-3.20.tar.gz", hash = "sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44", size = 216463, upload-time = "2026-09-17T14:11:04.752Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/58/a2/bb081bab032533a855d44de1d56f8e8426114ff1ba5d1f07a438a0a654f8/idna-3.20-py3-none-any.whl", hash = "sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c", size = 69583, upload-time = "2026-09-17T14:11:03.168Z" }, +] + +[[package]] +name = "mtusi2026lab3" +version = "0.1.0" +source = { virtual = "." } +dependencies = [ + { name = "argon2-cffi" }, + { name = "asyncpg" }, + { name = "fastapi" }, + { name = "uvicorn" }, +] + +[package.metadata] +requires-dist = [ + { name = "argon2-cffi", specifier = "==25.1.0" }, + { name = "asyncpg", specifier = "==0.31.0" }, + { name = "fastapi", specifier = "==0.141.1" }, + { name = "uvicorn", specifier = "==0.40.0" }, +] + +[[package]] +name = "pycparser" +version = "3.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ac/d3/eb1d3bc30dda12f7e69640ae2ac8cb10240b71fb73024ad528b7d2ae73da/pycparser-3.1.tar.gz", hash = "sha256:b3fc6dec06a8b2fefa0ed4ff92285306a5e3be9987bc5603c9edbdc4e492418f", size = 105946, upload-time = "2026-10-08T12:26:34.349Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/99/ce/b3ae9ee0324d991c860187be2a6ee436d27a3d02397eaddbb101ec901f3d/pycparser-3.1-py3-none-any.whl", hash = "sha256:f09d358c840bd147b79e55f2bc494f18ea869dc897f5852a8f5766b74f787882", size = 48709, upload-time = "2026-10-08T12:26:32.97Z" }, +] + +[[package]] +name = "pydantic" +version = "2.13.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "annotated-types" }, + { name = "pydantic-core" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/53/ef/fc4f868f4e2cee79f863883abffceff107875f569b848507319842d2a681/pydantic-2.13.5.tar.gz", hash = "sha256:51a9c5f7b2f8e636f04c6cada605d9b6a3bf1348fdf945a3d8869b19bba0ee08", size = 845750, upload-time = "2026-08-28T14:04:00.916Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/eb/47/c95ffc2009878c7aac0c5e08528022dcb885933252a88b5f170058014464/pydantic-2.13.5-py3-none-any.whl", hash = "sha256:346a034f080da3755d8e9cb5e00e8b07de1d39e4f6e2c87d8ab7cafa0b269a73", size = 472589, upload-time = "2026-08-28T14:03:59.136Z" }, +] + +[[package]] +name = "pydantic-core" +version = "2.46.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/af/f9/8a06bea35ef8daf588f707784c973a7046e0034c8d8cfb08828eeffb8b75/pydantic_core-2.46.5.tar.gz", hash = "sha256:10416c15b8839ecc4ef4d0885da76da6fd0f67333a0eb8aff6d93c4b8f2910fc", size = 472262, upload-time = "2026-08-28T10:01:31.677Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/82/3f/76358795aa7a8c6d4f36e2cb828ad1c90ee118e1393a9281664f5aade9d4/pydantic_core-2.46.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:b9fe6fb92520e3fd61f2e49000b6911b188824f089b75973ea06d6267f0b476d", size = 2076516, upload-time = "2026-08-28T09:58:21.576Z" }, + { url = "https://files.pythonhosted.org/packages/db/50/26b091836076ce4cb2fac264186936acc069e0595772cfd02a563bc4761a/pydantic_core-2.46.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:a39ac25a9a2fa4072efdb429833c4a4c8009a51ff9eea3eeae131713cd27991e", size = 1922874, upload-time = "2026-08-28T09:58:23.766Z" }, + { url = "https://files.pythonhosted.org/packages/09/f0/2a8ce3849e299d44e2d2c196b6082643a3235565a735cb51db7a6261f614/pydantic_core-2.46.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4fdc8b93a41521988916eeaa271173fcca7fa0803d62f87675aac8dcec1c8e29", size = 1951772, upload-time = "2026-08-28T09:58:25.435Z" }, + { url = "https://files.pythonhosted.org/packages/87/46/ac0dc8bdd9e6048183a14eb127764e7ad9240021c17513074a4711b0e31e/pydantic_core-2.46.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b98134087d9de723658d17a42c7d0da8d6e2ef08015dee7dc93889047315f5e4", size = 2031832, upload-time = "2026-08-28T09:58:27.102Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c2/339de5bef7be36301a2231eaa52e62163742c2281f11b5f4892bc79785cd/pydantic_core-2.46.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e652ab17569c94bff5475520f907b7148b8c24036a8ebbe5cf7cf7493d28579a", size = 2208645, upload-time = "2026-08-28T09:58:28.948Z" }, + { url = "https://files.pythonhosted.org/packages/7b/a0/9ff22b797724262da14427abaed4dd1d864a139693fc5e7809114376a716/pydantic_core-2.46.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d925f3d9afd05a8c0fb3a1031463a8d59ebe5e2afad297e29c78be19e13b4e62", size = 2265935, upload-time = "2026-08-28T09:58:30.625Z" }, + { url = "https://files.pythonhosted.org/packages/c0/a4/eb9409ec0736e50aa70a412f16c204ed149516846912f7e6724d4c73ee53/pydantic_core-2.46.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0fc5be0abd4a407e200d844b404e33639a554e7bd0d448e7b9ae181be4789ac2", size = 2066284, upload-time = "2026-08-28T09:58:32.289Z" }, + { url = "https://files.pythonhosted.org/packages/c0/02/7f6156ffc926857f1c37c07d9a388682865a81830ab6a1b637082c25e399/pydantic_core-2.46.5-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:816ff0a6550ffc06c098ccd2e0698600f9aa7da192a79eaa6f9af504a35db869", size = 2105889, upload-time = "2026-08-28T09:58:33.986Z" }, + { url = "https://files.pythonhosted.org/packages/92/b1/e781d357ebe09fc929f995700f1b3503e8897f1cece183ecb1300d4d67e9/pydantic_core-2.46.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c7ea57fc63aa7da93a1bd2d644e6577befae10c52c4e36377635eea1056a74f5", size = 2158006, upload-time = "2026-08-28T09:58:35.647Z" }, + { url = "https://files.pythonhosted.org/packages/70/0a/644597d84ab400e50609c192120b85c9681c22d3a20461b9060a79be0a7a/pydantic_core-2.46.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:efd62a42486f1bda5d24cb4f63d15a3c7768375fe83d36f9417b4ad7a2fb20b3", size = 2158408, upload-time = "2026-08-28T09:58:37.38Z" }, + { url = "https://files.pythonhosted.org/packages/1e/ee/ca3b7b3a4b3769ffe9ce9432a7c9be755de9593a46d3b0d54d0409323e44/pydantic_core-2.46.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:2bc9419666990c06d7397831f2126a1ecc3594aaa3ff7de5bf2d066802f4e07b", size = 2309609, upload-time = "2026-08-28T09:58:39.22Z" }, + { url = "https://files.pythonhosted.org/packages/ce/52/39fa1f451486019524ca685020390e7ca351832fd874530ba30c8628e6dc/pydantic_core-2.46.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:18a09e1e1011b462f2e32774f25859ef1223d5c2b0546a633cf56654710721e0", size = 2342618, upload-time = "2026-08-28T09:58:40.89Z" }, + { url = "https://files.pythonhosted.org/packages/81/5e/468fc630568c61dcef3cd47ad32ffbeed9af643f49208d1ea86ab4f890c4/pydantic_core-2.46.5-cp312-cp312-win32.whl", hash = "sha256:5cb482e9e84c851f4e623fe4acc1ced89168cf1fe18f7089db4548c8f5bbb65b", size = 1939475, upload-time = "2026-08-28T09:58:42.591Z" }, + { url = "https://files.pythonhosted.org/packages/cf/c9/4c19f41b84cf6b622a72fbeed7665b25d47a187d68d47d0d430c07f23268/pydantic_core-2.46.5-cp312-cp312-win_amd64.whl", hash = "sha256:5e81740c09e310f5aa5cbd3e434a01c154d4bef93241c7877b39f211d2b78ba8", size = 2043140, upload-time = "2026-08-28T09:58:44.272Z" }, + { url = "https://files.pythonhosted.org/packages/af/dd/0c1a050299147c746e5256db16d645ab5efd4f78c59937d581a0524e74a2/pydantic_core-2.46.5-cp312-cp312-win_arm64.whl", hash = "sha256:f7b0ec93a2893de856652154d73b7ba622f26fa97726487dcac373de5f4c6084", size = 1997729, upload-time = "2026-08-28T09:58:46.13Z" }, + { url = "https://files.pythonhosted.org/packages/f5/37/5abe39a8372a61d3dc3c1338fc504281c01b32fdb3169cd7187153b56d3e/pydantic_core-2.46.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:b7ca9034437b6022f941f4857459562ee00a560b97e7cce8a0ec5a74fc6766e0", size = 2075885, upload-time = "2026-08-28T09:58:47.856Z" }, + { url = "https://files.pythonhosted.org/packages/21/43/6323b1f8b217780454c61304bcd2b38ae4762f50754414124603ccc90bb2/pydantic_core-2.46.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f332f0e72a5a0400141f830744e141bf9f97917878dbe968669e8a7fefea78ff", size = 1922768, upload-time = "2026-08-28T09:58:49.58Z" }, + { url = "https://files.pythonhosted.org/packages/0f/a3/c05ca796e1197618a774b01e596aeedfefc2f7d8c01ae3054e910b120e8a/pydantic_core-2.46.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:193375f3548919d3f0b60936ca113ada3e38f264f91b9b8e0508efaad57be931", size = 1951241, upload-time = "2026-08-28T09:58:51.511Z" }, + { url = "https://files.pythonhosted.org/packages/68/32/33bc39ac705c52cffc908e8389f9754fdb208aea5c69cceddf4eb3ce99af/pydantic_core-2.46.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:79bdfa52f843137045b2d081cc05c120ba6665d29b7559c2c47690906f39279f", size = 2031975, upload-time = "2026-08-28T09:58:53.166Z" }, + { url = "https://files.pythonhosted.org/packages/b0/70/2333e885c0f6a67bc105c5916965dac9b57f2718ee20d81d1a06a4ebdc13/pydantic_core-2.46.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:24922243639cbdac66c75fcb6fd6495a9cb52b213d62f9a0d16f0310b1ff8038", size = 2208542, upload-time = "2026-08-28T09:58:55.017Z" }, + { url = "https://files.pythonhosted.org/packages/f7/ea/296debfb4264207bbda5936133892e027c0a58875ad53ebd512fba8ec3a2/pydantic_core-2.46.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c76fe65e607be28c7fd4d56fc3c42b1583aa058ce3408b7ad0fd540171d31f9f", size = 2264692, upload-time = "2026-08-28T09:58:56.767Z" }, + { url = "https://files.pythonhosted.org/packages/d3/f2/9e4de77a6271e07a76d2d58b11c091a979c191ed2939bf80067568b369d2/pydantic_core-2.46.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6f7b393a8b3da82f5c1fc0751e6d01ac6c55b93c18226a60bdfba4a724efafd1", size = 2066633, upload-time = "2026-08-28T09:58:58.531Z" }, + { url = "https://files.pythonhosted.org/packages/8d/db/f9e9d0c97445987b2084823d5c240de88087338f04fc2cfaa2df186b8049/pydantic_core-2.46.5-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:7ac031912d54f3d83ef3b3eb98dfabc1608802e2202263d25957eeed40b94761", size = 2105235, upload-time = "2026-08-28T09:59:00.421Z" }, + { url = "https://files.pythonhosted.org/packages/07/c5/79169b047b3b2c3e99e04bc76372af9637e0bf6db638274fa927df96369e/pydantic_core-2.46.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:837b396ca3d7b74091ca623f6cbd8351bd42d670a79c2683e79fb089f06a2de5", size = 2157367, upload-time = "2026-08-28T09:59:02.442Z" }, + { url = "https://files.pythonhosted.org/packages/26/b5/ba6057afb7c291bd449f51b867f95aef2072941c4ce4e5c31d6ffd132d3b/pydantic_core-2.46.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:5ee239d575f80b08eca11f6e20f90c4c695de7825c67eefe6091fbf20dda648e", size = 2158420, upload-time = "2026-08-28T09:59:04.2Z" }, + { url = "https://files.pythonhosted.org/packages/6e/28/2057abecaafdc22912afa819603a51f0a62d40643b7c4871c51721fea9be/pydantic_core-2.46.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:e80675d75ae2cd14372cb65cad5400d9347a3d3f6c13000183f22dfd027283ed", size = 2309588, upload-time = "2026-08-28T09:59:06.048Z" }, + { url = "https://files.pythonhosted.org/packages/71/9d/881156dc404e27479c4246128d73538464cab4a239bec61995e227644c30/pydantic_core-2.46.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:9c4b71f10dd532fb7a5cbc8f58707779e64f03a258c2bf8bfbaecfcd9970b519", size = 2341866, upload-time = "2026-08-28T09:59:08.539Z" }, + { url = "https://files.pythonhosted.org/packages/5a/38/d66f443a259f84d13babdceae568e572b0ed26da17ca5d0a649ebb110a67/pydantic_core-2.46.5-cp313-cp313-win32.whl", hash = "sha256:97bf8de4d541598c94a59344eeb988a94c08ff76b5723c41f6567ec18c7892ea", size = 1938580, upload-time = "2026-08-28T09:59:10.402Z" }, + { url = "https://files.pythonhosted.org/packages/2c/1e/1d5371213f4cc9a7ed70c0bfcc7911de22311ee99a662a56077d7292d2ac/pydantic_core-2.46.5-cp313-cp313-win_amd64.whl", hash = "sha256:15f4a94963c95accac15b7b657bb177d3ad82bb90b0d0526d9a9b85079925db5", size = 2041980, upload-time = "2026-08-28T09:59:12.396Z" }, + { url = "https://files.pythonhosted.org/packages/5a/48/4222d90b1c67568bace4dec6dca6271449c66de3595d72b6d098f5fde597/pydantic_core-2.46.5-cp313-cp313-win_arm64.whl", hash = "sha256:d22a945598fb91236b4dd793a6e42e4f3dd7740bb5aace5ebd7d4c08d13bb575", size = 1997213, upload-time = "2026-08-28T09:59:14.245Z" }, + { url = "https://files.pythonhosted.org/packages/8e/8a/14596f2a8367da50cf7cbac48169ee5d9c8e11d486a3b527082384630c72/pydantic_core-2.46.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:c1c43ad4339643d70ebb8124e1305a7dab423001eff58bb41a0f731adbc98355", size = 2074081, upload-time = "2026-08-28T09:59:16.141Z" }, + { url = "https://files.pythonhosted.org/packages/ae/d5/d8a4eb6d6c7f66b91dd37c576d76e9e60fba900caf5372c17bcf949febc2/pydantic_core-2.46.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1a353f84de772f423b5ffb11d7ae352fbbef0f446f3c0b0af0f8236d7233606e", size = 1920497, upload-time = "2026-08-28T09:59:18.065Z" }, + { url = "https://files.pythonhosted.org/packages/8e/26/092079428f86e927e030b2c0ced87df69dbb1c875cdeaa67bf42ea2be746/pydantic_core-2.46.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5086029a57366b8cf81b130a43908738095c270c21a8d7f0e8bdfdb89718e2f3", size = 1952130, upload-time = "2026-08-28T09:59:20.476Z" }, + { url = "https://files.pythonhosted.org/packages/08/c3/8ec0e290a9ebaebd64047bf5fda94be835c6b1551b02437e4b76778fbcd7/pydantic_core-2.46.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:46c25dda9d092a06c08db76ffe0a197107904d0dfac653f7d5306bbcd6d6119c", size = 2026371, upload-time = "2026-08-28T09:59:22.227Z" }, + { url = "https://files.pythonhosted.org/packages/01/72/4fd20ad520fb8da0157f95b27a7eb05a72790ef08138e7701ac972c342ea/pydantic_core-2.46.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:37ea7b83c935e5b0d68c9449b82651accf78a10828b2c02b2f2d9e9496446c21", size = 2202822, upload-time = "2026-08-28T09:59:24.277Z" }, + { url = "https://files.pythonhosted.org/packages/31/b0/d16e0771206b29314f0d52198b720be21e8a99ab2bf11e3bc0d7c9cebdff/pydantic_core-2.46.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e64e88d5585bea9ce95861079de72006c7fa6d3df4e3a3b65ba31eb979c15c9f", size = 2262756, upload-time = "2026-08-28T09:59:26.608Z" }, + { url = "https://files.pythonhosted.org/packages/2c/9b/59634b7ac631c63b2a37760eb6943af3e29573d6b59a4abc5e7f019d4cee/pydantic_core-2.46.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:54d510bac3ee52247af28ed4bb18a1e799f040ac60fd2bf5ccd4c92f1fbe786f", size = 2068352, upload-time = "2026-08-28T09:59:29.044Z" }, + { url = "https://files.pythonhosted.org/packages/08/7c/570abb1ad2155348dc754ea91be22e5aaa18eb6d69a6068f7c6f2679a6ed/pydantic_core-2.46.5-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:a2a5e1d0ff29adddc9f6d6821a66302e4493f8ca898b715b6b1182c2c201ea0a", size = 2104777, upload-time = "2026-08-28T09:59:30.95Z" }, + { url = "https://files.pythonhosted.org/packages/8e/25/5bf74adc65a1ac5b7be3f6cb0bcb5433615c1598a801c19d830d84c98ded/pydantic_core-2.46.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:03b9666e41e35d8909852ba191a0607520f81b74eaf12ccf8737005dbb313821", size = 2156312, upload-time = "2026-08-28T09:59:32.604Z" }, + { url = "https://files.pythonhosted.org/packages/90/6a/2ef38830675e050121040618135564ed56b860b45433b02d9b4ebece46f3/pydantic_core-2.46.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:a91c17edf6eea2402cb5457b4c89e99bc5ed1004aa34c4adf1d4258c1a5c22c2", size = 2150067, upload-time = "2026-08-28T09:59:34.453Z" }, + { url = "https://files.pythonhosted.org/packages/90/ef/a7dbb03a14a64c2a4621f989c615ed9a892535a6cad938fc27079f919d80/pydantic_core-2.46.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b49924c73a235e969511bf2aabdff3beebf9820931f646c80274d5d780010c47", size = 2304516, upload-time = "2026-08-28T09:59:36.194Z" }, + { url = "https://files.pythonhosted.org/packages/68/f8/6bb4c4b80e8a6fde1904c64a51c62a1d04fcdfa3ea521a66b2ddefa1d885/pydantic_core-2.46.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:2cbd9a5eff05e51c447c34dfa4632145b26b09120cf04bd0c871e44c1a5e1c9a", size = 2335223, upload-time = "2026-08-28T09:59:37.931Z" }, + { url = "https://files.pythonhosted.org/packages/2a/80/f46b8c681195190b2c1f1c7c0a81abce60663e987613e09ef64d433dd96b/pydantic_core-2.46.5-cp314-cp314-win32.whl", hash = "sha256:2d5d76654becf5efd62c9e51c3756c67b49498b0c9a40884934c40807adbd074", size = 1934827, upload-time = "2026-08-28T09:59:39.836Z" }, + { url = "https://files.pythonhosted.org/packages/f7/3c/60674207246bc0a4009d2391b7c7251c7159f279c8d2ab8aae8ef46f3dee/pydantic_core-2.46.5-cp314-cp314-win_amd64.whl", hash = "sha256:fa10ef4112775900e7a0661068635eb67b2ab824fbde764de6e0e21982a93db0", size = 2042648, upload-time = "2026-08-28T09:59:41.792Z" }, + { url = "https://files.pythonhosted.org/packages/69/0c/117c562c7c1babdf44576b72a5e496906506c93690387ecfbca7c729ae2e/pydantic_core-2.46.5-cp314-cp314-win_arm64.whl", hash = "sha256:045ab3b6d308439e32b81cc173bba5b9018bc6ed896afd0c65b3b009b1699af5", size = 1989652, upload-time = "2026-08-28T09:59:43.702Z" }, + { url = "https://files.pythonhosted.org/packages/e8/66/9336ae58f9eb68c41d121894e52c4c89eccb07eb8f602a04ee9c3f37736a/pydantic_core-2.46.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8816f3d218beb4b787de5c9759c259b8fa61f9dec42dc7811f320a33771778b7", size = 2065829, upload-time = "2026-08-28T09:59:45.364Z" }, + { url = "https://files.pythonhosted.org/packages/c5/02/bc19b47a96c2d3109760711acf22369e56bd7e405ca52f7ade164d2ead57/pydantic_core-2.46.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:bce57638e08ac148e5778cce7feb968307a727d66f8e2274a543d0cf0c9ad6a3", size = 1905716, upload-time = "2026-08-28T09:59:47.18Z" }, + { url = "https://files.pythonhosted.org/packages/52/a4/70b47c0509923dd98ccfed04fb3e32ea3849c82a0ff2205bb41009b43c00/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:976e1128455aa595ea04c79ccfedff1aaeab96ee013fcc916bed120c4f0ad94f", size = 1934216, upload-time = "2026-08-28T09:59:49.241Z" }, + { url = "https://files.pythonhosted.org/packages/52/ab/aa03b65f7bb198585edf806b906c3223ecf1795543e39e23aec4cce27ad2/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b891faeedeafba41b2983e5001a81b6a915b69544c7e7570d1989ce1c36ac7", size = 2010635, upload-time = "2026-08-28T09:59:51.692Z" }, + { url = "https://files.pythonhosted.org/packages/3c/8b/0da06343f30b84ec549aafd309c6456223d5dc8bd36af504c573faad561d/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f194189415698233dd1114a093a9b56e61e2c57e11b469be3b0506f46f0771c", size = 2209369, upload-time = "2026-08-28T09:59:53.582Z" }, + { url = "https://files.pythonhosted.org/packages/d6/5b/844c4defaa34a3df66eb9257087d121d70c201298b96abdf9f492fc2f1bf/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:82a36973cf8a2ef5406f4fe2edbf8ed0c99629535d959e0b100c76a32535a111", size = 2253238, upload-time = "2026-08-28T09:59:55.484Z" }, + { url = "https://files.pythonhosted.org/packages/f4/64/a4e536cb16d7f61a7fd3120b46c577fc7fa7325992f69c4f52bc786d77d8/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cdbb78909f52b981d3b2d56b97328d71eb0b974c36bd77c920123a7ebb192829", size = 2065740, upload-time = "2026-08-28T09:59:58.038Z" }, + { url = "https://files.pythonhosted.org/packages/5f/75/aaa38c6bc2d085f6605b34eabdc6a8a4e0b2e61fc9c8e6e52b28e97b3125/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:52e24eacdb536cade636aa90fb851835222becff8484b7001fdc78cb0290f2aa", size = 2087425, upload-time = "2026-08-28T09:59:59.898Z" }, + { url = "https://files.pythonhosted.org/packages/55/ae/fcab4cfc39aba3689e1d20c8b5250ad280957022c09af2ed9cd585602a5e/pydantic_core-2.46.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:37ae34309d7bd8c0d61ab839668058f2a7962ea1fc51d105d2db228fe0618034", size = 2139306, upload-time = "2026-08-28T10:00:03.057Z" }, + { url = "https://files.pythonhosted.org/packages/2d/f4/f1d03a4bc9d9acbc62f4d742b8a319af52f71885079868b2ff8e48a651ee/pydantic_core-2.46.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:0cdbada856a1c69a7624a64d3d9aefe79300bd6ef827b43a4f265010b9b55184", size = 2144589, upload-time = "2026-08-28T10:00:05.645Z" }, + { url = "https://files.pythonhosted.org/packages/83/f3/7a53bb1356de514a4cd295f25b6ac39237895620c0462d2592b76c16e114/pydantic_core-2.46.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:545f26c504b27c3758439a5e6d9349931f0a04f855668d5fe323c89e82300a38", size = 2288882, upload-time = "2026-08-28T10:00:07.931Z" }, + { url = "https://files.pythonhosted.org/packages/cd/94/5a81583660c175c59d49ffb09f4b3a44debeaf86a19fca664ae1cdd9ee32/pydantic_core-2.46.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:ff218293c9c806138dca139765e3b067621be52bcd93cdc14c7711be7ddc90a9", size = 2335210, upload-time = "2026-08-28T10:00:10.177Z" }, + { url = "https://files.pythonhosted.org/packages/5a/9f/5d685c2693b972d1a59c998586e8823712b66603aeff47ee60a4bdaafd37/pydantic_core-2.46.5-cp314-cp314t-win32.whl", hash = "sha256:97cf3eb53a8cccacf9d46686a0926186c9bfb5574f2ed66d3639d5fe117cd3a9", size = 1921180, upload-time = "2026-08-28T10:00:12.35Z" }, + { url = "https://files.pythonhosted.org/packages/70/12/5c94ee16d65a37a15f9e869f5e6256df111154491173801a4c5e800ab548/pydantic_core-2.46.5-cp314-cp314t-win_amd64.whl", hash = "sha256:d2f9fc07a8042a8f95925b35c4f04f469707c981fc33245b6ca187cf5d2dd290", size = 2020515, upload-time = "2026-08-28T10:00:14.774Z" }, + { url = "https://files.pythonhosted.org/packages/63/19/67830dda664e6bdf9285ee2e40f355d0d7d6b92aa0c42e8d217bb8d33d36/pydantic_core-2.46.5-cp314-cp314t-win_arm64.whl", hash = "sha256:acf8a67ba51f4ca9ddbd0e6b3000a65ac51ab734661778b3e7ba64d99a710f2f", size = 1989276, upload-time = "2026-08-28T10:00:16.984Z" }, + { url = "https://files.pythonhosted.org/packages/df/dd/053c2e4303f791f3b8f8a14ab0b22008e8eb21d868c0c90b4f9be705b76a/pydantic_core-2.46.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:013d6f3483d81e02e7c328831808f336c8596ee33b4bd4026b9ffb1e960b8942", size = 2062540, upload-time = "2026-08-28T10:01:00.318Z" }, + { url = "https://files.pythonhosted.org/packages/d7/dd/a18df751a5e37dd51bfad7f68e766999125bebe68c9e1d10a493ad01bd63/pydantic_core-2.46.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:e9c134bb666dd54b778b9fc0d2b50cbb7f979b9e3716f26a88c9ab3b6fc1dd0f", size = 1902040, upload-time = "2026-08-28T10:01:02.529Z" }, + { url = "https://files.pythonhosted.org/packages/b7/13/01d40f9d07ce8a779fd6e0bd8ad4fba91309500dd67b869e2e219d261a6d/pydantic_core-2.46.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:347ec774390c87326a2e4929d58d3f7e8763a104d5d35f4cd595a4c952366433", size = 1967479, upload-time = "2026-08-28T10:01:05.004Z" }, + { url = "https://files.pythonhosted.org/packages/fa/04/c81d4841331c2178b6fb09ae225425e110ed72d990c9fe556c4ec03d1013/pydantic_core-2.46.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8e24d8f05fa2d28513d94e877e9c75ad66175376209b3977f916e240e623193c", size = 2111034, upload-time = "2026-08-28T10:01:07.345Z" }, +] + +[[package]] +name = "starlette" +version = "1.7.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, + { name = "typing-extensions", marker = "python_full_version < '3.13'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/7b/2b/3850dc6bf7ef71b088962eba31dafc6cffd2f96e577ebb0bb316df96da3e/starlette-1.7.0.tar.gz", hash = "sha256:c79f74ea63cff761804fbbfb182f1e0b440c2d07b164d24700c5a1bab5d6ff5d", size = 2736246, upload-time = "2026-09-23T07:30:26.35Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/4e/d6/1ec1b290f9e0fb067899b61e1d37a30c923068bad260b216dbe37a7d2967/starlette-1.7.0-py3-none-any.whl", hash = "sha256:67f8e99895493dd2911a03f11314af6ceebeae4e704bb9f43dfc6a9db151c93e", size = 78980, upload-time = "2026-09-23T07:30:24.567Z" }, +] + +[[package]] +name = "typing-extensions" +version = "4.16.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" }, +] + +[[package]] +name = "typing-inspection" +version = "0.4.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/a3/26/b09b8010994eccc3c09092e6b34058f36a460eea2d4c3e8b910c695975a0/typing_inspection-0.4.4.tar.gz", hash = "sha256:547274fa6b0a561ccf549cc9524b999a578e737d015d8709d021f9d0d13bea47", size = 76928, upload-time = "2026-08-12T12:37:25.997Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/67/81/4add07e5172b7ac40d8ed5ff580409a7801a4fe26d529bdd915401dabfbe/typing_inspection-0.4.4-py3-none-any.whl", hash = "sha256:65b8397ba37ccbce054456aaccddfc91e6e3083c92824df348d96ca832f3f147", size = 14750, upload-time = "2026-08-12T12:37:24.648Z" }, +] + +[[package]] +name = "uvicorn" +version = "0.40.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "click" }, + { name = "h11" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c3/d1/8f3c683c9561a4e6689dd3b1d345c815f10f86acd044ee1fb9a4dcd0b8c5/uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea", size = 81761, upload-time = "2025-12-21T14:16:22.45Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3d/d8/2083a1daa7439a66f3a48589a57d576aa117726762618f6bb09fe3798796/uvicorn-0.40.0-py3-none-any.whl", hash = "sha256:c6c8f55bc8bf13eb6fa9ff87ad62308bbbc33d0b67f84293151efe87e0d5f2ee", size = 68502, upload-time = "2025-12-21T14:16:21.041Z" }, +]