From 85433e20e4102202451b2358c4a65075b2964b27 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= Date: Sat, 17 Oct 2026 20:21:04 +0300 Subject: [PATCH 1/5] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20=D0=BF=D1=80=D0=B8=D0=B2=D0=B0=D1=82=D0=BD=D1=8B=D0=B5?= =?UTF-8?q?=20=D0=B2=D0=BB=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F=20=D0=B8=20?= =?UTF-8?q?=D0=B1=D0=B5=D0=B7=D0=BE=D0=BF=D0=B0=D1=81=D0=BD=D1=83=D1=8E=20?= =?UTF-8?q?=D1=81=D0=B2=D0=B5=D1=80=D0=BA=D1=83=20PostgreSQL=20=D0=B8=20S3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 6 + .env.example | 2 + .github/pull_request_template.md | 35 +- .github/workflows/application.yml | 22 + .python-version | 1 + Dockerfile | 29 + Makefile | 20 +- REPORT.md | 383 +++++++++- SCHEMA.md | 75 ++ compose.test.yaml | 11 + compose.yaml | 194 ++++++ evidence/analysis.txt | 1 + evidence/audit.txt | 2 + evidence/bootstrap.txt | 2 + evidence/cluster.json | 307 ++++++++ evidence/cluster.txt | 4 + evidence/contracts.txt | 3 + evidence/failover.txt | 4 + evidence/lint.txt | 2 + evidence/persistence.txt | 3 + evidence/reconcile-cli.txt | 3 + evidence/runtime-sha256.json | 17 + evidence/s3-source-version.txt | 3 + evidence/smoke.txt | 2 + evidence/storage-basics.json | 249 +++++++ evidence/storage-research.png | Bin 0 -> 82340 bytes evidence/storage-seed.json | 1 + evidence/storage.json | 675 ++++++++++++++++++ evidence/storage.txt | 1 + evidence/student-tests.txt | 13 + evidence/topology.json | 90 +++ evidence/versions.txt | 8 + infra/api-policy.json | 1 + infra/bootstrap-s3.sh | 29 + infra/haproxy.cfg | 44 ++ infra/reconciler-policy.json | 1 + infra/s3.Dockerfile | 18 + infra/start-s3.sh | 5 + migrations/001_initial.sql | 37 + migrations/002_idempotency.sql | 14 + migrations/003_attachments.sql | 30 + pyproject.toml | 45 ++ research/analyze.py | 58 ++ scripts/bootstrap.py | 46 ++ scripts/cluster.py | 82 +++ scripts/restart.sh | 5 + scripts/rolling-update.py | 49 ++ scripts/stop-one.py | 48 ++ scripts/stop-one.sh | 4 + scripts/storage_lab.py | 45 ++ scripts/verify_cluster.py | 253 +++++++ scripts/verify_storage.py | 424 ++++++++++++ src/messenger/__init__.py | 1 + src/messenger/__main__.py | 24 + src/messenger/app.py | 337 +++++++++ src/messenger/attachments.py | 124 ++++ src/messenger/auth.py | 127 ++++ src/messenger/cache.py | 57 ++ src/messenger/cursor.py | 41 ++ src/messenger/domain.py | 79 +++ src/messenger/migrate.py | 46 ++ src/messenger/reconcile.py | 207 ++++++ src/messenger/repository.py | 353 ++++++++++ src/messenger/schemas.py | 120 ++++ src/messenger/service.py | 52 ++ src/messenger/settings.py | 57 ++ src/messenger/storage.py | 74 ++ student-tests/conftest.py | 85 +++ student-tests/test_api.py | 299 ++++++++ student-tests/test_attachments.py | 244 +++++++ student-tests/test_cluster.py | 137 ++++ uv.lock | 1075 +++++++++++++++++++++++++++++ 72 files changed, 6906 insertions(+), 39 deletions(-) create mode 100644 .github/workflows/application.yml create mode 100644 .python-version create mode 100644 Dockerfile create mode 100644 SCHEMA.md create mode 100644 compose.test.yaml create mode 100644 compose.yaml create mode 100644 evidence/analysis.txt create mode 100644 evidence/audit.txt create mode 100644 evidence/bootstrap.txt create mode 100644 evidence/cluster.json create mode 100644 evidence/cluster.txt create mode 100644 evidence/contracts.txt create mode 100644 evidence/failover.txt create mode 100644 evidence/lint.txt create mode 100644 evidence/persistence.txt create mode 100644 evidence/reconcile-cli.txt create mode 100644 evidence/runtime-sha256.json create mode 100644 evidence/s3-source-version.txt create mode 100644 evidence/smoke.txt create mode 100644 evidence/storage-basics.json create mode 100644 evidence/storage-research.png create mode 100644 evidence/storage-seed.json create mode 100644 evidence/storage.json create mode 100644 evidence/storage.txt create mode 100644 evidence/student-tests.txt create mode 100644 evidence/topology.json create mode 100644 evidence/versions.txt create mode 100644 infra/api-policy.json create mode 100644 infra/bootstrap-s3.sh create mode 100644 infra/haproxy.cfg create mode 100644 infra/reconciler-policy.json create mode 100644 infra/s3.Dockerfile create mode 100644 infra/start-s3.sh create mode 100644 migrations/001_initial.sql create mode 100644 migrations/002_idempotency.sql create mode 100644 migrations/003_attachments.sql create mode 100644 pyproject.toml create mode 100644 research/analyze.py create mode 100644 scripts/bootstrap.py create mode 100644 scripts/cluster.py create mode 100755 scripts/restart.sh create mode 100644 scripts/rolling-update.py create mode 100644 scripts/stop-one.py create mode 100755 scripts/stop-one.sh create mode 100644 scripts/storage_lab.py create mode 100644 scripts/verify_cluster.py create mode 100644 scripts/verify_storage.py create mode 100644 src/messenger/__init__.py create mode 100644 src/messenger/__main__.py create mode 100644 src/messenger/app.py create mode 100644 src/messenger/attachments.py create mode 100644 src/messenger/auth.py create mode 100644 src/messenger/cache.py create mode 100644 src/messenger/cursor.py create mode 100644 src/messenger/domain.py create mode 100644 src/messenger/migrate.py create mode 100644 src/messenger/reconcile.py create mode 100644 src/messenger/repository.py create mode 100644 src/messenger/schemas.py create mode 100644 src/messenger/service.py create mode 100644 src/messenger/settings.py create mode 100644 src/messenger/storage.py create mode 100644 student-tests/conftest.py create mode 100644 student-tests/test_api.py create mode 100644 student-tests/test_attachments.py create mode 100644 student-tests/test_cluster.py create mode 100644 uv.lock diff --git a/.dockerignore b/.dockerignore index bc16e556..af7fc017 100644 --- a/.dockerignore +++ b/.dockerignore @@ -17,4 +17,10 @@ backups __pycache__ node_modules evidence +student-tests +tests +research +REPORT.md +SCHEMA.md +requirements-dev.txt .DS_Store diff --git a/.env.example b/.env.example index d99d26a2..a0e40eef 100644 --- a/.env.example +++ b/.env.example @@ -18,3 +18,5 @@ S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key MAX_UPLOAD_BYTES=10485760 MAX_IMAGE_PIXELS=40000000 +PUBLIC_PORT=8084 +DATABASE_READ_AUTOCOMMIT=1 diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 1bec5472..a8077206 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,25 @@ ## Лабораторная 4 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Горбанюк / БВТ2301 +Целевая оценка: 5. Трек 2, согласованность двух хранилищ. -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Перенесена собственная lab3. Добавлены приватный MinIO, Attachment в PostgreSQL, +связи с Message, bounded PNG/JPEG upload, download с ACL через любую API, +раздельные S3 identities и отдельный reconciler с dry-run/grace/apply. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Запуск: `make bootstrap`, `uv sync --locked`, `make up`, `make test`. +Первый build собирает закреплённый официальный S3 release из исходников. +Команды собственных тестов, отказов и исследования: [REPORT.md](../REPORT.md). + +Проверены 65 тестов, публичные smoke/persistence/failover, остановка загрузившей +API и скачивание другой, прерванный body, S3 outage, десять параллельных uploads, +реальный aged orphan и сохранение свежих/used объектов, missing/restore и повтор +apply. Измерена стоимость обхода с paging при 0/100/1100 дополнительных объектах. + +Ограничения: один host, LB/DB/S3 остаются SPOF; утраченные bytes требуют backup/ +исходника, а не восстановления из SHA. Presigned flow не заявляется. Источники приведены в отчёте. Удалённый CI пока не запускался. + +- [x] Исходный README/COURSE/CONTRIBUTING/contracts/public tests не изменены. +- [x] Все заявленные проверки приведены в evidence. +- [x] Secret values, Bearer и private keys отсутствуют в Git и отчёте. +- [x] Условия сохранения volumes, cleanup и ограничения задокументированы. diff --git a/.github/workflows/application.yml b/.github/workflows/application.yml new file mode 100644 index 00000000..c40f8e04 --- /dev/null +++ b/.github/workflows/application.yml @@ -0,0 +1,22 @@ +name: Application integration +on: [push, pull_request] +permissions: + contents: read +jobs: + application: + runs-on: ubuntu-latest + timeout-minutes: 30 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.14.7' + - run: python -m pip install uv==0.12.13 + - run: uv sync --locked + - run: make bootstrap lint check + - run: VCS_REF=$(git rev-parse HEAD) docker compose --env-file .env -f compose.yaml -f compose.test.yaml up -d --build --wait + - run: PYTEST_ADDOPTS=--disable-warnings make test-student + - run: make test + - run: uv run --locked python scripts/verify_cluster.py --output /tmp/cluster-ci.json + - if: always() + run: docker compose --env-file .env -f compose.yaml -f compose.test.yaml down diff --git a/.python-version b/.python-version new file mode 100644 index 00000000..a128d5c0 --- /dev/null +++ b/.python-version @@ -0,0 +1 @@ +3.14.7 diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..7b6fb677 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,29 @@ +FROM python:3.14.7-slim-bookworm@sha256:82bc3c539b8813ada9d68c63b40158fa002f7f33de9bf3312a3dfdc0620dff56 AS builder +WORKDIR /app +RUN python -m pip install --no-cache-dir uv==0.12.13 +ENV UV_PYTHON_DOWNLOADS=never +COPY pyproject.toml uv.lock .python-version ./ +RUN --mount=type=cache,target=/root/.cache/uv uv sync --frozen --no-dev --no-install-project --compile-bytecode +COPY src ./src +RUN --mount=type=cache,target=/root/.cache/uv uv sync --frozen --no-dev --no-editable --compile-bytecode + +FROM python:3.14.7-slim-bookworm@sha256:82bc3c539b8813ada9d68c63b40158fa002f7f33de9bf3312a3dfdc0620dff56 +RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app +WORKDIR /app +COPY --from=builder /app/.venv /app/.venv +COPY migrations /app/migrations +ARG VCS_REF=uncommitted +LABEL org.opencontainers.image.revision=$VCS_REF +ENV PATH="/app/.venv/bin:$PATH" \ + PYTHONUNBUFFERED=1 \ + PYTHONDONTWRITEBYTECODE=1 \ + APP_HOST=0.0.0.0 \ + APP_PORT=8080 \ + APP_ENV=lab \ + APP_LOG_LEVEL=INFO +USER 10001:10001 +EXPOSE 8080 +STOPSIGNAL SIGTERM +HEALTHCHECK --interval=2s --timeout=2s --start-period=5s --retries=3 \ + CMD ["python", "-c", "import os, urllib.request; urllib.request.urlopen('http://127.0.0.1:' + os.environ.get('APP_PORT', '8080') + '/health/ready', timeout=1).close()"] +CMD ["python", "-m", "messenger"] diff --git a/Makefile b/Makefile index 5d86d171..cf6394bc 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ PYTHON ?= python3 -BASE_URL ?= http://localhost:8080 +BASE_URL ?= http://127.0.0.1:8084 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) @@ -28,3 +28,21 @@ 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) + +.PHONY: bootstrap up down image lint test-student verify reconcile +bootstrap: + $(PYTHON) scripts/bootstrap.py +up: + VCS_REF=$$(git rev-parse HEAD) docker compose --env-file .env up -d --build --wait +down: + docker compose --env-file .env down +image: + VCS_REF=$$(git rev-parse HEAD) docker compose --env-file .env build +lint: + uv run --locked ruff check src student-tests scripts/bootstrap.py scripts/cluster.py scripts/stop-one.py scripts/rolling-update.py scripts/verify_cluster.py scripts/verify_storage.py scripts/storage_lab.py research +test-student: + uv run --locked pytest --disable-warnings +verify: + uv run --locked python scripts/verify_cluster.py +reconcile: + docker compose --env-file .env run --rm reconciler diff --git a/REPORT.md b/REPORT.md index 9ad2b84f..e556f8da 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,372 @@ -# Отчёт — лабораторная 4 +# Лабораторная 4 — Горбанюк, БВТ2301 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +Целевая оценка: **5**, трек 2 «Согласованность двух хранилищ». Работа подготовлена +локально; fork/push/МР пока не выполнялись. Будущий заголовок: +`ЛР 4 — БВТ2301 — Горбанюк — на 5`. Проверенная версия отмечается `lab4-verified`. +Окончательную оценку выставляет преподаватель, публичный smoke — только минимум. -## Запуск из чистого clone +Перенесена собственная реализация lab3: слои HTTP/domain/service/repository, +сессии PostgreSQL, Argon2id, кэш Valkey, keyset-пагинация, две API за HAProxy, +идемпотентные сообщения, отдельный migrate, action hooks. README, COURSE, +CONTRIBUTING, contracts и публичные tests именно lab4 сохранены без изменений. +все заявленные результаты подтверждаются командами и evidence. -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +## Запуск из отдельного чистого clone -## Архитектура и решения +Нужны Docker Engine/Desktop + Compose v2, Git, Python 3.14.7 и uv 0.12.13. +Go на host не нужен: S3-сервер и клиент собираются внутри Docker. Первая сборка +требует доступа к реестрам, Python packages и Go modules и занимает заметное время. +Повторные сборки используют слои/cache. Нужны свободные RAM/диск для компиляции +и контейнеров; испытанный Docker-host: ARM64, 18 CPU, около 7.75 GiB RAM. -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +```sh +make bootstrap +uv sync --locked +make check +uv run --locked python scripts/validate_openapi.py +make up +make test +``` -## Доказательства критериев +Адрес клиента: **http://127.0.0.1:8084**, только локальные синтетические данные. +bootstrap создаёт новый случайный пароль PostgreSQL и отдельные S3 credentials +для root/API/reconciler/tests в игнорируемом secrets/, создаёт .env; существующие +значения не заменяет. Каталог 0700, файлы 0644 для non-root Compose secret mounts. +Не переносить чужие .env/secrets из lab3: у этой работы собственные volumes/проект. -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +`make up` собирает образы, поднимает PostgreSQL и S3, выполняет отдельные migrate +и bucket-init, затем API ×2/Valkey/HAProxy и ждёт readiness. Bucket-init идемпотентен: +создание bucket с ignore-existing, запрет anonymous, повторное применение scoped +policies/users с теми же локальными ключами. Все зависимости поднимаются здесь. +Ни S3 API/console, ни PostgreSQL/Valkey, ни API напрямую в обычном compose +не публикуются; единственный host-port — loopback HAProxy. -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +Для собственных тестов используется override. Он открывает только loopback +PostgreSQL 55435, Valkey 56382 и S3 API 59004 и создаёт отдельные test bucket/identity: -## Эксперименты и отказы +```sh +docker compose --env-file .env -f compose.yaml -f compose.test.yaml up -d --build --wait +make test-student +make lint +make test-failover ACTION_SCRIPT=scripts/stop-one.sh +# Вернуть остановленную реплику: +docker compose --env-file .env up -d --no-build --wait +make test-persistence ACTION_SCRIPT=scripts/restart.sh +``` -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Тестовая БД создаётся/удаляется отдельно; test bucket не совпадает с основным. +API основной системы не имеет credentials тестового bucket. Не запускать +разрушительные ручные тесты/эксперименты против данных вне этого учебного проекта. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +Полная проверка реальных контейнеров создаёт новые синтетические объекты: -## Ограничения и следующие шаги +```sh +make verify +``` -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +По умолчанию получается новое evidence/cluster-.json. Для сохранённого +запуска использовалось `--output evidence/cluster.json`. Проверяется stop каждой +API по очереди, реальный CID/PID, сообщения, rolling replacement и полный restart +включая S3. Восстанавливается остановленная реплика. Hook stop-one.sh требует +TARGET_INSTANCE_ID, публичный resilience.py передаёт его сам. + +Обычная остановка сохраняет PostgreSQL/S3 volumes: + +```sh +make down +``` + +Намеренно удалить **только учебные данные lab4**, если они больше не нужны: + +```sh +docker compose --env-file .env down --volumes +``` + +Скрипты не используют общий Docker prune и не останавливают другие лабораторные. + +## Архитектура и версии + +```mermaid +flowchart LR + C[Client] --> LB[HAProxy :8084] + LB --> A1[API 1] + LB --> A2[API 2] + A1 --> PG[(PostgreSQL: metadata, sessions, messages)] + A2 --> PG + A1 --> S3[(Private S3: original bytes)] + A2 --> S3 + A1 --> V[Valkey: disposable User cache] + A2 --> V + R[Reconciler: dry-run/apply] --> PG + R --> S3 +``` + +Детальная схема/протокол и ограничения — [SCHEMA.md](SCHEMA.md). Новая миграция 003: +Attachment, внутренний storage_state, связи с message; составные FK запрещают +вложение из другого чата. Сервер назначает UUID key originals/, filename +остаётся отображаемой строкой. Идентификация/ACL проверяются при upload, metadata, +content и отправке сообщения. Участник может прикрепить вложение другого участника +этого же чата. Посторонний получает 404. Публичный ответ не раскрывает object key. + +Используется реляционная модель для связей/транзакций, объектное хранилище для +байтов, stateless API и явный протокол восстановления. PostgreSQL — источник +сессий, членства и результатов повторов. Кэш не даёт право доступа. Sticky +sessions нет. Идемпотентность сообщения включает text и упорядоченные attachment_ids; +отсутствующий список равен []. Message + links + результат ключа коммитятся вместе. + +Версии: Python 3.14.7 (digest в Dockerfile), FastAPI 0.143.3, Pydantic 2.14.1, +psycopg 3.3.6, Argon2id через argon2-cffi 25.1.0, boto3 1.43.109, Pillow 13.0.0. +Точные транзитивные версии/hashes — uv.lock. PostgreSQL 18.3, Valkey 8.1.3-alpine, +HAProxy 3.2.1-alpine. Образы S3 собираются из официального исходного релиза MinIO +**RELEASE.2025-10-15T17-29-55Z** с исправлением CVE, mc — RELEASE.2025-08-13T08-35-41Z. +Готовые upstream Docker Hub теги оказались недоступны, поэтому используется +infra/s3.Dockerfile. Компилятор Go 1.26.7-alpine3.23 и runtime Alpine 3.23 закреплены +digest. Community-репозиторий MinIO архивный: это воспроизводимая учебная версия, +поддержка production здесь не заявляется. Go module source/tag и локальный image ID +фиксируются в доказательствах, а не подменяются обещанием latest. +Собранный через go install бинарник сообщает DEVELOPMENT.GOGET; это build label, +а точная исходная pseudo-version/commit и SumDB hash извлечены из Go build info +в [s3-source-version.txt](evidence/s3-source-version.txt). + +Миграции выполняются одной отдельной службой под advisory lock с checksum. +API сам DDL не запускает. Миграции 001/002 не менялись. 003 добавляет схему вложений, +но внешние wire-ответы lab4 изменились: старые lab3 API нельзя смешивать с lab4 за LB. +Rolling здесь — последовательное пересоздание процессов тем же образом, с +ожиданием готовности между шагами, не произвольное обновление бизнес-схемы. + +## Поток, безопасность и ограничение ресурсов + +Upload — raw PNG/JPEG, не multipart. Auth/ACL, filename и Content-Length проверяются +до чтения body. Опасные разделители, NUL/управляющие символы/суррогаты отклоняются. +Внешний MIME должен совпасть с PNG/JPEG, обнаруженным Pillow. До полной распаковки +проверяется площадь; verify и повторное load отсекают повреждённый поток. Байты +никогда не перекодируются, SHA-256 считается инкрементально. + +На API одновременно обрабатывается **один upload**, остальные ждут до 5 s, +потом 429. Сам поток ограничен 15 s и фактическими **10 485 760 bytes**; объявленному +Content-Length без проверки не доверяем. **40 000 000 пикселей** проверяются до load. +Анонимный временный файл находится в tmpfs 32 MiB и закрывается при успехе, +ошибке или отключении клиента. Это scratch, от него не зависит доступность файла +после 201. RAM декодера зависит от ограниченной площади, не только сжатых bytes; +один слот не даёт десяти декодерам одновременно занять память одной API. + +Boto3 выполняет один PutObject ≤10 MiB: multipart transfer/автоматических retries +нет, connect timeout 0.5 s, socket read timeout 2 s. Повтор сообщения защищён +Idempotency-Key, повтор upload может создать новое вложение. SDK/SQL/декодирование +выполняются вне event loop. Download передаёт 64 KiB chunks через API с ACL, +Content-Length, истинным Content-Type, безопасным Content-Disposition и nosniff; +redirect в S3 нет. Клиент проверяет итоговый SHA. Разрыв stream после начала ответа +нельзя превратить в JSON-ошибку задним числом: такой GET нужно повторить. + +API: 1 CPU / 512 MiB, readonly filesystem, UID 10001, cap_drop ALL, tmpfs 32 MiB, +один Uvicorn worker. PostgreSQL: 1 CPU / 768 MiB; S3: 1 CPU / 768 MiB; +Valkey: 0.5 CPU / 128 MiB; LB: 0.5 CPU / 128 MiB. API swap сверх лимита запрещён. +API не публикует порт и не имеет container_name. Пулы/SQL timeout сохранены из lab3. +SIGTERM: Uvicorn перестаёт принимать соединения, grace 5 s, Compose ждёт 7 s. +Не подтвердившийся upload оставляет pending, который восстановит сверка. + +HAProxy: round-robin, readiness каждые 500 ms, fall 2/rise 1, connect/check 500 ms, +Docker DNS обновляется с hold valid 1 s; адреса не зашиты. LB client timeout 20 s, +server timeout 30 s учитывают bounded upload. Readiness требует PostgreSQL и S3; +при отказе S3 LB может временно исключить все API. Valkey не критичен. + +Приватность/права: API identity умеет Get/Put только в originals/ основного bucket, +List/GetLocation только этого bucket для readiness. Нет DeleteObject, bucket/admin +операций или доступа к чужому bucket. Reconciler имеет List/Get/Delete своего +prefix, без Put. Root передан только S3/bootstrap. Консоль привязана к loopback +внутри S3-контейнера и не опубликована. Отдельный test identity ограничен test bucket. +Secret values отсутствуют в Git, образах, evidence и логах; локальные secret mounts +не заменяют защиту Docker-host и secret manager удалённого окружения. + +## Согласованность и сверка: трек 2 + +201 возвращается после PUT и COMMIT ready. До PUT уже есть устойчивый pending. +Это не двухфазный COMMIT между S3 и PostgreSQL. При отключении клиента до конца +body не создаются ни intent, ни S3 объект; после intent любой неясный исход остаётся +учтённым. Сверка отдельно восстанавливает запись или удаляет брошенное намерение. + +```sh +make reconcile # только dry-run +# Изменения включаются явно: +docker compose --env-file .env run --rm reconciler python -m messenger.reconcile --apply --grace-seconds 300 +``` + +Grace не может быть меньше 300 s. CLI работает постранично (S3 до 1000 объектов, +PostgreSQL до 100 строк), preview до 100 actions, counters полные. Один reconciler +на БД благодаря advisory lock, исправляемые строки блокируются FOR UPDATE. + +| Обнаружено | Безопасное исправление после grace | +| --- | --- | +| Старый orphan нашего UUID-prefix без metadata | Повторный HEAD, проверка ETag/size/возраста, DELETE только этого объекта | +| Старый pending, PUT сохранил правильный объект | ready; checksum/size/MIME сверяются с намерением | +| Старый pending, подтверждённое 404 объекта, нет links | Удаление брошенного намерения | +| Ready, объект пропал/не соответствует metadata | missing, metadata и Message links сохраняются; API выдаёт 409 | +| Missing, правильный оригинал восстановлен оператором | ready, тот же ID и связи | +| Свежие объекты/намерения, ready с/без Message links | Не удаляются | +| Сетевой сбой, 403, 5xx | Проход завершается ошибкой, это не отсутствие объекта | +| Неожиданные bytes у pending | Review action, автоматическое удаление запрещено | + +S3 LIST и HEAD имеют разную точность даты. Проверяется возраст обеих наблюдаемых +записей и ETag/size, а не точное равенство LastModified. ETag используется как +проверка неизменности, не как SHA оригинала. Приложение не переиспользует ключи. +Сторонний writer с правом overwrite не должен менять originals/ во время сверки. + +В dry-run нет изменений данных. Повтор apply сходится к отсутствию новых actions. +При ошибке часть независимых исправлений могла уже закоммититься; запуск можно +повторить. Потерянные bytes нельзя восстановить из SHA: для фактического восстановления +нужна исходная копия/backup. Сверка проверяет HEAD metadata, а не перехеширует весь +bucket; сквозные проверки отдельно скачивают оригинал и считают SHA. + +## Команды исследований и критерии + +Для проверки настоящего orphan нужен его **реальный** возраст ≥300 s, часы S3 +не подменяются. Сначала создать seed, затем выполнять прочие проверки: + +```sh +uv run --locked python scripts/verify_storage.py --seed evidence/storage-seed-new.json +make test-student +make verify +# Когда LastModified seed старше 300 s: +uv run --locked python scripts/verify_storage.py --seed-file evidence/storage-seed-new.json --output evidence/storage-new.json +uv run --locked --group research python research/analyze.py evidence/storage-new.json +``` + +Сохранённый запуск разбит на базовые проверки и продолжение после aging +(`--resume-basics evidence/storage-basics.json`); memory/cost повторены отдельно +на финальном образе без параллельного запуска тестов. Итоговый набор — storage.json. +Скрипт отказывается перезаписывать output. Для графиков сохранённой серии +analyze.py читает evidence/storage.json. Raw содержит cgroup readings, времена +каждой загрузки, CID/alias и counters/время всех проходов сверки, без токенов. + +| Критерий | Проверка | Доказательство | +| --- | --- | --- | +| Исходный skeleton/OpenAPI | make check; validate_openapi | [contracts.txt](evidence/contracts.txt) | +| Весь API lab4 и прежние возможности | make test; make test-student | [smoke.txt](evidence/smoke.txt), [student-tests.txt](evidence/student-tests.txt) | +| PNG/JPEG, MIME, лимиты, ACL, чужой chat/id | 65 собственных тестов с настоящими PG/S3 | [test_attachments.py](student-tests/test_attachments.py) | +| Байты с другой API после stop загрузившей | cross_replica в verify_storage | [storage.json](evidence/storage.json) | +| Сохранность metadata/bytes/session при restart | публичный persistence, StartedAt PG/Valkey/S3/LB | [persistence.txt](evidence/persistence.txt), [cluster.json](evidence/cluster.json) | +| Каждая API, идемпотентность, rolling | make verify | [cluster.json](evidence/cluster.json) | +| Приватный bucket и ограниченный API user | анонимный GET 403, Delete/other bucket 403 | [storage.json](evidence/storage.json) | +| Прерванный body / отказ S3 | raw TCP abort; реальный stop/start S3 | [storage.json](evidence/storage.json) | +| PUT прошёл, DB finalize упал; PUT не прошёл | injected failure между шагами, dry-run/apply/repeat | [test_attachments.py](student-tests/test_attachments.py) | +| ≥10 загрузок, bounded RAM | барьер 10 клиентов, два размера, kernel memory.peak | [storage.json](evidence/storage.json) | +| Orphan/missing, свежие/used защищены | реальный aged orphan, удаление used bytes, восстановление | [storage.json](evidence/storage.json) | +| Стоимость обхода | 0/100/1100 дополнительных объектов, 3 dry-run повтора | [storage.json](evidence/storage.json) | + +## Наблюдаемые результаты + +65 собственных тестов и публичный smoke прошли. Публичные persistence/failover +сохранили прежнюю сессию и оригинал; реальный S3 stop дал два 503, после start +тот же файл снова скачался. Консоль недоступна из API, повторный bucket bootstrap +дважды завершился успешно с теми же credentials и данными. + +| Серия загрузок | Клиенты | Успешные RPS | p50/p95/p99, ms | Максимум memory.peak одной API, MiB | Ошибки | +| --- | ---: | ---: | --- | ---: | ---: | +| 1,081,015 bytes, 360,000 pixels | 10 | 58.07 | 121.6/159.4/159.4 | 162.77 | 0 | +| 8,674,572 bytes, 2,890,000 pixels | 10 | 13.52 | 500.3/726.9/726.9 | 163.62 | 0 | + +Средняя суммарная загрузка CPU двух API по delta cgroup cpu.stat: 0.58 ядра, 0.91 ядра +для малого/большого payload. Окно включает probes чтения счётчиков и служебные процессы после readiness; это короткая усреднённая оценка, не CPU p95. Raw cpu.stat +сохранён в before/after каждой серии. + +Kernel peak около 163 MiB при лимите 512 MiB. Он включает startup (в том числе +Argon2id) и является верхней границей за весь trial. Из близости двух peak +не следует, что размер файла не влияет на RAM: эксперимент не отделяет пик +startup от пика декодирования. Файлы больше проверенных размеров, но в пределах +10 MiB/40 млн pixels, покрыты лимитами реализации; их полная матрица RAM не измерялась. + +| Дополнительные fresh S3 objects | dry-run min / median / max, ms | LIST pages | +| ---: | --- | --- | +| 0 | 137.78 / 141.20 / 184.41 | 1,1,1 | +| 100 | 150.60 / 163.01 / 166.15 | 1,1,1 | +| 1100 | 189.81 / 216.18 / 233.53 | 2,2,2 | + +Настоящий orphan был выдержан 503.0 s. Dry-run обнаружил +его и брошенный intent, но не изменил S3/БД; apply удалил ровно эти объекты, +повторный apply вернул пустой actions. Свежий orphan сохранён. Для used-вложения +после удаления bytes dry-run показал mark_missing без изменения metadata; +apply сохранил ID и Message link и перевёл запись в missing. После возврата +правильных bytes следующий проход вернул ready, download снова совпал с fixture. +Это подтверждённое улучшение протокола: сбой между двумя хранилищами больше не +оставляет незаметный вечный orphan/pending; он обнаруживается и сходится к явному +состоянию. Это не обещание восстановления без исходных bytes. + +| Воздействие API | Успешные RPS | Ошибки/попытки | Успех после hook, s | p95, ms | +| --- | ---: | --- | ---: | ---: | +| Остановка API 1 | 421.2 | 167/2615 | 2.225 | 31.2 | +| Остановка API 2 | 334.3 | 153/1964 | 1.819 | 44.8 | +| Rolling replacement | 432.3 | 287/7903 | 13.610 | 47.9 | + +Каждая остановка укладывается в 10 s; подтверждённые сообщения сохранены. +first_success_after_action_seconds отсчитывается от старта hook до первого +успеха после его завершения, это не длительность сплошного простоя. Другая API +может отвечать в течение hook. В stopped хранится паспорт процесса до stop; +скрипт отдельно проверяет running=false. Проверка cross_replica сохраняет также +фактический after_stop с running=false и alias другой скачавшей API. + +![RAM загрузок и стоимость сверки](evidence/storage-research.png) + +CPU/RAM лимиты проверялись inspect. Kernel memory.peak включает Python, decoder, +tmpfs, page cache и startup; это не process RSS и не усреднение Docker stats. +Каждый размер испытывался одной серией из 10 клиентов, API пересоздавались до +серии. Десять клиентов не означают десять одновременных декодеров: именно gate +ограничивает активную обработку, остальные ждут, все десять завершились успешно. +Короткие локальные измерения не являются production capacity/SLO. + +Стоимость сверки измерена при неизменном числе metadata и росте числа свежих +S3 objects. Это проверяет paging и постоянные накладные расходы; масштабирование +по числу metadata отдельно не измерялось. LIST стоит O(objects/1000), индексированный +DB lookup нужен для старых объектов, HEAD — для старых metadata. Нет вывода, будто +полное чтение/хеширование всех bytes столь же дёшево. Три повтора дают min/median/max, +не статистический доверительный интервал. Обе API и health probes работают во время +замеров, остальные тесты/сборки не запускаются. + +## Вопросы на защите + +**Почему Docker volume одной API не равен S3?** Локальный файл зависит от выбранного +host/контейнера и не появляется у соседней реплики. S3 — общий адресуемый сервис +с object key, API хранения и отдельными правами. Временный tmpfs здесь нужен только +во время запроса; после 201 оригинал читается из общего S3, что проверено остановкой +uploading process. S3 volume тоже нуждается в защите от отказа диска/host. + +**Когда честно вернуть 201?** Когда bytes полностью приняты, проверены, PUT успешно +подтверждён и metadata ready закоммичена. Возвращать 201 после помещения в локальную +память нельзя. В lab5 будет другой контракт: 202 после устойчивого staging и +надёжного сохранения намерения обработки; ready появится позже. + +**PUT прошёл, а COMMIT — нет?** Два хранилища не откатываются одной SQL-транзакцией. +До PUT уже сохранён pending, поэтому объект не теряется из учёта. После grace +reconciler сверит key/checksum/size/MIME и восстановит ready. Если Put не дошёл, +старый пустой intent удалится. Если metadata вообще нет, старый orphan удаляется +после дополнительной проверки. HTTP timeout сам по себе не доказывает rollback. + +**Почему случайный key/private bucket не заменяют ACL?** Случайность — защита от +угадывания, приватность — от анонимного S3. Любой участник приложения всё равно +может знать ID чужого вложения. Только проверка действительной сессии и членства +в конкретном чате на metadata/content/message запрещает чужой доступ. Автор +выводится из сессии, filename/key не используются как доказательство прав. + +## Ограничения и продолжение + +Защищён отказ одной API, но host/LB/PostgreSQL/MinIO и их диски остаются SPOF. +Backup/PITR/репликация storage не заявляются. Это локальный HTTP-стенд с вымышленными +данными; удалённая демонстрация потребует TLS. Presigned upload (трек 1) не реализован. +Готовые неиспользованные вложения сохраняются; политики удаления истории нет. +Для неожиданного несовпадения pending требуется оператор, оно явно видно в report. +Reconciler запускается вручную по команде; для регулярной эксплуатации его нужно +запускать по расписанию, вечное автоматическое исправление без запуска не обещается. + +В lab5 появятся устойчивое staging, outbox/job, брокер и worker. Объекты очереди +будут ссылками, не bytes. Потребуются lease/retry и защита активной обработки от GC; +обязательный thumbnail будет отдельным вариантом. Lab4 останется независимым +проверенным репозиторием, его контракт 201 ready не меняется будущей работой. + +## Источники + +- [README](README.md), [семантика](contracts/README.md), [COURSE](COURSE.md). +- [Официальный релиз MinIO с исправлением CVE](https://github.com/minio/minio/releases/tag/RELEASE.2025-10-15T17-29-55Z). +- [MinIO policy access](https://docs.min.io/aistor/administration/iam/access/). +- [Pillow Image API](https://pillow.readthedocs.io/en/stable/reference/Image.html): lazy open, verify, pixel guard. +- [Boto3 retries](https://docs.aws.amazon.com/boto3/latest/guide/retries.html). +- [AWS S3 object uploads](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html). +- [Linux cgroup v2 memory interface](https://docs.kernel.org/admin-guide/cgroup-v2.html): memory.current/peak/max. diff --git a/SCHEMA.md b/SCHEMA.md new file mode 100644 index 00000000..3e71eb17 --- /dev/null +++ b/SCHEMA.md @@ -0,0 +1,75 @@ +# Lab4: метаданные, байты и восстановление + +Основа — собственная lab3. PostgreSQL хранит users/chats/sessions/messages и +результаты Idempotency-Key. Valkey — восстанавливаемый кэш User. В lab4 добавлены +Attachment и message_attachments; оригиналы находятся в приватном S3. + +Миграции 001/002 перенесены без изменения checksum. 003 допускает пустой text +для сообщения с вложением и добавляет таблицы. Обязательность содержимого +проверяет модель HTTP; составные FK в message_attachments гарантируют один chat +у сообщения и вложения. Position сохраняет порядок ID. До десяти уникальных ID, +проверка доступности и вставка связей входят в транзакцию message + request result. +Для текстового POST отсутствие attachment_ids и [] дают один hash. + +Attachment имеет id/chat/owner, отображаемый filename, фактический MIME, +size_bytes, SHA-256, серверный object_key, storage_state и timestamps. +Object key: originals/; имена не используются как пути. +Storage_state — внутреннее состояние pending/ready/missing. Внешняя схема lab4 +позволяет только ready; для pending/missing API возвращает 409, а не выдумывает +несуществующий статус. Чужой чат — 404, перед любым GET выполняется ACL. + +## Загрузка + +1. Auth/ACL и filename/MIME/Content-Length проверяются до чтения файла. +2. Один активный upload на процесс. До входа очередь ждёт максимум 5 s. +3. Request.stream читается с общим бюджетом 15 s и счётчиком фактических bytes. + Временный анонимный файл — только ограниченная scratch-копия на tmpfs 32 MiB. +4. Pillow читает заголовок и проверяет площадь до декодирования; verify + повторное + load отклоняют повреждённые PNG/JPEG. Байты не перекодируются. SHA считается + инкрементально по исходному потоку. Размер ≤10 MiB, площадь ≤40 млн пикселей. +5. COMMIT записи pending с известными key/checksum **до** S3 PUT. +6. PUT целого объекта; затем отдельный COMMIT перевода в ready; только затем 201. + +Падение до шага 5 не создаёт объектов. После 5 любой исход PUT/COMMIT остаётся +связан с устойчивым намерением. Состояние 201 не кэшируется до COMMIT. +Повтор upload может создать новое вложение: Idempotency-Key гарантирует повтор +сообщения, а не бинарного POST. Прямой загрузки и multipart upload здесь нет. + +## Сверка + +Отдельный CLI с отдельным S3 identity; dry-run по умолчанию. --apply разрешает +исправления. Минимальный grace — 300 s, заметно больше штатной загрузки/остановки. +Ключи не переиспользуются и не перезаписываются приложением. Сверка берёт advisory +lock на весь запуск, обрабатывает списки постранично, строки — под FOR UPDATE. + +- Orphan: старый объект строго нашего UUID-prefix без строки Attachment. + Повторный HEAD проверяет ETag, размер и возраст непосредственно перед DELETE. + LIST и HEAD имеют разную точность timestamp, точное равенство дат не требуется. + Свежий объект пропускается, другие prefix/buckets не затрагиваются. +- Старый pending + существующий совпадающий объект → ready. Это восстановление + случая «PUT завершён, финальный COMMIT/HTTP не подтверждён». +- Старый pending + подтверждённое отсутствие объекта → удаление намерения, + только если нет message relation. Свежие намерения защищены. +- Старый ready + отсутствующие/несогласованные bytes → missing; строка и ссылки + сохраняются. GET возвращает 409. Сверка не способна восстановить утраченные байты + из SHA; после восстановления правильного оригинала она возвращает ready. +- Ready-объекты, даже не прикреплённые к сообщению, не удаляются. Действующие ссылки + никогда не удаляются. Ошибки сети/403/5xx не трактуются как 404. +- Несогласованный pending с чужими checksum/size/MIME требует оператора; + report содержит review_invalid_pending. Автоматически удалять такие bytes нельзя. + +Сравнение HeadObject проверяет size/MIME/метаданные SHA, а не повторно хеширует +все bytes; полная проверка SHA выполняется клиентскими сценариями скачивания. +Обычный проход: LIST O(objects/1000), индексированный lookup для старых объектов, +HEAD для старых metadata, O(metadata) строк. Память ограничена страницами и +100 записями preview, counters учитывают весь проход. При ошибке часть apply +могла уже завершиться: повторный запуск безопасен и доводит сверку до результата. + +## Границы гарантий + +Это протокол восстановления двух независимых хранилищ, не распределённая ACID +транзакция. PostgreSQL/S3/диск/LB и host остаются SPOF. Глобальные backup/PITR не +реализованы. Clock skew предполагается значительно меньше grace. Поддерживаются +только серверные неизменяемые UUID-ключи; сторонний writer с правом перезаписи +не должен менять их во время сверки. Для lab5 придётся учесть lease активного worker +и staging-prefix: этот CLI не должен удалять объекты по ещё активному заданию. diff --git a/compose.test.yaml b/compose.test.yaml new file mode 100644 index 00000000..84afb277 --- /dev/null +++ b/compose.test.yaml @@ -0,0 +1,11 @@ +# Only DB/cache test ports; API replicas always stay behind the LB. +services: + postgres: + ports: ["127.0.0.1:${TEST_PG_PORT:-55435}:5432"] + valkey: + ports: ["127.0.0.1:${TEST_CACHE_PORT:-56382}:6379"] + s3: + ports: ["127.0.0.1:${TEST_S3_PORT:-59004}:9000"] + bucket-init: + environment: + CREATE_TEST_BUCKET: '1' diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..eff96437 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,194 @@ +name: mtusi-lab4 + +x-api: &api + image: ${API_IMAGE:-mtusi-messenger:lab4} + build: + context: . + args: + VCS_REF: ${VCS_REF:-uncommitted} + user: "10001:10001" + read_only: true + tmpfs: ["/tmp:rw,noexec,nosuid,size=32m"] + cap_drop: [ALL] + security_opt: [no-new-privileges:true] + pids_limit: 96 + cpus: ${API_CPU:-1} + mem_limit: ${API_MEMORY:-512m} + memswap_limit: ${API_MEMORY:-512m} + stop_grace_period: 7s + secrets: + - database_url + - cache_url + - source: s3_api_access_key_id + target: s3_access_key_id + - source: s3_api_secret_access_key + target: s3_secret_access_key + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + APP_ENV: lab4 + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + DATABASE_READ_AUTOCOMMIT: ${DATABASE_READ_AUTOCOMMIT:-1} + DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-8} + DATABASE_URL_FILE: /run/secrets/database_url + CACHE_URL_FILE: /run/secrets/cache_url + S3_ENDPOINT: ${S3_ENDPOINT:-http://s3:9000} + MAX_UPLOAD_BYTES: ${MAX_UPLOAD_BYTES:-10485760} + MAX_IMAGE_PIXELS: ${MAX_IMAGE_PIXELS:-40000000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_ID_FILE: /run/secrets/s3_access_key_id + S3_SECRET_ACCESS_KEY_FILE: /run/secrets/s3_secret_access_key + networks: [backend] + +services: + postgres: + image: postgres:18.3 + environment: + POSTGRES_USER: messenger + POSTGRES_DB: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: [postgres_password] + volumes: [postgres_data:/var/lib/postgresql] + command: [postgres, -c, fsync=on, -c, synchronous_commit=on, -c, full_page_writes=on, + -c, shared_preload_libraries=pg_stat_statements] + healthcheck: + test: [CMD-SHELL, "pg_isready -U messenger -d messenger"] + interval: 2s + timeout: 2s + retries: 30 + cpus: ${POSTGRES_CPU:-1} + mem_limit: 768m + memswap_limit: 768m + networks: [backend] + valkey: + image: valkey/valkey:8.1.3-alpine + command: [valkey-server, --save, "", --appendonly, "no", --maxmemory, 64mb, + --maxmemory-policy, allkeys-lru] + healthcheck: + test: [CMD, valkey-cli, ping] + interval: 2s + timeout: 1s + retries: 20 + cpus: 0.5 + mem_limit: 128m + memswap_limit: 128m + networks: [backend] + migrate: + <<: *api + command: [python, -m, messenger.migrate] + secrets: [database_url] + healthcheck: {disable: true} + depends_on: + postgres: {condition: service_healthy} + api: + <<: *api + deploy: + replicas: ${API_REPLICAS:-2} + depends_on: + migrate: {condition: service_completed_successfully} + valkey: {condition: service_healthy} + bucket-init: {condition: service_completed_successfully} + lb: + image: haproxy:3.2.1-alpine + volumes: [./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro] + ports: ["127.0.0.1:${PUBLIC_PORT:-8084}:8080"] + read_only: true + tmpfs: ["/tmp:rw,noexec,nosuid,size=4m"] + cap_drop: [ALL] + security_opt: [no-new-privileges:true] + cpus: 0.5 + mem_limit: 128m + memswap_limit: 128m + healthcheck: + test: [CMD, wget, -q, -O, /dev/null, http://127.0.0.1:8080/health/ready] + interval: 2s + timeout: 2s + retries: 30 + depends_on: + api: {condition: service_healthy} + networks: [backend] + + s3: + image: mtusi-lab4-s3:2025-10-15 + build: {context: ., dockerfile: infra/s3.Dockerfile, target: server} + command: [server, /data, --address, ':9000', --console-address, '127.0.0.1:9001'] + secrets: [s3_root_user, s3_root_password] + volumes: [s3_data:/data] + read_only: true + tmpfs: ["/tmp:rw,noexec,nosuid,size=32m"] + cap_drop: [ALL] + cpus: 1 + mem_limit: 768m + memswap_limit: 768m + healthcheck: + test: [CMD, wget, -q, -O, /dev/null, 'http://127.0.0.1:9000/minio/health/live'] + interval: 2s + timeout: 1s + retries: 30 + networks: [backend] + bucket-init: + image: mtusi-lab4-mc:2025-08-13 + build: {context: ., dockerfile: infra/s3.Dockerfile, target: client} + command: [/bootstrap-s3.sh] + volumes: + - ./infra/bootstrap-s3.sh:/bootstrap-s3.sh:ro + - ./infra/api-policy.json:/policies/api-policy.json:ro + - ./infra/reconciler-policy.json:/policies/reconciler-policy.json:ro + secrets: [s3_root_user, s3_root_password, s3_api_access_key_id, s3_api_secret_access_key, + s3_reconciler_access_key_id, s3_reconciler_secret_access_key, + s3_test_access_key_id, s3_test_secret_access_key] + environment: + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + read_only: true + tmpfs: ["/tmp:rw,noexec,nosuid,size=16m"] + cpus: 0.5 + mem_limit: 128m + networks: [backend] + depends_on: + s3: {condition: service_healthy} + reconciler: + <<: *api + profiles: [tools] + command: [python, -m, messenger.reconcile] + healthcheck: {disable: true} + secrets: + - database_url + - cache_url + - source: s3_reconciler_access_key_id + target: s3_access_key_id + - source: s3_reconciler_secret_access_key + target: s3_secret_access_key + depends_on: + migrate: {condition: service_completed_successfully} + bucket-init: {condition: service_completed_successfully} + +networks: + backend: {} +volumes: + s3_data: + postgres_data: +secrets: + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + cache_url: + file: ./secrets/cache_url + s3_root_user: + file: ./secrets/s3_root_user + s3_root_password: + file: ./secrets/s3_root_password + s3_api_access_key_id: + file: ./secrets/s3_api_access_key_id + s3_api_secret_access_key: + file: ./secrets/s3_api_secret_access_key + s3_reconciler_access_key_id: + file: ./secrets/s3_reconciler_access_key_id + s3_reconciler_secret_access_key: + file: ./secrets/s3_reconciler_secret_access_key + s3_test_access_key_id: + file: ./secrets/s3_test_access_key_id + s3_test_secret_access_key: + file: ./secrets/s3_test_secret_access_key diff --git a/evidence/analysis.txt b/evidence/analysis.txt new file mode 100644 index 00000000..03043441 --- /dev/null +++ b/evidence/analysis.txt @@ -0,0 +1 @@ +PASS: research figure generated from storage.json diff --git a/evidence/audit.txt b/evidence/audit.txt new file mode 100644 index 00000000..1a3025df --- /dev/null +++ b/evidence/audit.txt @@ -0,0 +1,2 @@ +PASS: 101 candidate/versioned files; 45 reachable objects; no requested names or local credentials. +PASS: instructor files unchanged, upstream push disabled. diff --git a/evidence/bootstrap.txt b/evidence/bootstrap.txt new file mode 100644 index 00000000..53d790d6 --- /dev/null +++ b/evidence/bootstrap.txt @@ -0,0 +1,2 @@ +PASS: private bucket and scoped identities ready +PASS: private bucket and scoped identities ready diff --git a/evidence/cluster.json b/evidence/cluster.json new file mode 100644 index 00000000..2d626560 --- /dev/null +++ b/evidence/cluster.json @@ -0,0 +1,307 @@ +{ + "initial_instances": [ + { + "id": "79907dfdbd61808088ab2f17ab8cc4e5760c9dc8d20f38e726e830629e9a66bc", + "started_at": "2026-10-17T16:54:30.42283897Z", + "pid": 10590, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "fccb137fe0244ddf98a9e454eab19756" + }, + { + "id": "47d2cb2718e3c28a5e08cf1932d3e715aa6df2fb7253e161adb1f139ed75da19", + "started_at": "2026-10-17T16:54:30.345976304Z", + "pid": 10534, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "1ee65c20c8df4f808677d83c6556e18d" + } + ], + "failures": [ + { + "duration_seconds": 5.81228291700063, + "workers": 6, + "requests": 2615, + "successes": 2448, + "errors": 167, + "successful_rps": 421.1770202788521, + "error_fraction": 0.06386233269598471, + "first_success_after_action_seconds": 2.225296332999278, + "action_seconds": 1.7712559159990633, + "p50_ms": 8.855707999828155, + "p95_ms": 31.16029100056039, + "p99_ms": 73.12783300039882, + "instances": [ + "1ee65c20c8df4f808677d83c6556e18d", + "fccb137fe0244ddf98a9e454eab19756" + ], + "tail_instances": [ + "1ee65c20c8df4f808677d83c6556e18d" + ], + "confirmed_writes": 243, + "stopped": { + "id": "79907dfdbd61808088ab2f17ab8cc4e5760c9dc8d20f38e726e830629e9a66bc", + "started_at": "2026-10-17T16:54:30.42283897Z", + "pid": 10590, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "fccb137fe0244ddf98a9e454eab19756" + } + }, + { + "duration_seconds": 5.416828084000372, + "workers": 6, + "requests": 1964, + "successes": 1811, + "errors": 153, + "successful_rps": 334.32849850803495, + "error_fraction": 0.07790224032586558, + "first_success_after_action_seconds": 1.8193489170007524, + "action_seconds": 1.3782874589996936, + "p50_ms": 10.209916999883717, + "p95_ms": 44.78274999928544, + "p99_ms": 68.33825000103388, + "instances": [ + "1ee65c20c8df4f808677d83c6556e18d", + "ec543faccabb4b4d856cb21490da98d9" + ], + "tail_instances": [ + "ec543faccabb4b4d856cb21490da98d9" + ], + "confirmed_writes": 179, + "stopped": { + "id": "47d2cb2718e3c28a5e08cf1932d3e715aa6df2fb7253e161adb1f139ed75da19", + "started_at": "2026-10-17T16:54:30.345976304Z", + "pid": 10534, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "1ee65c20c8df4f808677d83c6556e18d" + } + } + ], + "concurrent_replays": 30, + "concurrent_effects": 1, + "rolling": { + "duration_seconds": 17.618615958999726, + "workers": 6, + "requests": 7903, + "successes": 7616, + "errors": 287, + "successful_rps": 432.27004991329574, + "error_fraction": 0.03631532329495128, + "first_success_after_action_seconds": 13.610468083001251, + "action_seconds": 13.610214250000354, + "p50_ms": 9.198334000757313, + "p95_ms": 47.916500001520035, + "p99_ms": 80.57516699955158, + "instances": [ + "156f31907e404f4b82cd2ece01102a69", + "5ae9d1ba363c48999bc872e0a1648271", + "c8354af5dac443e3afdfc970ba76d70e", + "ec543faccabb4b4d856cb21490da98d9" + ], + "tail_instances": [ + "156f31907e404f4b82cd2ece01102a69", + "5ae9d1ba363c48999bc872e0a1648271" + ], + "confirmed_writes": 759, + "replacements": [ + { + "old_container": "79907dfdbd61808088ab2f17ab8cc4e5760c9dc8d20f38e726e830629e9a66bc", + "old_instance": "ec543faccabb4b4d856cb21490da98d9", + "live_instances": [ + "5ae9d1ba363c48999bc872e0a1648271", + "c8354af5dac443e3afdfc970ba76d70e" + ] + }, + { + "old_container": "47d2cb2718e3c28a5e08cf1932d3e715aa6df2fb7253e161adb1f139ed75da19", + "old_instance": "c8354af5dac443e3afdfc970ba76d70e", + "live_instances": [ + "156f31907e404f4b82cd2ece01102a69", + "5ae9d1ba363c48999bc872e0a1648271" + ] + } + ], + "confirmed_messages_preserved": true + }, + "persistence": { + "before": { + "postgres": { + "id": "a6e5f14597245ada8071635bf261c294e53045ee0d09bbea1cd682681cfacd9c", + "started_at": "2026-10-17T16:54:25.66952526Z", + "pid": 9916, + "running": true, + "image": "sha256:7e32e9833a6fb1c92c32552794cb6ed569d51b445a54907d35fc112ef39684db", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "5432/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "55435" + } + ] + } + }, + "valkey": { + "id": "1899ba79d40145cd3ff95269e73076e3b2ba74a472e4427f204da8e9c52592b6", + "started_at": "2026-10-17T16:54:25.484294468Z", + "pid": 9764, + "running": true, + "image": "sha256:d827e7f7552cdee40cc7482dbae9da020f42bc47669af6f71182a4ef76a22773", + "memory": 134217728, + "nano_cpus": 500000000, + "published_ports": { + "6379/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "56382" + } + ] + } + }, + "s3": { + "id": "69b2b1d137ebb6ad0c9790189e0d858267596ea1481297fe1db1d21b37a25002", + "started_at": "2026-10-17T16:54:25.588696677Z", + "pid": 9841, + "running": true, + "image": "sha256:bd904439d1bb8ba4bbff8886ca4b91eb446b01891cc4ee8a4668a38b700bad7e", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "9000/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "59004" + } + ] + } + }, + "lb": { + "id": "f7affe8e1b5904cb78f8ac5d43bab11da4006dd9d933118be1696ec36b8fc1b3", + "started_at": "2026-10-17T16:54:36.001647626Z", + "pid": 10960, + "running": true, + "image": "sha256:ac79fe145f2bb6626ff26b584a2d0a34e791906c01015f2ae037aa3137b683d9", + "memory": 134217728, + "nano_cpus": 500000000, + "published_ports": { + "8080/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "8084" + } + ] + } + } + }, + "after": { + "postgres": { + "id": "a6e5f14597245ada8071635bf261c294e53045ee0d09bbea1cd682681cfacd9c", + "started_at": "2026-10-17T16:58:16.715706381Z", + "pid": 26327, + "running": true, + "image": "sha256:7e32e9833a6fb1c92c32552794cb6ed569d51b445a54907d35fc112ef39684db", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "5432/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "55435" + } + ] + } + }, + "valkey": { + "id": "1899ba79d40145cd3ff95269e73076e3b2ba74a472e4427f204da8e9c52592b6", + "started_at": "2026-10-17T16:58:16.815795964Z", + "pid": 26382, + "running": true, + "image": "sha256:d827e7f7552cdee40cc7482dbae9da020f42bc47669af6f71182a4ef76a22773", + "memory": 134217728, + "nano_cpus": 500000000, + "published_ports": { + "6379/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "56382" + } + ] + } + }, + "s3": { + "id": "69b2b1d137ebb6ad0c9790189e0d858267596ea1481297fe1db1d21b37a25002", + "started_at": "2026-10-17T16:58:16.681019131Z", + "pid": 26248, + "running": true, + "image": "sha256:bd904439d1bb8ba4bbff8886ca4b91eb446b01891cc4ee8a4668a38b700bad7e", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "9000/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "59004" + } + ] + } + }, + "lb": { + "id": "f7affe8e1b5904cb78f8ac5d43bab11da4006dd9d933118be1696ec36b8fc1b3", + "started_at": "2026-10-17T16:58:16.575992006Z", + "pid": 26158, + "running": true, + "image": "sha256:ac79fe145f2bb6626ff26b584a2d0a34e791906c01015f2ae037aa3137b683d9", + "memory": 134217728, + "nano_cpus": 500000000, + "published_ports": { + "8080/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "8084" + } + ] + } + } + }, + "same_token_public_test": true + }, + "final_instances": [ + { + "id": "ac20d4b45be85d82fe302e812b9b4c8d3645f68b126ef36b0aa1f0eae9f59a4d", + "started_at": "2026-10-17T16:58:16.863466756Z", + "pid": 26514, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "af0c8373068c4e0782fdb1af3602cac6" + }, + { + "id": "e49421e41e2ac4cbeaf4784d2ba9ce5b47053021dc804a59cf85b2c096fbf87d", + "started_at": "2026-10-17T16:58:16.838496214Z", + "pid": 26426, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "e96c5c7e0457467597c53e1af497f8ac" + } + ] +} diff --git a/evidence/cluster.txt b/evidence/cluster.txt new file mode 100644 index 00000000..3c352f7b --- /dev/null +++ b/evidence/cluster.txt @@ -0,0 +1,4 @@ +Verified failure and restoration of one API +Verified failure and restoration of one API +Verified sequential replacement under traffic +PASS: real replica failures, replay, rolling replacement and persistence diff --git a/evidence/contracts.txt b/evidence/contracts.txt new file mode 100644 index 00000000..1181e336 --- /dev/null +++ b/evidence/contracts.txt @@ -0,0 +1,3 @@ +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. diff --git a/evidence/failover.txt b/evidence/failover.txt new file mode 100644 index 00000000..cb8b7ab4 --- /dev/null +++ b/evidence/failover.txt @@ -0,0 +1,4 @@ +python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:8084" +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 125, "failed_attempts": 3, "first_recovery_seconds": 0.769} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/lint.txt b/evidence/lint.txt new file mode 100644 index 00000000..48c09f07 --- /dev/null +++ b/evidence/lint.txt @@ -0,0 +1,2 @@ +uv run --locked ruff check src student-tests scripts/bootstrap.py scripts/cluster.py scripts/stop-one.py scripts/rolling-update.py scripts/verify_cluster.py scripts/verify_storage.py scripts/storage_lab.py research +All checks passed! diff --git a/evidence/persistence.txt b/evidence/persistence.txt new file mode 100644 index 00000000..96917b24 --- /dev/null +++ b/evidence/persistence.txt @@ -0,0 +1,3 @@ +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:8084" +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/reconcile-cli.txt b/evidence/reconcile-cli.txt new file mode 100644 index 00000000..106f2fe8 --- /dev/null +++ b/evidence/reconcile-cli.txt @@ -0,0 +1,3 @@ + Container mtusi-lab4-reconciler-run-de897097f2a4 Creating + Container mtusi-lab4-reconciler-run-de897097f2a4 Created +{"mode": "dry-run", "grace_seconds": 300, "elapsed_seconds": 0.10601412500000151, "counts": {"s3_list_pages": 1, "s3_objects": 50, "s3_head": 50, "delete_orphan": 2, "pg_metadata_pages": 2, "pg_attachments": 48, "ready_preserved": 48}, "actions": [{"action": "delete_orphan", "id": "2d392b8a-fbb1-444c-856e-f193ea279929"}, {"action": "delete_orphan", "id": "81c3c3e9-589f-4e4f-a130-c81082388565"}], "actions_preview_limit": 100} diff --git a/evidence/runtime-sha256.json b/evidence/runtime-sha256.json new file mode 100644 index 00000000..bb0fd6f9 --- /dev/null +++ b/evidence/runtime-sha256.json @@ -0,0 +1,17 @@ +{ + "auth.py": "6bebcd8d1d3ca4c2c6e8b0e5793ae13d8996cac3709b5b845d814b51a5e1a3c3", + "service.py": "7e100756e3bb24a89bce5dfa41a471969cdb4287c1523673d1e7ff8255bf3c19", + "domain.py": "bd8456d7423a3e12c02a57ed90d1875fc5c7acdcfc0d26b94f9ead4855160298", + "cache.py": "17756fa84a2c40fd4d1baf9602a7b755ca5998bc241f0657db3505b04623321d", + "__init__.py": "f798dc149d6bef46d697dccdaf6be9c8d08654f18161e42c99f548c30074f4ae", + "attachments.py": "3fbf029536834be791d39b38fb76e2eb694b46a57d891ff73763b3a7be99234f", + "schemas.py": "3f94cc536beec31ec7890331abbc736445a311d03b30b9b5726dd60c17c9f6a9", + "storage.py": "2fd071caf423a09378d8fc162dc5f675484addf8589e0e0228057c6b7bb77d75", + "settings.py": "d21f4b624767b19c80f534e608de6de6071260b5e2d642a06e6a7aec0148c161", + "app.py": "6dd900a5ff7b2213ace024b55dfd7313195d1fb1257bab6067b16d2b4f515941", + "repository.py": "d29dabc547e0071b21f8b9d5371fc5753b89766f2c3e8ea8412cdcb8a8c33384", + "reconcile.py": "6c96d72a8c49a03ff721029545a41c3587bc24be3272df4003bf6141dd04df9c", + "migrate.py": "f073c080e13635a01482539dbb474b9b4f49bbf5ff66f483dbda4fbe1d1eb57f", + "__main__.py": "486cd5bbb3f1a814de74357e938968d219070e845cf178761a7a23e87d003ea4", + "cursor.py": "a2208cba232ae0f67c4430d3e90c3962129c8fb3987ea853c624cdd2c73d7a1f" +} diff --git a/evidence/s3-source-version.txt b/evidence/s3-source-version.txt new file mode 100644 index 00000000..03b67f9d --- /dev/null +++ b/evidence/s3-source-version.txt @@ -0,0 +1,3 @@ +/binary/minio: go1.26.7 + path github.com/minio/minio + mod github.com/minio/minio v0.0.0-20251015172955-9e49d5e7a648 h1:6TdolSCLSs2nwm8i0PpWDqf9iX2Ty9WQK8wmr7dCnUM= diff --git a/evidence/smoke.txt b/evidence/smoke.txt new file mode 100644 index 00000000..7f27321d --- /dev/null +++ b/evidence/smoke.txt @@ -0,0 +1,2 @@ +python3 tests/smoke.py --base-url "http://127.0.0.1:8084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/storage-basics.json b/evidence/storage-basics.json new file mode 100644 index 00000000..260b78dd --- /dev/null +++ b/evidence/storage-basics.json @@ -0,0 +1,249 @@ +{ + "privacy": { + "anonymous_get_status": 403, + "api_delete_denied": true, + "other_bucket_denied": true, + "attachment": "d8693ef0-f3bc-4206-988f-d1664afeb827" + }, + "cross_replica": { + "uploader": { + "id": "e49421e41e2ac4cbeaf4784d2ba9ce5b47053021dc804a59cf85b2c096fbf87d", + "started_at": "2026-10-17T16:58:16.838496214Z", + "pid": 26426, + "running": true, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "e96c5c7e0457467597c53e1af497f8ac" + }, + "after_stop": { + "id": "e49421e41e2ac4cbeaf4784d2ba9ce5b47053021dc804a59cf85b2c096fbf87d", + "started_at": "2026-10-17T16:58:16.838496214Z", + "pid": 0, + "running": false, + "image": "sha256:6c726c0f2282b19aca4a42d1dcc517121d9994a44a00e288a6869ec31ab34ba6", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {} + }, + "downloader_instance": "af0c8373068c4e0782fdb1af3602cac6", + "original_preserved": true + }, + "interruption": { + "before_rows": 5, + "after_rows": 5, + "aborted_body_no_intent": true + }, + "uploads": [ + { + "clients": 10, + "bytes_each": 1081015, + "pixels": 360000, + "duration_seconds": 0.16621475000101782, + "successful_rps": 60.16313233295339, + "errors": 0, + "p50_ms": 114.14141599925642, + "p95_ms": 153.93212499839137, + "p99_ms": 153.93212499839137, + "before": { + "09da358ec38461f3ee21c4d1129697a9f1486323410ddde90b5716268ac9e07c": { + "current_bytes": 95498240, + "peak_bytes": 170278912 + }, + "c0356d1a469d326b73ef6a577338bffb3860ff6afcc646dd5bf1198a0c5c1792": { + "current_bytes": 96903168, + "peak_bytes": 165269504 + } + }, + "after": { + "09da358ec38461f3ee21c4d1129697a9f1486323410ddde90b5716268ac9e07c": { + "current_bytes": 102379520, + "peak_bytes": 170278912 + }, + "c0356d1a469d326b73ef6a577338bffb3860ff6afcc646dd5bf1198a0c5c1792": { + "current_bytes": 101384192, + "peak_bytes": 165269504 + } + }, + "responses": [ + { + "duration_ms": 76.5632500006177, + "instance": "3198dd66596b404b8d3e3f2d9cab7d81", + "id": "27d3163c-060f-4918-bed4-ec714a233595" + }, + { + "duration_ms": 95.78312500161701, + "instance": "28dadbd8074d47a88abc712e0c76b41e", + "id": "f7796135-d0d4-4486-8281-6947ddfa0dee" + }, + { + "duration_ms": 114.24379100026272, + "instance": "3198dd66596b404b8d3e3f2d9cab7d81", + "id": "fa09990f-7d53-4ee9-be56-e8153bd77eae" + }, + { + "duration_ms": 114.14141599925642, + "instance": "28dadbd8074d47a88abc712e0c76b41e", + "id": "ccdfddef-f5fb-4c40-8d88-7049d5812f12" + }, + { + "duration_ms": 133.79766599973664, + "instance": "3198dd66596b404b8d3e3f2d9cab7d81", + "id": "d3623f75-6e59-4f46-a809-a95590c89238" + }, + { + "duration_ms": 153.14370899977803, + "instance": "3198dd66596b404b8d3e3f2d9cab7d81", + "id": "efd8eaa0-c524-4d93-8c4f-4e212af9f524" + }, + { + "duration_ms": 94.01983300085703, + "instance": "3198dd66596b404b8d3e3f2d9cab7d81", + "id": "6810a6bc-af11-4d08-a007-d49908ce64df" + }, + { + "duration_ms": 153.93212499839137, + "instance": "28dadbd8074d47a88abc712e0c76b41e", + "id": "3ab6e0ac-cf3f-4bcb-80d0-faf404fcea3b" + }, + { + "duration_ms": 133.07204200100387, + "instance": "28dadbd8074d47a88abc712e0c76b41e", + "id": "f12f4260-b0fa-49aa-b4bc-2d0c6a4539a0" + }, + { + "duration_ms": 75.5845829989994, + "instance": "28dadbd8074d47a88abc712e0c76b41e", + "id": "fecbb057-308a-45ec-9bcf-95856be457d7" + } + ] + }, + { + "clients": 10, + "bytes_each": 8674572, + "pixels": 2890000, + "duration_seconds": 0.7018210000005638, + "successful_rps": 14.248647447129633, + "errors": 0, + "p50_ms": 485.1206250004907, + "p95_ms": 683.7534580008651, + "p99_ms": 683.7534580008651, + "before": { + "4e4fab2b66feb2efc1c03e276733a0cd367a1d71d4c01714da527e4cfaa0f3db": { + "current_bytes": 95817728, + "peak_bytes": 170561536 + }, + "3e96dd5071d136499279b012cab6415e2a1d16bccb0605ab0db81f4f0d89de18": { + "current_bytes": 95109120, + "peak_bytes": 167698432 + } + }, + "after": { + "4e4fab2b66feb2efc1c03e276733a0cd367a1d71d4c01714da527e4cfaa0f3db": { + "current_bytes": 112578560, + "peak_bytes": 170561536 + }, + "3e96dd5071d136499279b012cab6415e2a1d16bccb0605ab0db81f4f0d89de18": { + "current_bytes": 112189440, + "peak_bytes": 167698432 + } + }, + "responses": [ + { + "duration_ms": 650.3965840001911, + "instance": "fded6353f47f48bda9a66715f6e739d8", + "id": "d771f44e-cbcf-41de-9d6f-b3e8dbe6ac7d" + }, + { + "duration_ms": 607.8036670005531, + "instance": "42f0e3d590f34d929f4ad18f3c1c61de", + "id": "2bf2e458-909b-4aaa-b939-69ad893a2191" + }, + { + "duration_ms": 453.6054160016647, + "instance": "42f0e3d590f34d929f4ad18f3c1c61de", + "id": "26ad1005-42cc-486b-bdc6-f0f9a959d224" + }, + { + "duration_ms": 485.1206250004907, + "instance": "fded6353f47f48bda9a66715f6e739d8", + "id": "a077b398-0d5d-43b9-8c94-1e42f0c61591" + }, + { + "duration_ms": 328.2669590007572, + "instance": "fded6353f47f48bda9a66715f6e739d8", + "id": "7d293d77-2c70-4382-b1cd-14d318c33dde" + }, + { + "duration_ms": 528.5843330002535, + "instance": "42f0e3d590f34d929f4ad18f3c1c61de", + "id": "11795c80-f431-46de-b672-005870afb0e0" + }, + { + "duration_ms": 561.6339999996853, + "instance": "fded6353f47f48bda9a66715f6e739d8", + "id": "7d6915eb-e40d-4742-8590-1d6c482fc6a3" + }, + { + "duration_ms": 410.78812499836204, + "instance": "fded6353f47f48bda9a66715f6e739d8", + "id": "394c46d5-af43-49ea-a6b2-bec2e5405343" + }, + { + "duration_ms": 379.54966700090154, + "instance": "42f0e3d590f34d929f4ad18f3c1c61de", + "id": "40e7d89a-ad66-4f98-a5f6-076c25df99b9" + }, + { + "duration_ms": 683.7534580008651, + "instance": "42f0e3d590f34d929f4ad18f3c1c61de", + "id": "0994d2cb-53ee-45fe-a20d-66b165f528d1" + } + ] + } + ], + "outage": { + "before": { + "id": "69b2b1d137ebb6ad0c9790189e0d858267596ea1481297fe1db1d21b37a25002", + "started_at": "2026-10-17T16:58:16.681019131Z", + "pid": 26248, + "running": true, + "image": "sha256:bd904439d1bb8ba4bbff8886ca4b91eb446b01891cc4ee8a4668a38b700bad7e", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "9000/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "59004" + } + ] + } + }, + "after": { + "id": "69b2b1d137ebb6ad0c9790189e0d858267596ea1481297fe1db1d21b37a25002", + "started_at": "2026-10-17T16:59:16.975092214Z", + "pid": 31660, + "running": true, + "image": "sha256:bd904439d1bb8ba4bbff8886ca4b91eb446b01891cc4ee8a4668a38b700bad7e", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "9000/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "59004" + } + ] + } + }, + "failed_operations": 2, + "statuses": [ + 503, + 503 + ], + "stop_start_and_ready_seconds": 1.7791777080001339, + "original_preserved": true + } +} diff --git a/evidence/storage-research.png b/evidence/storage-research.png new file mode 100644 index 0000000000000000000000000000000000000000..974501325fc172786432f8d159414bd99cf209cc GIT binary patch literal 82340 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

yEhsIyQ&2boz5>(s1ZKJ?wHUGX3E zacTwz8{b2PK>I0g4BR%LHAQ>K60W#teX(4hU31K_0!-k>b8g!u$!Ao235i$c$^8u= z`<+2+7}OKhcqf~y!ekP5LPsne8@$Q8tJXHwSZ}W5q<^A0!SfdCDSuWk-k_k_n<^zK zcD94mBt1)eL0<3TEqLQMt??%-PVz4XVI8r~*Qvx#k{27G&I6GW&do_1bZwkQ(5aH2 z&N~T(1C!3QD^Q4B8unMG8U~>so%R^)A-`ByTr(f5b*-Cs1;~d+Li;#-_Jvuw)2Jow zxf99Il8`3I!Ub%b@~TLuOP-&6pn&hL*OKbmwE{%Qqwsi>a0 zuN>;v*MPa8;c-UK!cDiaUmiy0ep|ahoCp|=gGE7sRQwV^kg~k0Vwrd6mhqeFZ4~tb zJ_6+Yk24t@ghh{Ws@yh zCVtIybHv&cnP!WB4kTFn4M2tbwQU26yYix5i@~SqMuIbrL+j5+Kd-DcuAd4Thxe2_ z%a#RXoavNy5*m`rsSV10VQGd2)~(;{lJ&yB(1k4=u)|vYWP#%(Wix@UCfCvO-+E1}qrFikhN?wHMdj}m zkB{`H4qQhvm-2qHRZOqi=0VRuTxA|aC+KcLiVFt*9=`Dq*Ak}Jd6x>jH*4!457a=e z7H~;4s)wDDi0TwrD!fY!?#sTl&^CxS;%!m7KTHV`c;zbKBuG%{!3w=K8j0%^4a|?( z#UT*Dlkwc_j%bbU{)oS+ZrO;|HG#U~(0EBP1 zG^mcecdaBhOn8WzS4>n(om5Q>t1c#5PTJ0u6#QY~wy{U=^I60fhvU9X>)eLo%*O3N z8e3`c&5h;T$tZd4g~j*NB!Sd{FTWHMSm>-fJX&ik;kl}3RnZE8Wjv?waV>}EE}Qvi z<5C!|HRPv1b{_Pw2bUi}$hYD7X5{WH-C+>Ue^ATjKEyia81ZlqFYRU-P|7W?+@j7p z3mr4NG{~$0AK2IZWbpN{G5wO5B|$x-vjR}_mw)XksV$EcMaNzilPGpA?Ce=TSl(Ml z4i9YD;SbH4+=J|x<;@i*=?vM$^yvGY7~YUce4G)BO})}rX&|6aRMDaS*e3;8`UeXT z{nA(aa-z~~0gKmT+yTibOkA}#>LP))e?%pDD>eXg#q8=RQs525zYur=jOjL3r*<}e zWmGRuwTWM~>EBGw-^tyQ%(&_t0`coPU)C#lYCR;IdJpf~f40+c03KC~RC{BwSaSX3 zXy8QqP~Af;B#H*!9;v?O-|rz9SH9{?pbO6yKT|k#|N2J5{}8N%%TL z0Re(AHL^#X6D)u72>SgA9_dT-6c%z5d5Sj3Vto{P*d@c64iQ}=oFdPqH4-)YDie~J=xhpCDz=j?cmZo1z%X5ArxvNlGZO#wCv*Ch_@k^wSQfTU7%4;eb})4RLYI40=)~ zDFW=FX-gu&fhzpsV?n{hm*?!$IEM7^E_I5D39fxDLv!>9{0YPO1d{&<5Za0Td90Uj zgQ4#LYURJjH`MxZJkd$q`^tbO|{V@h-oxun})w zW>q=DlznKHB%}dt9+@ST&>r)Rdb;7rF{{?t$}pmOt+(3+#y$Oe{C{xO{_me$9@=I8 z=PLsC_wPrfmj$`GxhB0R#8}&Kp>dw}8nEd;0=7iPuV|nY?9g`Yn4 zskXPb>%d!H3b@S?kni5v16y4Ua9(YyGK1&*ACE7@`m`gJymMK8E>A)-)@61_V6r}# zi<9$#i%T)MPix@MkPsCuO2wUFVtN*(0j2{y7prUMbZ(`8`*w%nleHnzoi1AEfxEX@ z$8>jfRReb}2ERI4XB{V~TD&0uCaL~Elay-!8-f_Mod?fNm+*?*4z zcat*V9T;^26amHqtnsB*=*|}4Rw-fkUz>8?!uJMbT>$0W$S636MroeW4aQK}J!47n zj_aY=nHKBnL22KxktXLzff^lF<;V2tvd3Koa<%-xG*Zo=q_7;S+eUBV;-utz5-#hx z0TDPUG0}mcJq^uJKrLPYMNoH=5)vLUESMFl066RpnHpMpc$9yyiWUt1vDUO@z$fkS z5{&iJ7D0uB6|K{^;p^kG0;+U05b_^X*fy8Kx{{3T0>GtJ#{T>4g%=mdY^#}~daGD< z4_Uj1%csV%Rt;YT>7mbKaGn8;u0J*O+-%fPXWbbV!ByZ$_CgqDC=D}!ipf`YHntVu z2do7v;Q>G~?!YZOj8O?$sf-rzAA5Mdi&LcmxL<7k#$$-(C07Co-^{)ypVel#wHJ^0OR0}LxAem2P0jZ3+2 zY=l>U3)dYX!Sen2WrUD%F61qGdnvw)Jt>xN^=P56z{gNhSLsVm|@rDR$x27 zH&)|pT2z{TlJ92yXg=6mV7H4W3w$*3q;Xy{K3>l-{IXav@@yM}(EFU=-HO7df$6a{ zHjW2S&^Es_n+k*~Mh(`8l|uk_Lcb5Jr^?5ABk_2EkUoLD)uel<#Aqagjvu9n^4$$v zatafDbC(DqezgO;O~R(W@90Th2LWaO(t%JCC>?--$+!bYYjQ7e<^^`Kk==d;^3RF& z#O|RS&FFWd+~9%hJNz5|9*vB=wXrZL6Qfb)j*cc9=o=MP)YmJ75XroDvJ!<)cPPkx)1M&~WqNPM2#5?J1_$SW=>nT7nQ z=A#`a2qnm|7_7BWfF*&a-qcWaczS4*PAwV&mZv$JEH%nnV+GWw*I!~N#ds!!D zOO0-*PMs&O^>4ZgEYaBni<+!08OA>WU|dQ{<_=Y7ziHP1)Nei7E~!U(eGG`LZlmSU zhwfRx-%#K3EEbp~DRV;fC1!nwFmw-L0JgQq#dn7pYX)@#6W=1<&b>LeQ!&aSQF#7s z8-kjKHVe+ukl)kHDUC5TP|SxI{qB~>)i5mapYIE^IoJd*=lc)p%Uk;RR59v7Nf}3A zcJK$~Rr1?HwMU%U`|Aigu}a#!+{PL3kMP0hM_-;D-v#-zzCGD4eA#2M#8ap{07Sg} zHZ%Vp>a-0Gh7a626BkbDW_joVcuid#9$?ODEOphBVRLV|e_Em>X&-pye6ox)LpSd= z0)|76HX^M`+nYo7Sf_~dT5Jsln_!o$(P zXSaz)#DT0NZ0>ne*yT%?>Z8@mbm-f(&P!LWB!x%}tQJ9nR4%T#W*Aeu-b&@VT1PqZjMz>lyVK~%VD+Nx@G<8Ia zxOaj5H-=87``YYI7i1V-*jsTzu;N5Yq*`u78uN|db$}tKn+w8&6X9@BaamvvS{JR& zzyy`$ffklJ4l>Feft`9_{cmcRAU9n2t_b#8A; zUfTe(>jFWB_~=eq(CwTzr=dUhtg+!?NGqYDow0~Rhjp8Gfi0cl!M~bhuZ*? zy=gdF@si+F;_yrz&15=(KtXymL}@f|ZFFFgBHm85ne6L9Nsn$I*I_?1kyE!TPz&Rwdc3>y_h`#?3n}Y#P6PW zsPq`7N3T2*iC3^yKAcTP=U-JBGaEm7=}}K?EZWkLx>oEc^|^@V!1-s0v;x=%NqLSP zq%<(_>L%-1sv-8i3fUZuE-%}Lnj1m3B+_znUK|mdTri~WIyFFg+<@`-*q$I+Oov603d>J;iu zTBIf@KMX%_e6b8*^FekCav}{(KWm5a76}QnwAZXc21?x)o)!PJIFzZ864P46r8%xP z!NK**B>UdUk;KZp(n-*vFu{_0?B!u5BP)aOoYkK_bt-l_a-O`CISFI7O8?~J<^i!A zt;ief!*A@$YYU%5+g|MU?T!yyP0*x3oEt9Yygnl4o6olhSRBK?jo|I2S&!c(uWxIm zOn0g!Yw)ayy*KCCY0k_33eYwL^n_@)6M(!$nRD10v`1Qo}7JipXRYio6==)Htx)us6bcC$CA4f0PpvR zQ5}e{--Hu}UM`+w(g=$uiq{OSgmV8V66fWLp3D=uojXyJ3)wa5r+;5x5-D7y{J3Xm z$T5~0OOv7rh0PzthS%^uQMYRS!)HuFh#Vm3%Od!I?f7#P?3tGtt^zyk=Uz&yHC6o( ztK?q0Ih7jk8m;noSLpK`JIu{kPX{}kPa@onr`|5v$;kZ2KkY4nJD^Pd$Z;M_hx&E4 zv6s4X;!B?xqO&ugUoKgYbuWLSMqQurtnz4c4J(rUz$|SQXS@4+F@L8>BTm}ADPfG@ zsk1QEgbRf^JE;XvtJ{CHe@`w|-25Tp4miKdUDSRZp>e>3>Pd9*c{a^T$JC?)nlPXb ze#2+}E~#OsFXVOPu~h9W%|n-|u}i8$o-w*<&Z)1Le8tkfD_0C`+@mCt&ktZGL2dN; zy0D?y2=r6$x?%ouB3HHBxHPE&GE*ka)opR;Ci1>5+65^dzbKJ4qjR}?m^E&+!T>d? z1DoCnvD}?98h@Bt*H+TA?xGM0jmizTr;IR=QiYnwTvOz2z3xp*|L}cRH`u(NhZ#*! zzf@SH@Wl~~vBmpA;>S8SUVk$d;*>N*iRbOM?-AX56>LzIJD3wnqNgrDZ@CyRshQ0e z)<2es8DoR*=T;hOVN~<}=i}p$O}-7~aFN_PLoISzujidC+km+WM?yixQKW zuM^JUfjJ-mKguTNKGQVL@+NWzW_kuGGbk;7x}fEctklkAG5lkTg?M8TX9tEo37O|^ zhIC7ReN7>cX>xC4ZWR!5@DvlapXs0j0`v*RJ(n|N;WAX+fhgnCecgV%yC8`wFmVN) zKJW)wJb)zc)IcSu*bLJ~rH;3jE^GF5Zk9U^*Y8 z0l;7}#(Oi}nX#Xlb5Nioe_d-tdM2ceW2p%~ZZhl$~Jn+B!%H zbqs|H7I*DsPK)Vs! zCDFMjpvy^8rY$cbVX^RMQs=d$kHT-0phTUp7U15PfRV2KWtvi4+6X*MI6#*DiX5}z z&S^rxwt$dRMsZ_w5It30bEB)m$fSK8qY|2Q?$iIyBgwPYmAqBUts>(e1 zc`YD8phvd35Lrp3|Vk@NJdNrL^f5ARQ4rvPTOQgc9n2x<- zsRO-|;VY|Mou@Gj=<_*WEvJUJm>vINhi|fuR?;c8&{t_|C2>W@ zN5w@nk4bM_C;L9n>H~ZhqJ^(~5kpwE^@|BCo+|*5O+z+CIP&Tpf9c>7}uj*7sT&aoo+7pS4iMmUmGK z@LTsu@p(#^oRMc15|;3zsBJIms(t`i?~O^yofzX7+x+qn(V^M<|DH~jKv^s{4x1J+ zuaYxD6m4fzd1nUxJ{}OKk>3lTo13Vlr2kVs)x;Q6q3?d$24J?egB61&d>`KUKu9iB*v$3-n5gR#F5L-oKwS$lMMDP;>>9Y!XPVYFO8K(iA|F z5nB_01ew|bm{ugUpek0a%L+uoowe!4kG|K0lVC8|@a{z>CYM84I?9#sD7u7kHy4vr zEbPI)Tof;*x2ApQ{b7t#05GWf-uo-#6KGdxP<2)~xr3n&Sy1*s^;N@wSPr4ErTK-0 z1}qSDc)c>aQ{{Yn$H&JX8vgUl8N<4m`-eYuzu#S3w%l-1^5wZ|9z_PW2kN9wzU?G% z-mU;lQ3b*gCL)$FG~?YaAi0zm9eIQ8XJBi}Kg}sDj$cv=E&_(L>~GU(^C*C;AHp$=~@R@dCHsz;q+slLQ z(-?TU%@0uK^7qUBI|v{ZgNN3;0X`n(FfbQ9l&*BzVk(2_B7R+DurAh~ z&BKho=!CPbv~fkomO^{tWmgicvsxpkl z^Wcf(p>%s*F3RZDH)j}y^*zgK4Tgi80-BP#SRMd*#|wZP z&7g0Cknh>IqNcV6^7X!EvKpBJ@n>2l1A18F>z8%)2txgc@$g}}AMa^YN@I&bUUy?G zpr7h6^A!kcN%O&G7l14i6Sj#TEG+80p(f{W!}bcSMYyq+e}l-HyUhcLoAda7Ql_<0 zF*|Z%0B~Dy52RD2SnH!c;H-Y^*|hOOA2cE}fUI)BS`8R(96Tdpl~a!*KHX$oA+z#v zJEI|g#S=kE>&{Rft*Wjr(}@%G2VioX(J_DT-aX@#f0&@tDZ`V}BDT+MU#;BrP$4ak zT`XM|L>zdB{Cdhdg#&4ku?my;@C-7F;i1BYQ>S(c=rQr2YsmWJ=GK;bMe}ZzwMWBu z$>!~Wmw2!_jiz6}e(i1%+pGHek#K~m#Wx4xLdV|BU7(PES1on{!JJXrxn%uw{ys0* zlP42N64o~PFF}*tuwdw)R+Fz>pHmcl3;0?JZ`=s>dPm8-u zS9$-#JfA)Uo4KZt`4*?g8N&~(Ts?DzjkPvEtBGJa8d$3GR zyde|1_s3^T0dz%9`vD(MA$tw#V1n@m1jZ9)|FyKkh!-zT@cdp}l>!|3C6Pj)qLv$4 z!nSKb1AQh?;1V_%8@~~7sw;q^3Aj}V;&`tr=$h>E7ze!g*Z1%3oYDq--1LIW7r0M< zeszUe@t>e|#~x5f=efD@%z|J@G^nh`SRQ}zo^UQilCipZFb9Xku3yG<1<-AM@&RTQ z5X%xf^wucWNl@!|HJ5Aj01i&Kd2wss=KMQpF9=P)^&*QOr?8lEx$ZZCp!s;oIUP$) zu}O3PeQ*`jWB`N`p^9tqc=2gZ;oK-2$A2#3Vjt*s8nuY&ELm7wv;uslJ8&nNWf}rH z5vu(b3qpK79?0>S?AMGJC!CkCa$tBRJ_pHycY;i9GTtYk+S#%OI}?=10uqqWH~^6@ zpds3Cy+U{xm|&g+1qJ1|4HG+8jE@=t#sz8*Hn}W+5X z5Y#tRQzKAzkE?Ni7M(;06$7jGzYp}|+vM+WxElvtfF@8>yHjN11Wa#m*i>#An8=$T zpM?MtXcfHkp$>Q^#sY9*c-?viL>#JT2>M}Qf9wJ_V&e1D!_$vJ!jRMiDSfx{R@70g zuzhga)oa(q{CO0X8;*Fn=>2JO|L3HqrFX8HX58XWx#^x7q6S){iea?%rma}`QeP|5 z*mVCUY`h7WGxBx6gH3EvelTHX0fm8a{X2+&m9Jv-2<~ujUW)>gGbGW88Bala^7%iR zEaw-pR6wJQZzviKce*~W0opGiOhlLsGG_(qpYP-&5l5fl5KP0~WqD_zpo^)5(uknb zxOVAh%fEcNP2vY{O_7rj7w=+73g`8-*0H{LgE~o0{tYM0%8DCcFMW$}k6>GVplx_) zJ6J+OqFX=f-Me38+&BPX0A*B9g|MXQd>TdbD=I23*pg-}>ey4|To-8-q@kN`pwcJm z=?t=vS7w6y1N*O0&C@39b5O6=UH(pw8v3tDx6CgbG-=TFL*mnw?&6tsJLu4VQ{wCY zL)Lo-QrW-p;|HOL^kh6pY1@kIhz3Q3jOG{r-Obc}C%!bKm#%zOL80I;?g+Jgt`^S{wOV0lfXg&rqG0-AFs5oj{}g zfz##6-LW+R!G80~4@Y(G?)~?y;My~$<$m}aVA!`C zTljN{nO>BVXZ}z@=oK7S-fCAO zg0SGcfokUJA8SGDTz-ubzk6Dk;JB1+K<$WJ7Yp9h7@{}yQ4tZN`OgL@fq%#**D8el z;rXZD+-RJH4i|mDYhqbs!93F>>*MSyIcCu=!(O`NszaK+XMNd)H1NMVg*mbDJ=Zd|Bbyk>BS!{3v-rjbRDY6hcwJu_m#yhnXgE5Rp6@I^3t1HIFZ(3iU`IvGo%CtFBxCnSFJx$G5 z3?M=fD*i$#1BY>vNU%8=E0!CMJ@17&At)-^>9I0r3kP=!a#q5zsoNUQ3h&{oa{Ce~ z+a`XMF38GLLw(=xSLDaxG~ifILcH+Y5|rb9K*nwZR9yf?Pkh933{)M3&=MIaDk?Tw zXXs?@M6;l#9gNnMCyqN@1w5WfHR?WfM0EId46VlH0|M}YVQ@!&{P^JpCQK3_!nd3! zTJjLTBMSwZWcSOtUDg~KzK*^*DIw7Vxd>kZB$c>a!{A=dGkr+^3-t@sPDr3lKq8K? zyOV6abwr!~=r<}%v>Hl_{J(!gXXX2I>8;MO6UesL%6JXZxQQ@GL%2#nM!?bjS8rx0C8bvHeoZh_ z*Wa1Ptwo2R-*H%lK2y&K`@ zPnQfq=y?m5hj8pRqyK6yiUNzh>7PCol&zm!`(U|y!3m#r#8T_Ut*Ho;{-E2S?xg!A z{rfP+U4{|Ig=}vpTGSoM0` zeK>cH9>?&zHY7yg;-leCLH3u~DDyXY&<4nkSVB3y3&I0&m=#x7{S8NO z*Y>e9H25=#SiMK#O%Orix=AbtNxZn@NDWT4^X*026`0N@{61E^vKoRu1oO*CLnANQ zY`i}(js%rWiIvfm^3U794NYhems7(Lg44J%f>mb0Wb|bEtTCYl>H8dtSJt4-__zgH zBFxg0rWA71GAWQ~qte<|bhHU~B=Fy7>8$UTSEM#VLp;~XMPy(vgV)aTRh*>z6}E(e z)SwYHJTC=p-?J~F@S}*&F=`%wvCOvQap~R9e#gON{kww5GoaCIhvf|q$D&Ck`0)8k z{S+zi=ww|EVik9vGepyxfQ(FkMdhvclrXU_4h)0i;Vu0H{NS@%>?Ly0`QPamUC2zp z;Q-Isovx90Ap|FGeD%RCu74==j?2nc47qF3VtAep`zA~PT2K$x$UAVBcSG!z-{{Y| z!G7vnN23&tK_-g^{()gorslyA*#}3@!1nse{Je-W+^V{%Ij+Ap)3%J-ak z3CjO|Xscj2%SuQ{_~7{0Uw<8aQ|F9a;AlGJZ%ujj29($j^N>KmRX0256PzSQ+_bo$ zf4>)u^eVyEZs?#W0)UVbjx_S~6c7dCv6H$3JT#A8|D1sE?MsS23NMqflLlsoC=L?$ z{r3m1#tOGzCY!Ab9P5G3CP3QMT&L2zT(UOecxp^eZiD_=)m*Cef+Er7;X!GFja6R2 z|4xyFHa=)py}#TYW4#Fx0U-36_5(^uR?IWpyVND0g*kl4d}50*`2Px94%!#~IbPva zCA9JK@ev9R#wSny%6yDrOlPVo8Gleqa2U-_82v>TM9x~Bv0Wlu^Ca)1C3>7bm8~

`O9w))H*ES6nfs$(vVAURob9aCk)Z$Yt!JrEouzibTa~!5Og{qo znL&YLq^kZ48)scRcar2wtAoQ0ZN0wk8OVA3=S!?f_m?N;lxQTJ=m_Ezjj(kb@9ZWw z2uYli%YMn#SM(s5v%6Jp8ylo*P%brg|2b%uW_t0KS$6-9zHo6kG`>(u%DImkkq*co z*RgGNc^|`GWs_%UqEYgd%iwHbXrNo+f#o?Oup5|P(N$Qc4(kkPVbdzkVJBsldoX($>J~1 z*J{$pPF7q0by11R*v<}TIsw5`=lQtWl5TfYiu$&yMS3Sq%6q<2PUc;ocq}VZic!@r zupX*uWB=S4Euos*mi3pQ&VM)8C1Jl%gIi^IZ{WKt+yCNbP9v=@H;%N5V>R%$SKIj| z$}KO%a)~8`26J_{F3%3&hjO(3yGtHpcLtG3Wi5)YyC@=Ul-)@Z(^RL_hs6f_#hpnK zNwjW+h$q3EEy^eV*GBF(&@o11$SJ=Exu|z}hBdHlg4?h{He=v>v7*_rb+_ESi)AD^ z*}j`eP?ZKCj_%*v8;Ad2ZM)EYDBT90*qHLuwPphSrcxBkZ)Z37Ous%t zmGdXZf8V-W59$)RX-O}sT(X-Z{StPi(lBo@{JKH8rEaz3GWm1elDD%%{Bi_SyWGkD zu3mW4??OjzX>i@Pmp2OIz7W&tYzt4q`aQ>|P|lhd?1#<{g>VvU>-Lh(WcyC!RnAy( zn*+A&202@0Rr_RSPs;#=OckQ5rF9obpIpc=(Fg7xVE=wKsd45VG2i`1qQB_|sQF=g zV+&@znp^l$|IMYTWoR>;GiVvg_O936+U=%>6Z?aIQ+7}jEBSc@oS>{u zKy&`h4ZA)YnjC{Jg$ilOb2*~w?>DO=tltil3RxO z6kat?mY+#*A@KfyB_gB$Q3&25Pnlx~6~r_puU{U}Qt% z;?INe{6W-OCr?#wKi}R zvn2EQEQfLcS$bsoGwSFY?jb-}1sFi!1bRUT#PL4@L4BT5lC(#0i7L26C5{?2Y5L4t- zrfU4!hF*M@PO>d`(4fEfZ5gSdk}P;cZesDu^t0CtV|UHX`$1r5cTDkFE~xuTJAU+J z>W#ixUz%ZaC^ptrHv`4ve$@jlKr>KQRzg-?PrI6jhez@v#tM|TI<~@;m;~1E>(5IS zgR`xaeS9h_K*bUPvTMMnP&#dQuO~dVTB$z`sU41oX5XQM9cP2L zdak|_B2fM?UfDCZg%+*$v7_)t4sn7~1#HkJzkrw2I$q7EmkbnwE80M^-lm6LZ zEdACd;c7ayBWAqO8hm(pFOMnpfu(Lr`TR`uZLrz_S!!n6SCCelOpU?pHu|4N=ST*F z!n(44rPRkIZ_)K0TZ#wXMh2()UcVij{iR@(>8g3B`|ibkV_uL!M}VfHc2h<=Z8UI#)gs;OIC$|Zk3$}yW5GJhdU3X-x?B<&y@fn zbRx$a>ZBWJ>q@I23ecw7k75~yqmsWqp&~4w*}TM}4~+=@80P)*OTFfzQcT-Z!Km>- z{+@|yIkN3Qt{uTQhrp_|teW+tL_Va)z7^)0fn!Y6H-G+p#`MxvZYBT2)L3F_8x%%E zs|~;iN`g)&-{*4qq;MkVch&V`?g`KX zL?Z_%#UtcnSO!eHr0p_Fy+d$ic@~^?c}O)?@dl7%T_e|Ueo_h;pl4Wr zSC#4bp$ecq+adK8sWsinZ)YgCHLXFk?Al)8v6Nmoz6-8n-T%5NII#rqIl5#AlEnF} z>-5D>Y3958u)_!YavrcuVDmZdT!CaLtq}qBC{YbTD{3bi#)IFKGgcAjYd9}+@LCn=g?^<;{XfNuZol4e+0K5lBdpkE8E$`nf40DOUw!0G#!3x$v|?>X|P7EK~q3TllAdX^G_ZhE3-LR zoo}iVi2C^a2>ZhFfJ7($6z7Z-akDEDGCmG$)-l9?SafN%d0!-nP@;rTZzv6JL-!}O zhcyxMBQFRfZyw}{mfCE}!|++<_x=#H>{j$&##nm+YlFe9>gw}A-gaG!eBZ%|rc}Y< zSPi>kCtJpEgKgO1Z&GqX_m&x^^|+PB>mY=dVuu?8p05ZpIZ34;y7gAsfjPy-pdZPP zu`6u^VoB@ky?pa_!m$v^05bSttlnwq=o8w#9`17ZUZ$ERC3H{Jd&&%Oe4ZkGeF2WJSDwZjMDlik|`QvqQa26p5U3HmX>QOSFSkh`?2aZrx79Khki|h&^-uD9}sJS^T-}jvtEi> zULZR_HCn_k(hG?7Pd1rR$cQZN9H-MToJBI&%q6vBPIXCV4I~a;cW7Lh}?&EHe!8df;m#>Q3SxCru z+%mWRT%cU^OG7Cy99`A3_n^0Ro{`7Cga5KpHdc6>Y_@86l97V|W9qui6l)CrG^v~1 z@@I_e&Ut`FhrrqH=*4cD--xvz4eA@0r!#W;GWGIjfs(ZSK7*Qt902`*XLFaB|D2mO z5Iwb4x#~q?Z5HI=lPJH@oZ{B;BHQi5m+bCrsc~P<^ju1*!@e7NNSH=&nbPbrZ+mw& zboRwX#yoHVR09@cmKx_4jSLr`P4v;niKD6Ka*s8FF#Kg`Vf!d(58eU-`cT$EU^a;W zVw2RU9h~-jIr~$7hz$n61u0sR z>Ls_bO(bfSjfTkBfHDWk@-IVb1G;|E=K$Iy+->};>`MUsEWBX?pq{d~PEP{Ood>r} zKC%=w5ZkZ95r-XPEnZKvc>Su=$#AORdV~$(C+2;*&XYZE14Gaty|5z~^qUpppW$fz zV^JXjv#=fbrwDL=miV=yV7ovNoJ=7)lLX35^Y(L#&!BzMt`|Y$le`u%!N>wJ3puU= zt5xX?yIzHd*Y?2^bcEIc=2HRLdh^S>95`m>z7Ixo?R4Z-W~tP4qvWo_>a-!T!;V?9!%iP5yrAEbR=P>`-;=81ha5;>boGhvov~hr2OlLG1|g zn_D0}3@aP5g!ZV~@j(T6!@eLyW~VtkP;H5WN2ULiilz;^i(kEgKB)5_Ng1mgH6g!z z^T`PGu2Uh4=yJ4`B5i)ZU0I2I8=Nt}M`7H7N=QCj$<+LO;N&$NxfVWn*D#Lvsee=% zHS!<(w}K?dP9zDF>|Qf!ie-NoPV*h1<@@GulzG|orcrMaMS8~@O^^z`fu3{Z4OLf= z&UvX`R#MIlta3-iL4D%pOYSW8bfSm^;f!)OoO5}qg`N-O6AK(>JvYGXOOw{!HsJJ z{k9E!XzC|^^9A;m7bqneTBmKJpl02Hr{D)m1m{rY}7iYLyd@j(5*uV5~ zzP0Uw%ZELuiYFz8y*e*PH7ha#|KQUM{yGpy6CoP=z~G6U%V8yg+O)2WNaPNQc=__Z z2fT*xrZ(Z+;4~6JOg55Rjp~(&`dv|9l4(!nX1>wF+H<%QoJzRcd}RB2W$)0E`Xdin zOdci%aWh(pA2Wx{((L3NoeyH7L6B1hPhqSj^eW|O91!B11pSY}mV|6h&BFV-*{ViiHiw0W zY%HZJojw`>QaHLiXLBdeC4aF0L|2nY;#RsQw~|8ibGfw!G*Wv)N2y|51;1j@8MFvS z@=EMGS_ySsv?oH`yzSu13WCMKjN|#q5rjdiz$p3A@bu_f0Q@2J;z8hBpsgxR$~v)w zUPT_MEVO^8`c6iOyWN!F?5avSAs&+RF!|C&^G;bzxi=sa+Ci-jr;zgYSN9e=yObv+rcL`fU7d3Q9}~4KzZ*E z!m4V3zBudHh??A9-H4g9jUl~0VnptR)?GWlt`Hw<@%jT$eZRlty|oZ-1|Wlj#EM2$ zn%24x5yy^G3DGOIRip1p6aJ3G5h`j8A}IU8OJNSJ20NW zF(#cI?`fO#i~tm@6+SL^$Z-81_EJ-jm}uG`KI;7ZDDc(ZCFMCj{d0JGR=WWfhuGU? zMR^D%`aRQT*G2AsEcs#)iGaA(E?fvef+xrf;j!-Gb1+wXK)WxyDH9cB_)4h5*+jEd zYlt&W=YaN6+|}`^szKOD(?obz`PK576*Dx7=6f&d>nU}oUSSTQm9C#oKYz${JM%-Gu#M{UdP~O3+0a|==MZ(L*drf zQ%mThl!8bnUY1XP-i+T(WD=3dUjPPsR3KwKM%3`TS@%NL1iwJMPiLWPBK^=o30zR2 znw24c^B&?A?ny|7eNcgjAlGRvgiC$&x$);s;p|AO)Y;d=&Y2wHFFVxqgQYLigaG4~ zy@6=+&OLD}emUE#&quaj{~$@iVz+-R9AN#BuKRVZ0T{Oz=v+m<=V=4!e}7`4p~>53 zBrJ$ulEE8&pXkKK2=eD_h}*>wd)59P=u+e8=#nl{&J4%yvJ!kDYBwMWaMha(&U?TQ z^}`f$8yZuFn@SE~h;wT=^5~MY-p;A2gY>)MuTg@onEg;}7MyO+{@`@YH42-Wpr~2Y zAv;jS#`mOBA2h$R(haZs?WXk2(O<h;ax(&$4dkPl6?qySWdbb-vX1asV9rL>}Y}4G3ZyBU%(>KE0|1#Xf z?w)4oJsGoG=4{ndgZ?xUxcGGDhE?b_((SLJ&xBhMtxJLY5qMv=`Hy#@)c%~Xk;O7n6F-T=1_ zx?piY7lizh2H64?g{~aZ)q$a)kifPFO1Fxh#FP|uL`3L3-cfx8$(niTZy;bL`>e5ER*V?o z0F8TIXrN1Bc2*1=7?iFjUvy?0$sp0A7#Pe4tlxf*-|?%P4#Jh5g&;HhPSkYDmIGYC z&iJjnXugpJ8wCo3>YjF@#C%exlw=2HKVm#TAaNm?pkBnYdu1t|OK5$f-ZhP)o>XSQ zkFZm&zMLentB*5&V0TU5<(@=2lT%_l*KB5CVZjFWb%3HpL|5+?h_nf?kLA@@u+Nps zf-eVY8kG(rluZ8Y~fo~j)qlKWZ)o+dve4wTa;|Eav?*1oRlVHz)+jLrL z>7)fH`Q>e)xFZn|kc`!7GcatE3Tk=LIb+-2A}nz(&oP!uG&dj0i&8x+^jGpm@`ra0 zNse;VMNm5`h8(m+;@e}-&*8PW%|SEUop_lZJ)g+y4`PQ8`sN6dZJupxZ55Qrgj;%f zBuE%^hjBV~y&x{M1qm$L%N60V2^nk76e)m9N%H}MpdNz<^+#LL1}1JW$qsu%u=j;o zC|gReE`JfNz>}T~?^pCgJdZoed5duVP2UC4Bme13+Vkrrz_SVn3AKUtb~wro5(5l# z&BvR<37|CyENrXX-tt5Pl-`-m^%bx!mm(8x1;myTZhxeS0gBWcG_P*e6trQ{b10*a zA_|_CK5V3s83+^In$KBw950)Qw$8jBFXsl$)TMJ!4GNC{O6&$Is5dz;7}OtOCs=#U zo5jnv?0?TUM-WZ*zxhV`%POm%)$XyoSZv8pugiMPn!eIMLs6wq5CWfLhUeT+MVTj~ z%bmACyw6Fgi>u-g1cbtv1R+C=ID@Rt%{0gZX;c^D%RLEGt+V%1f!$yqwHdSDe(F0Y zWX%)M?^%%X3bKUlF$ZAXN+0N2>=&LF4@zf>1lfhw%_f8m1SI6ewNoQh$?u>8_~*S* zmXY(CHth$EapNTB;u4_7ZHflnoRg^$U?aUPu&&N8vU5k$mseV9i3|RnL(~UQ;)72- ztUReQWKtqtZ>xE7U~m{PSbj0&YH)3zj;TjDc=0Hs1Ud0?kYT*cOE7fEt0H0;RQM6G z5f_*qN?U{Gqx8)jkfBpXCIEmE5uTH6c$zmbKbQ#7WvR7n|n&(U_uI|lw5o} ztcLpA6EK89>JUn)#1N5+*%*lQM#5j++o$5tD`ZkxCYc{z*?^Zo-O>;R0Z+CheC^Vm z&K#2}E4{$-^720IxsXI~b{Qk&5Us2Ldc}m`G%X2}+bn7$vX5g$-J|t4SJsR4~KeEau>i$ zvXK$P0L8ldCzZA#`3`uuNyrwomBVV3K7S6vogcI9loP8Da5bR??jN2-@qe3RzYIV< zK66J=sATMwRoY~>lPxH_T^c=q89=VEXSeH3ZaM*PP&^YL0_kze9y3S|qA)Q5mk7PI zc37>}pw=8G2nmWoNFW|d&S;zKboPoM^Y87wOl2BF7+#riBNZg~&(<^eKVPSkmMA(v z>ss*Av!F0#PZJkU!N6<_hl$Rm>&9xUJ|WZjiqv}|>{bga{zj*E1C>;Iz5u+Dk{POc z6KH5>A@21@rjbnoNnLjgH6OKxN)v;m=a-&6dxofs1Zid#HUoVadjTU!3)0L7@sn^r zc@*1kYhbp@IiPxggM{-T8)3|!hg?PV>7qumyc#^xp38XKkrAJq79I8Po_z20@1$)l zAjr2EV2PluzjkI_v0}(v&VraeH`GXgc0mR2$V}XEa)1dtZ=y9uX-SsFrDWtO|12`_ z!x`5PsZuwsit)ZKgW5N5ehawjZ}GaOzW$M{>g96R{Q@^m-ORxSAO|y_gT_+$iNDXdcGz6jSjqGc# zxwC&8xu-qv03~Nhf@bbB_VALByHKo-?g1&_Z|rYZBh6(S{X)S`YJ29I#-;FKH!l6N zd1o$`l7PLvxz1V@`G%Tl)Iavjow{DCedlh$Ay;IbQ_-!4+^)u7fF$GLO(S@(qx{3c zOx+ygt|B6OQR=Finwo}HlJBLz4goKSj-}h}CM*mtg2^+fpzQ90sO-_Ex74EGYGn&s z1yji^_zZZ(u0>sh%(;q~Eii?LSio!j@DduO0;C9p-kJq`*vsSg{f4UrCmN^VaL+L} z;FKwd;VM`1j0~nqV5D|(d6g4{p|%c7^o3ck7c^d$@aqZImrthGZh*&3@4|&}Gt^*W z3a9^naHU(%g|EHk_w%{Hf;A@#F%L97r?W)>n|ibJtnG?foBsUs73AWt^=SA?KxHGq ztgLtzew_B(Eql$K_WuZPnUhV^2j-Z{yZOoEVZz=$B4^%*a1lw^FSA2JX@C^S-_i~t z>^LX3wn0Hx-}OSr8V|`lx~615Dn{J2%}#UO4GfM1IsuC@K+nk9fa~alcR)lJ1ia)9 zD`_(_*JvoV!>>moFkT5Y@Nvz8^M`+R`_tQtZW(fx?0oE5af#1y> zpx|X-E+eCrB%uXhdI}tvO6#&79IPxlw9Kq5{VUe)r3;qBSwoh!6m?U>$$&Yr?+n|F zhSMzaU-Jrblvcb@B7*^w(iY_6 z-vpBK;V2y2r32P<4LqlvQ4NAxNM4)QkXIbf86Bl6ie*4&chi4Eiw#Ja3CWF9aDKNv zwMFBbZ)b(AD5oggV=}q{@&!}^aOu*aDQ#8*&#;aVCgJ@83#(o_r6g!$Ob4UMdhlB7 z@PZL>CY57G>l3Q8HPCF-K(hhiM^Laarl(OVx|0F;7uL(57JrW2X?wL|04HrjsWCnA zEq@?b<3jUEbhy*e1qle&o3octXJ2A7mG~sSQbYy>&|);(Z=eWc+-TVy+8R|_wYa#bVhjrE&0`563iNb7&x!jW;TE*m8Vo`7=!WSU1)pC5*vEQN zC?1?>g~-!K@jwdMv&tsmJdy)P1UOjbR=E8Rlo8%d_7N}hF8>%|hPyPJbEw?1oJ$55 z6wKAp>QQh#9R^nQApcl6r1gLz7#J>dBRjq4sDQY!skU6Ao*9gHWCTQ4!6Kioq8juH zn6R*?7GV?tSejGcwMU#;C@e$O?)oZjEV)Oq5>%Zlc z6ohtRUUqTI+xS1Kj(vDn>rfaHUGf3BGtG(#&yLuY;FF=rZ9dlUva9GgdiClm<#O^M zKd2XncOvtDfuMOO>vb&vk_31KNP$0EjkSUz#M&b?!q9JP9YgfhrW?Blu_TsAWAi)P zY@cKs2zD*0Xc?cmfawKJtUfMS7?AzX&*`oVy?%_J$1xR(SkT%C!!@@C=@}lT#@XK> zMee|N!qs5ZJfkK$%Q>S403nR)*%vop;)0bj5onWLc!&%Ds=xJ6)4PnS&Vd4T8Hl5P z)b&AdRwnr}sS1%9J@$wPf0cLCj#Yi`|- zD)YTm^5K*_3rgunjvqhX3z;zHpo79gh#d7n_wQfcXBwfm;`#xap4kud!pQI2zO=^! zcsD&*d`IPW$P37HeF!?T#!A73zw+;V(3>ZCtUX0gIS)zslyp|76|bs}*#4|;6F0Mv zm>GO~KTF`4p9hS)@CF9+10+#snXBLd^vj4mM#C*pqV<~M_IR+S=vLQZ1y(sx&SH6K3=C&eS{3oDxvQDs;`QyN_3jvmTK5-aGaV z<>H~3tI~*_+1@G^?-&9bR9@7PA=<4_7^?i+?@(^6bSklbRX<^$l9F3@nKFyP^VEWG zHjHyfvhpQYrMZ%>oUMA14n@8%1$UynTD+XMGWGA?q!M8mI2G@#cV_E`m{d?3rPEps zEVP2wNa1Pgnrp^58#6rD$=Zp*?0sD!!(~B*SFJvS`|BH72;NEY;3 zk1nIoD;P^`fNUecT@vXb2obb^3B_rN@0er5f* znbt`TAjxSxv|b%t62R|gfwX%F?SGm34Fky+{FWS=BX*>a{mT0Ni_!e?%U$;Ug6bk# z^Ng)PgJ-+_G>*%<-^n*PxyR3+n+v|xnc_$UDzF>=>g$2OjOEYi_ecZd!3&IsX1et2AgmG~!2O~JsF*DjN%6Z4Ozs*I=(q*t z!2`8*c${w{wRI$Nbw((td_Xq}8#=g^N@MolOw*fh31Kse6k7|-%cd_j%0Y@bnO{M3-^>e#u zdILbTSqQLj^ewXNtn*l&of4XW26{3u?c@?5gZkOA?}6333m{$ox`WoB%3&NiU=@NTx~8yP8@w&uEo&?DCgf%s4DP%a`0b+O?4u~~=hZ8;O6>sj zjv>IaY&I6o`Q|l~xzfH_n>&x(@+;%`awvCU3X_%HUBbMN!Bw$M;|`gGc_9y|+g2mL zO#n8thhrUFz%Y8q=htmch!vzCxkpU@1^e0a!Ajae?Xf{6MYn*IfOGRGKvFPi+Ir?> z_tjHzW0cp62AqO6;S}1L)21oIw>6~1G?-Ga9*`cpRJ$JZBK$!g*fc!Z8bC{7SCu)p z<+RfcO$JvXX!V07@w!@q^%3a5`9LWJrT}2xUmP)c;KG<^F)9R9e`J*{sMfJdHj#G$ z*Uta^K-wTEPRyGeBucEHtn=^~ zMeo^fdG~&pu7gft76{qBXo>(w$47|%SKcxPr4H^+GpaZf6q87IU6=+AF zuXqz3J-rtFL{UY|wIg$lXjPH03W#43>Z8iqE+a{7B*zK>Q;uj$Exn|0MRvloy2SvI z-vKfSTlWFiwe|$BnrqmcLGljk?^7*e{J0XtBA_C6R3qsdfaFit>!H7_U2<&O?IfL7P{f$qQJreQuXce+%4wA-Y z6ZJ?=wE8qt&>mFZzn|j?VKJ(w^$+{=TucKDKH|-xUkQ{ouV58)pYbk?Mxub8>#ZD- z%O2SoC%A~)Z`QI86o$J8uH=_119W8tU-3_5&d7&kr)i8$*6TadOv z20$wpV9!skd$;R2?RUkduE`Re(ht`Fb~@MwN<@^R#BaoEKPYZLGyvUWoRjxDZeJ)! z2ZnZ%F@g19cJTgXe^KMSCg1+dYh-|7ayzi{OPg*}E6VNCzKq@Wp)0afm;~{u*WoX9 zZ&~WeK@v{nqKsq@P&8EW8 z6Z{M*yCBLY9VZYgw4wCu@2^5*z>b(A@ft`bcJ#_fg6;~6)3NF_MvXyQ<=q=ET^5zf zL*hT8I1yqd@HVAiTER~?AJWekuaSh8juXuo{DU)Ax8&n~Fb+Yyh=3U((jTrJZ%* zn!&f4mg9Z_kyk1oa|k#^p(N=S*4ZU>OS<>KAz${T5z6!(aI_Vm7+;2r$3=E5UaJ5^ z*uvy`;v*ztV3Av2#`ovGgm9z7*rK;RDM@t3>ex6_rSDQBdex_eoavMef0vO20TZEuolPhY)HcgQm}gIL*?QgI%u= zNjlsjvZ_hYYzS|4>EFE@L*A`Jsw;HB-<_%!*(^)_W+DYecN{F#&RDhsD;^ zlUS%7!%99EOl|jcE_bJj$Q5`cLcG{_Pmr?BMi|)fvMbFD_p@SGpC3c|EPgVF%|<$p zOb(dfOXP1}USz}~nUbM{;A>F97vBmAIf2BW5P5t0o7ZG(j5#{L*VjRB;=YbR(m4^Y zjUM;hr5(tsIxN8R5caV<94z_;7GK*|0b2wocRZ|}5`rLdN8*5q|odjfCJD_a#0G=4 zC?8OdU2#3IC2LG1s32P_MQ2}5m4de%^`)?^0}ONt|8#K6>xmjO)r&&U)KhH+*zu8y z$nIdd7!lmLrW6gP6q~4F{EYbDafj32!aeC%g-keM5qAtaocD}q9TQ8@FL#XG^zIWD z|GH{VPR{8L0|>&tza{&e=|0bu1uAmNo%I7X6rZ?>B`59p-oEt<0lREi`P|@c^$2x6 zzMw>ol`SZtfMzZ!fY6<~ zjJ7tr(hjpwn}zXa{FS>CvF3}t`|Y6odp`gt`#^9_4!9Vu@%;*^TtC|(ZGR)oug!vG zYrI;7=aky_hRq-i|KU_kTYX(P zIf09E*~EW)Ihj#zqVUftnX2lOf>#JCCflF0z0Lhw4J*6oo^EY(9M679y1gmg`*HM9 zuQeM(5egWLc+wRbw-2+FSP-o*JAG7_?K{?9i-$Wg22)z1uF)9Wgd^O~jp4R>nI4gC zg(an4kAKzU>Z~XsjiS$Vbq9St3M;jm)e3WwR`FOg4cz7O?7aRQBD)qR&u^2$HJ5e- zu0EG9oPjJ6_krNBHU(xajWpe*@Km2`aC{i8W&_d~wo4EeYhl=Oe<;UVNx9~q54%%3 zk#qmBbIX~zZ8|!h7x>#B17Fz;$s>f7tzaPq(6Dvb7@!<*z3Co1q*KqR)Xki_qNm7r zAmaz(y!^(k!q2>;IRhrT)WvvMAX6%@fhD@X4LGHLe)_ti@32d!YIb|#m9*p0hoDQa zXz2XrrQWZkCyAn22l6TP0U=jvSp4*}NxX;9>GSTHa2zKkOc;WHCX8yo>3k1^6fnP- zf}t=k7UPdcuCON$%1V{$Bi^gbQ_6emf^LhFC!H&M%R#FtQ2^Uu2vGoYDNS(rurFUo zb2jV}KMzd5(XuK$Wk&Qj3KNN5T_f7AZJP$x>9I{H<-EuDxg8%arNU0cf+O5uf0yBk zaQ^v@3_?a;f3jq#^sn2Yg(Lk0X_B-ejh z+!=*d_`!;W{hlAL*$GS-q8+yqTRmS^BK?H?dj?m{44s7OdPUb>s_>TG52w>JE~g#x z|7P~Us%O2km9@)F_feshY8vP1EiD=2=U0$-NleB2`_x1wC8O1sw>I>`uM-4@;G_+w zzr>T#UA3=Vea&Wn_}@29Um_`QEfPJeprsxMR|TcZZ0~34r$}V0Ns(-!@uDu?osspM z>vpAoqAHfuq)8Qzh73>xtmncA(Z-u}<;1K@wq6&_Sy-rD2tCZFCG&TRm+4MxKNM-) zT)#K~{E?yjRff>OeTP944-%i!40(!Jn|S&!yZHE@HQ1`P7lOnGG}gR!Mv-0rFA!`R zP94-dDFtRapO4z9T>2L@KMM6f z0@Lz`9nwyuD924{Xj|>~gy`mCC08UzF-pnQ%5k|_+_W5ZgLCUw{rNr+mY70ua=%)| zW2LYPWmHE>=Cac=>lG=VJR96szdUV0@4Un1?Dgj=_9%ndg%iX?-VpDH0}dZXT30#@v7 zKc0BlnkB96^PaaSJdd=^Z=G5l50tq2 zI3IxVzTUSxz_^Pw2xf5|TnBSbuEQWdtN%7UdEsRGb)hCJxTSGwuhjK^%S|VyAiIh6?2!1PUQ5)7(6NPI(8S zh5)&7+hkfr@va)&q9iDQ~#%}Mz z)Ub*T^n%oKA9j?xbjD3jxfE4Ula10YuZQD3^LDn;B(NwO?J4YT{m@)T<7e^2n%DqF z83WDET`Et1JgZi$)#lldf|*J8qaoW2pOOyY?i2mm=?|U|YLbUuxO7BO+mEJZOK*xi zwJiKG-j`I|Zakdh07JR@X3W2u=E=}Lpw)D3vkl^9i$DBuSv2ye9(<-tBEoYMx%b8s zfpGP7fll4cab6zg%zrYP9;1AHamXEC@d;uRCcqX3>ek~LFB0*N2rOx8@L(6jZXdQF zg)ePDs4VHoql2b^w+R$xGvhSk&-hQApzE`U3R6wm8wV#?$rpg!_3gu{g$sOGcshSt zeL0Ys89Twob4-~+q9O;m*{}-KP7tc4drx4YJ4?hP02_hyM02sO5Tr}d^GIUf_JXgz zZ>hrJt8Pq3Zp@(NUj$Luaq%*3>z=o;;ST z?0+ygJ$kM5^c;xTGJI(SB;;|$S170V*##!@ zF(*7J5I)Au@r#^pVER@6(PGcqb6dlzF5+@)!;;<~r%a;dV2D7Z_adpIH6na_ef3=x zq4lrXUVpCHF>g=(RGmVT2=>p~CiV+SK6axi!J}FCL+=5$KNNkkrf0juimsy^o?UTJ zbM`#N+r*1NGKM3&)GicG0blAdB8zkaV*K$KHD=zw#X;E!bODLgruVn1*Ufu)wny-D zq1W|mM;}uqn2D{KG@hlliWdoP)$+fjRN{AQHoFt~5fD!8so*VWVr@7^8PC5*s{ zAgF7%L$RASLgdG26KkN#=0ga|nA0#iiIM+_+~&aZ0^37%N}rGd3|}o`_*(4-Ba$QL z>i5oqWoF50xLnKH2ZP(Q$I-Eh)-JlvAiwU1Ysy{yLTaZ=h3Q?qwxp09ZwGfbTGRq! z^4Q!|C@h*Lm2tH3v_gXV$G8xj!Y$B zUsg2%;!faNo~or3)F+4we>6|}Ozi-;qxQUh1=V9CNT&o}`1av)jn%rq-#Hq7G!L67 zG3w`WF33%Z9p7L5L<=Hpz;T6?oZF>>xAaQ0vkus{fWrptCYh?5p^t|TU@pAfvIYHe z(YusA5k$$Mk!b~AiLcy${P=#-AOAHSs=d<+v;*BSkhP{Nt8%t3WiFTE-GJh{m*WQB zOa?!WglnAG0iH!gcFEvhL{pUB=RzsDpY{U~Qy;Oz8wGNLUnC#6TVwA$nll5sqdHg%)1|B@ z-c)MYeTgD=m+l3I_kUs%M3J9>oERj82kjDFPdyC2*MJnTl83|`a?_6zrTy%ZxBK5j znRl`#_rg6zI3`*(;IJg?*aF-d_;_bJ^Df`zWWeyfU}9VG{E}i>zD|C7SN~gs2Joq8 zW>5ez1r<$ky|E`5i?9L&Ab^uVef<9T*jO*a#u^R+3+wjZ`j3E{2B=w z4-_=1EWgV+b;j$L1B&&YU7xRlEkh`<>Z1zdKX%ZE*bQqlO$Kt><$_Ybbf>rMg&<=k zlm`nVPcOm>IL}%zWw2t>U*eCrW7lmiS`lXGA91VQoB5vVn&!4Lmh3h`Kip?MoXO8t zGu8RF#K=?Yyr=z$zuVyFO@wZ<@`ZMvOnc%A#(f~i@gagSpyb%)m>!7M?{Fj-7hTKv zv0}Jh{Y3kXSy#F?XfJM+L4_FHmVg6mhu4TI1v4bj3q}o#9>8ACLU&4lQ08XX8)Od- zk<5jKv&0z8b-C4dklNdY(A+YB%~crMVULxG?`9VoKV(K89}|G^zu+7{62OI)I}T_` zz8eqM=3xT^o6}I<&-MT3%{lQYDhoryg7v1j$ufH$L~~)82;nRtOdfoE8MMX;V#lh#i*K& zO0s2YOcm7q7<;AV$&I$a%$c4$2moe29Mb=k8A2gMqAw%yN8d`|eP@epfc@4CtvGA2 zo`PHh@Q_opGL`NuYI%rO6NSfiw35M6lQVD+tgpf(HID45LmuCbbh}gi1W1+C7AKRH z{X0$TM@@%iSe2;#H)AJt6F@W{Ja~44 zJ&MWJ_~Of-KYu!9O+A;HlSGTE5VASZ7H1%01G)hMvQVU4kDm)*KsjcfvggkaBb`hy z?AoX@(>K=5?|QNMK!7R*vQ^PS$kcdjKh?%5^2< z5e5SVTi!kvLwwpRaHr{%RxXj2wvaUmQqkHst3*oQXN~KXIAN1V74OLYgO@!Tw+)E7 zk$4@-I9`4LDR7?&_QS?@Tj(5W?*8Pn2&%EtNrY98Pe_=x{EfVTl-WVZ5VffqCFn5# z5M=h*1dC1UDn6CwpFqrpZEORT=(1k1JP8-3WWE+a#5v0SXw01jb6qZU#~rq(!YdCj ztW;jqm!lrt;FVv2_Prkz4O0;cGi!(<8b0>CQpIX_%B@F5_CiLb#A!-w$W?^)JA*z% zx#A5hazmls{XJo~X)upN5N`83@OJlzmd2Z$PbtDA8{Nv)P*tzdQ|tE{Co~lfx^nu+ z&$}(Jgsu=Igbv*{fBsE@iB_J-)0yI$U)NpeDmwF7s1dC}U{yV^dxWT{s0QmVKejbk zehz5+41lEz?0GF&FfM(c?xb{RumJ7yM*1*kiOBG*q?n(j`?EL)rmHv7GqUk$ZPKf& z#wu&D>a#j{5$a%xrgiDnY@d5OPHz1VbYrg zqrHKe-k2&sfz8dg!8kJ|9$e?K8|!&V#1|WBu|?PPZE>cqlJYKUben%J#8(CQ)0y(f zR6t6^+~$(pR&p`X_Y-nx5O`HK&j#7YR#j6IVpmG;si6l`)KU5` zHmwc$8=&I2cCswbc{(b6A?w{o{7M6sZ3PmA}X5D-!)Km|PvjS59BKP+6XN+ZpDHmRpG)zb3gJ zDKI;Kf zA_{nn+xFSpPoaT`_X&ypoAalCWujayR}xoLZu~M*q!-pUvpXbwky$Uz$?`c!e>ORf z5|KUa1bCpTRN4-u;}fFX%k3LwZ!X&qpn}=|&$gJwL?NdG;P(G>n;*j7=LGEL^9POE zjH2JniO!R|hSL~s=AL0~p~Yy)uQEBn#^fQkQ(i4!-E z@)NLZa4yeea!>n@l3Sm4GdPQrZ|d*7toyDbGIlIL?lELyS#zXTyKGfj#w7P+=8rn4 z8>Y*=MB*f|`V$+DMtsPGzl&)w+`TvrSibQ*KeXT7n$ACk-O}7aopz*rOJL^><&5ng zmTXI#ocEcvyo4G`$3mjY{9+w5x$_IitR;hMB|oJ!?T}#3ZBlk}1gWJ}m-*i5%GuRj zSBzaPk%=GGXPPXn>}_Cr%O1OWB|k=+D5~@BuxvUJ)evAYpl^boZXYgl}2N zU6;EpnwSKg*%gqiRDq&u0vP2Ev&{icCUzz_w4nZ|n=~~><-0?{?YLQD3{E^(S-M~= zK-C=|PI*4wc{4MS5)&VH_GiAltL684m+#Ma<_r(VZxP&v0r&Z+;E$sAiR0tq6*d4A zU^iO4_j>J=(A7>KQ$ng|Dt{I8!&n(gzF>KgA+# zV|w`ZpfbTz^MNpknrH*dK6{UH(;-e&_P%#1CZ)RbKBh;spWKlTmsx(t-MVY@ z?8c@%wJhh@d~qGtfKqRQ;YYXGVQ6PICg)i0b7$kdID8{SeS;HF@)cV?z8rQ=VTxy% zyQH)A%NHWRHK+~raIpk4qi_eOzm35qrc3kUR<)zIlN?naH-U-JS`3>jH^$hOD z1@y%t!&cg8oo#Q!-;W*zVZ1U26xi54MoU?m%ctWB*SvNnwx2RbAVq^eAj5C zL9)Uxwx|B@PRb<>(Tu@my|?NCReq<3GbM}++uGUw`b?Y=c~TyM10JSYy;;rjASZdz zbx83p+c^C>@0I?1GE1?Mky(ui|M#71@6;cus)lm)D6>(Zf=klhw}U5w7s3l7&I+M% zcA&I{=E`aD4>`}#JE5Zt-`nGeRujC94@8pjP{+@2WNFS1Vntq82R|iy@}-unI#QJ+ zU-+Z=m3!ygo}ooZ-%6kC-L3ouQ!2Ypu$BCEkouP0Nt@%Q(iyw%6jrFS|Kz(@UUpif`DM|8aNm?m97|cdx@nRSCam)=X}wcR80Zy(J78cgJ%HP_+)M4XJ9 zH|#1|hgUC@z$PrBWajd=A2X*(-fF?deNJY5Y9Ktfg_gx#KKk2Pz)`5uRq)(Ef^5%c zclycW8QL%`i8_tWqmd7 zG%h3~LSe4yrSZC9q7=@PpyaYvqUaO7s;&vO0Z^IHRqnl;eXgYVqZcWEk3@FniZJtm zqA5ngm2W7PE&mulPM;RDN++LgAeW^>>E)WcylExG4Ra27SE-eOq0kU#6@KRDa0p;F z&g5%UJNYj?yqj`bpqIrP?KY6elq9Ru0@J z0CxF!{(SS9oVjn-T~*^Fr~4DUhr1DodvX5Yq{&Pi{G!Fjj^CJ`ZAM>s{5?Rj*kqG! zB@|VV?dp?!cGLrDM5~;gQjFMY-NIa5Ew)C4!b7=i8uQ*zn=EN2i+<337YgfUL#Xw> zeaW+nASt*VamuH6&2t`~iabd_?#{d|k+T@r=IgwUpZZT{JVoJD<2@L_8ff=B=X`y5!8$)H$%P z6RFab3-{ymr(LDn86i6(MrL zA!9#|p2`6t7In?#6NOAqMaAPsr80N*XIc6MCmFBUoU72NoUWwvmUg7X$ZRfTrAHl9 z{pF**aq#>`jPg`w=AX!F$FApBw`xzz3Yu6}xnOm|BUI8@jg5eEW;7Oa8P{aenZ6mA zWb_@ui!BXgP0I%ec8;|!R8lOKZZl4a?kw-+H-|F>9Jswx26&O-z-yIxwP&OH9kycs zCOl=}Qdx}qBa)Bk|3F!fJGH8=64EcL78h(?or-+#`zZe4ql#UoQXuY-&6q9-r^Td{ zqdFX|U5r1nQMRH|r>dSGd`Hkod{qB~iz`8JD5FjKNj_fy-Edf00G&cw=j1!H>qN!{ zMg>LJ-u2AzVy=Oe=w(;?z~P z|7`us>d{(4v9v8@F8^&n5+2T!PS^%GwIVnaaMgdXR^M$1i@gIXcZJN+Gl(TJrS9rkFHt{&PTBA&jkQnE99ZU{ya{Xnk#h z_^iQ~G$g4IK6-h0Kz=@V=IJl;-AKedgXxf8iDk#vDj#%*>);pH+@byj4EE4MC6p_v zidC}o+j{O9*T=*DfQ&N`nJRbRv%HHZC;`(;-ls#btOCz~=FU^#wgnH`+Og0V!Yzr~ zPCPKV+rf+RhV%`mcqLn#;j~zW-(1Qq$zb(rqvAHux=Tg*;gNnxpApq%qoLq~fk66K zmj8z_&x<~^`2X`%I(t^XS0%zna{K)o+*3N38S>lqB(Z!%5D6I%&Me#fFnPbHBe`P! zxn9GXVB`Ri8bT+MCo^b zXWasaGgtg5FdbN1b@&^uo#lvhhk{$*YaD8A6P!H!7N}RAI(ZtEaKE(?IafJN|2D-z zB4k&=-E~FEgRiemIR8{IbIm|CXEgN&f0*n4W#{7GZ$MmY|3ODbbq=Y}E7{-@Ky0>; z)ShRdbk&cij=sZamlX!5A8%|w3G!xWUk25!$^u%i(neOv3i;8$UxqL~A7AKB{8i>S zY=90(0{>$O)sUyM_uJC!7&BCq_ADEaGTngeK$zK`UDM=P4$5%HzqtsCb}B0zh&&%P zpBW7h!7(}b$I*Ye5wTp-~pCzSY~53&InIKB&o_2d+c7o33b?izszn4_bk z?VkNTpSeoC4^W|}W7sP)Pw~izTy)va%{zX_*y~(nooag{a^FZ}|6~v$Ge06ZHhZ>< z$Do%eu-*SXB&DQzxLr(!Vj~PUB3?uM@Uo%>jZ|Gepei2~NxFgl*%+&si)mMkYPZwbUeH_$I8a;Jb^ zC^F|)8(C=RoVj9&V8oft?E(~ei9`mm3%?ubZ0tRQx!CzB%A}Q~v}%UYDq~B!F$vYL zTk6r*Qhp_(DVv$qUKLtQewZbX(U={QLAo#|BSYLNRoTNP}tJ8I3 z^uznmlv;oQ#|>0UDu5p8PL;fmsCIFBieiE>Og!vn4?nFqFsEMx-v?Vc3xGP++rONG z0KKDVX17D6Fot#CMk5iOC9o7iH>3V_OEtRp%q<6Tl;t=#)usB^=PFe{PIp=`?FmPg zJI_dYfie<}vIgJnLTzN^`7>u95rZxnkyvwZsDK@Z2?of5Ep)3H<*@8?KXRXIzhG9% z!09T=tog~|o+<`)#Ujxr{dzb`;|xu=QJqMS#SHgk!u9t0sJX zhTZ&Jx}5OL_=y=BCdY{B{H#*gQztF>1Uu3Px29hW1=% zP^ds1FyGHr3~9tb1JUC<4LwzNm>18J>?S41Smr%R2R*YJI##H^j~g9qIhxefk9ac~6(7$IrDhCbKOuAh1%=2iw`b2JwWv#ah22PK z&+1}mvW7}WJ0@H4LHBc_&?b@4WH-UvGs#=Nfse{I$>!^%cal)Oak1U}Nq454wsGgJ zVaww*)EWz|n7&+))l@<^ZHS)3y@TmyN_;VRMWO(x)d6u$ma60lB=6~;y@Ii`!q>O- z_eJdC&$Al~3jgi*M(SzBqkp)Sx4uqByj!iYzq$!jfP3?9k_oM$0C+XrHB`pT zqq#F@_&0(TUgzyn`AggSB|SQJa=7@QI`mFfgMTT3n0NXvMj zjbZ-2V4M_qFeC%63sMOfMq}VA(g9`{6EfWtw3`buzZ}>J;RVw%aWweH(`)GFf=0$6 zGi2dHHwGT*E`;M0DB?YsDr)nw!XsArN^ZrOK+M}8;Pq9uvueD2`O3bx=aJm=2T?~K zm(x2M4J)TM6|zi=X*!ltc`RhwM6JdMZm!&WvyZ+&ZTIU5kx%9)<5E~)8ehD0X&&e+ zHwA{k0V2`7FJ*F*)*1!-dYjwu1<}q3)@0uHEaVV zS^2#XwQ>y<+;ecNV8AA$s-O^zNCwXJBcT&+FjH0q@1DBmx#QbHLY1w*>~~t>faHeI zrKp62|83IRKx)s(iS*V!!rQNbl}nE|WLBvoaf?IFzo6I_kmc+V9!#Y(k}IjjX~nc@ zYHG$KBWwrh=|=Vxk7y*W(vsm6RxTkNIfbmN5dY@D;0F!`%abuB2CvrGv_XEoFSc4T z0yHNu1x#vj<7q2w5^;vPeTD6#X@~^ks1Jdj_(1X|>zX_Kvq^13(fS8I z2MK;hf0bSw%CfUBAK)5GUwv0nE4yOmyc&}^rC%LWatK;jK49Efj@~!3ul0o~*TXW= zt!fW6q~)nCNS>#qdB~Y>#@Ad{-$EFvULn7&K)vC_41NMlfogXP3#&Uc|cHm3gny*AYLh zR5ow!%_~cHK`b(kc__{yM(w0rodLVAl*sfpPC@*%m5Sf-lgdW-od%2bzdf*3lGR`j zY`ybRwTtb-Ag8e0&rG>9Kbxfq#DMN7Oh9dFf7Z=(0{o&LnR+W)2~c~nDQ|&9 zYRuwbY1ZSfMQk+15U!wRwrba2fua=TRV1Q-(*0 zKwuWWR9S)XCa}DUxy<@^_>`=P4{!b5u1<@KpM)^7Wv_hpX|^wnW(0z@4O`V2Ye_I% zo3ywE1jO7{)W1nvyvgH4Q96oi%}<<2h#TG zDr3v=dU(t@!+vjJw}80NW5!nag_V=7d1nmhx~3pM3IX_+M-+kd=X-E`bjZz`0K89+?_mB+Mx{98%OmBJBD zB-?9(!FzDlLa!~ISlGGEiM&$g9;b6(Cw55$j`^OF4r98% z;ZOLobP?X#-e&BspzPmR4VgdT^Na5?JvIDpQZ*E7%w6)R{6@`j_piBM9mjLI8T2`h z#@T(NSN)xBPq}(N+EUSTI{v)Q`p)&EVCefdpA~0l_e@_@UaxrlelW4rh~3Egmu-vz zV%JP>EHZ2Qeopr-jZlHQmJG>+(2#>t#8Cxfk0P0y`*ROO=%Lb z4PxdOIA0RfIbulS%wQH|08u~1ASf|ISibIQpi>w+M}_-kZ{B`~fCJG!nT;OeW~+&Z zJ(|sy&Hq9+Y!~61P_7eE>txrLXS8gzl+!c`$e~n@0qjjL;jG}zOb=<>OWx$7OO9Xs zN;%2-ZM?X9z8k(bmreA|YT+X%^Myk**CI~Dsb-$4d`(qAU(g_Ds^?1gK#M2+O*3$3 zcU*Lz))X+dlMAvxFdB7y@WDX6sv8*0tBuo@^ec~_B{J~pO)Dbfz&2CSREBbK&Z)5$ zMd`j&pA8iR!Gh4Z=(&f@3y7CGk+P!(S5nvgEK9Vff6(E^@i}f2GOZxTgXaT_Tny_2 z-6b%5(t%Tzx#c=@p3HSRqKj81T{>CuM=&Y+H$uuc)cx|!p9tPITPT`_n|c+^L%Uve zUmgyHzx=t@(H<&cC1XrdsMCk#1}xWg52p=Szd6lsqMjFia`_3Eq&Xnghyy|B4 zn{q+IIm^!S^!|@6pW0|C3DiQhZ?^XM2K{)ye;h16-7oVhWeb?h~!558dK16I^ z{8p;*#ax&dC)-<2i^m_b&Zd=jX(XVz06; z>7FQS#IReH#=kK&;ncb6$aASx#o;pBSn79Esm7|bZvvU+9_Y{q{ZyoK*at%_pRVy> zgVk^!No{Gaa9*IGO(U`S7(gef+)rI1-sJ)h>;g)Zle4qCYM7t_aO4xQU>^b(6pi^) zSP^yyUtBfJU@bH@7MKuv(>(H7UUQN}@yZ_p9SN=s(H^ID!Sh-NVilL~|6S}4@FaJ! zNzD4azU7lz!qv#|-;2d4U+um;kxz3paCmu!A+;*YD#wPc8JcYC&gZtXGUd-X?|P>g z$D2r+ZTXGfHJL2U+dD0y{t1W+Az5Y~>f8xAz&73r`U!QkRirV2-j`=A9Q1pm{_$~g zg|9nJ`3|0VP1UhgEJjh(+V?T>c;!yXlKd5#D!4u}p*Y{5R8X+@IKQ`%LYSt0KwXZ< zJx^AqXQQAS)(hSCra@&e(--KnTS$sqbGQ7o>{}6xeM8)dh!!>*N5iDZ5q#?qcWEh! zFQaWuqxoIvQ)17l7F~0hqq^MLm?c&wA~a?3ix4P9a)~wKhHOoTkd<-b%x}H=yo2v( z=1DZGLblnVsMir6d;9GejVLt@CredUJW_^(XUYUZlfQC39fFs=hFAu#WmJ`2I!5{F z&DXo7Xuqp$t>pa}7xomq1Klk__U5uUV;t(uX#SYuNBD9o_dg@Gg9u&-qMbNLXrKF5 z*mX>W&4{y8&#g$bXDOc}WJ# zat=pzt!ce}F5jvwN^-irTBBp^H9?PA#hGWdsPsg?qabgt=`6K<5&W~lAtlaui0SRx zCEt`Az9u&B)g$`0gnngK;}+i$zYu(%C0QQ$t~G_?F=J1s_4%vhMy9e+(6y;3u6_8M zU|zYY71wRhFcz!T)y+fOZg=rPyt{^SY?S0h)@xr6FJ_=<*a}${KGENM?J=(2A^1ko zGk~~ga)@YK#?*S-*3q@tx1{GjB9{=LT?Z?d5XqWRZHC7?n2q>j`vc5UTuUYx#S`B3 zw0Pb$Q@cD3#q3({AMvH4Cbcc8FV=a_)VjiL#WK%aVoM0H>ya2J)16E=Rtp_bLT}fa zlJIy6fy8FhK>Uqa*G=2gFlb;}Ehu!qAj)-}5|ys_<@5%wy{!2pD4ul}PK-j)<%NQ3 zR$oG|u=S@W>Xpdak$q!pr<%(NJz{{{CF2yM>++wQH6uH${*yClMR5)#0IsyG^H#RmE0`iG#QNj;;ag zI(HHMw7~ghoZ|@$*NIw^8vI|XsS)I6FLtI5ucVXzToN{@ zxOHc3&jO?V)V{{&1eeM$o6NvN+u_Sx*B&yqgHa)vywHjl_-fiNO7X{I6+1d!q;`-J zSHCXrNa%Y0yq)f@ENzM1v}LhoDG8akOfLG>Hq*a6&HOj!y-0&-m0-U=278ZhvBZN# z59q&*B`&~s=7*E1?e!@o7bh)Av0NQ23txE-6;9Xx#c^J8VY2jietgI1Jk4y^(dDnV zyx0=L8|1WbaGLNQD2R*PGWmlCpRRt@LY_n=;l^}>P!et z_F&^}n#;i8Yh;&v=U|rQX0$KE-i7F27kqOkoN1VbzKhZXkN6@w>pTUmG0e4`KlYjx z&IyB$YT&)=C$I(04FTcN2kzOHFyjeN7H|%21Z`9n;uTfLImD}(9U7kOZ;S6cTHC#z zs#MueNLAVRiec|?zq%Wpk@Bm@pVzr79Pvg=u?Ynfozrs4Mj(qVuE;ppA)AQV5>?P+UK~wKC0P>US-|SzW_;wQ^(JPqNTSyM%st2wx=!-lQX zd()1(m^SW4-df3RF}t!-g8A}7alw4gA+$)MItO`gtkQ14J$X>kpJ-oCQV*&E1YMD@c!KX1vDVDwRpP402PPuloySis|EGBkzIX2#( znfwZK^tB!fmH=c z=`DBbk8!IY$J-5O^ZO)$l0;&iv`oCE`fu~h!zmo}FNbkBo7Zsq+DS~e4b?8Y$HD@C zP5kNR-u&_DmE#Db$NJBHBchJhZ4426fe}?n8Q$^F>UdL4&C^2STU)wO1rl#XO5+D3 z?vJ1}^r{WLaJv8Z8Dbp!4sOW*FJEvxugzdGPj?q%)w}FE2J$2IM9H3t!Mm@-6MKdB z48>*cW9|KF0vq5t(pe5Ov0D8!v-HfsENxjVfVTOavbR$}x0#=^RS7yuQmMWSh+5A>_KLn2cA(erPDZ*wo)zCCR9!#5&b7xynBjW7ZJr6d3o3eD|vq*2B8*K5n>=m}h9VmcFZgyDTELnjRv3Cvb zfDdLB7OwiHzOuBmq?*=L{~NzVo!-pa-TKM|OY4QTkutG|Q6KYNhR#!;^o*63A9OdX z^mN92I$tRIsW8oURO`hZg^riL%lwZdMf`lg^%d-6BqgaNEoI=3>-#A)n#E6yAhg6Xt0VEro0Gz z*_O6jxsx!!koH}CIXmXJP~;|X7m_v+!@a_JCEE#c@&zAgpmRfpfpy-!ZM5J5qO9B_ zLoh3LO5~cBN=#F!!{Ao^Pt?LKy~A?^zg3Mi8tHmE!@q{wlkRy%{=@*i5Wf6G{w22-?|-DAz|gpB_R1ALKfr3u3xl3Gjt2(G#LkV! zJNI{wjRm!Yd=EUl;Io%p%J*XYis_6LVhwiP2{`@O79sN*!r)N0@`}a8^ek|N|q~za&Czo_c zbP14W6JL@-s^X=$%qU)d#|Fk|!!_!qyU5=zlKf;1g!vJWMkbp?UDe~O^4}PJvVoEv@P@Mqs(JYlqT8P2y!;VV!;b9oO80X6Hp=3PVoSNC0<$U zFSF*lSCqdlwZFf=*5^p>G7U9xZgm7Z$kaAqYN`U8VpZcN>pliC&}eniy)odXLM%KS zAV)9@k{%tHDdkwMx%e|bWl$}gneHNO#~g{@#T#umXg-QXW7sFWS}rsXWaMJ%?pl5= zu-JFql#L13F`D{FN3`-gDaeG5tLYPT}}ZZ88uyjt_Arnt!SF`iigNu(j+ zC-=y8(|t%tLhZtrzIo${H(;I93E{y^NB~e>B`o!XaxFbPUOs_1&$@R)v#;$}>z8A76x0h4CD)%_U9Uw^=aWGJ2B#_$_bPlkH33u2I1AxHd|Ig3_( z@)c^abs=(tr7&r;o`a#HI6ymMPi|cigQ!=#%k5quBCj{n2;v(dZw`L>vh#|*@dJ%~ znx1vr0ny}_UHMT*pB~}Skvk9up$~`9J3U9zJ8Ex38m0dZWVks+D2OcvE0lfrNBw+n zn4=Q>nb1YfQ9TfK^dB_Zy%DOnS|dhKb#%4RIX*9zrNbAyLCLYXUVUQP$f@K7hj^0u z)m0?{Kx-IQJEb7@F1GgqmYtWypuU<%1dj2S%Z#D{$g z^gmtAnNXZ@7G)B+w~F!XNF|tMuXcRsJ+tM=sAS8^gj)I|*i$vojLvB2uP=RcLxpV5 zjA;>U-Z5aN?S${*8t|bC|2-0T0-|K6i=01n>tipSclhp&gARV+Q7RnClhdCUfPowd z<+d7#-q5xJJzo*GZmIrNPxbN}|AsQEeqy@eJN^TMKDJ^3jLj1}CESisd21;7{ejm^yoKG|7w?~;xZ6z5&t zxme~zuQHrV99>T@DqVX*8hi_q;pLNWZ2AKenj6#=EFAw~9LT#aP6RaAz_PxOApFRap`1wG#I z+y4%-LQw~c-vs31kufPLJb(&ZU{cgnwa)UwMnS}o!82s{1c;M-perr-AX9h=$f-~M z11m^hMxKTRab7u>_Fk^oEW`c58=uy2dXReNGUyJ!hJYDdtN1&9#tn=4-3B%KRLo2bsMr4PwR#Sa> z=DW>#cJ`)~({aJhYl}O|u}C|gt8J-<8&lA@_fm}V&8vcuwikZprw1Wgb$ZvgF54B4 zsGK=j-w&((BDKRe*MvMSq}~uvya7t<4%nBma&f6a`^E-9!bmutIw7p+K~>-T2cIoE zV>x7-iUXr4W*IxX3%6w*_WW!md)hmDDC-CRdJ)~(_?&xLM{0Gqp^f;F8g8ieL)hAg zoCfZ^QU_}~-oW>TAAZD6g8q-n2mcV0PRjJcJ#0^5?y-Q`>D~u+PqyFb$p(xMlkO5C ze6Pexm@1%9XY7?FU=udgG8E%hG*64DdLqoV^qj*^gD`S)22g6 z#+JG|4qaryPMH5KP);m5kcI&+Y*ZF2DPkj-!u?~DR%#TUOZFI4$@SQRRm*kc z1kB95j*tVNZA^kk>jn%@xpV@_Tkg=#fOJKIf6J z{cdjJO41!#9hRo|4kzd?wjcZj*3ro$l{Kxwo8rVriL5NG7T^C>{U(<#36Wl>^&8(+jVEk?{}(albla3xY9mAZQJ?7CBa>jk!6xy$yPuMc~ERf zpTmaJy#zyIj5tF;8suLOt60ddVg){J3@C_H!2l=-aHd?xD5ti$aD+cIb595VEJVd)eR?$KVu&eGY=@OqG2e3%_an(mhInEV@E zSN)mFfjlx9asn|Rr3o*>Jb(9T9kDBtL+kyk!g;1qobsR3RH_`LvlrVW>>!?jACS_U zPhi0ep+JVukGJ)80{mqt+&0gm4SDHrgq)JNRM45)-7_b2**N>g;%{ycn}50Yu6D%k z@<_plj>hGgYZ?w)1E{078gD79@1skTNb4}W9R8E!bC3`zwgG6j zRrjnJTJKB?8h`P#b72gUMv%A5r548>1x2V9h###>#%Kl*UJVit%0{~g-mZdCRpi(5 z=Y!j!H`xy=WjAOY+5r^F!pB#t@J>kIG7vWM2M&@y{O%6A=iK?_@}b{OLHM zj?;lq3_Yf3=*AP&ySn5QTV-iPUE{6Ex z#f#mmAOwg8)E^W{reZRG`SnQz+*zftQXfv3nBiZySV%k`jHHK-)X*N$?d*1bA5P}4 zo+`cuC(=_LsbY6IL4iX&=?p{R2an$i)_r+Aok*ilF(fy3ojX@ zO6_3sRU3{)4rl+D=|C{w023Kj#SR;ug_i`Y|^3|>IGnTL(=_zUiD2S4= za8^u)jOVk$A?YS6pt(U7O5?%tQ92qaV?U9TAn*PG`eD{h>S+O$-nCSw@K38!hMFi= zL%9kI>`vW>#3E6i41lrmw7zS)tYr;3qgK6@jl#2kkaew>x_VftJ`qYQV(*CLWU)Pp z*=?!+nvPx1$R#DYKE{DxT5NQnkB`TZ>L=;$n}GT_^e0;blfD^kSRt|b zXDyNg8Z(1?@0b6-*I&w|NK@Zcob6k+Z!$dSL%FZLiitv#iyoai8z{uW5At1;c* z%1)JHNb8c_LzXm?+(PLE zuPO*+Tz+mco~H(Lr4P7~k?c@viKjP{vIFRFdpe45)f}?rX_Q2L8ffqi>2q?11pQ+Y z?=z8W%RY$Wo^Vr!lvDkCYpUB%(~t=`%vbr-b%y-^lwN43rnT8S)Gv3a(8cc5zJ7nd z<0JQrN3WXOq@0?m#b`DWP1bxDUz1?GXYM4DLWwVKWM>X3er^!-(g6Y0Ibc#ZE!8zO zO%;1eBk5h?bp#WOiMl7Hwi4oxzMk`f<;)!5w=j@K5NDvsXD_2T_5+A}BF8=+CP=8~ zKD?x8wmzQfZ+EjSk@JEub$r~wJr#q2(nFTu2@6-+#H1%v)4Bml>F|P(0*y;DY{0Ba zRN~|ly)2!^PH3zjJ31ZARM^uj$9NJlkx`ihG`L2*+Q~(Nj+9r zUn)MyT-H(ErXx34kOvq;V$}vLN1rv^1z}tC`g*iLfnXQdsC%P;05?XwKy(Ik{PnKP^XMX8oJ9E`5|bJ#vpR$!w$d z2h;gnK!x!TUkF|^mW$g>6%sG#I=h6YsxmNBhn{U05(~`>Jh+O|EzDX&aR8tHGLwcY zO}n;HQ>|#vur{J2Ah9s6DAj3Vpv6>qk$Kxq2cY)jC>5f}{M-i%{~)Z_9Z2onA_ zrW4bTorGhz%__@i5>5WUo9W&B_XW8Muz3uZMbVy)YZ2-yya+y%}+iIN>~``DrraQytP_Pim|E?%trMd_}cP6 zvMl2scWK_*;NZE&rmncH9(!T>(oz=Tuz=dDIQ60DBEmy|zCO%=d+lY8QPT~O|Jn8m z@V^z}+HCbq!ZlXf0#f_mArh7X7R;J%M^)J#^nx7) z(Ox;ExSEyXqnb(fj+Eqo*?F5LAu5TX&7l!Borv3=+W)Vz?>A%rER`_!UFF6@s4Ei{t zJC@}JM6%&<=i?(twCdzmX+D0yqBQcupNpUZ z1tS4#spYjbpfnGXxfrO$@2xfLn#NRS;zfbQJ>k0;RGann`wK~xwb9753i1`&AwGi* z8GMG(ij=53s?|;N!f9cM`O{p_jLGstmb`5m~QHEMMD4fKb_k~(ky1rR)yRL`K=LoXKm%cz`!7I z*Z8~aN)usVp#O}ha$w2OI>qu}O#;RVZooczT5o1-oLut<{%>?CgJwh)v|IKS$T0zl z1gy5oPGjMyh5;^(I%*Mg%RY5%hK+_P+#~{T(Rj+bFoGT@Z^=oOu0cKjF5Y^8kWaSnFFR@zDYM(X5FMfjVW6C&0gw!Bdp zBQ&OXT4?N#1+wqK6C8=eOnbVx_^%Ltp3`VU{MPCxAOPE8hsye^EuwV&1Q9oJ8@!kK zCj*B3J+*H;aOt!o9kXgS0J7gJ{&y&-KigS}QsZmTrQ$PPX>vtM{{^rBk(`oP~K_ zE}Or*+#5w%`UHaC(T&xDQ#_xX1T2SEV$})G&mEPyWXCxJAS04a+yfE%1*ry!suJ9~ zaNz>K--(YGZ26{rok2!7xAxBc%N2cPU0vPqI563v&Ob$F&q65JM1N3*sfpUR=K#P| z1&X>lz?!XbuU_&AarF@j1>SLz%~-jOWqzhpek}E>+|{pELg-15@z(FVUba8tU}?R# zq?IU`UhMPK(X8h5TghOS<)c7R8J_asU}b2?e?Iz@jdloT5hjaQyzm%uozwB0@(OFh z8JEXDWFehCOm1@^h=<`1h{kC_KdsJDo?(DApc^QV-4`qA_1U^{l#civ$f@MhMXJ&VslO8&WpgKcK+|{ zF%VQULnn)Bb5r#Zs9T z4*TA4_8lKescgP4x%EJpdO%XPcQw%>&9v36NA3Wx0I6Ztte;?Vfp*_oO>kW~9L*{dyY1D1Z-R{Pc{rSiagf28cnoS%<-^jrLj9TgXrgP#}u zV;W1MZgqLq9@_!*MZrV1ZYNAd#iN|F%g+c9gs zuL5NQtDxYpLkw&fJD@+#fs+~OG)`e>ANc%!#$)=9PUrLFO=x0`e**c}O%rZRp9!58 zjz5^WZFH5G4c!O{`yIuy2=}V1cH8$URQ;p<@)@*3KKlB~y$=SRJFx^{cV<$uo?i+G zANf5aErA?5=@N*hzrtbS-yF;kGUaa5Dg}un!eR-CNxw)<-9fBSJosxFBpHKcDj&_P zUfINTMRiMb@NJc%G(h5X^q%7m(k+axZGW38&`e@ORF_*YdUW?pCl(y~O6W`{924*> zB25oQ;q0 zZitSib4y4VBL%bjO$2ePqN(|0<_XMe+#pM^E0E|ca+G=2Ex^YI88l$@bX3hVl<|ep(UZQXyE!ZMa$?CC_L}_{Klv&c`v!SJ)b}e+oo;id)^5_Jop&sAen~ge zeNKiTp8+INAQ9aDAH0KKh*8gTKbgHkT2#31^vKSh%>e_zqk&VF&ye)R zjoamt9mb^&1I7R{sOM6P|FKjj?z((+`qaV=at!#9IW_YyXuSk zSu$23E;D}j2)!TcA*r%We^dk}MBWJJD$8n59MP__XSXDk*9yfi-K^6by=0Rwh$=|* z!}?xQ+@V1cDl%Eav~R(fK$xag+ejQO;Er5e6i%VI{)`|P$(bTzcB^vRK3Hp`Q0q@X zm{q@gx)18Q4v=A5e6ROf7zTF^HKa#x=Lf>#VOQC- z-?UhKo5`$nlIuRDRa}ipOzgoE2fNO^l=0eIi3Bo2s<|&FPOsK~xWD{_07b6-BJDdO zB3;a}m#^b(Yio-)WV?2)CE41-VtB#(zZH_*K;{c%Adak6b)sfrStrmYgw!h#fPhAH z;Fsn)Ag)(4U4y>2JElG`Q`~DM@YD5}?eatADlrQ5S>`&Wn?`$A+sd6M$q$aR4kN2n@lj8xcpVxq*jx=n_wLiiuty)Hq8YW!tOTbHDw#c-l!s< z*WpEm5xJSy^EgIw^R6?JxIkap-aXQ>v5K|WY{KM{kM;eIW6FBQq5^7TcM}b&5h?$T z;K|~P`_}7<&t|}aCJ_lb^v;X%p7*eMxHmJ%m4_n7SaEY3f7CMdJN85n?5rXpW5zR0 zetuBUgqP}5%E}4Y)H_02(vSbIA#2QR$ug^Aj4HjihDocYzo=O_cuPvP7l&by7jIJ& z?HLPjgIGV7Zx4j>ltX%AwFppzAwWZgbEnGAA#0KDZJ}5VMOXMV1%+{}h+`AfAh}|HaX36s0D< zv%djz?{@-Bn?ysAd>IW{`P5RKw7#gvmyK=meqDWArWioH$Ac6trA2Pe`%n|Jn z37ZY)KR?7{B?{VJWF4Lr;deXBa=lt6Q%;icll1~sJ8VYNh+N7x&sv@^l30B0Y$y}U zanPhiv;7{E(oo!0jh1r6CTwV-PL#?WKCJ-pZ@hS`4iEKI+vwlq9e)CPEmi~(GzTyj zszS^}-?}u(kUQ(J700dSB+$el-Z_z`es)~NFRk2;#>BeEX%-6@lMuEGkEth^wG~q% zZ}b#KY7-J(T6NB19a3Na>QwBuuYi(qx&DuE$h3s$Ze^RuXJ-(PA?y!fi5wkcX2b8Y z1wpx^ebGH6Am?Z(a~ng3_!DJO$Zq5KwlHfs>V_i0hYNnh&VmFX&;a`v{P!=SWC+p& zl1xI%eeTMw${4-%DTh|iq`Z$XN_D7Z`G-kTSAMF>V2Q0oLn-5IX+>K&*VC*9XOPK{ z$n?VAP(6GJ6iQtXRH16Df8|U3za9F^S(wsp041;;jD@Vs%%26F`BsrV4JcaJOz?0vQloTG{z4Q?lZMZv-bqK8uTpSZ4a0=Sil&#i-w=LcUix%?+8@g@y0I zM7;HfOKeREXDHvlgszh{7^=s>9#a(%yf1b^MY>5k$CM6XSY0dsp3#mncA>iN)yMX) z&WV>Ko|*MPhh<1y4ovNNc&jC;U8^v7s<@sVp2n-~F!R(b@SsN?7eNnL@nWFYGlp(y z9wcM&kSo>&qglkTClrvvp_AMGE-#f6@`{s?xR|lRv%}&&Qumwqrop-TE%Le-k)?p& zMcNk~`3$cSMS?9|%N&|egeQgy2Fa+maS())&O5-2{0TDs&v3=nu*E{u5}<-GLU55) z9n{vz*MdkWhx{vi6-?K-qRT^g0y-t13Nlp>!tlChAHF6v z<3GQn1Ym3knMTj%kPQw}6RbQ&Zo7P*+mzNFV}(1N$(4t!%+=}LtKpwl-FnZQ0YwUn zip}M(FO{?gPlVeJrpH-6IbAu6{JfL@wIfZ7?fNpg;|cYZEAy+~cPJw^G? zLL&hNJz+6DfRv5W3h zBqRnY=`axKW~4iZ0i}lKS$oibyvO_DeZIVY@!(*9nd{ou-fNxfj3!oS1%kklS`O?b znFq?;2qV4w2iakch!|r%!d3H1fDlvbe*1xRna~-hI{)XG&74+KX&V4#3K0E7dyRPt z&h`k^gn`qgcFi!luTW$&8rD1LjoT|}sQHe271Sz!ONl7R7%6-S`=11abXCAn#$l3`XGOSK*UTAo|EaP^ zq1E|wrECf|E~**+^At?lk_f=x4(PINe(D6 zPl1Xs1RNG`qjSw22{~>YH5N$X2lrje?kt_{YA%avn4_cHi|25(c=CT(C-lEMv1mn#ca1ybuveixdc$a zc{(Nr=*wX+lc9Yc#bI%AT!8nPjINF3 zzVY!%c|WD_?417orVc0J`bNPzL60L%g(4*eS#^~nDF!wHTukAi;dh(Ao}C_`erDyl zYZaj!HDFwyA}5+1Kh*rKq~j zwmJIj)7wZb{XL1ARVfG@wt=BwafC6~fkW;lY3(Oa^vQ0fkHRSTA)k@4|&DYmT zeH`&Kc#2WxJBa7>A3Nck-$D+-Czu#mZ@v`*Fv!nObK+H8I~D!qI~!A80KkR>J8+%s z9!YBEfo0+M1h)F_IBQ?}YAna>OZDLH+~baB*vZ052|vkJM&V%J)v~rhXxR>gT6r&> zJawubs3x3F_Ups;CK^>$FBFTSdnczY6Yem~Z|K_A(uecU4SN_n$fa;e# zkQu?tAX|H} z90bdYjr=V?iXFzzLy?Wme8hZe{$m%;(XZ;G4j1bfD_DII#hfd6yuFimt>I0 z3fZDwj#q)arcfmHC91xSjnDQGSs+rkp$}7vx+sl$R7kyfiORD#pv(c-h}+31zVZ9- zW3#tfB3_%+ygAoph|$ix=8`8NWk4viJTVgV49>OQEE^lhhNJt@)?-2YZKgXrR^O#d z(-B-FVsV0;@~S6MN-=2pO22HPXVH(h91zab#cHI>MjJA)soLo`)62`n+yNo1H*f`5 z^MIpTTC>QRo2k45XAa6WbMW5FfAr(oyi)O_-3~4~AOJSTp7nftoBPZO>KiREH{-aK zQf{41?G4!|*IlMRH$m~9Sx8*0olk*}^W%UWvPq@>(Pk5u!B_?H6Q7!~M?Z55wVyF} zQ49j6ZDx66&j59!qn~8^o!9KqlOI8sU4y9nx)Lc6*qrXboCZ5tNK6dJ;IkJm7OjYW z9O?G7KlW|ay_OOEF{;cS5}~e^a?1v`vfI44gBocjx{qeu?uA~w0&_T$^n9siKw}J( z$%)lOSkA|fYQXWUu_}BqV3*UK%E7^L;$_V(bHY>m>_Ml3c2I?@cfh=B^s>#I-dX~g z%~?U*_q!8<6eLpIqmhj0LUvN8b+DtDIxz^?_U-2oT-A2 zA0}n(K>9|O6Q=OcGA>j(&)lN9Wc=tuRFeNYu%f90v(R(k99_7T_*Q7*^r^a+{|J@w zy4f+ZXs_6FdiM$hW1hE7dbRs~S{y0#o>=7%yjM*xagT!H5{+=vJDC(^{rBeusSp5b z7z#FY@8pTk?*T{-408-%o`9V=8fd53_!9Ftfig3g<1NCt ztfA6-a~ud{+_{aw0bqw~E~q1k*#yRk0a~EZ!uAPh037yhRXuULRNj@TPRQ4qJh-n} zOhr^MFoM&o!q~6wK>l^v^sX>vm~Wjqvs?lZhnV1CBGPDK09hyP8Jd|^@d6DsdbCP2 zV42zv8MCZWi!i3uv@EIG-CkgQmaHSVyMe7TfzF;)D&K9v&>g^%6!6SqnfC=x5vb`y zN&?L`&$F>9!syq%8Gs+1T;s>?^lORGM=UnCGt4&t5k8ukYFJUXH0Q=68C?O2$Zm(@ z?E)McXX(+_1ow~65#7fF+?200itLq?HyXiBBDUR%2Ts`>XOxc_b>}s>*+h;LvkFqB zqoG_XY~+J1_(+(PH$WPoiAQ2-w@yP|1tf?e7nnNaSP99sLD(L-bh_R3yO}0aObzc| zP~_Kr+p+EGOm~YhP3{pQ5>-#ehPzk8-8!+?lS*3y*^v)~bHB||#u%_cZ@@7=5o3+{ z(9VZk2c}}e)kS{^z!_!pG@jbAW$nlOE|;6X+C*zfQh_6G6&8|+Q)r8VdVc?q1TzGACtLqpc!=R5)#FZ;Xy;E@O<+# z0TAECFAtUH8xZGZoZ`8J0owtIvM%F?k8iyGiq_jV`KLEb(qA*fO7kHaZ9}yU{%j@kimgD(EYM@~iGFne7=VR0>rTesli6v$n}C4AvDuIFCw z#u!|=p{Pi0RM*%T7B?qG!G2lmMb??kNdjpe3rmN$yW{Suki<~-^%MP$`T1TIhxf5{ znhDYfzje+0nJsr#?qEn{Jg0k4rTfuy_j7$o={ALb{kNfY+2qfMtz3Zq?;m;m^l9u8qC-;(_cJ4ZadcWC zoB=^X6vGG!W#yDt{9qX*PkOneqy&bFoPN~DkKdeG$}uSW^hGIt(TuV?GV5&Yqswn> zlb_6nvp{D>xUF^b(N_-aQ4y6dXT``z9%|k`;GaDU2hWM)R)RTfl!L|fd>fobzHgH3 z{_Ep!lZx-H@pv%l9xy4Qhy1|N1w=Pmhb?*nOngIt+WxWzdZaiw2X0+^O>1hm3ng}c zg8;}_jB@f- zmM?dgHqn|$r~k96QAj%Y?TkBm{#XkI+ELUJ>_49611{dbeS|TlfG18m&|p{C;_hF~ z&f(3#{Fn(lJ!yYxDlt;8_S%niHb$J$0gY><0<`ItvfBy5Iu;MDSd5dc*Ku$-D5ts7S z^dD}x)rQh>0m1~`Q|Du4;a{D@TC6C7(=Wz?b5p2L?(vY;3rgUfWIW~q`7u&sr_Z7# z)R_$DBrtm}v1tbZsQ$w{KHk zS{hk0`hxSkgoGg!#^(Sb{s0W_&sc{0`g;11IE{W)7H_EBA3 zPL6dg zEvIAgKSyE`aJB(tlp)}cf{jy%)b@b#01|+B=5gvX2%yDSUre3iXGx z(~`29<@wG}frKRNd&TBdiH{n&5PkobIV37Zs8bHC`eXeNVgvuA#1B(a3Z}gXvs1xT z*a%QhK>}Jhnyvd>zI5qQsz5I=Y|fIB9l5adFCrPi^A>B0W-)N+Av#0oTPJXqdiixE zePx$YGk;qx)oZ7ZkucGqVri;ia^``KQWae$MZd)m9U_mB3|}PHPu@o#8xE)oNz%sNwINZ1@_Io`@rJ73jmx%1|w^N(U5+n=W0s z{|--G#cMs^yLMVeIjADpds<0muPS(8l#D)o^>)_?JU{aR$JtM(19tJJ+i-!=J^HwP^)LOEA$^d~7JDI&W! zo?{8ibl<4b3$(7D409?lVNHaoZ7k;+>X~`E&1d7rzJg0oqc%l^uNsd&H*Y zQ#R>;Gk_OhsUHyf`wkvbZnh(q?0kdvs`a_tV5(2H+^t-(_shDL5p%BQS`{5UkFtN) zoD7IU%8T!WUfwP5XBE2IESY<-uaK-DN9{d(q*?e{@gW4L_$A5xc_*|nWv*3OiYjhK zm6jIrdDqJ4+^A`+_)TYk$`_$!fk|5c*x`_w57Q6ugMST~P}lkR_}+sQ$q{6BTBVKP zkTn6rB7ueiYpe>&6Mz2fS^5f*Qb*F7a5;y2aCYz*(q2{c3Ecgv;ZJ4(T8rl&`;>YF zDA5j*wC{i;A3y&DL~Um_#tN&3gzjn^Avf@xi$S5Gq35&>T*8s4nFSO0@?|J8ae=c+ zlat8HAQ|TKo^b`GoBa+|p^nMoFqKW*;oIo;C_gd-+}0Sx0Tu8!Xmy#{#KjFD48m?_ z9{Qwj-@g55Pf_GFXg(SAcS?^;;)cMX4CrFI;JU^sx%Dd`&SUn2pdk^)Cn?0=fxQXG zNcdhn7uFqejQaa`b~%3AFAUw1o`bh9gu|;^TS-N3-n_YpMn6D(VYzhaCV17RD3FRE zg2NT&WdA6rvSV;BU%W7Z1lmR5BQ_Yg4Vcy!beRxYawK6LGhvaZ>>|!i<>G^XUQptZ zC^<Hf!fD_(Y7bgR8W_A9sIxx#C>9ud!Eukp^w#3_i1rb-$gCOXR=RwK)DbF zRGc7~xt*XkI~^-{=LsxK5-*-RK03A#Dj4TB(_S-%$KVVIORjsL_s{ldE%c~~xIO+W z;B8be^xCW!bu|De06Sg-Y!RfF(8RA(xN0tV>@_eeoCb>>?gbW=VN?|rGu!wkQ14rd zE3)Z13k>wk_Io6i5z*1?qt6H{R!L`u`6&-w@Y+d!>rD>#ea++KvGLXSW)1QUZY8{d z_>Nn;HP@~uq1pPt+2gLUvX69?iBHA~+nxO);cb<|7_%^!5@Jis{IR0^{>$;xj8{}% zy>$FhTxom0^)@=7WFNu)Y$bOGDmf=2v@54E&v*W~4~ z7SW4Y#9EKRjPl**A6J-(0Mw~pZjFz~_8(2$P3Nct`j5|`>-7jb@$pKr_2tzQ^B)zM zTb1aj%N>3ykx`|z!{6AFsUDXpvL70ZvxgM*F+7<2UYtUNi#9&^Eqy;^)O>mD)!~JExzNxBzIh|G zZ3hK3Di)UCNHD2O=*+w5n@>FRc&@^zbUf4+8LpF%EdM|-K1ouP zh&7>M!+QqKaZ3CJA?xjyfLHf_zIRu;AdV8^9@5jGiV2=9cA)DS8kK{`J{bd6$)m{b z)3@f9!rydl45p!i`o+WAyl!Oe4} zun;ch8OXgt5KVvf&|vW_j-d5 zdG}>rY%U6t_T6xfs%TE&xcUi)LnUH_g z*;O`)mq#o}t%}tObJ>XS{ES zP{ONvIXhe6`Tfp~C3Gt5I9p^(^1v$|{=M9On&Zy({~)BX$eNaYYQ^d%u4Qj+{%shT z?=-D@C))gsoUioiXnkW`_^5N%iFmoC4E{7Lhpy9z99--jwViJW2()Ic&=tgVO))=% zbK0-;Pls|WXmG=_4ESxaRbOpRMT@0-XG=)zT_1A23bB8P?|a3p)fFQ?>H< zS|xc^osrYROUzb!jRn0K{n*t!vbU5vh5y_WzhH3u17kTCqxn7wt&LBCnc=mp=#7&Y zCG7#I%y-HOOH`o95%dL}mE+gpH-(GEuv$*YtD;4@M)GIf`hA?b{>dxPxM*`xj;%1{ zl=2trt>V4sSMg87xbJQ~A(jO-X?CYhazw`WmVOVsL43!Rf38yNF!zAt^$1(>xk@p2 zHBX8nJ?rJDylt0LIPe8aiOQil;1ZzAQADak|ROif2 z`oW&>qZ-kmYO6lu9ShhL1#w#+PTSk|q{NY@2(Yg-R~LqiMmON})LOp;tT=?T2A|~A zifV|z;UnN z8;kmUcci**0Ll0HOPAWhG+(}cEr<>L_tI6}0*ku}x!XXv4nh10nPVqs2i{s2CvQy< z57?x)%zF>k?DGLTH*$w^hXEJt4QJ;9Bn~?{xB$rQ#VMks$3Y+2iCXp-=h_Ta4lMUt z9#XN@Ui3}R01dr+xr9(i0$O|)m;YRA(qBNRXef7I8m~ER6b6i2jR!+0EivvWtw4IC zE!9(0o7wN!UGR^4sba_CYJI&hA{RLEvIN;c>A3I5-{|UJf!~*8_lI(`r4Pg08GC+@ zWecPWPd(tL%pm2%}&X@WCS{^Q;1z56}VU=masin)7mX^1$Ut~>|DViqo!#6X^ z8>8dL&YwN6>X^6Kj}<&z^fD#sdV9O$tcCK;KIlDr()YdEru+G`%K!B?-P+IE%HuGo z{q3XjJB0!&Ao#espQBz&I&!xGwMTb4S=d z*wKp8$h)F>m~L*U`uh&04g6Otv3m3mEUjw!y%F(CRAXTdR$1R52zuqPdmZXtUS83C zD;}CUISjtkW<~Y)d_|<~B$qC)uSFUxj(y)o`^@pTR3H)#o_U@u9XmRDRwm`+9y0bvYc`uNz!q5eD z%CzsG4siS$^o9?kTK=9mT<;%4sh)7$9s2{QNKSCP{&e>%nbRUX0X=b!j*k6UN=C8U z5V=OaKAjvm4ul#`hg~S_We|O~J_BT3Qu|L5PnZLT_jdc?v}TD-8=d0&Z)^Jy7uOwJ zKTSH*Z#n|(7@2P515VuVro_$iTvAoyt?KjHo7&s@;GEIF|M?&#ra)H{y!xPeV*V2y zyD|+@7AJEoFxqP4P{Nf-TQPFg&C<#|fBt+_C>zmm=*Ep3ED@T>T@@^xrH}C;$B>Vy+owM;=7VE4CTB}FfeeV z=@NSU;yQtdH4fp@;eg;PCY>Q3xl*!waL#Nn*-bF)0&g9&F%2LkE`u?-$#~dQgq~e6 zon7(gMYUhmPTd+*ug?`ae9_4{3JxOMyKsve*toA__*KYO(s@e9d6coX`fTJ=u} zjK27#{^ysVFaCe~kvL-*0<#DTcDVt6|IfdqfA@==Q{e2zD3dc052-qNFUcn}d`Y_nX!S+u{s~NOTrV#69GW}n#O{ADb_69HdA>?b+ zS#$!hp>Pm5{eZL06u98+pKSGzSC81QYSKzW<-b36?EOPgqLY~-h+vlC#6om}=PzFH zVH3fy0c3T~O9bF9oaf|hsI?}_%h69hys1X+2>GYh&1_0hYLi0TncXmbMmHQr6l-_z ze}B8w$A4y}nnBUrwfoCNOL+ST9C>sf{(EmX)HF0qnz~}>*wR|1#77G(S8rNN;FG)X=;eL&y5qbI=^N>CUgSx9 zUOS|}u9=v;XP3h(!lCKJ^y}=!+(0xT{P^FKGR0OhM}g`Spdaf>z!u622H4b5%5wP7fKtk*p;Kjt3v@p2! zp8^^`cJt#3hY^8&31*ti@>v3 z@7k+>iFX-1ZMw$BPM@Zw<)EOTXwNZ{v;8!!0| zf%RK^iIaICK~Y&b93}3-53#|n=dm)&a_{@A;AhXCIWqOdnyOs^U&f||B2?|s54p{D z-T;3aTOX{)Ej2Y}q;-dyCwkLux>b4y+}*-FeeENq@vk(AmaavcAOmS6eDH~!wRd57 z%H9HbhDJ+<*fF~8c(Cfaj#Q(MTPB+L(qq7s3F+v!K*K+|?F19e1{94t!UxLJN$+jY z-IokGrPSiR3Xjykg)_*-9E<~+!6r~7IXPL-Vpal$4B%?F;PS^o)z9<$fd{e>SOTW3 z>HIDfG@j*E2~eUg=vVo87bf_&CP~jvz^C3ijLlzj;?^(z_zfQ@w)kubXma-_CnqB| z*Ai4<9XRnoD!MN22ubBft1gbfM9WhzYfyB^6$0$w6SW&avx!ej@W|jlfBt>rmVApZ$`Hq+VF1mdtf^b+fqxdJDl@&^-Ct>;66;SZIt3X|<0*?ZTO#11r+n=So*MUpfPd z4#)@Ut?8!KY&1aDZjJe{p;rL?kw8)uJ>4Nc^jK7crU_c-A|f7@!)|E z=Qgwe0~=sKRPAn79cJ1^Rt(T)mY7dX?@EB)HlMOZ6vxG1CeFiyK{t3sPLcrJLo>5D zxog+zqswNt9M?ofuO{4fv2t%{PE*O;V}xY+Q!>Y z+GiUl4Vjj?EeO?~+K3nS*?JJVa!2Z%#vWsw;A zcLZ#UNmFqYu)IXfu(fT3(MJ^2?_qJU_(*!>AF;AS26Rh&AU1earVqX zdq3u}u`UeyyijprxB33Vk!=gc3|CNmccTQB5XYEibuG?E5+~7)ePp)MN#IMDJt)mc z0xqQw4>p5sR=fB=O8GaeLV}&3v51)f2RNJ(2>pzzT=BYuxioaqzwsq{uSPoo0nn7u z8r~ryt>rg@UuhyoPJp%Ry0Y+qNwdqUo@Gx@PcwAOQ96R6SE|*osh9@tq6WG|c{dO> z4t?+(;yH5oNji(r;_%X%naXNbK&MX|? zrfTimS#R-;C^pRJ`SRsUqb)4n?B9Ip1|E$c`gDAErwKmpG$NR>9;5)%+2Gj_orbwx z34Y`$69!&Z0`BFaV`F0j;g_N3Q|QOgw4>SuY)E$xMR5(<k449NkU}6z4R({p-rT^mpI!vQWl5=)jS zE0$<>A?gm_#$6*#j8p@-l*Pdj%sTO@01<8a&B1AJg3J*$ocuqvOJ!B${OMhQ3KY|a z7X98mG*9&I_R_MX*{2GpC~Q5jimkWwX~!KHo@qX&xpyUs~HVDwX z&;R!A@YmSxC+x{z*SC1LE7WwD5onO3aRUj`qU`umv=zOf)=)6xX$SbtO63s_ zEgvigiO&>@SAzQ=<2(k(RY@a0=1o?C|7}f+&`Y-G)4}~q55Lmp=m3FcDK|>Ex8rob zOLf?DT47d^`U^ctF$r4XnEX_IPVSTBBs=w*JJJnrXUw%7bO#;5hyWUC15Qc_gA`eS z%d}E9t=W%2rbf#3a$CL+DT2%Hh2^>q;K+NCrL{mHCPI8sw!wXNY8N6CZ)Z>G1Nta3 zwZwGDu=j$FW%NLMfl><2gL`b>Zp!Px!nlwKtqwlr6v6_u=Sma_?SMPX@oi#ZmnoYs z#qp>+g0-?y_AejZcQ<@}EhscqYZEcvDOJ?^Rq-&gE0j@;WfxDy;*C05EV#2fGqriu z?QZz;cAL<2#zl;@56vP%0y{xJZYKikaGKj8E#*>XUJl3RD@-$Ay531VwRplDtntFZ zw8D}j9M=Nr!LgC?5N2?Hf<^qz>>FO-r?n(g>f90wheMm!nW?F%2BZ;$@>bX-6UBaY zu+`G(b}Rx+aiNV(+Si5`s2<3%2*G|26gPJ)ytPsU-GP#!Y-{bkh0x5&r{pASnd&Mc za>)JA9r_C8kJm_F z$a$WfzVv(*1O0GD+s=gGh@R-7E#y*%aGVWI&2NP{1=ts9JANK>>D$x=RY^OB?L(*F zq3?Ywt`x@TX6<`+dpo0QeOWxS%Be6dTV<8US3=5S*^MA*ED}>?W6fG2AxD{+Ex-Wb4=Al_KQf7z9ZGk zD3_LuZ%d^tT#=6$ELz?!pqPehyil2y&ui%QTdpIlT@T3eaYyJcw|afX-NOZnGJNYe zYRm8~lR}*Ng0gS6bqsz7P@8dlz1dj(E`_!S)k(SMU^ zuB2G52JPf{BtfHKc}F`O+u1KT{J!exNTRdfFC--bOe1FDP0YNJA$4VP_(@E~s_s&} zFT8CHkKOv!aBC*q0tr?ET_>uhN4H|cvDtdUJz$U){rtUXTl-0|hQ>zcA+0XLN8yH~ zRf}^Qot+vbkS5k7t9v@$D>XC&u!LVU1HWc|$5f_eF8zXZoKbc*Z~ zc6~s~t^*NMyqZFVmB#X)in7CT)q?ekZ*O{XldJSG-FxG8`X!#Xk-< z;{cPD)ZnJppbBc7!ZfFELNg#95ys9-Cm+cv@v@yxluo@NZpQ6d^S7=LThZVo)@TU~ z(~53PlU!AiGg*?4JtdPwzm0Gc>%n7Q`uvOH+uhtg-f~ruBUe27FCjl4T@BxcNFIvW zCbV$-C^&TmubOLUPYBDIZq|1YFDVZLf9u$96wsxV(WbMy(Ps}$>tvKcL$9UI$|#L` zscM#%b;@Qv>b3+p9bw>L<{15^Y}(-^=Q;WO9G=QG<7kK+?!jWVzrjk?-VmRd`j}We`)?SSQzzX(@h-vKn>ElTV|C3-nt-+i7EF zg8Lj5A>|2pgm`MDcC8>*e{6nJeXI7#>O>pOkf^n+y8pgvCQGfiWXcc@;vYL2py^TV ziCQw-q5-p670-?|CCRed*K};q6`Q%{lR0rD^C#<*-xF+#;bLsWwv2(ssCR$~5320! zwtH63!$woO^b5*$q10)HZOr->?T}h0=ks z)0IH+(ej?Ea#k;ys!)&-_{Kgz8S`B4WH>%^w5Vhr2Q4Fm?k5#Cbt{&m_{dx3Hl?d_ z?Kbx*XDzhethTlNK1}&-y7{(O?^NP#PINd9Xo5n4!9 z7;(0(=XEb3r4)hFR8dgl+_UN^t7PI>f>J4FkwO=zZ{36?qhy`&AClZ%S49J|R}5D^ zHT%3uy#Iy5jJ3#4c$*4XF8VIrg{lE;v=`jMcOUPz){)0VXAB*UF_>Y8paQfM={)E^ zkUERDN&;p31e1q3%JOjS9`1{2P$5 z7UdNG?|l%0@fG13ciV~QxD#fOHD)HWiuXk#AT|9gcUBhb!#SHKw6b-hhqzvlpT3XMS zU`vhojU{-^wCF(xJ&<9MXi=g>*=$wPIC}5pN+F!)%;dj1dfQ?qHy~y%vd*imKx+kP zOck<1FLrLD?x|@=x1nHdMbz^{Ij(1bZF>0J?)S?1zMKb5 zt_f%Ng!%Cdtc+Y0Q*V*I{eJFV`TVn@p4x$&&ckYo!q$cRPU8=z1xUwiLtToz0z2d8 zu~6I9jMWL&$!?O&PCzDXzAS4_`_PdZwtNd03h#<^FyxDTz=N=c8CNW!8F27^9bq2b z*I&aK@U&Unl}rMj`jTk|0=JXIZ-=Rna3oaVVKs_yzfLQVHJ+ikg+^1*2)=E+9c=a; z=hHfzW!8U^P)&OD2g(e7Z-_sr3-_l;e?f%%V5Lc2$O-QoE8=Oj@uI7@y~?vIBcyAt z#$o1XNM;|A-6{z4dr78J@buNHTq`MU7o3CYli%gYXP5s`QP*FoRhn^@%a+b!^6FKW z?uhQ_=xFjw5=!ZyvD-K}qwu8fb{U6>cJCd-=(%-G1;(q`vJI(Nr3pE9cSD$xnd z_*d+~M;fV4nwy&Id0je=8*j74>78{>_|eer{{QaJ^ zerD{j;Xc2rwmVxOA8wk8q|&zx-Yt+?^GXM96Wm|84;8O^1=D}1Ibg)$$~ z0Fynl{oT5$^1frU)yKUQ*^EjQmZq6)+(VBp|CG;Hdg<$SgjV1OeZIx>Q{oYAWAylu zBBnL z4A6rX>arZASCsumXWDNQ%n2GDN_M_82-!rHIVUtAEw#cCoW1UVc4>< z1##`V6aYYD+N9EVQn7>}t;4O`nc^>;V{toOV<7;>F2!B}C`dLUh0HPBr+d~MV>W5c z#FA2leW}W`>Pn*#zbXI=K5<2W~%^BBvODS0BFd74UJo913^RqyxyJO{c)|H3h_fLqq+(An#1oALmhuy6$F9IIE!{N{e z#0ZXU3HF6FgKO8G@PojrztXHJhSoO?s>^%@0t)pk@r99+g1#h-xdVrsG}oJzl$5d- z2}k{^S72f*DkCGK=p`Xw)%imNhFC^9v^&c`?*(ekcs6vHZ$Q>|Jn%1g9V9cmX3O!P z`r-~AJjhs-3ss~YKn8NPFE{9>KwinSq5PmaUt?04U(FW(~*3Vl)%io}IazaRWK44XhlCcP~(FbI|b|S%J zmfaje51wzz%gbMZE4|{FNJNQ%-|qDoKo8Fk1u(mv0#K^Hd($QwK}ig(imL@HC`n!0(j1WI9R433a-Xw#k2b;K+a^xcP| zMgJ)PFEO*S88@jJJQ?!?Nh3jZJx|tId%dO~twS$=9mR|V)&u*rK0aDE&I~)f79@}nKrj#s#P zg{|420X}3FW`&GZ+NN`#(S7pBO6s~La7AA7%1VW1xn%`g40~Gim5rFz7M*RX?)J38 ziX$9pntoy{&p3U!G!2>5#dq2XaS?1T6;sPgg=gXLtpDE=ChPwi_x@iDrHE4}G| zKF9jM_z|@hWJrc=XCau$5Mbny(|x-z(G$X{YiM*Pb&o)4BiI0d>Wz!Hp}qt9xYok~ z7=|?YAXkbUZI(N0U(KatJex$~RgmNySsZS6?bJqmbf7PY-+;MIIH$IjN0myv z=#7`BxX-ul5EOYzWWgMKta2Wj%n)Eut9oSvUYrLc8t{dR`1tW7Sw0n@uY#nl0Puta z1u^^2A=?MwKC2G;Y}(SmV|E}P@PwOWRP+}R>WgNJm4@+t!$%YMQT`SbhOrIW%4`P9 zbx6=6PLPj}z*X9rpP^0)vuBQ+@VMa0mTG8cM5nyNW0@nAm0K9@>1LfTrg`!(f zIxao^!pvYr8Jfz&R^(NoOQ{RPho+=_P>vC%b^xtKEHXs-b}g$=Nz6=2l0wPp)WfI) ztQqQ@`jl=<={_*xi3|^j;X-R;fekQgo5giW`~6)aUS}a1Q3d7@j`le>gqnfDgmfBa z!+PXch|mLB^r@F}fWZp$Z!!oH;5^*4;Wvb0G7qLb(A@+hN5dJX3PAGmfVC3MXZiy8 z=D&qkO1Q1`WDMQb1|h-7hR+32zED>2d)SyN4OtE_{~3-}vk3&f-6nhZcs2ef7+IfZ zWj*mtx)8{_-e%xVgET1PZWRkDzkB4*#C_ zIXO9*!jOJ)0mTG{Sb5yK;x^B9oXc@#pv|uyEPK#wD78T6?%lT~S^SGIxz;t)s*JGe z17AIw>ykiWQxdxAVzK)OHmqV&QH)Fbt|`pHx(pM+v!)(~2TI9!0Ew^b>+3&m$q7Ue zRr!M;?+=GjpaOOs8JA223~FQFvg$A+s~uQI(IJioa6&k)a}3Nwuz|2Q8-&v9n+|`o1g=C1SdS{if!Slhlu+O_G0xP4$WHiJ%fghW# zl;rdfk4zJ7xfyS(9=co8VLbw#CaevYKq13rM3=a)%e%<{z}-b`)sE)igE30*Tc%SX zE_FYT0`Ol>qq+eu@o-G?Ubt|dicYAJYYC3N@RDtSt^|uuw73MqUd^4vG8f#WgEv3~ z;aGWYkZ}MhQOX<~gEn2aH^J)tzTMA{ZyT3pts-)A}&!hH#kASgPmQ8H?-Ym zdb6b^5tf7HB}-7S+}FaAGkFce*x38|6lfb92f+-xIW8`akKmU56)NU9@WC~FzMGG{ z9iS_Z(3u25zhDs?8(U;ac4=Qj;j79gFL;yFz+teq1U!D75>W!{Chb3zlq*)7+T*}o zbgPmObFeJ}7mmxkFvCx)F?NtNg6BIPrVjiBPZ-rHmVbglLR<@?iT1ta=)+|68Ka>t z@=Hg@et#OYC@7Go?8|NiAUiCKOE5%q;ko^>S|5BsUn=%jiMFU?afXa=;CN=dYpI3F zYPr^6qNckzc3h;qM`&<|7lkuGRg+qubI@LrG-ETyX$FlYyy2rW+LK%TA-|KPYh(Ns z7#cgO8m^pVnwA8jRz8fi&8qDomjv*+JGx9bAWq#kGc$|9q40BapvMgaJQsa7BUs_;ptW<*`Q`;bP-neuRH zw>j`{;BccfE+$iq6|fvd#uM@2t?dAcqF5X-MC0HQbCH~aOv%d!Dx7=JZy6$30xqzEp+a&kL$>Xe86Q-E}9 zDt4E5j~qSfMqUX=gnEjU3Ot!GP|Q(EYCid~W2Mbhzpwh_bsb;>^#}(C2TyK5C*4$` zitbR(Cto>`&{;>YZ&yVQ+HKHwVbct|v4Lb(`qCW$1(y^(#wh;wev6yMf6A=?q$awC z_prrnYGU8QH|Jd*Kng+qmXWI1??;=iSdX#@2RxxYV7ALWp;VtxdU#x8YFnoZ>!h6U zHP&{lX-RDH$GQ31S3r7gp=M$-8eMv~Z2dX5g~Z;_i3f~^1d8B1sr`T6zxsNWnDCqZ zaMU%D7y&V%(H7B;X@;@U9dyEWTnr z{u~G6!kIbXis>NJ=&Z%vcyKw7Xp?T3#i&Akyk6x}y$=1l+vL<#nSICRAh=zalKC=0 z_<+*@l-&lSJF`g2#Q$@eR=>-y2a$s+4f#U_hBe}c1DXrm4ju=eS#S&V?gP`X*;mh= zT`WR&6O34Cay3{|dd3Vq<-e{v>D9hrP(0u#cF?iB$8dvQR4NN={atgWx)t$^&3vu> zWET=cLT;JSX}E1_e_IiweemmB;lOfXp>fS&!V21m_mOHJn?r*wPXmEN?mz-A*&T|p zDXahVI0gvNPQVLb!E|h=lWvRt#B3HWTVD@I*oZ0}tO-bk0chTp>slUa6{Rier*Vdn z{&5+Vk`?aao=Y^tO`kr@F9BcDyvi_VU;OC8F4Qpt4Enq~y1yn}=J3|d6HL2nPdyp@ zdtq8Z+$e{sdwIuU`Ew9fTU%RCM55s|G5{eaQbLjgB<=N@kH9tM?I3@jfqZRY#h1@? zsKu-XuL14B%!9*X;pzCeNeB5=-avYh_GPYh0Ln~24rVCs=F*K!tN3;o4xZL$hEx$E z8D*t4lokwGAmUXHTA2yM?_Jtpt}bDmA5Oo&eKT?j2CxDZPxK3fzk$w@^Pf{(K~O(y z%>!j~K5pEi>3kLxU;P__GT^_&=Mij|b2o&(D z$mKBDf5IZp(bJ<$LOJ;e{!@}<9GL1F!LJfzcTcB?+jAiE|Ld>?4n!6XwS(_aqeQFE zd4w8n3gKnmMH+dpXy!{=<>50%p)cg0f7=Hx*r+6!0-#9!4rU+^1q%H|A60Dw%9FC=bi~Zq>XX)q0!NnF+JAjR#3_U7_6U1 zy)Giuk{xB_0^pC2bbDlEWJ2P*-#*fMeJrq~oDw1;v{H7#xp(K{6wEr`)b`1PdBuJa z@H$_5u!&lqOTUnp!8%lUO^zptj|Hd=gs_%DAD5Gggv$qZ5-ik|fGec=pbAW`B1=@r za~sN($@^ATQc3ZGJ+7L$Pyv^K>+Co@pMnkH1RqDrwK7Ax1jBzYIC07hZNmTS1svND zV`uE=Rw3n0Ar%=ce^cSzR8l;M75z+-Zu^JhDizQL<_omki9tbX^R`FDe))+3iHS(> z;%8<&e*7+3rAzlZfQk(a#aS@u{Cv%&-=S7h^!8kg!(jT&b2^1q;pH$%G3#DO!>;|e zM1MYjyj~)+hip+1gvA_A@tnou9&;IFjL11`q|pVtt-xt7f?b*5)(*u_(0X-c`SlLN zLOT!BZWC=V|B?kKh=z(pvasHJWr_@IDUfx7z~u@wATeko0d9jO0lx0eFYf{EivT@nH%(i145c`Xd3>5u7i8R z=(4!37~Roy<^Q@4zoC4NwV`jaYK?=~xCw({O9MJZ4cIU=3j!Zgl3er@?0SLR4o6XcCc8H;iJeC(Cd? zDKn++^~^nB&YrUGvVBn`XZo$KMF&my_^$3%tp79|hjri{kIaQe19J*re5!$-%Z_aG z=@A;^ymJaipAmpNePqp3_b66^x2a=gP)yYz%hOa~^BnL`#-Q4<4ecFn!j+WH8uvXI z-H7{H?2ugBCvLFNg!>tb)pyv~(O3zNemp!T;`T3bcdKqeXGb{E)D6ne&NDJ>4c4OjulkN)B)PSiBGw;u`o*dPI$mM zl-=mPx7mxx&J6qs2h7SqrMG7^o&eV4;l)OlF%`E&`R~?+uppy+{zE>%D(c!;<)~D0 z4;YH^SL?#+*xLExo!$xjlZA25$8+?Z0u03IXhtOC9JW$EVZUx~hrDH7R(nfI-m zDY$>7w+R^sbe4T@S9-ZW#|b*g1#}gDj>S5;bk%(NEt~J7pYyog{|xXx2Gt6Gi>^)z zYRBQWXFRI*7e0UWcWW0tSMiQfL^KmUmu@Z2-ADeV+>eC)?Rln(P8+a$v+nK?s!T_} zJ!jcq24CgDIGl@Uda7xgKv^n`f7?MRq<~dcBy|B8$7I{$XaXmu_)FM6@Egjsq%!Jh zoa=Q3!E%&eIBqu@N+-(`7#1(*i<+^oe338F(FWjVH}RF)3aq6x%e^ojR)`X@F=FCMN|5Q0U&&$GLRtK)a9=h4+Hor>N>dz&Vxtip#S?XBQ_| z^bK5cZN(6;6B>|?Fpf^_!`1ONLYN&t<>(xk0V|n>3+LQJ_0mSqGL$k=3lvQ!4qC-i z6PIlgBQPG-)VVpt0gbHduY&gnTB`d_1HeSoAI&{{_;4I3vG|I_fi66cyba>Ogp+3} z3QRKJm2AT$yA;XfG5yvNOYA0kZ9ee@9zT70$_w_brXe^59m01P09DIZg2ukSUn_j2 z?#GY&@cuu2v2_Kz z%GwsxqKKE3*T{!)X~o|y)NSAr2I8POxW_&>Re^%SNe@UxuRld9C@MN7KvOa?=nHHe zmU&70K{05Qu0P*ImT86CobNWzgG(V~wdpPO^4OQT_quJwVEY(7=Pm^XX7`mqxSHUg z>q*;xypJA*ZfEoZ zS732-^7kn4oHlW=8|M7p%rDKEnw5B3)b~Ah*A$Y78H;p)ni+?f4u}py`r5RCi*6ZfAVF%ZuTO$^3)-Z zqUJae6h;<1M;9M04#Y6ScYYPz*)zdStv%bL_ zpN&Rlv3XZY%dM|@Xim>L8+`vi3$CBOYE6F{=L?>qvoaU%iQGzd-QKOYdh=yqb2R&0 z?7WIcoS@U%W=>qUHw$zOWZL4_RRI-v$Si4Se#`ESh{}w zyKh0j%W#Z}pZRRw7q!pdc$0~>_xp0--oP1u|)J&C9GX5LquyLEm4`>ZcmGsEUgW4-)FRCn$2_lalUT$<-R>mqP+{l!~Q?HBH{eetwwmw9B) zKDzMy!u8*vww7G{|MkEdq^|t<8+jL4RL(zq8`xa|F2iQu|Nr0aN?p(y3wy-A*a3Ig zO#@DcT)VUUOL~|2df-UIvl!r@mu>O8SM97bY1;d2WC;LhB?4X%HEX< zb!-ut!uJk%tnSlg@7V=>V&1>M#25`+IHP*k$M-#J$3 zLia5*EO5Md@HXfcJKzYH&wZ}BhVmyIWv*^acAq@;+x-83+(A2*CR;MFbYEQ^K6{PH z+wf(QhO;7xBC^b=S=*M9oL!3Q_`VCr%a{mvz-H@3{I zTyS|(U6jyk{raEXp#3lV;$#=x%h+kGYabpE5b$gpu(k%RoO^Oa*niD;+eJs$eX*64 zm)8dt97%ia?VH$P+lNdvK-cephVdEifG*(yt|@=}I+Q8k_?F}6fen)Us=FBh#=x_q zL1$p?1Qvs*zf>|Y@xpWi3o-lDk6+>YAQ%o96TKS&TmS+Il!4zz^Z&`;UFXOXr0~-X Oq`=eF&t;ucLK6T +configfile: pyproject.toml +testpaths: student-tests +plugins: anyio-4.15.1 +collected 65 items + +student-tests/test_api.py .................................... [ 55%] +student-tests/test_attachments.py ................. [ 81%] +student-tests/test_cluster.py ............ [100%] + +======================= 65 passed, 2 warnings in 15.34s ======================== diff --git a/evidence/topology.json b/evidence/topology.json new file mode 100644 index 00000000..f0904bae --- /dev/null +++ b/evidence/topology.json @@ -0,0 +1,90 @@ +{ + "project": "mtusi-lab4", + "services": { + "api": { + "image": "mtusi-messenger:lab4", + "cpus": 1, + "mem_limit": "536870912", + "memswap_limit": "536870912", + "user": "10001:10001", + "read_only": true, + "secrets": [ + "database_url", + "cache_url", + "s3_api_access_key_id", + "s3_api_secret_access_key" + ] + }, + "bucket-init": { + "image": "mtusi-lab4-mc:2025-08-13", + "cpus": 0.5, + "mem_limit": "134217728", + "read_only": true, + "secrets": [ + "s3_root_user", + "s3_root_password", + "s3_api_access_key_id", + "s3_api_secret_access_key", + "s3_reconciler_access_key_id", + "s3_reconciler_secret_access_key", + "s3_test_access_key_id", + "s3_test_secret_access_key" + ] + }, + "lb": { + "image": "haproxy:3.2.1-alpine", + "cpus": 0.5, + "mem_limit": "134217728", + "memswap_limit": "134217728", + "ports": [ + { + "mode": "ingress", + "host_ip": "127.0.0.1", + "target": 8080, + "published": "8084", + "protocol": "tcp" + } + ], + "read_only": true, + "secrets": [] + }, + "migrate": { + "image": "mtusi-messenger:lab4", + "cpus": 1, + "mem_limit": "536870912", + "memswap_limit": "536870912", + "user": "10001:10001", + "read_only": true, + "secrets": [ + "database_url" + ] + }, + "postgres": { + "image": "postgres:18.3", + "cpus": 1, + "mem_limit": "805306368", + "memswap_limit": "805306368", + "secrets": [ + "postgres_password" + ] + }, + "s3": { + "image": "mtusi-lab4-s3:2025-10-15", + "cpus": 1, + "mem_limit": "805306368", + "memswap_limit": "805306368", + "read_only": true, + "secrets": [ + "s3_root_user", + "s3_root_password" + ] + }, + "valkey": { + "image": "valkey/valkey:8.1.3-alpine", + "cpus": 0.5, + "mem_limit": "134217728", + "memswap_limit": "134217728", + "secrets": [] + } + } +} diff --git a/evidence/versions.txt b/evidence/versions.txt new file mode 100644 index 00000000..53965c04 --- /dev/null +++ b/evidence/versions.txt @@ -0,0 +1,8 @@ +Python 3.14.7 +uv 0.12.13 (Homebrew 2026-09-10 aarch64-apple-darwin) +Docker client 29.8.1; server 29.8.1 +5.5.1 +minio version DEVELOPMENT.GOGET (commit-id=DEVELOPMENT.GOGET) +Runtime: go1.26.7 linux/arm64 +License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html +Copyright: 2015-0000 MinIO, Inc. diff --git a/infra/api-policy.json b/infra/api-policy.json new file mode 100644 index 00000000..40c30de6 --- /dev/null +++ b/infra/api-policy.json @@ -0,0 +1 @@ +{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetBucketLocation","s3:ListBucket"],"Resource":["arn:aws:s3:::BUCKET"]},{"Effect":"Allow","Action":["s3:GetObject","s3:PutObject"],"Resource":["arn:aws:s3:::BUCKET/originals/*"]}]} diff --git a/infra/bootstrap-s3.sh b/infra/bootstrap-s3.sh new file mode 100644 index 00000000..e292e5a9 --- /dev/null +++ b/infra/bootstrap-s3.sh @@ -0,0 +1,29 @@ +#!/bin/sh +set -eu +# Never print mc arguments/errors: they can include access key identifiers. +exec 3>&1 +exec > /tmp/bootstrap.log 2>&1 +trap 'printf "%s\n" "S3 bootstrap failed; credentials suppressed" >&3' EXIT +bucket="$S3_BUCKET" +case "$bucket" in ''|*[!a-z0-9.-]*) exit 2;; esac +mc --config-dir /tmp/mc alias set local http://s3:9000 "$(cat /run/secrets/s3_root_user)" "$(cat /run/secrets/s3_root_password)" +mc --config-dir /tmp/mc mb --ignore-existing "local/$bucket" +mc --config-dir /tmp/mc anonymous set none "local/$bucket" +for role in api reconciler test; do + target_bucket="$bucket" + policy_source=/policies/api-policy.json + if [ "$role" = reconciler ]; then policy_source=/policies/reconciler-policy.json; fi + if [ "$role" = test ]; then + if [ "${CREATE_TEST_BUCKET:-0}" != 1 ]; then continue; fi + target_bucket="$bucket-tests" + mc --config-dir /tmp/mc mb --ignore-existing "local/$target_bucket" + mc --config-dir /tmp/mc anonymous set none "local/$target_bucket" + fi + sed "s/BUCKET/$target_bucket/g" "$policy_source" > "/tmp/$role-policy.json" + mc --config-dir /tmp/mc admin policy create local "messenger-$role" "/tmp/$role-policy.json" + key="$(cat /run/secrets/s3_${role}_access_key_id)" + mc --config-dir /tmp/mc admin user add local "$key" "$(cat /run/secrets/s3_${role}_secret_access_key)" + mc --config-dir /tmp/mc admin policy attach local "messenger-$role" --user "$key" +done +trap - EXIT +printf '%s\n' 'PASS: private bucket and scoped identities ready' >&3 diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg new file mode 100644 index 00000000..635322e4 --- /dev/null +++ b/infra/haproxy.cfg @@ -0,0 +1,44 @@ +global + log stdout format raw local0 + maxconn 2048 + +defaults + log global + mode http + log-format "lb status=%ST backend=%b server=%s duration_ms=%Tt" + timeout connect 500ms + timeout check 500ms + timeout client 20s + timeout server 30s + timeout http-request 3s + retries 0 + +resolvers docker + nameserver embedded 127.0.0.11:53 + accepted_payload_size 8192 + resolve_retries 3 + timeout resolve 1s + timeout retry 1s + hold valid 1s + hold obsolete 0s + hold nx 1s + hold refused 1s + hold timeout 1s + hold other 1s + +frontend public + bind :8080 + default_backend messenger + +backend messenger + balance roundrobin + option httpchk GET /health/ready + http-check expect status 200 + default-server inter 500ms fastinter 250ms downinter 500ms fall 2 rise 1 + server-template app 1-8 api:8080 check resolvers docker resolve-prefer ipv4 init-addr none + +listen metrics + bind :8404 + stats enable + stats uri /stats + stats refresh 1s diff --git a/infra/reconciler-policy.json b/infra/reconciler-policy.json new file mode 100644 index 00000000..c2027604 --- /dev/null +++ b/infra/reconciler-policy.json @@ -0,0 +1 @@ +{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetBucketLocation","s3:ListBucket"],"Resource":["arn:aws:s3:::BUCKET"]},{"Effect":"Allow","Action":["s3:GetObject","s3:DeleteObject"],"Resource":["arn:aws:s3:::BUCKET/originals/*"]}]} diff --git a/infra/s3.Dockerfile b/infra/s3.Dockerfile new file mode 100644 index 00000000..839858a6 --- /dev/null +++ b/infra/s3.Dockerfile @@ -0,0 +1,18 @@ +# Official security-fixed source release; no dependency on retired image tags. +FROM golang:1.26.7-alpine3.23@sha256:b17af760035fc2f338eed92d448a6c67f2d45438844fc6c60678fa5f99e44b57 AS builder +ENV CGO_ENABLED=0 GOTOOLCHAIN=local GOMAXPROCS=4 GOFLAGS=-p=4 +RUN go install -ldflags='-s -w' github.com/minio/minio@RELEASE.2025-10-15T17-29-55Z +RUN go install -ldflags='-s -w' github.com/minio/mc@RELEASE.2025-08-13T08-35-41Z + +FROM alpine:3.23@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0 AS server +COPY --from=builder /go/bin/minio /usr/local/bin/minio +COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt +RUN addgroup -g 10001 app && adduser -D -u 10001 -G app app && mkdir /data && chown app:app /data +COPY --chmod=755 infra/start-s3.sh /usr/local/bin/start-s3.sh +USER 10001:10001 +ENTRYPOINT ["/usr/local/bin/start-s3.sh"] + +FROM alpine:3.23@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0 AS client +COPY --from=builder /go/bin/mc /usr/local/bin/mc +COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt +ENTRYPOINT ["/bin/sh"] diff --git a/infra/start-s3.sh b/infra/start-s3.sh new file mode 100644 index 00000000..5aba08ee --- /dev/null +++ b/infra/start-s3.sh @@ -0,0 +1,5 @@ +#!/bin/sh +set -eu +export MINIO_ROOT_USER="$(cat /run/secrets/s3_root_user)" +export MINIO_ROOT_PASSWORD="$(cat /run/secrets/s3_root_password)" +exec minio "$@" diff --git a/migrations/001_initial.sql b/migrations/001_initial.sql new file mode 100644 index 00000000..c2c2cc1d --- /dev/null +++ b/migrations/001_initial.sql @@ -0,0 +1,37 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username varchar(32) COLLATE "C" NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name text NOT NULL CHECK (char_length(display_name) BETWEEN 1 AND 100), + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp() +); +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL CHECK (char_length(title) BETWEEN 1 AND 100), + created_at timestamptz NOT NULL DEFAULT clock_timestamp() +); +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id), + position smallint NOT NULL CHECK (position BETWEEN 0 AND 99), + PRIMARY KEY (chat_id,user_id), + UNIQUE (chat_id,position) +); +CREATE INDEX chat_members_by_user ON chat_members (user_id,chat_id); +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id), + sender_id uuid NOT NULL REFERENCES users(id), + text text NOT NULL CHECK (char_length(text) BETWEEN 1 AND 4000), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + FOREIGN KEY (chat_id,sender_id) REFERENCES chat_members(chat_id,user_id) +); +CREATE INDEX messages_history ON messages (chat_id,created_at,id); +CREATE TABLE sessions ( + token_hash bytea PRIMARY KEY CHECK (octet_length(token_hash)=32), + user_id uuid NOT NULL REFERENCES users(id), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + expires_at timestamptz NOT NULL, + CHECK (expires_at > created_at) +); +CREATE INDEX sessions_expiry ON sessions (expires_at); diff --git a/migrations/002_idempotency.sql b/migrations/002_idempotency.sql new file mode 100644 index 00000000..dd0e2896 --- /dev/null +++ b/migrations/002_idempotency.sql @@ -0,0 +1,14 @@ +CREATE TABLE message_requests ( + user_id uuid NOT NULL REFERENCES users(id), + http_method text NOT NULL DEFAULT 'POST' CHECK (http_method='POST'), + chat_id uuid NOT NULL REFERENCES chats(id), + idempotency_key varchar(128) COLLATE "C" NOT NULL + CHECK (idempotency_key ~ '^[A-Za-z0-9._:-]{1,128}$'), + payload_hash bytea NOT NULL CHECK (octet_length(payload_hash)=32), + response_message_id uuid NOT NULL REFERENCES messages(id), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + expires_at timestamptz NOT NULL, + PRIMARY KEY (user_id,http_method,chat_id,idempotency_key), + CHECK (expires_at > created_at) +); +CREATE INDEX message_requests_expiry ON message_requests (expires_at); diff --git a/migrations/003_attachments.sql b/migrations/003_attachments.sql new file mode 100644 index 00000000..019d7cc9 --- /dev/null +++ b/migrations/003_attachments.sql @@ -0,0 +1,30 @@ +CREATE TABLE attachments ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id), + owner_id uuid NOT NULL REFERENCES users(id), + filename text NOT NULL CHECK (char_length(filename) BETWEEN 1 AND 255), + content_type text NOT NULL CHECK (content_type IN ('image/png','image/jpeg')), + size_bytes bigint NOT NULL CHECK (size_bytes BETWEEN 1 AND 10485760), + sha256 text NOT NULL CHECK (sha256 ~ '^[a-f0-9]{64}$'), + object_key text NOT NULL UNIQUE, + storage_state text NOT NULL CHECK (storage_state IN ('pending','ready','missing')), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + updated_at timestamptz NOT NULL DEFAULT clock_timestamp(), + UNIQUE (id,chat_id), + FOREIGN KEY (chat_id,owner_id) REFERENCES chat_members(chat_id,user_id) +); +CREATE INDEX attachments_reconcile ON attachments (updated_at,id); +ALTER TABLE messages DROP CONSTRAINT messages_text_check; +ALTER TABLE messages ADD CHECK (char_length(text) BETWEEN 0 AND 4000); +ALTER TABLE messages ADD UNIQUE (id,chat_id); +CREATE TABLE message_attachments ( + message_id uuid NOT NULL, + chat_id uuid NOT NULL, + attachment_id uuid NOT NULL, + position smallint NOT NULL CHECK (position BETWEEN 0 AND 9), + PRIMARY KEY (message_id,attachment_id), + UNIQUE (message_id,position), + FOREIGN KEY (message_id,chat_id) REFERENCES messages(id,chat_id), + FOREIGN KEY (attachment_id,chat_id) REFERENCES attachments(id,chat_id) +); +CREATE INDEX message_attachments_by_attachment ON message_attachments (attachment_id); diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 00000000..71558026 --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,45 @@ +[project] +name = "mtusi-messenger" +version = "0.4.0" +description = "MTUSI lab 4: private object storage and recoverable attachments" +requires-python = ">=3.14,<3.15" +dependencies = [ + "argon2-cffi==25.1.0", + "boto3==1.43.109", + "fastapi==0.143.3", + "pillow==13.0.0", + "psycopg[binary,pool]==3.3.6", + "pydantic==2.14.1", + "redis==8.1.0", + "uvicorn==0.54.0", +] + +[build-system] +requires = ["hatchling==1.27.0"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/messenger"] + +[dependency-groups] +dev = [ + "httpx==0.28.1", + "openapi-spec-validator==0.7.2", + "pytest==9.1.1", + "ruff==0.17.1", +] +research = ["matplotlib==3.11.2"] + +[tool.pytest.ini_options] +testpaths = ["student-tests"] +addopts = "-ra --tb=short" + +[tool.ruff] +target-version = "py314" +line-length = 100 + +[tool.ruff.lint] +select = ["E", "F", "I", "B", "UP"] + +[tool.ruff.per-file-target-version] +"scripts/*.py" = "py39" diff --git a/research/analyze.py b/research/analyze.py new file mode 100644 index 00000000..820de0b2 --- /dev/null +++ b/research/analyze.py @@ -0,0 +1,58 @@ +"""Render measured kernel memory peaks and dry-run traversal costs.""" + +import argparse +import json +from pathlib import Path +from statistics import median + +import matplotlib + +matplotlib.use("Agg") +import matplotlib.pyplot as plt # noqa: E402 + +ROOT = Path(__file__).resolve().parents[1] +parser = argparse.ArgumentParser(description=__doc__) +parser.add_argument("input", nargs="?", type=Path, default=ROOT / "evidence/storage.json") +args = parser.parse_args() +d = json.loads(args.input.read_text()) +plt.rcParams.update( + { + "font.size": 10, + "figure.dpi": 150, + "axes.grid": True, + "grid.alpha": 0.2, + "axes.spines.top": False, + "axes.spines.right": False, + } +) +fig, ax = plt.subplots(1, 2, figsize=(11, 4), constrained_layout=True) +labels = [f"{r['bytes_each'] / 1048576:.2f} MiB" for r in d["uploads"]] +base = [max(v["current_bytes"] for v in r["before"].values()) / 1048576 for r in d["uploads"]] +peak = [max(v["peak_bytes"] for v in r["after"].values()) / 1048576 for r in d["uploads"]] +x = list(range(len(labels))) +ax[0].bar([v - 0.18 for v in x], base, width=0.36, label="Before: max API memory.current") +ax[0].bar([v + 0.18 for v in x], peak, width=0.36, label="Kernel memory.peak incl. startup") +ax[0].axhline(512, color="gray", linestyle="--", label="Per API limit: 512 MiB") +ax[0].set( + xticks=x, + xticklabels=labels, + ylabel="MiB per API container", + title="10 simultaneous clients, 1 active upload/API", +) +ax[0].legend(fontsize=7) +cost = d["scan_cost"] +xs = [r["extra_fresh_objects"] for r in cost] +values = [[v["elapsed_seconds"] * 1000 for v in r["repeats"]] for r in cost] +ax[1].plot(xs, [median(v) for v in values], marker="o", label="Median of 3 dry runs") +ax[1].fill_between( + xs, [min(v) for v in values], [max(v) for v in values], alpha=0.15, label="Min/max" +) +ax[1].set( + xlabel="Extra fresh objects (metadata unchanged)", + ylabel="Traversal wall time, ms", + title="LIST pagination + metadata HEAD checks", +) +ax[1].legend(fontsize=8) +fig.savefig(args.input.with_name(args.input.stem + "-research.png")) +plt.close(fig) +print("PASS: research figure generated from storage.json") diff --git a/scripts/bootstrap.py b/scripts/bootstrap.py new file mode 100644 index 00000000..6221bf29 --- /dev/null +++ b/scripts/bootstrap.py @@ -0,0 +1,46 @@ +#!/usr/bin/env python3 +"""Create local synthetic credentials once, without printing their values.""" + +import os +import secrets +from pathlib import Path + +root = Path(__file__).resolve().parents[1] +directory = root / "secrets" +directory.mkdir(mode=0o700, exist_ok=True) +password_file = directory / "postgres_password" +if not password_file.exists(): + password_file.write_text(secrets.token_urlsafe(32) + "\n") +password = password_file.read_text().strip() +for name, value in { + "database_url": f"postgresql://messenger:{password}@postgres:5432/messenger", + "cache_url": "redis://valkey:6379/0", +}.items(): + path = directory / name + if not path.exists(): + path.write_text(value + "\n") +# Compose bind-mount secrets must be readable by the non-root container process. +# The parent directory remains 0700 on the host. +for role in ("root", "api", "reconciler", "test"): + names = ( + ("s3_root_user", "s3_root_password") + if role == "root" + else ("s3_" + role + "_access_key_id", "s3_" + role + "_secret_access_key") + ) + for index, name in enumerate(names): + path = directory / name + if not path.exists(): + path.write_text( + (secrets.token_hex(10) if index == 0 else secrets.token_urlsafe(32)) + "\n" + ) +for name in ( + "postgres_password", + "database_url", + "cache_url", + *[p.name for p in directory.glob("s3_*")], +): + os.chmod(directory / name, 0o644) +env = root / ".env" +if not env.exists(): + env.write_text((root / ".env.example").read_text()) +print("Local secret files and environment are ready; existing values preserved.") diff --git a/scripts/cluster.py b/scripts/cluster.py new file mode 100644 index 00000000..b78f509b --- /dev/null +++ b/scripts/cluster.py @@ -0,0 +1,82 @@ +"""Read-only discovery and scoped Compose operations for the local lab4 stack.""" + +import json +import subprocess +import time +import urllib.error +import urllib.request +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +def compose(*args, env=None): + return subprocess.run( + ["docker", "compose", "--env-file", ".env", *args], + cwd=ROOT, + env=env, + check=True, + capture_output=True, + text=True, + timeout=90, + ).stdout + + +def inspect(container): + template = ( + '{"id":{{json .Id}},"started_at":{{json .State.StartedAt}},' + '"pid":{{.State.Pid}},"running":{{json .State.Running}},' + '"image":{{json .Image}},"memory":{{.HostConfig.Memory}},' + '"nano_cpus":{{.HostConfig.NanoCpus}},' + '"published_ports":{{json .HostConfig.PortBindings}}}' + ) + r = subprocess.run( + ["docker", "inspect", "--format", template, container], + capture_output=True, + text=True, + check=True, + timeout=5, + ) + return json.loads(r.stdout) + + +def instance(container): + code = ( + "import urllib.request; r=urllib.request.urlopen(" + "'http://127.0.0.1:8080/health/live',timeout=1); print(r.headers['X-Instance-Id'])" + ) + r = subprocess.run( + ["docker", "exec", container, "python", "-c", code], + capture_output=True, + text=True, + check=True, + timeout=3, + ) + value = inspect(container) + value["instance"] = r.stdout.strip() + return value + + +def instances(): + ids = compose("ps", "-q", "api").split() + with ThreadPoolExecutor(max_workers=8) as pool: + return list(pool.map(instance, ids)) + + +def wait_lb(base="http://127.0.0.1:8084", count=2, timeout=45): + deadline, seen = time.monotonic() + timeout, set() + while time.monotonic() < deadline: + try: + current = {value["instance"] for value in instances()} + if len(current) != count: + time.sleep(0.2) + continue + with urllib.request.urlopen(base + "/health/ready", timeout=2) as response: + seen.add(response.headers["X-Instance-Id"]) + if current <= seen: + return sorted(current) + except (OSError, urllib.error.URLError, subprocess.SubprocessError): + pass + time.sleep(0.1) + raise RuntimeError("Expected healthy API replicas were not observed through LB") diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..1ccc34af --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,5 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +# All running application/state services; no migration, down -v, flush or seed. +docker compose --env-file .env restart --timeout 7 api postgres valkey s3 lb diff --git a/scripts/rolling-update.py b/scripts/rolling-update.py new file mode 100644 index 00000000..501a669a --- /dev/null +++ b/scripts/rolling-update.py @@ -0,0 +1,49 @@ +#!/usr/bin/env python3 +"""Sequential process replacement; at least one existing API stays running.""" + +import argparse +import json +import subprocess + +from cluster import compose, instances, wait_lb + + +def replace_all(base="http://127.0.0.1:8084"): + original = instances() + if len(original) < 2: + raise RuntimeError("Rolling replacement requires at least two healthy replicas") + wait_lb(base, len(original)) + replacements = [] + for current in original: + subprocess.run( + ["docker", "stop", "--time", "5", current["id"]], + check=True, + capture_output=True, + timeout=8, + ) + subprocess.run(["docker", "rm", current["id"]], check=True, capture_output=True) + compose( + "up", "-d", "--no-deps", "--no-recreate", "--scale", "api=" + str(len(original)), "api" + ) + aliases = wait_lb(base, len(original)) + if current["instance"] in aliases: + raise RuntimeError("Old API process is still serving after replacement") + replacements.append( + { + "old_container": current["id"], + "old_instance": current["instance"], + "live_instances": aliases, + } + ) + return replacements + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", default="http://127.0.0.1:8084") + args = parser.parse_args() + print(json.dumps(replace_all(args.base_url))) + + +if __name__ == "__main__": + main() diff --git a/scripts/stop-one.py b/scripts/stop-one.py new file mode 100644 index 00000000..48ffc6e9 --- /dev/null +++ b/scripts/stop-one.py @@ -0,0 +1,48 @@ +#!/usr/bin/env python3 +"""Map a process alias to ONE container belonging to this Compose service.""" + +import json +import os +import re +import subprocess +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +def alias(container): + code = ( + "import urllib.request; r=urllib.request.urlopen(" + "'http://127.0.0.1:8080/health/live',timeout=1); print(r.headers['X-Instance-Id'])" + ) + r = subprocess.run( + ["docker", "exec", container, "python", "-c", code], + cwd=ROOT, + capture_output=True, + text=True, + timeout=3, + check=True, + ) + return container, r.stdout.strip() + + +def main(): + target = os.environ.get("TARGET_INSTANCE_ID", "") + if not re.fullmatch(r"[a-f0-9]{32}", target): + raise SystemExit("TARGET_INSTANCE_ID must name a live API process") + ids = subprocess.check_output( + ["docker", "compose", "ps", "-q", "api"], cwd=ROOT, text=True + ).split() + with ThreadPoolExecutor(max_workers=8) as pool: + matches = [cid for cid, identity in pool.map(alias, ids) if identity == target] + if len(matches) != 1: + raise SystemExit("Expected exactly one matching API in this project") + subprocess.run( + ["docker", "stop", "--time", "5", matches[0]], check=True, capture_output=True, timeout=7 + ) + print(json.dumps({"stopped_container": matches[0], "instance": target})) + + +if __name__ == "__main__": + main() diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 00000000..911fbd6a --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +exec python3 scripts/stop-one.py diff --git a/scripts/storage_lab.py b/scripts/storage_lab.py new file mode 100644 index 00000000..005e8759 --- /dev/null +++ b/scripts/storage_lab.py @@ -0,0 +1,45 @@ +"""Local-only operator helpers; secret values never leave this process.""" + +from pathlib import Path + +import psycopg +from psycopg.conninfo import make_conninfo +from psycopg.rows import dict_row + +from messenger.settings import Settings +from messenger.storage import ObjectStore + +ROOT = Path(__file__).resolve().parents[1] + + +def settings(role="reconciler"): + password = (ROOT / "secrets/postgres_password").read_text().strip() + dsn = make_conninfo( + host="127.0.0.1", + port=55435, + dbname="messenger", + user="messenger", + password=password, + connect_timeout=2, + options="-c timezone=UTC", + ) + key, secret = ( + ("s3_root_user", "s3_root_password") + if role == "root" + else ("s3_" + role + "_access_key_id", "s3_" + role + "_secret_access_key") + ) + return Settings( + dsn, + "redis://127.0.0.1:56382/0", + s3_access_key=(ROOT / "secrets" / key).read_text().strip(), + s3_secret_key=(ROOT / "secrets" / secret).read_text().strip(), + ) + + +def connection(config=None): + config = config or settings() + return psycopg.connect(config.database_url, autocommit=True, row_factory=dict_row) + + +def store(role="reconciler"): + return ObjectStore(settings(role)) diff --git a/scripts/verify_cluster.py b/scripts/verify_cluster.py new file mode 100644 index 00000000..4edd0fa4 --- /dev/null +++ b/scripts/verify_cluster.py @@ -0,0 +1,253 @@ +#!/usr/bin/env python3 +"""Real LB requests during each replica failure and sequential replacement.""" + +import argparse +import json +import os +import subprocess +import sys +import threading +import time +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path +from uuid import uuid4 + +from cluster import ROOT, compose, inspect, instance, instances, wait_lb + +sys.path.insert(0, str(ROOT / "tests")) +from client import Client, Failure, check # noqa: E402 +from resilience import history # noqa: E402 + + +def percentile(values, fraction): + values = sorted(values) + return values[min(int((len(values) - 1) * fraction), len(values) - 1)] if values else None + + +class Traffic: + def __init__(self, base, actor, room, workers=6): + self.base, self.actor, self.room = base, actor, room + self.prefix = uuid4().hex + self.stop = threading.Event() + self.lock = threading.Lock() + self.events = [] + self.executor = ThreadPoolExecutor(max_workers=workers) + self.workers = workers + + def worker(self, worker): + client, iteration = Client(self.base, timeout=3), 0 + while not self.stop.is_set(): + started = time.monotonic() + write = iteration % 10 == 9 + try: + if write: + key = f"{self.prefix}:{worker}:{iteration}" + response = client.message(self.actor, self.room, key, key=key) + else: + response = client.call( + "GET", "/api/v1/users/me", actor=self.actor, schema="User" + ) + event = { + "at": time.monotonic(), + "ok": True, + "instance": response["headers"]["X-Instance-Id"], + "latency_ms": (time.monotonic() - started) * 1000, + "message": response["json"] if write else None, + } + iteration += 1 + except Failure: + event = { + "at": time.monotonic(), + "ok": False, + "latency_ms": (time.monotonic() - started) * 1000, + } + with self.lock: + self.events.append(event) + + def __enter__(self): + self.started = time.monotonic() + self.futures = [self.executor.submit(self.worker, i) for i in range(self.workers)] + return self + + def __exit__(self, *args): + self.stop.set() + self.executor.shutdown(wait=True) + for future in self.futures: + future.result() + self.finished = time.monotonic() + + def report(self, action_start, action_end): + events = sorted(self.events, key=lambda row: row["at"]) + ok = [row for row in events if row["ok"]] + after = [row for row in ok if row["at"] >= action_end] + check(bool(after), "No successful request after action") + elapsed = self.finished - self.started + latency = [row["latency_ms"] for row in ok] + return { + "duration_seconds": elapsed, + "workers": self.workers, + "requests": len(events), + "successes": len(ok), + "errors": len(events) - len(ok), + "successful_rps": len(ok) / elapsed, + "error_fraction": (len(events) - len(ok)) / len(events), + "first_success_after_action_seconds": after[0]["at"] - action_start, + "action_seconds": action_end - action_start, + "p50_ms": percentile(latency, 0.5), + "p95_ms": percentile(latency, 0.95), + "p99_ms": percentile(latency, 0.99), + "instances": sorted({row["instance"] for row in ok}), + "tail_instances": sorted({row["instance"] for row in after[-10:]}), + "confirmed_writes": sum(row["message"] is not None for row in ok), + } + + def verify_messages(self, client, actor, room): + actual = history(client, actor, room) + by_id = {value["id"]: value for value in actual} + check(len(by_id) == len(actual), "History has duplicate IDs") + texts = [row["text"] for row in actual if row["text"].startswith(self.prefix)] + check(len(texts) == len(set(texts)), "An uncertain retry created a duplicate effect") + for event in self.events: + if event["ok"] and event["message"]: + check( + by_id.get(event["message"]["id"]) == event["message"], + "A confirmed message was lost or changed", + ) + + +def public_test(target, base): + result = subprocess.run( + [ + "make", + target, + "ACTION_SCRIPT=scripts/" + + ("restart.sh" if target == "test-persistence" else "stop-one.sh"), + "BASE_URL=" + base, + ], + cwd=ROOT, + check=True, + capture_output=True, + text=True, + timeout=150, + ) + return "\n".join(line.rstrip() for line in result.stdout.splitlines()) + "\n" + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--base-url", default="http://127.0.0.1:8084") + parser.add_argument( + "--output", type=Path, default=ROOT / f"evidence/cluster-{time.time_ns()}.json" + ) + args = parser.parse_args() + if args.output.exists(): + raise SystemExit("Use a new evidence filename") + os.environ["NO_PROXY"] = os.environ["no_proxy"] = "127.0.0.1,localhost" + baseline = instances() + check(len(baseline) == 2, "This verification expects the default two API replicas") + check(not any(row["published_ports"] for row in baseline), "API must not publish host ports") + wait_lb(args.base_url, 2) + result = {"initial_instances": baseline, "failures": []} + client = Client(args.base_url, timeout=4) + alice, bob, eve, room = client.bootstrap() + key = uuid4().hex + + def same_request(_): + response = Client(args.base_url).message(alice, room, "concurrent replay", key=key) + return response["json"], response["headers"]["X-Instance-Id"] + + with ThreadPoolExecutor(max_workers=10) as pool: + responses = list(pool.map(same_request, range(30))) + check( + len({row[0]["id"] for row in responses}) == 1, "Cross-replica replay duplicated a message" + ) + check(len({row[1] for row in responses}) == 2, "Concurrent replay did not cross real replicas") + result["concurrent_replays"] = 30 + result["concurrent_effects"] = 1 + try: + for selected in baseline: + selected = instance(selected["id"]) + with Traffic(args.base_url, alice, room) as traffic: + time.sleep(1) + action_start = time.monotonic() + env = {**os.environ, "TARGET_INSTANCE_ID": selected["instance"]} + subprocess.run( + [str(ROOT / "scripts/stop-one.sh")], + cwd=ROOT, + env=env, + check=True, + capture_output=True, + timeout=10, + ) + action_end = time.monotonic() + check(not inspect(selected["id"])["running"], "Chosen process was not stopped") + time.sleep(3) + report = traffic.report(action_start, action_end) + check(report["first_success_after_action_seconds"] <= 10, "Failover took too long") + check(selected["instance"] not in report["tail_instances"], "Stopped API still serves") + report["stopped"] = selected + traffic.verify_messages(client, bob, room) + result["failures"].append(report) + subprocess.run(["docker", "start", selected["id"]], check=True, capture_output=True) + wait_lb(args.base_url, 2) + print("Verified failure and restoration of one API", flush=True) + with Traffic(args.base_url, alice, room) as traffic: + time.sleep(1) + action_start = time.monotonic() + replaced = subprocess.run( + [ + sys.executable, + str(ROOT / "scripts/rolling-update.py"), + "--base-url", + args.base_url, + ], + cwd=ROOT, + check=True, + capture_output=True, + text=True, + timeout=120, + ) + action_end = time.monotonic() + time.sleep(3) + traffic.verify_messages(client, bob, room) + result["rolling"] = traffic.report(action_start, action_end) + result["rolling"]["replacements"] = json.loads(replaced.stdout) + result["rolling"]["confirmed_messages_preserved"] = True + print("Verified sequential replacement under traffic", flush=True) + (ROOT / "evidence/failover.txt").write_text(public_test("test-failover", args.base_url)) + for value in compose("ps", "-aq", "api").split(): + if not inspect(value)["running"]: + subprocess.run(["docker", "start", value], check=True, capture_output=True) + wait_lb(args.base_url, 2) + before = { + service: inspect(compose("ps", "-q", service).strip()) + for service in ("postgres", "valkey", "s3", "lb") + } + (ROOT / "evidence/persistence.txt").write_text( + public_test("test-persistence", args.base_url) + ) + after = {service: inspect(compose("ps", "-q", service).strip()) for service in before} + check( + all(before[s]["started_at"] != after[s]["started_at"] for s in before), + "Persistence hook did not restart all state/LB services", + ) + result["persistence"] = {"before": before, "after": after, "same_token_public_test": True} + result["final_instances"] = instances() + logs = compose("logs", "--no-color", "api", "lb") + check( + not any( + a["token"] in logs or a["registration"]["password"] in logs + for a in (alice, bob, eve) + ), + "Credential appeared in logs", + ) + args.output.write_text(json.dumps(result, ensure_ascii=False, indent=2) + "\n") + print("PASS: real replica failures, replay, rolling replacement and persistence") + finally: + for value in compose("ps", "-aq", "api").split(): + if not inspect(value)["running"]: + subprocess.run(["docker", "start", value], check=True, capture_output=True) + + +if __name__ == "__main__": + main() diff --git a/scripts/verify_storage.py b/scripts/verify_storage.py new file mode 100644 index 00000000..92c44a74 --- /dev/null +++ b/scripts/verify_storage.py @@ -0,0 +1,424 @@ +#!/usr/bin/env python3 +"""Private S3, 10 concurrent proxy uploads, failure recovery and reconciliation cost.""" + +import argparse +import hashlib +import io +import json +import os +import socket +import subprocess +import sys +import time +import urllib.error +import urllib.request +from concurrent.futures import ThreadPoolExecutor +from datetime import UTC, datetime +from pathlib import Path +from uuid import uuid4 + +from botocore.exceptions import ClientError +from cluster import compose, inspect, instances, wait_lb +from PIL import Image +from storage_lab import ROOT, connection, store + +from messenger.reconcile import Reconciler + +sys.path.insert(0, str(ROOT / "tests")) +from client import Client, check # noqa: E402 + +PNG = (ROOT / "tests/fixtures/sample.png").read_bytes() + + +def put_orphan(admin): + key = "originals/" + str(uuid4()) + admin.put(key, io.BytesIO(PNG), len(PNG), "image/png", hashlib.sha256(PNG).hexdigest()) + return key + + +def seed(path): + admin = store("root") + try: + key = put_orphan(admin) + path.write_text( + json.dumps({"orphan": key, "created_at": datetime.now(UTC).isoformat()}) + "\n" + ) + print("Seeded one orphan; its real S3 LastModified must age 300 seconds.") + finally: + admin.close() + + +def memory(cids): + result = {} + for cid in cids: + raw = subprocess.check_output( + [ + "docker", + "exec", + cid, + "sh", + "-c", + "cat /sys/fs/cgroup/memory.current /sys/fs/cgroup/memory.peak " + "/sys/fs/cgroup/cpu.stat", + ], + text=True, + ) + lines = raw.splitlines() + current, peak = map(int, lines[:2]) + counters = {k: int(v) for k, v in (line.split() for line in lines[2:])} + result[cid] = {"current_bytes": current, "peak_bytes": peak, "cpu": counters} + return result + + +def pressure(client, actor, chat): + results = [] + for side in (600, 1700): + image = Image.frombytes("RGB", (side, side), os.urandom(side * side * 3)) + output = io.BytesIO() + image.save(output, format="PNG", compress_level=0) + data = output.getvalue() + check(len(data) <= 10485760, "Fixture accidentally oversized") + # Recreate API only, so kernel memory.peak includes this trial and startup. + compose("up", "-d", "--no-deps", "--force-recreate", "--scale", "api=2", "api") + wait_lb(count=2, base=client.base) + cids = [row["id"] for row in instances()] + resource_started = time.monotonic() + baseline = memory(cids) + import threading + + barrier = threading.Barrier(10) + + def one(i, data=data, barrier=barrier): + c = Client(client.base, timeout=30) + barrier.wait(timeout=10) + started = time.monotonic() + value = c.call( + "POST", + f"/api/v1/chats/{chat['id']}/attachments?filename=load-{i}.png", + expected=201, + actor=actor, + raw=data, + headers={"Content-Type": "image/png"}, + schema="Attachment", + ) + check(value["json"]["sha256"] == hashlib.sha256(data).hexdigest(), "Checksum mismatch") + return { + "duration_ms": (time.monotonic() - started) * 1000, + "instance": value["headers"]["X-Instance-Id"], + "id": value["json"]["id"], + } + + started = time.monotonic() + with ThreadPoolExecutor(max_workers=10) as pool: + values = list(pool.map(one, range(10))) + elapsed = time.monotonic() - started + peak = memory(cids) + resource_seconds = time.monotonic() - resource_started + cpu_cores = ( + sum(peak[k]["cpu"]["usage_usec"] - baseline[k]["cpu"]["usage_usec"] for k in cids) + / 1e6 + / resource_seconds + ) + values_ms = sorted(row["duration_ms"] for row in values) + results.append( + { + "clients": 10, + "bytes_each": len(data), + "pixels": side * side, + "duration_seconds": elapsed, + "successful_rps": 10 / elapsed, + "resource_window_seconds": resource_seconds, + "mean_api_cpu_cores_including_probes": cpu_cores, + "errors": 0, + "p50_ms": values_ms[4], + "p95_ms": values_ms[9], + "p99_ms": values_ms[9], + "before": baseline, + "after": peak, + "responses": values, + } + ) + print(f"PASS: 10 simultaneous uploads, {len(data)} bytes each", flush=True) + return results + + +def private(admin, api, chat, actor, client): + value, _ = client.attachment(actor, chat) + with connection() as conn: + row = conn.execute("SELECT * FROM attachments WHERE id=%s", (value["id"],)).fetchone() + # HTTP from a different container, no Authorization, no signature, no API. + code = ( + "import urllib.request,urllib.error; " + f'u="http://s3:9000/{api.bucket}/{row["object_key"]}"; ' + "\ntry:\n r=urllib.request.urlopen(u); print(r.status)" + "\nexcept urllib.error.HTTPError as e: print(e.code)" + ) + cid = instances()[0]["id"] + status = int(subprocess.check_output(["docker", "exec", cid, "python", "-c", code], text=True)) + check(status == 403, "Anonymous S3 GET succeeded") + for method, kwargs in [ + ("delete_object", {"Bucket": api.bucket, "Key": row["object_key"]}), + ("list_objects_v2", {"Bucket": "unrelated-bucket"}), + ]: + try: + getattr(api.client, method)(**kwargs) + except ClientError as exc: + check(exc.response["ResponseMetadata"]["HTTPStatusCode"] == 403, "Expected IAM 403") + else: + raise RuntimeError("API identity exceeded its policy") + return { + "anonymous_get_status": status, + "api_delete_denied": True, + "other_bucket_denied": True, + "attachment": value["id"], + } + + +def cross_replica(client, actor, reader, chat): + value = client.call( + "POST", + f"/api/v1/chats/{chat['id']}/attachments?filename=switch.png", + expected=201, + actor=actor, + raw=PNG, + headers={"Content-Type": "image/png"}, + schema="Attachment", + ) + alias = value["headers"]["X-Instance-Id"] + selected = next(row for row in instances() if row["instance"] == alias) + try: + subprocess.run( + [str(ROOT / "scripts/stop-one.sh")], + check=True, + capture_output=True, + env={**os.environ, "TARGET_INSTANCE_ID": alias}, + timeout=10, + ) + stopped = inspect(selected["id"]) + check(not stopped["running"], "Uploading process was not stopped") + time.sleep(1) + result = client.call( + "GET", "/api/v1/attachments/" + value["json"]["id"] + "/content", actor=reader + ) + check( + result["bytes"] == PNG and result["headers"]["X-Instance-Id"] != alias, + "Another API failed to serve original", + ) + return { + "uploader": selected, + "after_stop": stopped, + "downloader_instance": result["headers"]["X-Instance-Id"], + "original_preserved": True, + } + finally: + subprocess.run(["docker", "start", selected["id"]], check=True, capture_output=True) + wait_lb(base=client.base, count=2) + + +def interruption(client, actor, chat): + with connection() as conn: + before = conn.execute("SELECT count(*) AS n FROM attachments").fetchone()["n"] + # Close in the middle of a correctly declared body; no durable intent must exist yet. + s = socket.create_connection(("127.0.0.1", 8084), timeout=3) + header = ( + f"POST /api/v1/chats/{chat['id']}/attachments?filename=interrupted.png HTTP/1.1\r\n" + "Host: localhost\r\nContent-Type: image/png\r\nContent-Length: 1048576\r\n" + f"Authorization: Bearer {actor['token']}\r\nConnection: close\r\n\r\n" + ) + s.sendall(header.encode() + PNG[:32]) + s.close() + time.sleep(0.5) + with connection() as conn: + after = conn.execute("SELECT count(*) AS n FROM attachments").fetchone()["n"] + check(before == after, "Interrupted inbound body created an intent") + return {"before_rows": before, "after_rows": after, "aborted_body_no_intent": True} + + +def outage(client, actor, chat): + att, _ = client.attachment(actor, chat) + before = inspect(compose("ps", "-q", "s3").strip()) + compose("stop", "s3") + started = time.monotonic() + try: + statuses = [] + for method, path, raw in [ + ("GET", "/api/v1/attachments/" + att["id"] + "/content", None), + ("POST", f"/api/v1/chats/{chat['id']}/attachments?filename=unavailable.png", PNG), + ]: + request = urllib.request.Request( + client.base + path, + data=raw, + method=method, + headers={"Authorization": "Bearer " + actor["token"], "Content-Type": "image/png"}, + ) + try: + response = urllib.request.urlopen(request, timeout=8) + except urllib.error.HTTPError as exc: + response = exc + with response: + statuses.append(response.code) + check(response.code == 503, "S3 outage must produce 503") + failed = len(statuses) + finally: + compose("start", "s3") + wait_lb(base=client.base, count=2) + after = inspect(compose("ps", "-q", "s3").strip()) + actual = client.call("GET", "/api/v1/attachments/" + att["id"] + "/content", actor=actor)[ + "bytes" + ] + check(actual == PNG, "S3 restart lost original") + return { + "before": before, + "after": after, + "failed_operations": failed, + "statuses": statuses, + "stop_start_and_ready_seconds": time.monotonic() - started, + "original_preserved": True, + } + + +def reconciliation(seed_path, admin, reconciler, client, actor, chat): + saved = json.loads(seed_path.read_text()) + orphan = saved["orphan"] + head = admin.head(orphan) + check(head is not None, "Seed orphan is missing") + age = time.time() - head["LastModified"].timestamp() + check(age >= 300, "Seed must be at least 300s old; keep it while other checks run") + fresh = put_orphan(admin) + used, _ = client.attachment(actor, chat) + client.message(actor, chat, "used attachment", attachments=[used["id"]]) + with connection() as conn: + conn.execute( + "UPDATE attachments SET updated_at=clock_timestamp()-interval '10 minutes' WHERE id=%s", + (used["id"],), + ) + dry = Reconciler(conn, reconciler).run() + check( + any( + a["action"] == "delete_orphan" and a["id"] == orphan.split("/")[1] + for a in dry["actions"] + ), + "Dry run did not detect old orphan", + ) + check(admin.head(orphan) is not None, "Dry-run mutated S3") + applied = Reconciler(conn, reconciler, apply=True).run() + repeated = Reconciler(conn, reconciler, apply=True).run() + check(admin.head(orphan) is None and admin.head(fresh) is not None, "Grace safety failed") + row = conn.execute("SELECT * FROM attachments WHERE id=%s", (used["id"],)).fetchone() + check( + row["storage_state"] == "ready" and admin.head(row["object_key"]) is not None, + "Used attachment was removed", + ) + check(repeated["actions"] == [], "Repeated apply failed to converge") + # Remove a USED object's bytes, preserve its metadata/link, and repair after re-upload. + admin.client.delete_object(Bucket=admin.bucket, Key=row["object_key"]) + missing_dry = Reconciler(conn, reconciler).run() + check( + conn.execute( + "SELECT storage_state FROM attachments WHERE id=%s", (used["id"],) + ).fetchone()["storage_state"] + == "ready", + "Dry run mutated metadata", + ) + missing_apply = Reconciler(conn, reconciler, apply=True).run() + check( + conn.execute( + "SELECT storage_state FROM attachments WHERE id=%s", (used["id"],) + ).fetchone()["storage_state"] + == "missing", + "Missing original was not marked", + ) + check( + conn.execute( + "SELECT count(*) AS n FROM message_attachments WHERE attachment_id=%s", + (used["id"],), + ).fetchone()["n"] + == 1, + "A used relation was removed", + ) + admin.put( + row["object_key"], + io.BytesIO(PNG), + len(PNG), + "image/png", + hashlib.sha256(PNG).hexdigest(), + ) + healing = Reconciler(conn, reconciler, apply=True).run() + check( + client.call("GET", "/api/v1/attachments/" + used["id"] + "/content", actor=actor)[ + "bytes" + ] + == PNG, + "Restored original is wrong", + ) + return { + "old_orphan_age_seconds": age, + "dry_run": dry, + "apply": applied, + "repeat": repeated, + "missing_dry_run": missing_dry, + "missing_apply": missing_apply, + "healing": healing, + "fresh_preserved": True, + "used_metadata_and_link_preserved": True, + } + + +def scan_cost(admin, reconciler): + results = [] + created = [] + try: + for target in (0, 100, 1100): + while len(created) < target: + created.append(put_orphan(admin)) + repeats = [] + for _ in range(3): + with connection() as conn: + repeats.append(Reconciler(conn, reconciler).run()) + results.append({"extra_fresh_objects": target, "repeats": repeats}) + return results + finally: + for key in created: + admin.client.delete_object(Bucket=admin.bucket, Key=key) + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--seed", type=Path) + parser.add_argument("--resume-basics", type=Path) + parser.add_argument("--seed-file", type=Path, default=ROOT / "evidence/storage-seed.json") + parser.add_argument("--output", type=Path, default=ROOT / "evidence/storage.json") + args = parser.parse_args() + if args.seed: + seed(args.seed) + return + if args.output.exists(): + raise SystemExit("Choose a new evidence filename") + os.environ["NO_PROXY"] = os.environ["no_proxy"] = "localhost,127.0.0.1" + admin, api, rec = store("root"), store("api"), store("reconciler") + try: + client = Client("http://127.0.0.1:8084", timeout=30) + alice, bob, eve, chat = client.bootstrap() + result = {"started_at": datetime.now(UTC).isoformat()} + if args.resume_basics: + result.update(json.loads(args.resume_basics.read_text())) + else: + result["privacy"] = private(admin, api, chat, alice, client) + result["cross_replica"] = cross_replica(client, alice, bob, chat) + result["interruption"] = interruption(client, alice, chat) + result["uploads"] = pressure(client, alice, chat) + result["outage"] = outage(client, alice, chat) + result["reconciliation"] = reconciliation(args.seed_file, admin, rec, client, alice, chat) + result["scan_cost"] = scan_cost(admin, rec) + result["finished_at"] = datetime.now(UTC).isoformat() + args.output.write_text(json.dumps(result, indent=2) + "\n") + print( + "PASS: private S3, upload memory bound, interruption, outage and reconciler", flush=True + ) + finally: + for value in (admin, api, rec): + value.close() + + +if __name__ == "__main__": + main() diff --git a/src/messenger/__init__.py b/src/messenger/__init__.py new file mode 100644 index 00000000..e2cd3c93 --- /dev/null +++ b/src/messenger/__init__.py @@ -0,0 +1 @@ +"""One-process implementation of the lab 1 messenger contract.""" diff --git a/src/messenger/__main__.py b/src/messenger/__main__.py new file mode 100644 index 00000000..adc5bfef --- /dev/null +++ b/src/messenger/__main__.py @@ -0,0 +1,24 @@ +import logging +import os + +import uvicorn + + +def main(): + level = os.getenv("APP_LOG_LEVEL", "INFO").upper() + logging.basicConfig(level=level, format="%(message)s") + uvicorn.run( + "messenger.app:create_app", + factory=True, + host=os.getenv("APP_HOST", "0.0.0.0"), + port=int(os.getenv("APP_PORT", "8080")), + workers=1, + access_log=False, + log_level=level.lower(), + timeout_keep_alive=2, + timeout_graceful_shutdown=5, + ) + + +if __name__ == "__main__": + main() diff --git a/src/messenger/app.py b/src/messenger/app.py new file mode 100644 index 00000000..fc038348 --- /dev/null +++ b/src/messenger/app.py @@ -0,0 +1,337 @@ +"""HTTP adapter. The instructor's OpenAPI, not FastAPI defaults, defines errors.""" + +import json +import logging +import os +import re +from contextlib import asynccontextmanager +from time import perf_counter +from typing import Annotated +from urllib.parse import quote +from uuid import uuid4 + +from fastapi import Depends, FastAPI, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse, Response, StreamingResponse +from starlette.exceptions import HTTPException +from starlette.types import ASGIApp, Message, Receive, Scope, Send + +from messenger.attachments import Attachments +from messenger.auth import AuthService, Identity, basic_credentials, bearer_digest, unauthorized +from messenger.cache import SessionCache +from messenger.domain import DomainError, User, invalid +from messenger.repository import PostgresRepository +from messenger.schemas import ( + AttachmentView, + ChatPage, + ChatView, + CreateChat, + CreateMessage, + CreateUser, + MessagePage, + MessageView, + SessionView, + UserView, + canonical_uuid, +) +from messenger.service import Messenger +from messenger.settings import Settings +from messenger.storage import ObjectStore + +logger = logging.getLogger("messenger") + + +class RequestContext: + def __init__(self, app: ASGIApp, instance_id: str): + self.app = app + self.instance_id = instance_id + + async def __call__(self, scope: Scope, receive: Receive, send: Send): + if scope["type"] != "http": + return await self.app(scope, receive, send) + request_id = str(uuid4()) + scope.setdefault("state", {})["request_id"] = request_id + start, status, response_started = perf_counter(), 500, False + + async def with_id(message: Message): + nonlocal status, response_started + if message["type"] == "http.response.start": + response_started = True + status = message["status"] + message["headers"] = [ + pair + for pair in message.get("headers", []) + if pair[0].lower() not in (b"x-request-id", b"x-instance-id") + ] + [ + (b"x-request-id", request_id.encode()), + (b"x-instance-id", self.instance_id.encode()), + ] + await send(message) + + try: + await self.app(scope, receive, with_id) + except Exception as exc: + # Do not let Uvicorn print exception values that could contain user data. + if response_started: + raise + logger.error(json.dumps({"event": "internal_error", "type": type(exc).__name__})) + response = error_response( + Request(scope), 500, "internal_error", "Внутренняя ошибка сервера" + ) + await response(scope, receive, with_id) + finally: + route = getattr(scope.get("route"), "path", "unmatched") + logger.info( + json.dumps( + { + "event": "request", + "request_id": request_id, + "method": scope["method"], + "route": route, + "status": status, + "duration_ms": round((perf_counter() - start) * 1000, 3), + } + ) + ) + + +def error_response( + request: Request, status: int, code: str, message: str, headers: dict | None = None +) -> JSONResponse: + identity = getattr(request.state, "request_id", str(uuid4())) + return JSONResponse( + status_code=status, + content={"error": {"code": code, "message": message, "request_id": identity}}, + headers={"X-Request-Id": identity, **(headers or {})}, + ) + + +def create_app(settings: Settings | None = None) -> FastAPI: + settings = settings or Settings.from_env() + repository = PostgresRepository( + settings.database_url, + settings.pool_size, + settings.idempotency_ttl, + settings.read_autocommit, + ) + cache = SessionCache(settings.cache_url) + store = ObjectStore(settings) + authentication = AuthService(repository, cache, settings.session_ttl) + + @asynccontextmanager + async def lifespan(app: FastAPI): + repository.open() + app.state.ready = True + logger.info(json.dumps({"event": "started", "environment": os.getenv("APP_ENV", "lab")})) + try: + yield + finally: + app.state.ready = False + repository.close() + cache.close() + store.close() + logger.info(json.dumps({"event": "stopped"})) + + app = FastAPI(lifespan=lifespan, docs_url=None, redoc_url=None, openapi_url=None) + app.state.instance_id = uuid4().hex + app.add_middleware(RequestContext, instance_id=app.state.instance_id) + app.state.messenger = Messenger(repository) + app.state.attachments = Attachments(repository, app.state.messenger, store, settings) + app.state.repository = repository + app.state.authentication = authentication + app.state.cache = cache + app.state.ready = False + + @app.exception_handler(DomainError) + async def domain_error(request: Request, exc: DomainError): + return error_response(request, exc.status, exc.code, exc.message, exc.headers) + + @app.exception_handler(RequestValidationError) + async def validation_error(request: Request, exc: RequestValidationError): + return error_response(request, 400, "invalid_request", "Некорректные поля или JSON") + + @app.exception_handler(HTTPException) + async def http_error(request: Request, exc: HTTPException): + code = "not_found" if exc.status_code == 404 else "invalid_request" + return error_response(request, exc.status_code, code, "Некорректный HTTP-запрос") + + @app.exception_handler(Exception) + async def unexpected_error(request: Request, exc: Exception): + logger.error(json.dumps({"event": "internal_error", "type": type(exc).__name__})) + return error_response(request, 500, "internal_error", "Внутренняя ошибка сервера") + + def service(request: Request) -> Messenger: + return request.app.state.messenger + + def token_digest(request: Request) -> bytes: + if len(request.headers.getlist("authorization")) != 1: + raise unauthorized() + return bearer_digest(request.headers.get("authorization")) + + def identity( + digest: Annotated[bytes, Depends(token_digest)], + ) -> Identity: + return authentication.identify(digest) + + def actor(current: Annotated[Identity, Depends(identity)]) -> User: + return current.user + + async def credentials(request: Request) -> tuple[str, str]: + if len(request.headers.getlist("authorization")) != 1: + raise unauthorized("Basic") + result = basic_credentials(request.headers.get("authorization")) + if await request.body(): + raise invalid("Вход не принимает тело запроса") + return result + + def resource_id(chat_id: str) -> str: + try: + return canonical_uuid(chat_id) + except ValueError: + raise invalid("Некорректный UUID чата") from None + + def pagination(request: Request) -> tuple[int, str | None]: + for key in ("limit", "cursor"): + if len(request.query_params.getlist(key)) > 1: + raise invalid("Параметр пагинации указан несколько раз") + raw = request.query_params.get("limit", "50") + try: + if not re.fullmatch(r"[0-9]+", raw): + raise ValueError + limit = int(raw) + if not 1 <= limit <= 100: + raise ValueError + except ValueError: + raise invalid("limit должен быть целым от 1 до 100") from None + return limit, request.query_params.get("cursor") + + def json_input(request: Request): + media = request.headers.get("content-type", "").split(";", 1)[0].strip().lower() + if media != "application/json": + raise DomainError(415, "unsupported_media_type", "Требуется application/json") + + def message_key(request: Request) -> str: + values = request.headers.getlist("idempotency-key") + if len(values) != 1 or not re.fullmatch(r"[A-Za-z0-9._:-]{1,128}", values[0]): + raise invalid("Требуется корректный Idempotency-Key") + return values[0] + + CurrentUser = Annotated[User, Depends(actor)] + Service = Annotated[Messenger, Depends(service)] + ChatId = Annotated[str, Depends(resource_id)] + Pagination = Annotated[tuple[int, str | None], Depends(pagination)] + + @app.get("/health/live") + def live(): + return {"status": "ok"} + + @app.get("/health/ready") + def ready(request: Request): + if not request.app.state.ready: + raise DomainError(503, "unavailable", "Приложение не готово") + repository.ready() + store.ready() + return {"status": "ok"} + + @app.post( + "/api/v1/users", + status_code=201, + response_model=UserView, + dependencies=[Depends(json_input)], + ) + def register(body: CreateUser): + return authentication.register(body.username, body.display_name, body.password) + + @app.post("/api/v1/auth/sessions", status_code=201, response_model=SessionView) + def login(value: Annotated[tuple[str, str], Depends(credentials)]): + return authentication.login(*value) + + @app.delete("/api/v1/auth/sessions/current", status_code=204) + def logout(current: Annotated[Identity, Depends(identity)]): + authentication.logout(current) + return Response(status_code=204) + + @app.get("/api/v1/users/me", response_model=UserView) + def me(current: CurrentUser): + return current + + @app.post( + "/api/v1/chats", + status_code=201, + response_model=ChatView, + dependencies=[Depends(json_input)], + ) + def create_chat(body: CreateChat, current: CurrentUser, messenger: Service): + return messenger.create_chat(current, body.title, body.member_ids) + + @app.get("/api/v1/chats", response_model=ChatPage) + def chats(current: CurrentUser, messenger: Service, page: Pagination): + return messenger.chats(current, *page) + + @app.get("/api/v1/chats/{chat_id}", response_model=ChatView) + def chat(current: CurrentUser, chat: ChatId, messenger: Service): + return messenger.chat(current, chat) + + @app.post( + "/api/v1/chats/{chat_id}/messages", + status_code=201, + response_model=MessageView, + dependencies=[Depends(json_input)], + ) + def send_message( + body: CreateMessage, + current: CurrentUser, + chat: ChatId, + messenger: Service, + key: Annotated[str, Depends(message_key)], + ): + return messenger.send(current, chat, body.text, key, tuple(body.attachment_ids)) + + @app.get("/api/v1/chats/{chat_id}/messages", response_model=MessagePage) + def messages(current: CurrentUser, chat: ChatId, messenger: Service, page: Pagination): + return messenger.messages(current, chat, *page) + + def attachment_id(attachment_id: str) -> str: + try: + return canonical_uuid(attachment_id) + except ValueError: + raise invalid("Некорректный UUID вложения") from None + + AttachmentId = Annotated[str, Depends(attachment_id)] + + @app.post("/api/v1/chats/{chat_id}/attachments", status_code=201, response_model=AttachmentView) + async def upload(request: Request, current: CurrentUser, chat: ChatId): + return await app.state.attachments.upload(request, current, chat) + + @app.get("/api/v1/attachments/{attachment_id}", response_model=AttachmentView) + def attachment(current: CurrentUser, id: AttachmentId): + return app.state.attachments.metadata(current, id) + + @app.get("/api/v1/attachments/{attachment_id}/content") + def content(request: Request, current: CurrentUser, id: AttachmentId): + row = app.state.attachments.record(current, id) + values = request.query_params.getlist("variant") + if len(values) > 1 or values and values[0] != "original": + raise invalid("Некорректный вариант вложения") + body = store.download(row) + + def chunks(): + try: + while data := body.read(65536): + yield data + finally: + body.close() + + return StreamingResponse( + chunks(), + media_type=row["content_type"], + headers={ + "Content-Length": str(row["size_bytes"]), + "Content-Disposition": "attachment; filename*=UTF-8''" + + quote(row["filename"], safe=""), + "Cache-Control": "private, no-store", + "X-Content-Type-Options": "nosniff", + }, + ) + + return app diff --git a/src/messenger/attachments.py b/src/messenger/attachments.py new file mode 100644 index 00000000..bc5d65c7 --- /dev/null +++ b/src/messenger/attachments.py @@ -0,0 +1,124 @@ +"""Bounded binary upload. Durable intent precedes S3; ready follows both stores.""" + +import asyncio +import hashlib +import tempfile +import unicodedata +import warnings + +from anyio import to_thread +from PIL import Image, UnidentifiedImageError +from starlette.requests import ClientDisconnect + +from messenger.domain import DomainError, invalid, new_id, not_found +from messenger.repository import attachment_value + +Image.MAX_IMAGE_PIXELS = 40_000_000 +warnings.filterwarnings("error", category=Image.DecompressionBombWarning) + + +def filename(value): + if ( + not value + or not value.strip() + or len(value) > 255 + or any(c in "/\\" or unicodedata.category(c).startswith("C") for c in value) + ): + raise invalid("Некорректное имя файла") + return value + + +def image_type(file, maximum): + try: + file.seek(0) + with Image.open(file) as image: + if image.width * image.height > maximum: + raise DomainError(413, "payload_too_large", "Слишком много пикселей") + if image.format not in ("PNG", "JPEG"): + raise ValueError + media = "image/png" if image.format == "PNG" else "image/jpeg" + image.verify() + file.seek(0) + with Image.open(file) as image: + image.load() # Reject truncated pixel streams, not just an intact header. + file.seek(0) + return media + except Image.DecompressionBombError, Image.DecompressionBombWarning: + raise DomainError(413, "payload_too_large", "Слишком много пикселей") from None + except UnidentifiedImageError, OSError, ValueError, SyntaxError: + raise DomainError(415, "unsupported_media_type", "Повреждённое изображение") from None + + +class Attachments: + def __init__(self, repository, messenger, store, settings): + self.repository, self.messenger, self.store = repository, messenger, store + self.settings = settings + self.slots = asyncio.Semaphore(settings.upload_slots) + + async def upload(self, request, actor, chat_id): + await to_thread.run_sync(self.messenger.chat, actor, chat_id) + values = request.query_params.getlist("filename") + if len(values) != 1: + raise invalid("Требуется одно имя файла") + name = filename(values[0]) + media = request.headers.get("content-type", "").split(";", 1)[0].strip().lower() + if media not in ("image/png", "image/jpeg"): + raise DomainError(415, "unsupported_media_type", "Требуется PNG или JPEG") + length = request.headers.get("content-length") + if length is not None: + if not length.isascii() or not length.isdecimal(): + raise invalid("Некорректный Content-Length") + if int(length) > self.settings.max_upload_bytes: + raise DomainError(413, "payload_too_large", "Файл больше 10 MiB") + try: + await asyncio.wait_for(self.slots.acquire(), timeout=5) + except TimeoutError: + raise DomainError(429, "rate_limited", "Слишком много загрузок") from None + try: + with tempfile.TemporaryFile() as file: + size, digest = 0, hashlib.sha256() + try: + async with asyncio.timeout(15): + async for chunk in request.stream(): + size += len(chunk) + if size > self.settings.max_upload_bytes: + raise DomainError(413, "payload_too_large", "Файл больше 10 MiB") + digest.update(chunk) + await to_thread.run_sync(file.write, chunk) + except TimeoutError: + raise DomainError(400, "invalid_request", "Время загрузки истекло") from None + except ClientDisconnect: + raise invalid("Загрузка прервана") from None + actual = await to_thread.run_sync(image_type, file, self.settings.max_image_pixels) + if actual != media: + raise DomainError(415, "unsupported_media_type", "MIME не совпадает с файлом") + id = new_id() + row = await to_thread.run_sync( + self.repository.begin_attachment, + id, + chat_id, + actor.id, + name, + actual, + size, + digest.hexdigest(), + ) + # Leave the committed intent on every ambiguous failure. Reconciler owns recovery. + await to_thread.run_sync( + self.store.put, row["object_key"], file, size, actual, digest.hexdigest() + ) + return await to_thread.run_sync(self.repository.finish_attachment, id) + finally: + self.slots.release() + + def record(self, actor, id): + row = self.repository.attachment(id) + if row is None: + raise not_found() + self.messenger.chat(actor, str(row["chat_id"])) + if row["storage_state"] != "ready": + raise DomainError(409, "conflict", "Вложение пока недоступно") + return row + + def metadata(self, actor, id): + return attachment_value(self.record(actor, id)) diff --git a/src/messenger/auth.py b/src/messenger/auth.py new file mode 100644 index 00000000..33a01374 --- /dev/null +++ b/src/messenger/auth.py @@ -0,0 +1,127 @@ +"""Argon2id passwords and opaque sessions. Cache hits never authorize a request.""" + +import base64 +import binascii +import hashlib +import re +import secrets +from contextlib import contextmanager +from dataclasses import dataclass +from threading import BoundedSemaphore + +from argon2 import PasswordHasher +from argon2.exceptions import InvalidHashError, VerificationError +from argon2.profiles import RFC_9106_LOW_MEMORY + +from messenger.cache import SessionCache +from messenger.domain import DomainError, User +from messenger.repository import PostgresRepository + + +def unauthorized(scheme: str = "Bearer") -> DomainError: + challenge = scheme + ' realm="messenger"' + if scheme == "Basic": + challenge += ', charset="UTF-8"' + return DomainError( + 401, + "unauthorized", + "Требуется действительная идентификация", + {"WWW-Authenticate": challenge}, + ) + + +def basic_credentials(header: str | None) -> tuple[str, str]: + try: + if header is None or len(header) > 2048: + raise ValueError + scheme, encoded = header.split(" ", 1) + if scheme.lower() != "basic": + raise ValueError + raw = base64.b64decode(encoded, validate=True).decode("utf-8") + username, password = raw.split(":", 1) + if not re.fullmatch(r"[a-z0-9_]{3,32}", username): + raise ValueError + if not 12 <= len(password) <= 128 or not password.strip(): + raise ValueError + return username, password + except ValueError, UnicodeError, binascii.Error: + raise unauthorized("Basic") from None + + +def bearer_digest(header: str | None) -> bytes: + if header: + parts = header.split(" ") + if len(parts) == 2 and parts[0].lower() == "bearer": + if re.fullmatch(r"[A-Za-z0-9_-]{43}", parts[1]): + return hashlib.sha256(parts[1].encode()).digest() + raise unauthorized() + + +@dataclass(frozen=True) +class Identity: + user: User + token_hash: bytes + + +@dataclass(frozen=True) +class Session: + token: str + token_type: str + expires_at: str + user: User + + +class AuthService: + def __init__(self, repository: PostgresRepository, cache: SessionCache, ttl: int): + self.repository, self.cache, self.ttl = repository, cache, ttl + self.hasher = PasswordHasher.from_parameters(RFC_9106_LOW_MEMORY) + self.kdf_slots = BoundedSemaphore(2) + self.dummy_hash = self.hasher.hash(secrets.token_urlsafe(32)) + + @contextmanager + def kdf(self): + if not self.kdf_slots.acquire(timeout=0.5): + raise DomainError(503, "unavailable", "Обработка пароля временно занята") + try: + yield + finally: + self.kdf_slots.release() + + def register(self, username: str, display_name: str, password: str) -> User: + with self.kdf(): + encoded = self.hasher.hash(password) + return self.repository.add_user(username, display_name, encoded) + + def login(self, username: str, password: str) -> Session: + credentials = self.repository.credentials(username) + encoded = credentials[1] if credentials else self.dummy_hash + try: + with self.kdf(): + self.hasher.verify(encoded, password) + except VerificationError, InvalidHashError: + raise unauthorized("Basic") from None + if credentials is None: + raise unauthorized("Basic") + token = secrets.token_urlsafe(32) + digest = hashlib.sha256(token.encode()).digest() + user = credentials[0] + expires = self.repository.create_session(digest, user.id, self.ttl) + return Session(token, "Bearer", expires, user) + + def identify(self, digest: bytes) -> Identity: + session = self.repository.active_session(digest) + if session is None: + raise unauthorized() + user_id = str(session["user_id"]) + user = self.cache.get(digest, user_id) + if user is None: + user = self.repository.get_user(user_id) + if user is None: + raise unauthorized() + ttl = int((session["expires_at"] - session["checked_at"]).total_seconds()) + self.cache.put(digest, user, ttl) + return Identity(user, digest) + + def logout(self, identity: Identity): + self.repository.revoke_session(identity.token_hash) + self.cache.delete(identity.token_hash) diff --git a/src/messenger/cache.py b/src/messenger/cache.py new file mode 100644 index 00000000..73003350 --- /dev/null +++ b/src/messenger/cache.py @@ -0,0 +1,57 @@ +"""Disposable session-user cache; PostgreSQL always decides token validity.""" + +import json +import logging +from dataclasses import asdict + +from redis import Redis +from redis.backoff import NoBackoff +from redis.exceptions import RedisError +from redis.retry import Retry + +from messenger.domain import User + +logger = logging.getLogger("messenger") + + +class SessionCache: + def __init__(self, url: str): + self.client = Redis.from_url( + url, + socket_connect_timeout=0.2, + socket_timeout=0.2, + max_connections=8, + decode_responses=True, + retry_on_timeout=False, + retry=Retry(NoBackoff(), 0), + ) + + @staticmethod + def key(digest: bytes) -> str: + return "session-user:" + digest.hex() + + def get(self, digest: bytes, user_id: str) -> User | None: + try: + raw = self.client.get(self.key(digest)) + if raw: + value = User(**json.loads(raw)) + if value.id == user_id: + return value + except RedisError, ValueError, TypeError: + logger.warning('{"event":"session_cache_unavailable","operation":"get"}') + return None + + def put(self, digest: bytes, user: User, ttl: int): + try: + self.client.set(self.key(digest), json.dumps(asdict(user)), ex=max(1, ttl)) + except RedisError: + logger.warning('{"event":"session_cache_unavailable","operation":"set"}') + + def delete(self, digest: bytes): + try: + self.client.delete(self.key(digest)) + except RedisError: + logger.warning('{"event":"session_cache_unavailable","operation":"delete"}') + + def close(self): + self.client.close() diff --git a/src/messenger/cursor.py b/src/messenger/cursor.py new file mode 100644 index 00000000..a4f00b55 --- /dev/null +++ b/src/messenger/cursor.py @@ -0,0 +1,41 @@ +"""Versioned keyset position, bound to a list and its resource, never an offset.""" + +import base64 +import binascii +import json +from datetime import UTC, datetime +from uuid import UUID + +from messenger.domain import HistoryKey, invalid + + +def encode_cursor(scope: str, position: HistoryKey) -> str: + value = {"v": 1, "scope": scope, "created_at": position[0], "id": position[1]} + return ( + base64.urlsafe_b64encode(json.dumps(value, separators=(",", ":")).encode()) + .decode() + .rstrip("=") + ) + + +def decode_cursor(value: str | None, scope: str) -> HistoryKey | None: + if value is None: + return None + try: + if not value or len(value) > 1024: + raise ValueError + raw = base64.b64decode(value + "=" * (-len(value) % 4), altchars=b"-_", validate=True) + data = json.loads(raw) + if not isinstance(data, dict) or set(data) != {"v", "scope", "created_at", "id"}: + raise ValueError + if type(data["v"]) is not int or data["v"] != 1 or data["scope"] != scope: + raise ValueError + if not isinstance(data["created_at"], str) or not data["created_at"].endswith("Z"): + raise ValueError + stamp = datetime.fromisoformat(data["created_at"]) + if stamp.tzinfo != UTC or not isinstance(data["id"], str): + raise ValueError + identity = str(UUID(data["id"])) + return stamp.isoformat(timespec="microseconds").replace("+00:00", "Z"), identity + except ValueError, TypeError, KeyError, UnicodeError, binascii.Error: + raise invalid("Некорректный cursor или другая область пагинации") from None diff --git a/src/messenger/domain.py b/src/messenger/domain.py new file mode 100644 index 00000000..0b8ece23 --- /dev/null +++ b/src/messenger/domain.py @@ -0,0 +1,79 @@ +"""Immutable domain values; no dependency on HTTP or a storage technology.""" + +from dataclasses import dataclass +from datetime import UTC, datetime +from uuid import uuid4 + + +def utc_now() -> str: + return datetime.now(UTC).isoformat(timespec="microseconds").replace("+00:00", "Z") + + +def new_id() -> str: + return str(uuid4()) + + +class DomainError(Exception): + def __init__(self, status: int, code: str, message: str, headers: dict | None = None): + super().__init__(message) + self.status = status + self.code = code + self.message = message + self.headers = headers or {} + + +def invalid(message: str = "Некорректный запрос") -> DomainError: + return DomainError(400, "invalid_request", message) + + +def not_found() -> DomainError: + return DomainError(404, "not_found", "Объект не найден") + + +@dataclass(frozen=True, slots=True) +class User: + id: str + username: str + display_name: str + created_at: str + + +@dataclass(frozen=True, slots=True) +class Chat: + id: str + title: str + member_ids: tuple[str, ...] + created_at: str + + +@dataclass(frozen=True, slots=True) +class Message: + id: str + chat_id: str + sender_id: str + text: str + created_at: str + attachment_ids: tuple[str, ...] = () + + +@dataclass(frozen=True, slots=True) +class Attachment: + id: str + chat_id: str + owner_id: str + filename: str + content_type: str + size_bytes: int + sha256: str + created_at: str + updated_at: str + status: str = "ready" + variants: tuple = () + error_code: str | None = None + + +type HistoryKey = tuple[str, str] + + +def history_key(item: Chat | Message) -> HistoryKey: + return item.created_at, item.id diff --git a/src/messenger/migrate.py b/src/messenger/migrate.py new file mode 100644 index 00000000..a0807a01 --- /dev/null +++ b/src/messenger/migrate.py @@ -0,0 +1,46 @@ +"""Transactional, checksummed migrations, serialized across concurrent starts.""" + +import hashlib +import os +from pathlib import Path + +import psycopg + +from messenger.settings import secret + + +def migrate(conninfo: str, directory: Path): + with psycopg.connect(conninfo, connect_timeout=5) as conn: + conn.execute("SELECT pg_advisory_xact_lock(2301002)") + conn.execute( + "CREATE TABLE IF NOT EXISTS schema_migrations (" + "version text PRIMARY KEY, checksum text NOT NULL, " + "applied_at timestamptz NOT NULL DEFAULT clock_timestamp())" + ) + for path in sorted(directory.glob("*.sql")): + content = path.read_text() + checksum = hashlib.sha256(content.encode()).hexdigest() + current = conn.execute( + "SELECT checksum FROM schema_migrations WHERE version=%s", (path.stem,) + ).fetchone() + if current: + if current[0] != checksum: + raise RuntimeError("Applied migration checksum changed: " + path.stem) + continue + conn.execute(content) + conn.execute( + "INSERT INTO schema_migrations (version,checksum) VALUES (%s,%s)", + (path.stem, checksum), + ) + print("Applied migration " + path.stem) + + +def main(): + migrate( + secret("DATABASE_URL_FILE", "/run/secrets/database_url"), + Path(os.getenv("MIGRATIONS_DIR", "/app/migrations")), + ) + + +if __name__ == "__main__": + main() diff --git a/src/messenger/reconcile.py b/src/messenger/reconcile.py new file mode 100644 index 00000000..b9e22cfa --- /dev/null +++ b/src/messenger/reconcile.py @@ -0,0 +1,207 @@ +"""Conservative, repeatable PG/S3 reconciliation. Dry-run is the default.""" + +import argparse +import json +import re +from collections import Counter +from datetime import timedelta +from time import perf_counter + +import psycopg +from psycopg.rows import dict_row + +from messenger.settings import Settings +from messenger.storage import ObjectStore + +OWNED = re.compile(r"originals/[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\Z") + + +class Reconciler: + def __init__(self, conn, store, *, apply=False, grace=300): + if grace < 300: + raise ValueError("Minimum grace period is 300 seconds") + self.conn, self.store, self.apply, self.grace = conn, store, apply, grace + self.counts, self.actions = Counter(), [] + + def action(self, kind, id): + self.counts[kind] += 1 + if len(self.actions) < 100: + self.actions.append({"action": kind, "id": str(id)}) + + def head(self, key): + self.counts["s3_head"] += 1 + return self.store.head(key) + + def objects(self, cutoff): + paginator = self.store.client.get_paginator("list_objects_v2") + for page in paginator.paginate( + Bucket=self.store.bucket, Prefix="originals/", PaginationConfig={"PageSize": 1000} + ): + self.counts["s3_list_pages"] += 1 + for item in page.get("Contents", []): + self.counts["s3_objects"] += 1 + key = item["Key"] + if not OWNED.fullmatch(key): + self.counts["foreign_keys_ignored"] += 1 + continue + if item["LastModified"] >= cutoff: + self.counts["fresh_objects_skipped"] += 1 + continue + with self.conn.transaction(): + existing = self.conn.execute( + "SELECT id FROM attachments WHERE object_key=%s FOR UPDATE", + (key,), + ).fetchone() + if existing: + continue + # Re-check immutable generation/age immediately before deleting an orphan. + current = self.head(key) + if ( + current is None + or current["LastModified"] >= cutoff + or current["ETag"] != item["ETag"] + or current["ContentLength"] != item["Size"] + ): + continue + self.action("delete_orphan", key.removeprefix("originals/")) + if self.apply: + self.store.client.delete_object(Bucket=self.store.bucket, Key=key) + self.counts["s3_delete"] += 1 + + @staticmethod + def matches(row, head): + return ( + head is not None + and head["ContentLength"] == row["size_bytes"] + and head.get("ContentType") == row["content_type"] + and head.get("Metadata", {}).get("sha256") == row["sha256"] + ) + + def metadata(self, cutoff): + last = "00000000-0000-0000-0000-000000000000" + while True: + batch = self.conn.execute( + "SELECT id FROM attachments WHERE id>%s::uuid ORDER BY id LIMIT 100", + (last,), + ).fetchall() + self.counts["pg_metadata_pages"] += 1 + if not batch: + break + for value in batch: + id = value["id"] + last = str(id) + self.counts["pg_attachments"] += 1 + with self.conn.transaction(): + row = self.conn.execute( + "SELECT * FROM attachments WHERE id=%s FOR UPDATE", (id,) + ).fetchone() + if row is None: + continue + state = row["storage_state"] + if row["updated_at"] >= cutoff and state != "missing": + self.counts["fresh_metadata_skipped"] += 1 + continue + head = self.head(row["object_key"]) + valid = self.matches(row, head) + if state == "pending" and head is None: + used = self.conn.execute( + "SELECT 1 FROM message_attachments WHERE attachment_id=%s LIMIT 1", + (id,), + ).fetchone() + if used: + self.action("review_used_pending", id) + continue + self.action("delete_abandoned_intent", id) + if self.apply: + self.conn.execute("DELETE FROM attachments WHERE id=%s", (id,)) + elif state in ("pending", "missing") and valid: + self.action("restore_ready", id) + if self.apply: + self.conn.execute( + "UPDATE attachments SET storage_state='ready'," + "updated_at=clock_timestamp() WHERE id=%s", + (id,), + ) + elif state == "ready" and not valid: + self.action("mark_missing", id) + if self.apply: + self.conn.execute( + "UPDATE attachments SET storage_state='missing'," + "updated_at=clock_timestamp() WHERE id=%s", + (id,), + ) + elif state == "pending" and not valid: + self.action("review_invalid_pending", id) + elif state == "missing": + self.counts["still_missing"] += 1 + else: + self.counts["ready_preserved"] += 1 + + def run(self): + started = perf_counter() + if not self.conn.execute("SELECT pg_try_advisory_lock(2301004) AS locked").fetchone()[ + "locked" + ]: + raise RuntimeError("Another reconciler is active") + try: + cutoff = self.conn.execute("SELECT clock_timestamp() AS now").fetchone()["now"] + cutoff -= timedelta(seconds=self.grace) + self.store.ready() # Permission/network errors are never interpreted as missing bytes. + self.objects(cutoff) + self.metadata(cutoff) + return { + "mode": "apply" if self.apply else "dry-run", + "grace_seconds": self.grace, + "elapsed_seconds": perf_counter() - started, + "counts": dict(self.counts), + "actions": self.actions, + "actions_preview_limit": 100, + } + finally: + self.conn.execute("SELECT pg_advisory_unlock(2301004)") + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--apply", action="store_true") + parser.add_argument("--grace-seconds", type=int, default=300) + args = parser.parse_args() + if args.grace_seconds < 300: + parser.error("Grace period must be at least 300 seconds") + store = None + try: + settings = Settings.from_env() + store = ObjectStore(settings) + with psycopg.connect( + settings.database_url, + autocommit=True, + row_factory=dict_row, + connect_timeout=2, + options="-c lock_timeout=1000 " + "-c statement_timeout=2500 -c idle_in_transaction_session_timeout=5000 " + "-c timezone=UTC", + ) as conn: + print( + json.dumps( + Reconciler(conn, store, apply=args.apply, grace=args.grace_seconds).run(), + ensure_ascii=False, + ) + ) + except Exception as exc: + print( + json.dumps( + { + "error": "reconciliation_incomplete", + "type": type(exc).__name__, + "changes_may_have_committed": args.apply, + } + ) + ) + raise SystemExit(1) from None + finally: + if store: + store.close() + + +if __name__ == "__main__": + main() diff --git a/src/messenger/repository.py b/src/messenger/repository.py new file mode 100644 index 00000000..b6c53e01 --- /dev/null +++ b/src/messenger/repository.py @@ -0,0 +1,353 @@ +"""PostgreSQL adapter: bounded connections, parameterized SQL, commit before return.""" + +import hashlib +import json +from contextlib import contextmanager, nullcontext +from datetime import datetime +from typing import Protocol + +import psycopg +from psycopg import errors +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool, PoolTimeout, TooManyRequests + +from messenger.domain import ( + Attachment, + Chat, + DomainError, + HistoryKey, + Message, + User, + invalid, + new_id, +) + + +def stamp(value: datetime) -> str: + return value.isoformat(timespec="microseconds").replace("+00:00", "Z") + + +def user_value(row) -> User: + return User(str(row["id"]), row["username"], row["display_name"], stamp(row["created_at"])) + + +def chat_value(row) -> Chat: + return Chat( + str(row["id"]), + row["title"], + tuple(str(x) for x in row["member_ids"]), + stamp(row["created_at"]), + ) + + +def message_value(row) -> Message: + return Message( + str(row["id"]), + str(row["chat_id"]), + str(row["sender_id"]), + row["text"], + stamp(row["created_at"]), + tuple(str(x) for x in row.get("attachment_ids", ())), + ) + + +def attachment_value(row) -> Attachment: + return Attachment( + *(str(row[k]) for k in ("id", "chat_id", "owner_id")), + row["filename"], + row["content_type"], + row["size_bytes"], + row["sha256"], + stamp(row["created_at"]), + stamp(row["updated_at"]), + ) + + +class Repository(Protocol): + def get_user(self, user_id: str) -> User | None: ... + def add_chat(self, title: str, member_ids: tuple[str, ...]) -> Chat: ... + def get_chat(self, chat_id: str) -> Chat | None: ... + def page_chats(self, user_id: str, after: HistoryKey | None, limit: int) -> list[Chat]: ... + def add_message(self, chat_id: str, sender_id: str, text: str) -> Message: ... + def idempotent_message( + self, + chat_id: str, + sender_id: str, + text: str, + key: str, + attachment_ids: tuple[str, ...] = (), + ) -> Message: ... + def page_messages( + self, chat_id: str, after: HistoryKey | None, limit: int + ) -> list[Message]: ... + + +CHAT_COLUMNS = """c.id, c.title, c.created_at, + ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY position) AS member_ids""" + + +MESSAGE_COLUMNS = """m.*, ARRAY(SELECT attachment_id FROM message_attachments + WHERE message_id=m.id ORDER BY position) AS attachment_ids""" + + +class PostgresRepository: + def __init__( + self, + conninfo: str, + pool_size: int = 8, + idempotency_ttl: int = 86400, + read_autocommit: bool = True, + ): + self.read_autocommit = read_autocommit + self.idempotency_ttl = idempotency_ttl + self.pool = ConnectionPool( + conninfo, + min_size=1, + max_size=pool_size, + timeout=1, + max_waiting=32, + open=False, + check=ConnectionPool.check_connection, + kwargs={ + "row_factory": dict_row, + "autocommit": True, + "connect_timeout": 2, + "options": "-c statement_timeout=2500 -c lock_timeout=1000 " + "-c idle_in_transaction_session_timeout=5000 -c timezone=UTC", + }, + ) + + def open(self): + self.pool.open(wait=True, timeout=15) + + def close(self): + self.pool.close(timeout=5) + + @contextmanager + def connection(self, *, write: bool = False): + try: + with self.pool.connection() as conn: + transaction = ( + conn.transaction() if write or not self.read_autocommit else nullcontext() + ) + with transaction: + yield conn + except ( + psycopg.OperationalError, + psycopg.InterfaceError, + PoolTimeout, + TooManyRequests, + errors.QueryCanceled, + errors.LockNotAvailable, + ): + raise DomainError(503, "unavailable", "Хранилище временно недоступно") from None + + def ready(self): + with self.connection() as conn: + row = conn.execute( + "SELECT count(*) AS n FROM schema_migrations " + "WHERE version IN ('001_initial','002_idempotency','003_attachments')" + ).fetchone() + if row["n"] != 3: + raise DomainError(503, "unavailable", "Схема ещё не готова") + + def add_user(self, username: str, display_name: str, password_hash: str) -> User: + try: + with self.connection(write=True) as conn: + row = conn.execute( + "INSERT INTO users (id,username,display_name,password_hash) " + "VALUES (%s,%s,%s,%s) RETURNING *", + (new_id(), username, display_name, password_hash), + ).fetchone() + return user_value(row) + except errors.UniqueViolation: + raise DomainError(409, "conflict", "Имя пользователя уже занято") from None + + def credentials(self, username: str): + with self.connection() as conn: + row = conn.execute("SELECT * FROM users WHERE username=%s", (username,)).fetchone() + return (user_value(row), row["password_hash"]) if row else None + + def get_user(self, user_id: str) -> User | None: + with self.connection() as conn: + row = conn.execute("SELECT * FROM users WHERE id=%s", (user_id,)).fetchone() + return user_value(row) if row else None + + def add_chat(self, title: str, member_ids: tuple[str, ...]) -> Chat: + try: + with self.connection(write=True) as conn: + row = conn.execute( + "INSERT INTO chats (id,title) VALUES (%s,%s) RETURNING *", (new_id(), title) + ).fetchone() + with conn.cursor() as cur: + cur.executemany( + "INSERT INTO chat_members (chat_id,user_id,position) VALUES (%s,%s,%s)", + [(row["id"], member, i) for i, member in enumerate(member_ids)], + ) + return Chat(str(row["id"]), title, member_ids, stamp(row["created_at"])) + except errors.ForeignKeyViolation: + raise invalid("Указан неизвестный участник") from None + + def get_chat(self, chat_id: str) -> Chat | None: + with self.connection() as conn: + row = conn.execute( + "SELECT " + CHAT_COLUMNS + " FROM chats c WHERE c.id=%s", (chat_id,) + ).fetchone() + return chat_value(row) if row else None + + def page_chats(self, user_id: str, after: HistoryKey | None, limit: int) -> list[Chat]: + condition = " AND (c.created_at,c.id) > (%s::timestamptz,%s::uuid)" if after else "" + params = (user_id, *after, limit) if after else (user_id, limit) + with self.connection() as conn: + rows = conn.execute( + "SELECT " + CHAT_COLUMNS + " FROM chats c WHERE EXISTS " + "(SELECT 1 FROM chat_members m WHERE m.chat_id=c.id AND m.user_id=%s)" + + condition + + " ORDER BY c.created_at,c.id LIMIT %s", + params, + ).fetchall() + return [chat_value(row) for row in rows] + + def add_message(self, chat_id: str, sender_id: str, text: str) -> Message: + with self.connection(write=True) as conn: + row = conn.execute( + "INSERT INTO messages (id,chat_id,sender_id,text) VALUES (%s,%s,%s,%s) RETURNING *", + (new_id(), chat_id, sender_id, text), + ).fetchone() + return message_value(row) + + def page_messages(self, chat_id: str, after: HistoryKey | None, limit: int) -> list[Message]: + condition = " AND (m.created_at,m.id) > (%s::timestamptz,%s::uuid)" if after else "" + params = (chat_id, *after, limit) if after else (chat_id, limit) + with self.connection() as conn: + rows = conn.execute( + "SELECT " + + MESSAGE_COLUMNS + + " FROM messages m WHERE m.chat_id=%s" + + condition + + " ORDER BY m.created_at,m.id LIMIT %s", + params, + ).fetchall() + return [message_value(row) for row in rows] + + def idempotent_message( + self, + chat_id: str, + sender_id: str, + text: str, + key: str, + attachment_ids: tuple[str, ...] = (), + ) -> Message: + scope = json.dumps([sender_id, "POST", chat_id, key], separators=(",", ":")) + lock = int.from_bytes(hashlib.sha256(scope.encode()).digest()[:8], "big", signed=True) + payload = json.dumps( + {"text": text, "attachment_ids": list(attachment_ids)}, + sort_keys=True, + separators=(",", ":"), + ensure_ascii=False, + ) + digest = hashlib.sha256(payload.encode()).digest() + with self.connection(write=True) as conn: + conn.execute("SELECT pg_advisory_xact_lock(%s)", (lock,)) + previous = conn.execute( + "SELECT r.payload_hash," + MESSAGE_COLUMNS + " FROM message_requests r " + "JOIN messages m ON m.id=r.response_message_id " + "WHERE r.user_id=%s AND r.http_method='POST' AND r.chat_id=%s " + "AND r.idempotency_key=%s AND r.expires_at > clock_timestamp()", + (sender_id, chat_id, key), + ).fetchone() + if previous: + if previous["payload_hash"] != digest: + raise DomainError(409, "conflict", "Ключ уже использован с другим сообщением") + return message_value(previous) + conn.execute( + "DELETE FROM message_requests WHERE user_id=%s AND http_method='POST' " + "AND chat_id=%s AND idempotency_key=%s", + (sender_id, chat_id, key), + ) + if attachment_ids: + rows = conn.execute( + "SELECT id,storage_state FROM attachments WHERE chat_id=%s " + "AND id=ANY(%s::uuid[]) ORDER BY id FOR UPDATE", + (chat_id, list(attachment_ids)), + ).fetchall() + if len(rows) != len(attachment_ids): + raise DomainError(404, "not_found", "Объект не найден") + if any(row["storage_state"] != "ready" for row in rows): + raise DomainError(409, "conflict", "Вложение пока недоступно") + message = message_value( + conn.execute( + "INSERT INTO messages (id,chat_id,sender_id,text) " + "VALUES (%s,%s,%s,%s) RETURNING *", + (new_id(), chat_id, sender_id, text), + ).fetchone() + ) + for position, attachment in enumerate(attachment_ids): + conn.execute( + "INSERT INTO message_attachments VALUES (%s,%s,%s,%s)", + (message.id, chat_id, attachment, position), + ) + message = Message( + message.id, + message.chat_id, + message.sender_id, + message.text, + message.created_at, + attachment_ids, + ) + self._save_request(conn, sender_id, chat_id, key, digest, message.id) + return message + + def _save_request(self, conn, user_id, chat_id, key, digest, message_id): + conn.execute( + "INSERT INTO message_requests " + "(user_id,chat_id,idempotency_key,payload_hash,response_message_id,expires_at) " + "VALUES (%s,%s,%s,%s,%s,clock_timestamp()+make_interval(secs => %s))", + (user_id, chat_id, key, digest, message_id, self.idempotency_ttl), + ) + + def create_session(self, token_hash: bytes, user_id: str, ttl: int) -> str: + with self.connection(write=True) as conn: + row = conn.execute( + "INSERT INTO sessions (token_hash,user_id,expires_at) " + "VALUES (%s,%s,clock_timestamp() + make_interval(secs => %s)) RETURNING expires_at", + (token_hash, user_id, ttl), + ).fetchone() + return stamp(row["expires_at"]) + + def active_session(self, token_hash: bytes): + with self.connection() as conn: + return conn.execute( + "SELECT user_id,expires_at,clock_timestamp() AS checked_at FROM sessions " + "WHERE token_hash=%s AND expires_at > clock_timestamp()", + (token_hash,), + ).fetchone() + + def revoke_session(self, token_hash: bytes): + with self.connection(write=True) as conn: + conn.execute("DELETE FROM sessions WHERE token_hash=%s", (token_hash,)) + + def begin_attachment(self, id, chat_id, owner_id, filename, content_type, size, digest): + with self.connection(write=True) as conn: + return conn.execute( + "INSERT INTO attachments " + "(id,chat_id,owner_id,filename,content_type,size_bytes,sha256," + "object_key,storage_state) " + "VALUES (%s,%s,%s,%s,%s,%s,%s,%s,'pending') RETURNING *", + (id, chat_id, owner_id, filename, content_type, size, digest, "originals/" + id), + ).fetchone() + + def finish_attachment(self, id): + with self.connection(write=True) as conn: + row = conn.execute( + "UPDATE attachments SET storage_state='ready',updated_at=clock_timestamp() " + "WHERE id=%s AND storage_state='pending' RETURNING *", + (id,), + ).fetchone() + if not row: + raise DomainError(503, "unavailable", "Загрузка не завершена") + return attachment_value(row) + + def attachment(self, id): + with self.connection() as conn: + return conn.execute("SELECT * FROM attachments WHERE id=%s", (id,)).fetchone() diff --git a/src/messenger/schemas.py b/src/messenger/schemas.py new file mode 100644 index 00000000..9331315c --- /dev/null +++ b/src/messenger/schemas.py @@ -0,0 +1,120 @@ +"""Strict lab 4 wire types; password never belongs to a response User.""" + +import re +from typing import Annotated +from uuid import UUID + +from pydantic import AfterValidator, BaseModel, ConfigDict, Field, field_validator, model_validator + + +def canonical_uuid(value: str) -> str: + if not re.fullmatch(r"[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}", value): + raise ValueError("Ожидается UUID") + return str(UUID(value)) + + +def nonblank(value: str) -> str: + if not value.strip() or any(0xD800 <= ord(char) <= 0xDFFF for char in value): + raise ValueError("Ожидается непустая строка Unicode") + return value + + +type Identifier = Annotated[str, AfterValidator(canonical_uuid)] +type ShortText = Annotated[str, Field(min_length=1, max_length=100), AfterValidator(nonblank)] + + +class Input(BaseModel): + model_config = ConfigDict(strict=True, extra="forbid") + + +class CreateUser(Input): + username: str = Field(min_length=3, max_length=32) + display_name: ShortText + password: Annotated[str, Field(min_length=12, max_length=128), AfterValidator(nonblank)] + + @field_validator("username") + @classmethod + def valid_username(cls, value: str) -> str: + if not re.fullmatch(r"[a-z0-9_]{3,32}", value): + raise ValueError("Недопустимое имя пользователя") + return value + + +class CreateChat(Input): + title: ShortText + member_ids: list[Identifier] = Field(min_length=1, max_length=100) + + +class CreateMessage(Input): + text: str = Field(max_length=4000) + attachment_ids: list[Identifier] = Field(default_factory=list, max_length=10) + + @model_validator(mode="after") + def valid_content(self): + if ( + not self.text.strip() + and not self.attachment_ids + or any(0xD800 <= ord(c) <= 0xDFFF for c in self.text) + or len(set(self.attachment_ids)) != len(self.attachment_ids) + ): + raise ValueError("Некорректное содержимое сообщения") + return self + + +class View(BaseModel): + model_config = ConfigDict(from_attributes=True, extra="forbid") + + +class UserView(View): + id: str + username: str + display_name: str + created_at: str + + +class SessionView(View): + token: str + token_type: str + expires_at: str + user: UserView + + +class ChatView(View): + id: str + title: str + member_ids: list[str] + created_at: str + + +class MessageView(View): + attachment_ids: list[str] + id: str + chat_id: str + sender_id: str + text: str + created_at: str + + +class ChatPage(View): + items: list[ChatView] + next_cursor: str | None + + +class MessagePage(View): + items: list[MessageView] + next_cursor: str | None + + +class AttachmentView(View): + id: str + chat_id: str + owner_id: str + filename: str + content_type: str + size_bytes: int + sha256: str + status: str + variants: list + error_code: str | None + created_at: str + updated_at: str diff --git a/src/messenger/service.py b/src/messenger/service.py new file mode 100644 index 00000000..614fcb47 --- /dev/null +++ b/src/messenger/service.py @@ -0,0 +1,52 @@ +"""Use cases shared by HTTP and tests. Authorization precedes resource access.""" + +from dataclasses import dataclass + +from messenger.cursor import decode_cursor, encode_cursor +from messenger.domain import Chat, Message, User, history_key, invalid, not_found +from messenger.repository import Repository + + +@dataclass(frozen=True) +class Page[T]: + items: list[T] + next_cursor: str | None + + +class Messenger: + def __init__(self, repository: Repository): + self.repository = repository + + def create_chat(self, actor: User, title: str, member_ids: list[str]) -> Chat: + if len(member_ids) != len(set(member_ids)) or actor.id not in member_ids: + raise invalid("Участники не должны повторяться; вызывающий должен входить в чат") + return self.repository.add_chat(title, tuple(member_ids)) + + def chat(self, actor: User, chat_id: str) -> Chat: + chat = self.repository.get_chat(chat_id) + if chat is None or actor.id not in chat.member_ids: + raise not_found() + return chat + + def chats(self, actor: User, limit: int, cursor: str | None) -> Page[Chat]: + scope = "chats:" + actor.id + after = decode_cursor(cursor, scope) + return self._page(self.repository.page_chats(actor.id, after, limit + 1), limit, scope) + + def send( + self, actor: User, chat_id: str, text: str, key: str, attachments: tuple[str, ...] = () + ) -> Message: + self.chat(actor, chat_id) + return self.repository.idempotent_message(chat_id, actor.id, text, key, attachments) + + def messages(self, actor: User, chat_id: str, limit: int, cursor: str | None) -> Page[Message]: + self.chat(actor, chat_id) + scope = "messages:" + chat_id + after = decode_cursor(cursor, scope) + return self._page(self.repository.page_messages(chat_id, after, limit + 1), limit, scope) + + @staticmethod + def _page[T: Chat | Message](items: list[T], limit: int, scope: str) -> Page[T]: + visible = items[:limit] + cursor = encode_cursor(scope, history_key(visible[-1])) if len(items) > limit else None + return Page(visible, cursor) diff --git a/src/messenger/settings.py b/src/messenger/settings.py new file mode 100644 index 00000000..27c593f5 --- /dev/null +++ b/src/messenger/settings.py @@ -0,0 +1,57 @@ +"""Explicit configuration; credentials are read from untracked secret files.""" + +import os +from dataclasses import dataclass, field +from pathlib import Path + + +def secret(name: str, default: str) -> str: + return Path(os.getenv(name, default)).read_text().strip() + + +@dataclass(frozen=True) +class Settings: + database_url: str = field(repr=False) + cache_url: str = field(repr=False) + session_ttl: int = 3600 + pool_size: int = 8 + idempotency_ttl: int = 86400 + read_autocommit: bool = True + + s3_endpoint: str = "http://127.0.0.1:59004" + s3_region: str = "us-east-1" + s3_bucket: str = "messenger-attachments" + s3_access_key: str = field(default="", repr=False) + s3_secret_key: str = field(default="", repr=False) + max_upload_bytes: int = 10485760 + max_image_pixels: int = 40000000 + upload_slots: int = 1 + + @classmethod + def from_env(cls): + ttl = int(os.getenv("SESSION_TTL_SECONDS", "3600")) + size = int(os.getenv("DATABASE_POOL_SIZE", "8")) + idempotency_ttl = int(os.getenv("IDEMPOTENCY_TTL_SECONDS", "86400")) + if idempotency_ttl < 86400: + raise ValueError("Idempotency retention must be at least 24 hours") + if not 1 <= ttl <= 2_592_000 or not 1 <= size <= 32: + raise ValueError("Invalid session lifetime or connection pool size") + maximum = int(os.getenv("MAX_UPLOAD_BYTES", "10485760")) + pixels = int(os.getenv("MAX_IMAGE_PIXELS", "40000000")) + if not 1 <= maximum <= 10485760 or not 1 <= pixels <= 40000000: + raise ValueError("Invalid upload limits") + return cls( + secret("DATABASE_URL_FILE", "/run/secrets/database_url"), + secret("CACHE_URL_FILE", "/run/secrets/cache_url"), + ttl, + size, + idempotency_ttl, + os.getenv("DATABASE_READ_AUTOCOMMIT", "1") == "1", + os.getenv("S3_ENDPOINT", "http://s3:9000"), + os.getenv("S3_REGION", "us-east-1"), + os.getenv("S3_BUCKET", "messenger-attachments"), + secret("S3_ACCESS_KEY_ID_FILE", "/run/secrets/s3_access_key_id"), + secret("S3_SECRET_ACCESS_KEY_FILE", "/run/secrets/s3_secret_access_key"), + maximum, + pixels, + ) diff --git a/src/messenger/storage.py b/src/messenger/storage.py new file mode 100644 index 00000000..ab983fc4 --- /dev/null +++ b/src/messenger/storage.py @@ -0,0 +1,74 @@ +"""S3 adapter: bounded sockets, least-privilege credentials, no automatic PUT retries.""" + +import boto3 +from botocore.config import Config +from botocore.exceptions import BotoCoreError, ClientError + +from messenger.domain import DomainError + + +def unavailable(): + return DomainError(503, "unavailable", "Файловое хранилище временно недоступно") + + +class ObjectStore: + def __init__(self, settings): + self.bucket = settings.s3_bucket + self.client = boto3.client( + "s3", + endpoint_url=settings.s3_endpoint, + region_name=settings.s3_region, + aws_access_key_id=settings.s3_access_key, + aws_secret_access_key=settings.s3_secret_key, + config=Config( + connect_timeout=0.5, + read_timeout=2, + max_pool_connections=8, + retries={"total_max_attempts": 1}, + s3={"addressing_style": "path"}, + request_checksum_calculation="when_required", + response_checksum_validation="when_required", + ), + ) + + def ready(self): + try: + self.client.head_bucket(Bucket=self.bucket) + except BotoCoreError, ClientError: + raise unavailable() from None + + def put(self, key, file, size, media, digest): + try: + self.client.put_object( + Bucket=self.bucket, + Key=key, + Body=file, + ContentLength=size, + ContentType=media, + Metadata={"sha256": digest}, + ) + except BotoCoreError, ClientError: + raise unavailable() from None + + def head(self, key): + try: + return self.client.head_object(Bucket=self.bucket, Key=key) + except ClientError as exc: + if str(exc.response.get("Error", {}).get("Code")) in ("404", "NoSuchKey", "NotFound"): + return None + raise unavailable() from None + except BotoCoreError: + raise unavailable() from None + + def download(self, row): + try: + response = self.client.get_object(Bucket=self.bucket, Key=row["object_key"]) + if response["ContentLength"] != row["size_bytes"]: + response["Body"].close() + raise unavailable() + return response["Body"] + except BotoCoreError, ClientError: + raise unavailable() from None + + def close(self): + self.client.close() diff --git a/student-tests/conftest.py b/student-tests/conftest.py new file mode 100644 index 00000000..6fe20783 --- /dev/null +++ b/student-tests/conftest.py @@ -0,0 +1,85 @@ +import base64 +from pathlib import Path +from uuid import uuid4 + +import psycopg +import pytest +from fastapi.testclient import TestClient +from psycopg import sql +from psycopg.conninfo import make_conninfo + +from messenger.app import create_app +from messenger.migrate import migrate +from messenger.settings import Settings + +ROOT = Path(__file__).resolve().parents[1] +PASSWORD = "Учебный:пароль😀-12345" + + +@pytest.fixture(scope="session") +def settings(): + password = (ROOT / "secrets/postgres_password").read_text().strip() + admin = make_conninfo( + host="127.0.0.1", port=55435, user="messenger", password=password, dbname="messenger" + ) + database = "student_tests_" + uuid4().hex + with psycopg.connect(admin, autocommit=True) as conn: + conn.execute(sql.SQL("CREATE DATABASE {}").format(sql.Identifier(database))) + config = Settings( + make_conninfo(admin, dbname=database), + "redis://127.0.0.1:56382/1", + s3_bucket="messenger-attachments-tests", + s3_access_key=(ROOT / "secrets/s3_test_access_key_id").read_text().strip(), + s3_secret_key=(ROOT / "secrets/s3_test_secret_access_key").read_text().strip(), + ) + migrate(config.database_url, ROOT / "migrations") + with pytest.MonkeyPatch.context() as environment: + environment.setenv("S3_ENDPOINT", config.s3_endpoint) + environment.setenv("S3_BUCKET", config.s3_bucket) + environment.setenv("S3_ACCESS_KEY_ID_FILE", str(ROOT / "secrets/s3_test_access_key_id")) + environment.setenv( + "S3_SECRET_ACCESS_KEY_FILE", str(ROOT / "secrets/s3_test_secret_access_key") + ) + yield config + with psycopg.connect(admin, autocommit=True) as conn: + conn.execute(sql.SQL("DROP DATABASE {} WITH (FORCE)").format(sql.Identifier(database))) + + +@pytest.fixture +def client(settings): + with psycopg.connect(settings.database_url) as conn: + conn.execute("TRUNCATE users,chats,chat_members,messages,sessions CASCADE") + with TestClient(create_app(settings), raise_server_exceptions=False) as client: + client.app.state.cache.client.flushdb() + yield client + + +def basic(username, password=PASSWORD): + return { + "Authorization": "Basic " + base64.b64encode((username + ":" + password).encode()).decode() + } + + +@pytest.fixture +def actors(client): + result = [] + for name in ("alice", "bob", "eve"): + r = client.post( + "/api/v1/users", json={"username": name, "display_name": name, "password": PASSWORD} + ) + assert r.status_code == 201 + session = client.post("/api/v1/auth/sessions", headers=basic(name)) + assert session.status_code == 201 + result.append({**r.json(), "token": session.json()["token"]}) + return result + + +@pytest.fixture +def room(client, actors): + response = client.post( + "/api/v1/chats", + headers={"Authorization": "Bearer " + actors[0]["token"]}, + json={"title": "Чат 👋", "member_ids": [u["id"] for u in actors[:2]]}, + ) + assert response.status_code == 201 + return response.json() diff --git a/student-tests/test_api.py b/student-tests/test_api.py new file mode 100644 index 00000000..2bde7cc5 --- /dev/null +++ b/student-tests/test_api.py @@ -0,0 +1,299 @@ +import hashlib +import json +import re +import time +from concurrent.futures import ThreadPoolExecutor +from uuid import uuid4 + +import psycopg +import pytest +from conftest import PASSWORD, ROOT, basic +from fastapi.testclient import TestClient + +from messenger.app import create_app +from messenger.auth import basic_credentials +from messenger.migrate import migrate + + +def headers(actor): + return {"Authorization": "Bearer " + actor["token"], "Idempotency-Key": uuid4().hex} + + +def error(response, status, code): + assert response.status_code == status, response.text + body = response.json()["error"] + assert set(body) == {"code", "message", "request_id"} + assert body["code"] == code + assert body["request_id"] == response.headers["X-Request-Id"] + assert len(response.headers.get_list("X-Request-Id")) == 1 + if status == 401: + assert response.headers["WWW-Authenticate"].startswith(("Basic", "Bearer")) + + +@pytest.mark.parametrize("body", ["{", "null", "[]", '"text"', '{"username":']) +def test_malformed_json(client, body): + error( + client.post("/api/v1/users", content=body, headers={"Content-Type": "application/json"}), + 400, + "invalid_request", + ) + + +@pytest.mark.parametrize( + "change", + [ + {"username": "ab"}, + {"username": "a" * 33}, + {"username": "Upper"}, + {"username": "кириллица"}, + {"username": "valid\n"}, + {"username": 123}, + {"username": True}, + {"display_name": 123}, + {"display_name": None}, + {"display_name": " \n\t"}, + {"display_name": "😀" * 101}, + {"display_name": "\ud800"}, + {"password": "short"}, + {"password": "😀" * 129}, + {"password": 123}, + {"password": " " * 12}, + {"password": "\ud800" * 12}, + {"extra": True}, + ], +) +def test_strict_registration(client, change): + data = {"username": "valid", "display_name": "Имя", "password": PASSWORD, **change} + response = client.post( + "/api/v1/users", content=json.dumps(data), headers={"Content-Type": "application/json"} + ) + error(response, 400, "invalid_request") + + +def test_unicode_password_hash_and_authentication(client, settings, actors): + for u in actors: + assert "password" not in u and "password_hash" not in u + assert re.fullmatch(r"[A-Za-z0-9_-]{43}", u["token"]) + with psycopg.connect(settings.database_url) as conn: + encoded = conn.execute("SELECT password_hash FROM users WHERE username='alice'").fetchone()[ + 0 + ] + assert encoded.startswith("$argon2id$") and PASSWORD not in encoded + assert ( + conn.execute("SELECT octet_length(token_hash) FROM sessions LIMIT 1").fetchone()[0] + == 32 + ) + bad = client.post("/api/v1/auth/sessions", headers=basic("alice", "wrong-password")) + absent = client.post("/api/v1/auth/sessions", headers=basic("unknown", "wrong-password")) + error(bad, 401, "unauthorized") + error(absent, 401, "unauthorized") + assert bad.json()["error"]["message"] == absent.json()["error"]["message"] + assert bad.headers["WWW-Authenticate"] == 'Basic realm="messenger", charset="UTF-8"' + for value in ( + {}, + basic("alice"), + {"X-User-Id": actors[0]["id"]}, + {"Authorization": "Bearer unknown"}, + ): + error(client.get("/api/v1/users/me", headers=value), 401, "unauthorized") + actual = client.get( + "/api/v1/users/me", headers={**headers(actors[0]), "X-User-Id": actors[2]["id"]} + ).json() + assert actual["id"] == actors[0]["id"] + error( + client.post("/api/v1/auth/sessions", headers=basic("alice"), json={}), + 400, + "invalid_request", + ) + + +@pytest.mark.parametrize("value", [None, "Bearer a", "Basic !", "Basic YWxpY2U=", "Basic /w=="]) +def test_invalid_basic(value): + with pytest.raises(Exception) as caught: + basic_credentials(value) + assert caught.value.status == 401 + + +def test_registration_race(client, settings): + def register(_): + return client.post( + "/api/v1/users", + json={"username": "same", "display_name": "Алиса", "password": PASSWORD}, + ).status_code + + with ThreadPoolExecutor(max_workers=2) as pool: + assert sorted(pool.map(register, range(10))) == [201] + [409] * 9 + with psycopg.connect(settings.database_url) as conn: + assert conn.execute("SELECT count(*) FROM users WHERE username='same'").fetchone()[0] == 1 + + +def test_acl_validation_and_transaction_rollback(client, actors, room, settings): + path = "/api/v1/chats/" + room["id"] + for suffix in ("", "/messages"): + error(client.get(path + suffix, headers=headers(actors[2])), 404, "not_found") + error(client.get("/api/v1/chats/not-a-uuid"), 401, "unauthorized") + error( + client.get("/api/v1/chats/not-a-uuid", headers=headers(actors[0])), 400, "invalid_request" + ) + with psycopg.connect(settings.database_url) as conn: + before = conn.execute("SELECT count(*) FROM chats").fetchone()[0] + for members in ([actors[0]["id"], str(uuid4())], [actors[0]["id"]] * 2, [actors[1]["id"]], []): + error( + client.post( + "/api/v1/chats", + headers=headers(actors[0]), + json={"title": "rollback", "member_ids": members}, + ), + 400, + "invalid_request", + ) + with psycopg.connect(settings.database_url) as conn: + assert conn.execute("SELECT count(*) FROM chats").fetchone()[0] == before + assert conn.execute("SELECT count(*) FROM chat_members").fetchone()[0] == 2 + for body in ( + {"text": ""}, + {"text": " \t"}, + {"text": "😀" * 4001}, + {"text": 123}, + {"text": None}, + {"text": "ok", "sender_id": actors[1]["id"]}, + ): + error( + client.post(path + "/messages", headers=headers(actors[0]), json=body), + 400, + "invalid_request", + ) + for query in ( + "limit=0", + "limit=101", + "limit=true", + "limit=1.0", + "limit=1&limit=2", + "cursor=", + "cursor=bad!", + "cursor=e30", + "cursor=x&cursor=y", + ): + error( + client.get(path + "/messages?" + query, headers=headers(actors[0])), + 400, + "invalid_request", + ) + + +def test_concurrent_messages_and_keyset_ties(client, actors, room, settings): + path = f"/api/v1/chats/{room['id']}/messages" + + def send(i): + r = client.post(path, headers=headers(actors[i % 2]), json={"text": f"m{i} 😀"}) + assert r.status_code == 201 + return r.json() + + with ThreadPoolExecutor(max_workers=10) as pool: + sent = list(pool.map(send, range(100))) + with psycopg.connect(settings.database_url) as conn: + conn.execute( + "UPDATE messages SET created_at='2026-10-17T12:00:00Z' WHERE chat_id=%s", (room["id"],) + ) + for m in sent: + m["created_at"] = "2026-10-17T12:00:00.000000Z" + found, cursor = [], None + while True: + query = {"limit": 17 if cursor else 1} + if cursor: + query["cursor"] = cursor + response = client.get(path, params=query, headers=headers(actors[1])) + assert response.status_code == 200 + page = response.json() + found.extend(page["items"]) + cursor = page["next_cursor"] + if not cursor: + break + assert len(found) == len({x["id"] for x in found}) == 100 + assert found == sorted(sent, key=lambda x: (x["created_at"], x["id"])) + first_cursor = client.get(path + "?limit=1", headers=headers(actors[0])).json()["next_cursor"] + error( + client.get("/api/v1/chats", params={"cursor": first_cursor}, headers=headers(actors[0])), + 400, + "invalid_request", + ) + + +def test_cache_hit_flush_and_revocation(client, actors, monkeypatch): + user = actors[0] + url = "/api/v1/users/me" + assert client.get(url, headers=headers(user)).status_code == 200 + repository = client.app.state.repository + original = repository.get_user + + def must_be_cached(*args): + raise AssertionError("cache hit should avoid fetching immutable user again") + + monkeypatch.setattr(repository, "get_user", must_be_cached) + assert client.get(url, headers=headers(user)).status_code == 200 + monkeypatch.setattr(repository, "get_user", original) + cache = client.app.state.cache.client + digest = hashlib.sha256(user["token"].encode()).digest() + key = client.app.state.cache.key(digest) + assert 0 < cache.ttl(key) <= 3600 + stale = cache.get(key) + cache.flushdb() + assert client.get(url, headers=headers(user)).status_code == 200 + assert client.delete("/api/v1/auth/sessions/current", headers=headers(user)).status_code == 204 + cache.set(key, stale, ex=3600) # A resurrected stale cache entry must not resurrect a session. + error(client.get(url, headers=headers(user)), 401, "unauthorized") + error( + client.delete("/api/v1/auth/sessions/current", headers=headers(user)), 401, "unauthorized" + ) + + +def test_expiry_and_api_restart(client, actors, settings, monkeypatch, tmp_path): + database_file, cache_file = tmp_path / "database_url", tmp_path / "cache_url" + database_file.write_text(settings.database_url) + cache_file.write_text(settings.cache_url) + monkeypatch.setenv("DATABASE_URL_FILE", str(database_file)) + monkeypatch.setenv("CACHE_URL_FILE", str(cache_file)) + monkeypatch.setenv("SESSION_TTL_SECONDS", "2") + with TestClient(create_app()) as short: + response = short.post("/api/v1/auth/sessions", headers=basic("alice")) + assert response.status_code == 201 + token = {"Authorization": "Bearer " + response.json()["token"]} + assert short.get("/api/v1/users/me", headers=token).status_code == 200 + with TestClient(create_app(settings)) as restarted: + assert restarted.get("/api/v1/users/me", headers=token).status_code == 200 + time.sleep(2.1) + error(restarted.get("/api/v1/users/me", headers=token), 401, "unauthorized") + + +def test_migrations_idempotent_and_detect_change(client, settings, tmp_path): + migrate(settings.database_url, ROOT / "migrations") + modified = tmp_path / "001_initial.sql" + modified.write_text((ROOT / "migrations/001_initial.sql").read_text() + "\n-- changed") + with pytest.raises(RuntimeError, match="checksum changed"): + migrate(settings.database_url, tmp_path) + + +def test_logs_and_safe_errors(client, monkeypatch, caplog): + canary = "PRIVATE_BODY_CANARY_123" + with caplog.at_level("INFO", logger="messenger"): + r = client.post( + "/api/v1/users", + json={"username": "logging", "display_name": canary, "password": PASSWORD}, + ) + assert r.status_code == 201 + assert canary not in caplog.text and PASSWORD not in caplog.text + + def broken(*args): + raise RuntimeError(canary) + + monkeypatch.setattr(client.app.state.authentication, "register", broken) + response = client.post( + "/api/v1/users", json={"username": "broken", "display_name": "x", "password": PASSWORD} + ) + error(response, 500, "internal_error") + assert canary not in response.text and canary not in caplog.text + error( + client.post("/api/v1/users", content="{}", headers={"Content-Type": "text/plain"}), + 415, + "unsupported_media_type", + ) diff --git a/student-tests/test_attachments.py b/student-tests/test_attachments.py new file mode 100644 index 00000000..9bbbabd1 --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,244 @@ +import hashlib +import io +import struct +import zlib +from dataclasses import replace +from urllib.parse import quote +from uuid import uuid4 + +import psycopg +import pytest +from botocore.exceptions import ClientError +from conftest import ROOT +from PIL import Image +from psycopg.rows import dict_row +from test_api import error, headers + +from messenger.domain import DomainError +from messenger.reconcile import Reconciler +from messenger.storage import ObjectStore + +PNG = (ROOT / "tests/fixtures/sample.png").read_bytes() + + +def upload(client, actor, room, content=PNG, media="image/png", name="sample.png"): + return client.post( + f"/api/v1/chats/{room['id']}/attachments?filename={quote(name, safe='')}", + headers={**headers(actor), "Content-Type": media}, + content=content, + ) + + +@pytest.fixture +def admin(settings): + store = ObjectStore( + replace( + settings, + s3_access_key=(ROOT / "secrets/s3_root_user").read_text().strip(), + s3_secret_key=(ROOT / "secrets/s3_root_password").read_text().strip(), + ) + ) + yield store + store.close() + + +def age(conn, id): + conn.execute( + "UPDATE attachments SET updated_at=clock_timestamp()-interval '10 minutes' WHERE id=%s", + (id,), + ) + + +def test_original_png_jpeg_and_acl(client, actors, room): + jpg = io.BytesIO() + Image.new("RGB", (17, 11), "red").save(jpg, format="JPEG") + for data, media in ((PNG, "image/png"), (jpg.getvalue(), "image/jpeg")): + response = upload(client, actors[0], room, data, media, "Фото 1.png") + assert response.status_code == 201, response.text + value = response.json() + assert value["status"] == "ready" and value["variants"] == [] + assert value["error_code"] is None and value["sha256"] == hashlib.sha256(data).hexdigest() + assert value["size_bytes"] == len(data) and value["content_type"] == media + assert "object_key" not in value + path = "/api/v1/attachments/" + value["id"] + assert client.get(path, headers=headers(actors[1])).json() == value + download = client.get(path + "/content", headers=headers(actors[1])) + assert download.status_code == 200 and download.content == data + assert download.headers["Content-Type"] == media + for suffix in ("", "/content"): + error(client.get(path + suffix, headers=headers(actors[2])), 404, "not_found") + error(client.get(path + suffix), 401, "unauthorized") + error( + client.get(path + "/content?variant=thumbnail", headers=headers(actors[0])), + 400, + "invalid_request", + ) + + +@pytest.mark.parametrize("name", ["", "../a.png", "a\\b.png", "a\x00.png", "\n.png", "x" * 256]) +def test_unsafe_names(client, actors, room, name): + error(upload(client, actors[0], room, name=name), 400, "invalid_request") + + +@pytest.mark.parametrize( + "data,media", + [ + (b"", "image/png"), + (b"not a file", "image/png"), + (PNG[:30], "image/png"), + (PNG, "image/jpeg"), + (PNG, "text/plain"), + ], +) +def test_invalid_images(client, actors, room, data, media): + error(upload(client, actors[0], room, data, media), 415, "unsupported_media_type") + + +def test_byte_limit_without_content_length_and_pixel_bomb(client, actors, room): + error(upload(client, actors[0], room, b"x" * (10485760 + 1)), 413, "payload_too_large") + stream = (b"x" * 1048576 for _ in range(11)) + error(upload(client, actors[0], room, stream), 413, "payload_too_large") + bomb = bytearray(PNG) + bomb[16:24] = struct.pack(">II", 10000, 4001) + bomb[29:33] = struct.pack(">I", zlib.crc32(bomb[12:29]) & 0xFFFFFFFF) + error(upload(client, actors[0], room, bytes(bomb)), 413, "payload_too_large") + + +def test_attachment_message_relations_and_replay(client, actors, room): + att = upload(client, actors[0], room).json() + path = f"/api/v1/chats/{room['id']}/messages" + h = headers(actors[1]) + body = {"text": "", "attachment_ids": [att["id"]]} + result = client.post(path, headers=h, json=body) + assert result.status_code == 201 and result.json()["attachment_ids"] == [att["id"]] + assert client.post(path, headers=h, json=body).json() == result.json() + assert client.get(path, headers=headers(actors[0])).json()["items"] == [result.json()] + error( + client.post( + path, + headers=headers(actors[0]), + json={"text": "", "attachment_ids": [att["id"], att["id"]]}, + ), + 400, + "invalid_request", + ) + error( + client.post( + path, headers=headers(actors[0]), json={"text": "", "attachment_ids": [str(uuid4())]} + ), + 404, + "not_found", + ) + other = client.post( + "/api/v1/chats", + headers=headers(actors[0]), + json={"title": "other", "member_ids": [actors[0]["id"]]}, + ).json() + error( + client.post(f"/api/v1/chats/{other['id']}/messages", headers=headers(actors[0]), json=body), + 404, + "not_found", + ) + legacy = headers(actors[0]) + one = client.post(path, headers=legacy, json={"text": "legacy"}) + two = client.post(path, headers=legacy, json={"attachment_ids": [], "text": "legacy"}) + assert one.status_code == 201 and two.json() == one.json() + + +def test_scoped_credentials_cannot_delete_or_access_other_bucket(client, settings): + store = ObjectStore(settings) + try: + with pytest.raises(ClientError) as denied: + store.client.delete_object(Bucket=store.bucket, Key="originals/" + str(uuid4())) + assert denied.value.response["ResponseMetadata"]["HTTPStatusCode"] == 403 + with pytest.raises(ClientError) as denied: + store.client.list_objects_v2(Bucket="unrelated-bucket") + assert denied.value.response["ResponseMetadata"]["HTTPStatusCode"] == 403 + finally: + store.close() + + +def test_db_failure_after_put_is_recoverable_with_dry_run( + client, actors, room, settings, monkeypatch, admin +): + repo = client.app.state.repository + + def fail(*args): + raise RuntimeError("injected after durable PUT") + + monkeypatch.setattr(repo, "finish_attachment", fail) + error(upload(client, actors[0], room), 500, "internal_error") + store = client.app.state.attachments.store + with psycopg.connect(settings.database_url, autocommit=True, row_factory=dict_row) as conn: + row = conn.execute("SELECT * FROM attachments").fetchone() + assert row["storage_state"] == "pending" and store.head(row["object_key"]) is not None + assert Reconciler(conn, admin, apply=True).run()["counts"].get("restore_ready", 0) == 0 + age(conn, row["id"]) + dry = Reconciler(conn, admin).run() + assert dry["counts"]["restore_ready"] == 1 + assert ( + conn.execute("SELECT storage_state FROM attachments").fetchone()["storage_state"] + == "pending" + ) + assert Reconciler(conn, admin, apply=True).run()["counts"]["restore_ready"] == 1 + assert Reconciler(conn, admin, apply=True).run()["actions"] == [] + row = conn.execute("SELECT * FROM attachments").fetchone() + assert row["storage_state"] == "ready" + assert ( + client.get( + "/api/v1/attachments/" + str(row["id"]) + "/content", headers=headers(actors[1]) + ).content + == PNG + ) + + +def test_failed_put_and_missing_used_object(client, actors, room, settings, admin, monkeypatch): + store = client.app.state.attachments.store + original = store.put + + def fail(*args): + raise DomainError(503, "unavailable", "injected transport failure") + + monkeypatch.setattr(store, "put", fail) + error(upload(client, actors[0], room), 503, "unavailable") + with psycopg.connect(settings.database_url, autocommit=True, row_factory=dict_row) as conn: + pending = conn.execute("SELECT id FROM attachments").fetchone()["id"] + age(conn, pending) + assert Reconciler(conn, admin, apply=True).run()["counts"]["delete_abandoned_intent"] == 1 + monkeypatch.setattr(store, "put", original) + att = upload(client, actors[0], room).json() + response = client.post( + f"/api/v1/chats/{room['id']}/messages", + headers=headers(actors[0]), + json={"text": "used", "attachment_ids": [att["id"]]}, + ) + assert response.status_code == 201 + row = conn.execute("SELECT * FROM attachments WHERE id=%s", (att["id"],)).fetchone() + age(conn, row["id"]) + admin.client.delete_object(Bucket=store.bucket, Key=row["object_key"]) + assert Reconciler(conn, admin).run()["counts"]["mark_missing"] == 1 + assert ( + conn.execute("SELECT storage_state FROM attachments").fetchone()["storage_state"] + == "ready" + ) + assert Reconciler(conn, admin, apply=True).run()["counts"]["mark_missing"] == 1 + error( + client.get("/api/v1/attachments/" + att["id"], headers=headers(actors[0])), + 409, + "conflict", + ) + assert conn.execute("SELECT count(*) AS n FROM message_attachments").fetchone()["n"] == 1 + admin.put( + row["object_key"], + io.BytesIO(PNG), + len(PNG), + "image/png", + hashlib.sha256(PNG).hexdigest(), + ) + assert Reconciler(conn, admin, apply=True).run()["counts"]["restore_ready"] == 1 + assert ( + client.get( + "/api/v1/attachments/" + att["id"] + "/content", headers=headers(actors[0]) + ).content + == PNG + ) diff --git a/student-tests/test_cluster.py b/student-tests/test_cluster.py new file mode 100644 index 00000000..4a466305 --- /dev/null +++ b/student-tests/test_cluster.py @@ -0,0 +1,137 @@ +import json +from concurrent.futures import ThreadPoolExecutor +from dataclasses import replace +from uuid import uuid4 + +import psycopg +import pytest +from fastapi.testclient import TestClient +from test_api import error, headers + +from messenger.app import create_app + + +@pytest.mark.parametrize("key", [None, "", "a b", "/", "a" * 129]) +def test_message_key_required(client, actors, room, key): + h = {"Authorization": "Bearer " + actors[0]["token"]} + if key is not None: + h["Idempotency-Key"] = key + error( + client.post( + f"/api/v1/chats/{room['id']}/messages", headers=h, json={"text": "key validation"} + ), + 400, + "invalid_request", + ) + + +def test_replay_scope_conflict_and_fresh_authorization(client, actors, room): + path = f"/api/v1/chats/{room['id']}/messages" + key = "Scope.Key:123" + h = {**headers(actors[0]), "Idempotency-Key": key} + first = client.post(path, headers=h, json={"text": "exact whitespace \n"}) + assert first.status_code == 201 + repeat = client.post( + path, + headers={**h, "Content-Type": "application/json"}, + content=json.dumps({"text": "exact whitespace \n"}, indent=3), + ) + assert repeat.status_code == 201 and repeat.json() == first.json() + error(client.post(path, headers=h, json={"text": "different"}), 409, "conflict") + outsider = {**headers(actors[2]), "Idempotency-Key": key} + error( + client.post(path, headers=outsider, json={"text": "exact whitespace \n"}), 404, "not_found" + ) + other_user = {**headers(actors[1]), "Idempotency-Key": key} + own = client.post(path, headers=other_user, json={"text": "another author"}) + assert own.status_code == 201 and own.json()["id"] != first.json()["id"] + chat = client.post( + "/api/v1/chats", + headers=headers(actors[0]), + json={"title": "another", "member_ids": [actors[0]["id"]]}, + ).json() + other_chat = client.post( + f"/api/v1/chats/{chat['id']}/messages", headers=h, json={"text": "different chat"} + ) + assert other_chat.status_code == 201 and other_chat.json()["id"] != first.json()["id"] + assert client.delete("/api/v1/auth/sessions/current", headers=h).status_code == 204 + error(client.post(path, headers=h, json={"text": "exact whitespace \n"}), 401, "unauthorized") + + +def test_concurrent_replay_across_independent_apps(client, actors, room, settings): + path = f"/api/v1/chats/{room['id']}/messages" + h = {**headers(actors[0]), "Idempotency-Key": uuid4().hex} + with TestClient(create_app(settings)) as second: + assert second.app.state.instance_id != client.app.state.instance_id + + def send(i): + c = client if i % 2 else second + r = c.post(path, headers=h, json={"text": "same concurrent body"}) + assert r.status_code == 201 + return r.json(), r.headers["X-Instance-Id"] + + with ThreadPoolExecutor(max_workers=10) as pool: + results = list(pool.map(send, range(30))) + assert len({item[0]["id"] for item in results}) == 1 + assert len({item[1] for item in results}) == 2 + assert len(client.get(path, headers=headers(actors[1])).json()["items"]) == 1 + + +def test_side_effect_and_result_rollback_together(client, actors, room, settings, monkeypatch): + repository = client.app.state.repository + original = repository._save_request + + def fail_after_message_insert(*args): + raise RuntimeError("injected between message and result") + + monkeypatch.setattr(repository, "_save_request", fail_after_message_insert) + path = f"/api/v1/chats/{room['id']}/messages" + h = {**headers(actors[0]), "Idempotency-Key": uuid4().hex} + error( + client.post(path, headers=h, json={"text": "retry after rollback"}), 500, "internal_error" + ) + with psycopg.connect(settings.database_url) as conn: + assert conn.execute("SELECT count(*) FROM messages").fetchone()[0] == 0 + assert conn.execute("SELECT count(*) FROM message_requests").fetchone()[0] == 0 + monkeypatch.setattr(repository, "_save_request", original) + result = client.post(path, headers=h, json={"text": "retry after rollback"}) + assert result.status_code == 201 + assert ( + client.post(path, headers=h, json={"text": "retry after rollback"}).json() == result.json() + ) + + +def test_expired_key_can_be_reused_without_deleting_old_message(client, actors, room, settings): + path = f"/api/v1/chats/{room['id']}/messages" + h = {**headers(actors[0]), "Idempotency-Key": uuid4().hex} + first = client.post(path, headers=h, json={"text": "old"}).json() + with psycopg.connect(settings.database_url) as conn: + conn.execute( + "UPDATE message_requests SET created_at=clock_timestamp()-interval '2 days', " + "expires_at=clock_timestamp()-interval '1 day'" + ) + second = client.post(path, headers=h, json={"text": "new"}) + assert second.status_code == 201 and second.json()["id"] != first["id"] + assert len(client.get(path, headers=headers(actors[0])).json()["items"]) == 2 + + +@pytest.mark.parametrize("optimized", [True, False]) +def test_read_modes_preserve_public_result(client, actors, room, settings, optimized): + with TestClient(create_app(replace(settings, read_autocommit=optimized))) as c: + c.get("/api/v1/users/me", headers=headers(actors[0])) + pool = c.app.state.repository.pool + before = pool.get_stats().get("requests_num", 0) + response = c.get(f"/api/v1/chats/{room['id']}/messages", headers=headers(actors[0])) + assert response.status_code == 200 and response.json()["items"] == [] + assert pool.get_stats()["requests_num"] - before == 3 + + +def test_instance_header_covers_health_errors_and_success(client): + values = [ + client.get("/health/live"), + client.get("/health/ready"), + client.get("/api/v1/users/me"), + client.get("/not-a-route"), + ] + assert len({r.headers["X-Instance-Id"] for r in values}) == 1 + assert all(len(r.headers.get_list("X-Instance-Id")) == 1 for r in values) diff --git a/uv.lock b/uv.lock new file mode 100644 index 00000000..3cc36d11 --- /dev/null +++ b/uv.lock @@ -0,0 +1,1075 @@ +version = 1 +revision = 3 +requires-python = "==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" }, +] +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/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" }, +] + +[[package]] +name = "attrs" +version = "26.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/9a/8e/82a0fe20a541c03148528be8cac2408564a6c9a0cc7e9171802bc1d26985/attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32", size = 952055, upload-time = "2026-03-19T14:22:25.026Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/64/b4/17d4b0b2a2dc85a6df63d1157e028ed19f90d4cd97c36717afef2bc2f395/attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309", size = 67548, upload-time = "2026-03-19T14:22:23.645Z" }, +] + +[[package]] +name = "boto3" +version = "1.43.109" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "botocore" }, + { name = "jmespath" }, + { name = "s3transfer" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/2a/80/0430e16c302b0d1a4ca3c8c69ffee9e4f8f2170d56162d2761b34fd512ba/boto3-1.43.109.tar.gz", hash = "sha256:c829bc3352e1e3922d8fe1db10b697182ac411b64ce5fc3acb0a06a29837417e", size = 112661, upload-time = "2026-10-07T15:24:51.293Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a1/56/c83a8fdadf06f631d1a0c4d82fc8daa9e1a40f6354264fba20c186363f49/boto3-1.43.109-py3-none-any.whl", hash = "sha256:703a81baed186d31e27cf50065d25a9faeb704f009e7c56b0f002ca52a328896", size = 140044, upload-time = "2026-10-07T15:24:49.793Z" }, +] + +[[package]] +name = "botocore" +version = "1.43.114" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "jmespath" }, + { name = "python-dateutil" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ce/c8/b508359d1f3846a918c06807a9ae27eee063f904559269e42ccde9de09ea/botocore-1.43.114.tar.gz", hash = "sha256:f366fa4db518775632ad1eb128cd8203ca46396cecf37209d904f0bbc049ce90", size = 16369844, upload-time = "2026-10-14T19:24:17.683Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9a/41/7c6fa7ac5fcfd5ea3c6f32aab001942da32b184a210f39042778cb1ad8ed/botocore-1.43.114-py3-none-any.whl", hash = "sha256:d1c441a22e93e158de5b1e026205f5d6d67a4545d10540c5090c62dccb3a9eca", size = 16067885, upload-time = "2026-10-14T19:24:14.629Z" }, +] + +[[package]] +name = "certifi" +version = "2026.7.22" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a3/c2/24167ea9858356b47a87a50d39908bfdb72ceeefe0041586e704e5376b3a/certifi-2026.7.22.tar.gz", hash = "sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55", size = 138112, upload-time = "2026-07-22T03:35:12.644Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0b/a7/71ac2cff56fec219ed242bb11b8efb69fcc4bec75db06fb7bfe35de520e6/certifi-2026.7.22-py3-none-any.whl", hash = "sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775", size = 136983, upload-time = "2026-07-22T03:35:11.276Z" }, +] + +[[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/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" }, +] + +[[package]] +name = "charset-normalizer" +version = "3.5.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/33/1c/f41d4e74c28ab327ff3acd36053f7ea506c55872d7a90b0fa71aa3ab0c89/charset_normalizer-3.5.2.tar.gz", hash = "sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef", size = 172659, upload-time = "2026-09-30T04:39:23.398Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/58/ca/7aa91362a2f77ac8e9e28a9b902a74f7d0e11a851ef0d27a74308da8cd90/charset_normalizer-3.5.2-cp314-cp314-android_24_arm64_v8a.whl", hash = "sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187", size = 226010, upload-time = "2026-09-30T04:36:27.669Z" }, + { url = "https://files.pythonhosted.org/packages/a8/cf/ac8878d0322cf88a1aad4c7b147db32ca0bd806eb0060957b2e31486dbe6/charset_normalizer-3.5.2-cp314-cp314-android_24_x86_64.whl", hash = "sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad", size = 239266, upload-time = "2026-09-30T04:36:29.434Z" }, + { url = "https://files.pythonhosted.org/packages/c9/6d/9a08d7e0b29b7208e2c6c01dc56c8e0520e7c7beadbbfb024b58fd69c8a5/charset_normalizer-3.5.2-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf", size = 206783, upload-time = "2026-09-30T04:36:30.872Z" }, + { url = "https://files.pythonhosted.org/packages/82/44/b0aa350280e6ff5a5492d17cf10460dd39d5ee848f872f7ba2df10607f60/charset_normalizer-3.5.2-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995", size = 210449, upload-time = "2026-09-30T04:36:32.625Z" }, + { url = "https://files.pythonhosted.org/packages/7c/8a/40db9aa9f5907bb0e6f8b6d64064bf8852fb33d4b813ff9414911df7647c/charset_normalizer-3.5.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424", size = 367815, upload-time = "2026-09-30T04:36:34.197Z" }, + { url = "https://files.pythonhosted.org/packages/7f/72/9c5e7707b57c8ddfa9ddf7b0b1d009d7fbab9e9e887d5b721060f37e307d/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13", size = 247095, upload-time = "2026-09-30T04:36:35.803Z" }, + { url = "https://files.pythonhosted.org/packages/83/09/71e453691e927de4ddf792770cfaab3f49d494e222f66ea5e404bbd5e39c/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d", size = 233942, upload-time = "2026-09-30T04:36:37.407Z" }, + { url = "https://files.pythonhosted.org/packages/9f/86/85c84e4da8b27dd409577d9437926ff581c5f9d3c66038dc68c1a526de51/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4", size = 273762, upload-time = "2026-09-30T04:36:38.904Z" }, + { url = "https://files.pythonhosted.org/packages/92/08/564955a4b5f2ccb410ab480bbe8c6a18063ff27f2d35458731c4a5335df9/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438", size = 269514, upload-time = "2026-09-30T04:36:40.469Z" }, + { url = "https://files.pythonhosted.org/packages/18/24/bad3ac4271589df29cf5ce2f5ae490518a5739358052bd0d61209e6fea54/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a", size = 255056, upload-time = "2026-09-30T04:36:42.02Z" }, + { url = "https://files.pythonhosted.org/packages/d6/3e/350d89ad49916b86554d6f5f2d03ec1152148f87e5ff735106c6a03b1a36/charset_normalizer-3.5.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56", size = 251311, upload-time = "2026-09-30T04:36:43.577Z" }, + { url = "https://files.pythonhosted.org/packages/56/5b/4970a2d154df502e133402906dd04e3ae7cada7b3011283c88d0479a2585/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd", size = 250190, upload-time = "2026-09-30T04:36:45.185Z" }, + { url = "https://files.pythonhosted.org/packages/88/8c/f1a91bddc8fb47c2889e29ea7ea49a194eb0d9868675d786806519c00d76/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204", size = 237098, upload-time = "2026-09-30T04:36:46.689Z" }, + { url = "https://files.pythonhosted.org/packages/24/0e/bb5dace3cc7e79068425386a6589c19b5a2ab5fefc2a46abea6919683332/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7", size = 274228, upload-time = "2026-09-30T04:36:48.31Z" }, + { url = "https://files.pythonhosted.org/packages/9d/79/b849ad523017ea9f5a45581bbebed91439e0cf42fd2860a6f64e358eb5a6/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd", size = 252401, upload-time = "2026-09-30T04:36:50.091Z" }, + { url = "https://files.pythonhosted.org/packages/89/8c/75469d690cf47200bce8f6cad7655724fc23148e147abfc5ce78b5f65863/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc", size = 271846, upload-time = "2026-09-30T04:36:51.719Z" }, + { url = "https://files.pythonhosted.org/packages/26/cd/6d52d3c7437cdcf2e310ce9f28f282e733d4ef60ed19105d1819c356255f/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874", size = 258151, upload-time = "2026-09-30T04:36:53.234Z" }, + { url = "https://files.pythonhosted.org/packages/f7/4c/070b38bdb5f49a70199fce923ec0726a49536a63ab262abbfcaaf351110b/charset_normalizer-3.5.2-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655", size = 143570, upload-time = "2026-09-30T04:36:54.816Z" }, + { url = "https://files.pythonhosted.org/packages/81/84/9ebfc8ed6c8c4fcd8e726ff6bf220cc8deb3966e31dce9be8dd8aa017e64/charset_normalizer-3.5.2-cp314-cp314-win32.whl", hash = "sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0", size = 186412, upload-time = "2026-09-30T04:36:56.643Z" }, + { url = "https://files.pythonhosted.org/packages/d1/78/5ed86f743d4bc350db307e7636419a0a5ee1d91806d30c7f667bd5c80dae/charset_normalizer-3.5.2-cp314-cp314-win_amd64.whl", hash = "sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c", size = 210965, upload-time = "2026-09-30T04:36:58.205Z" }, + { url = "https://files.pythonhosted.org/packages/53/94/a3a7698e9b1a395e1eb99ccd9a324be9347973bff4e72db2a06496d7cd27/charset_normalizer-3.5.2-cp314-cp314-win_arm64.whl", hash = "sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253", size = 200406, upload-time = "2026-09-30T04:36:59.764Z" }, + { url = "https://files.pythonhosted.org/packages/c1/48/c5dd00d5ef7791f02666de250a5bb6071e29b7e133cf4b835800b6d3bc27/charset_normalizer-3.5.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709", size = 396871, upload-time = "2026-09-30T04:37:01.543Z" }, + { url = "https://files.pythonhosted.org/packages/12/c8/8379554b42e8368161d898476686947a0fdbd3e8865170d7909dcabfdee8/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084", size = 249711, upload-time = "2026-09-30T04:37:03.111Z" }, + { url = "https://files.pythonhosted.org/packages/4a/eb/2ddb1035d17320caa9f41682935123a9a250277b261c3efc86b2d2a21343/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb", size = 231146, upload-time = "2026-09-30T04:37:04.721Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/2ecb4bde104322cd7859d6594fcfa74649f8d90b3221c9feecbef149875b/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f", size = 271552, upload-time = "2026-09-30T04:37:06.295Z" }, + { url = "https://files.pythonhosted.org/packages/3f/98/9d5f6ebc3aee9fef5d30b4aff11fb2ab7a1222b4064f8ef2c7c87cde217a/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09", size = 269810, upload-time = "2026-09-30T04:37:07.905Z" }, + { url = "https://files.pythonhosted.org/packages/09/e1/a3b06a10461b1b7628853c934c644e03bc28e42767116afb52f19a56519b/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80", size = 259845, upload-time = "2026-09-30T04:37:09.554Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d3/6f561f74a296cf27d61775a1dc665ad13f3bff6a798810ca05907f37a7c4/charset_normalizer-3.5.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c", size = 252825, upload-time = "2026-09-30T04:37:11.274Z" }, + { url = "https://files.pythonhosted.org/packages/26/9f/69e13ca3b18f43e0eafcd34c04a45b732ae22a43b54a5fc9e119103356eb/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f", size = 252659, upload-time = "2026-09-30T04:37:12.941Z" }, + { url = "https://files.pythonhosted.org/packages/73/a9/ace29806a0dae18939919c76ba526472d83214afa101105fabff2cf30625/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03", size = 238819, upload-time = "2026-09-30T04:37:14.659Z" }, + { url = "https://files.pythonhosted.org/packages/f8/c1/6116d52a2e3311ec80f21f5fb5e17b27405f10b9608af8f6e69516841a1b/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604", size = 272973, upload-time = "2026-09-30T04:37:16.346Z" }, + { url = "https://files.pythonhosted.org/packages/19/aa/9955c7e93bba10a9c7e8f7a5031b7ced66f3a1883a55c00712b8d5850ff3/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8", size = 253692, upload-time = "2026-09-30T04:37:18.212Z" }, + { url = "https://files.pythonhosted.org/packages/bb/33/2a6ae7fdc1b10cb581cef91addd8cdfc5f40d50abb5702309369d5834579/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93", size = 268757, upload-time = "2026-09-30T04:37:19.877Z" }, + { url = "https://files.pythonhosted.org/packages/a2/22/80992720a0282cd39bba1db35868e6b9c22f41281160143a836544bc1d8a/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915", size = 262220, upload-time = "2026-09-30T04:37:21.583Z" }, + { url = "https://files.pythonhosted.org/packages/92/9f/181fd07e1bffea1d95cd80c84ac537354f50699c22cfc4d3c02b6fc16208/charset_normalizer-3.5.2-cp314-cp314t-win32.whl", hash = "sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5", size = 197797, upload-time = "2026-09-30T04:37:23.235Z" }, + { url = "https://files.pythonhosted.org/packages/49/1c/25d8415ec1c4f2f41f1680435e4c87cfb378ff2f677d950946f2a45d0632/charset_normalizer-3.5.2-cp314-cp314t-win_amd64.whl", hash = "sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc", size = 222765, upload-time = "2026-09-30T04:37:24.891Z" }, + { url = "https://files.pythonhosted.org/packages/3e/b4/46b48f013dadfc0d0d33b375438e31bdf5a989dc68389c6bf627054d4df9/charset_normalizer-3.5.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105", size = 210985, upload-time = "2026-09-30T04:37:26.634Z" }, + { url = "https://files.pythonhosted.org/packages/8c/ab/176fbfd5b64939c55d652366aa5b9ef1d767af207a3aa6ebeb0d226c484d/charset_normalizer-3.5.2-cp37-abi3-macosx_10_9_universal2.whl", hash = "sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd", size = 331815, upload-time = "2026-09-30T04:38:26.216Z" }, + { url = "https://files.pythonhosted.org/packages/7e/84/371eac6b30bdbcbf2d632a1a01809103459216fcaae61b8b8d922c1bfb8a/charset_normalizer-3.5.2-cp37-abi3-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7", size = 253276, upload-time = "2026-09-30T04:38:28.032Z" }, + { url = "https://files.pythonhosted.org/packages/43/6f/c4fbae58febff71709c51bc7e18fdfa55341dc382704740f9f0cbf03817b/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f", size = 241239, upload-time = "2026-09-30T04:38:29.732Z" }, + { url = "https://files.pythonhosted.org/packages/61/71/458c3f42164a07d0c5210798e9e704b39e540a6793b05aba67f3a35243a9/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93", size = 231121, upload-time = "2026-09-30T04:38:31.462Z" }, + { url = "https://files.pythonhosted.org/packages/09/54/ab9e89367076f6331bb6c65c4bf14a5361fa5191cb6561bf534f18504e1b/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade", size = 260350, upload-time = "2026-09-30T04:38:33.239Z" }, + { url = "https://files.pythonhosted.org/packages/7c/c1/061431ecc688d9d76602502cb57cc01e691e682c18f1beb45f9673b5bbd2/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0", size = 255430, upload-time = "2026-09-30T04:38:34.865Z" }, + { url = "https://files.pythonhosted.org/packages/8d/1f/20c8949f0676f7ab811abdeb7f4d7f1cbc6e61ff20bef08b44edeb092bc8/charset_normalizer-3.5.2-cp37-abi3-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26", size = 250612, upload-time = "2026-09-30T04:38:36.649Z" }, + { url = "https://files.pythonhosted.org/packages/2b/9e/46f2fa4c431fc98c4ae76a8cb5bdca54e0341e3cfc3fcfd8e82740250818/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011", size = 242083, upload-time = "2026-09-30T04:38:38.26Z" }, + { url = "https://files.pythonhosted.org/packages/bd/39/559be29a0c0f086e0bba6922babd38916cc5e0b58ced4de13ee01ea05508/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621", size = 232738, upload-time = "2026-09-30T04:38:39.81Z" }, + { url = "https://files.pythonhosted.org/packages/ff/6c/387b0e4f756a282831c1d9fc6aeb6c51ca4507ca202767c8de15ce9b12e2/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_ppc64le.whl", hash = "sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4", size = 260703, upload-time = "2026-09-30T04:38:41.346Z" }, + { url = "https://files.pythonhosted.org/packages/96/92/1fdf015f09ef449f50d3ac4b67c90887c9c318b727daa95cc4f866e6521d/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_riscv64.whl", hash = "sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e", size = 247622, upload-time = "2026-09-30T04:38:42.937Z" }, + { url = "https://files.pythonhosted.org/packages/dc/3c/8e7b8a5671ad5d433669fb2a76f1a0164df2d9b1718b0206bc2a16d840cc/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_s390x.whl", hash = "sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c", size = 257500, upload-time = "2026-09-30T04:38:44.604Z" }, + { url = "https://files.pythonhosted.org/packages/b4/f0/45b579df5cabc1d5d53ea1cc35e8437d3ca768c0acccc7041517cb6fbb32/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0", size = 255100, upload-time = "2026-09-30T04:38:46.289Z" }, + { url = "https://files.pythonhosted.org/packages/31/68/fdec18a343f5fb3f310588dd478b09ac4799e0b187dbade3a8cd776f03ef/charset_normalizer-3.5.2-cp37-abi3-win32.whl", hash = "sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf", size = 174499, upload-time = "2026-09-30T04:38:47.999Z" }, + { url = "https://files.pythonhosted.org/packages/9d/8a/b618149cc5207943a0242068d7a27897f56a62947b5a039085f2a22029f8/charset_normalizer-3.5.2-cp37-abi3-win_amd64.whl", hash = "sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036", size = 200092, upload-time = "2026-09-30T04:38:49.707Z" }, + { url = "https://files.pythonhosted.org/packages/03/cf/4c66866fa9e2b1c78e3c911516d1de497a677b7ac60f1eceda74ce777ca3/charset_normalizer-3.5.2-cp37-abi3-win_arm64.whl", hash = "sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e", size = 294363, upload-time = "2026-09-30T04:38:51.312Z" }, + { url = "https://files.pythonhosted.org/packages/fc/ad/d07d7862a62ffa6d79d68074d14823243dd235a77c45262acbf6adeb28bf/charset_normalizer-3.5.2-py3-none-any.whl", hash = "sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685", size = 68872, upload-time = "2026-09-30T04:39:21.828Z" }, +] + +[[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 = "colorama" +version = "0.4.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" }, +] + +[[package]] +name = "contourpy" +version = "1.4.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "numpy" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/83/5a/a55177dd22553a277388e8a1b3220e92de91bacb28356cdc73caa240121d/contourpy-1.4.0.tar.gz", hash = "sha256:20156f5a1ac4f8ce02656e39a61e82164a3d359796dc8026f75b062783d500e1", size = 13323726, upload-time = "2026-09-11T19:05:05.808Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/75/b0/b548628c8dddf6e5e0a981b7fa8e4c008024df09c7d17c6a9e271edfa0b3/contourpy-1.4.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a3e67bc1a6a4618a1dac7c3053a9ffece5ddfa2046b2670b342cf430bb0b87d1", size = 297354, upload-time = "2026-09-11T19:03:35.017Z" }, + { url = "https://files.pythonhosted.org/packages/04/5a/513484208742f65af2648c519f0b7ab034616e183c4403538024c136a1ab/contourpy-1.4.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:072a702e2e178f4fcf96f04775d0c059e4c917925abf0d3208ebb6865df3c23d", size = 283729, upload-time = "2026-09-11T19:03:36.818Z" }, + { url = "https://files.pythonhosted.org/packages/35/da/5a6562febc994b2c4bf9d01e57a50458ef8a2051bb3e7b35a00333e0fc26/contourpy-1.4.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:404dbcd9233513dfd1323b66ea593fef90e899f658f6b8a9ed8e93bd0ca669db", size = 357819, upload-time = "2026-09-11T19:03:39.058Z" }, + { url = "https://files.pythonhosted.org/packages/6d/99/7b358ce888aaa426f755daa096c99c59d17c352037344e836f20e5d3b957/contourpy-1.4.0-cp314-cp314-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:61624f6722480aa7e168fd746164e7bfdf48f8ccb6542f1613741200dc37e2b1", size = 407795, upload-time = "2026-09-11T19:03:41.293Z" }, + { url = "https://files.pythonhosted.org/packages/be/02/34d7548adf08c60967435d79d7a90882eacc84f5093435287974c7e99943/contourpy-1.4.0-cp314-cp314-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2e741a39dfc96babe1722561e81351aeec104526c57dbe91c167c1db606c2d55", size = 408552, upload-time = "2026-09-11T19:03:42.728Z" }, + { url = "https://files.pythonhosted.org/packages/cf/8c/9677dad226e5aaac5b823d5b09d881ebc32ff1648af417597649841e516c/contourpy-1.4.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e439ab450c93455feb0218532ded3e946ec7a9b5f459069f122cfa44b89229f6", size = 384850, upload-time = "2026-09-11T19:03:44.402Z" }, + { url = "https://files.pythonhosted.org/packages/08/f5/e3fbeaa489c223629fbb434737cb3de4ecaca9cae4825e77b92490f640f8/contourpy-1.4.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:417be048f7e122cefbe2a34c51a1f2b0410f8eb35796f794d45475ddb7872d9d", size = 1357601, upload-time = "2026-09-11T19:03:46.746Z" }, + { url = "https://files.pythonhosted.org/packages/88/be/55fec293d342c222ed58a5d4056df4362e192af2e59527a3d5d822de8828/contourpy-1.4.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:43d80072a32299bf945de0a6dd4e034ea0162e832261de2e07a274a5adbba9c9", size = 1427340, upload-time = "2026-09-11T19:03:48.745Z" }, + { url = "https://files.pythonhosted.org/packages/86/40/0faabf453edf59b0e3633381d7ca72c3414fb9b72b5cbb08b06ed792d3e5/contourpy-1.4.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:fa1b787362a3856e63dd2b89449f6c384d55ee1beb8f94f4bcc871b40f02462c", size = 118355, upload-time = "2026-09-11T19:03:50.047Z" }, + { url = "https://files.pythonhosted.org/packages/38/0c/7ea75aa3559ae8a6805015e15a19c92b6480752ecc92526361e5776e88c5/contourpy-1.4.0-cp314-cp314-win32.whl", hash = "sha256:738c44fa71735a617f36da58e32810512407d283d5d1bb5b1cecb00d7eeba7cf", size = 356977, upload-time = "2026-09-11T19:04:11.401Z" }, + { url = "https://files.pythonhosted.org/packages/15/41/3df8cc14bb572c8b447f9dfbc876703f0f2f2896058285b5c87a1d4a638d/contourpy-1.4.0-cp314-cp314-win_amd64.whl", hash = "sha256:181bea01bc742734ae672fa00c717d855dd35e1f029536406538c52e7b0cd73d", size = 240101, upload-time = "2026-09-11T19:04:12.772Z" }, + { url = "https://files.pythonhosted.org/packages/66/01/ee6830a5aa4565662a345172f6f35eeeed625d20f1c9d4ecd35318fe4ade/contourpy-1.4.0-cp314-cp314-win_arm64.whl", hash = "sha256:64039341e2d8804f1a13bda8c69083eab935167bbd7e856cf096241f17d5bd45", size = 576359, upload-time = "2026-09-11T19:04:14.983Z" }, + { url = "https://files.pythonhosted.org/packages/51/af/49ee9c9cf012699e505c1b63c531cc99f19df50f205173092c4d541e3ec7/contourpy-1.4.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:ef47fef9a912c77e3d84b014f701e5a9340f25703e9ed3bcebe37f91fb69dc49", size = 313601, upload-time = "2026-09-11T19:03:51.452Z" }, + { url = "https://files.pythonhosted.org/packages/ad/59/ce411ab2be0f805038626d8f4ca9ce563487ff51ff6c363e7512271564ed/contourpy-1.4.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:96019f059bcb3774acc0104be3360a57b36d33eaaa2e1d7f77c800ca8e07618b", size = 302812, upload-time = "2026-09-11T19:03:53.022Z" }, + { url = "https://files.pythonhosted.org/packages/95/b0/390915f9af14c1e2d3b2a9ad99d85b98df4352346a51e368cbb825f813c3/contourpy-1.4.0-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ddf5a2596d716fd3793434844caf31abc7a40b1e8718431420c89858268fb909", size = 348996, upload-time = "2026-09-11T19:03:54.594Z" }, + { url = "https://files.pythonhosted.org/packages/c7/85/e0952576d54322f3e9983b1e049a7a31f42ce82c5c29d01821e6dd3780d7/contourpy-1.4.0-cp314-cp314t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:dd59df9e2fb0aff8bd7fd1adb9f349b7c835245a9d0f18c2f2deeb537190f2b1", size = 400272, upload-time = "2026-09-11T19:03:56.822Z" }, + { url = "https://files.pythonhosted.org/packages/d6/7d/f13543a5e1598e4a4ad01d9d5e2d65f9c09c37660616429913d606c5977d/contourpy-1.4.0-cp314-cp314t-manylinux_2_26_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b7794ea07cab575633daad8d6e963b662053391022294d3aacc1d9ba9ef54114", size = 412895, upload-time = "2026-09-11T19:03:58.487Z" }, + { url = "https://files.pythonhosted.org/packages/c5/a8/6e5eaff53507dfd2dfc428240eecda32453067277d4b3e7ca71210b2d611/contourpy-1.4.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a1c8a74744fa746eeaa12f0f9ed7f8b4add9d8f1b14d95e3b5e133675eac888f", size = 377060, upload-time = "2026-09-11T19:04:00.122Z" }, + { url = "https://files.pythonhosted.org/packages/16/a3/d00e44d35511b3cead5bd794ee672d4eecf30d9de4ceac57a49d6204064f/contourpy-1.4.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:107ec46f7aa1664266d69b1181aadc953d58d39f7d8d648fa5b795d4a060b0de", size = 1345688, upload-time = "2026-09-11T19:04:02.705Z" }, + { url = "https://files.pythonhosted.org/packages/1e/01/1e533b0cae32c8edd63fe40435ec3b29345dab87321afcd28722d7f957d1/contourpy-1.4.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5a4c89c7f38a0d7a94356d74e3391073c4325c4d47ad2fd065c3fe7dbae16c0c", size = 1416140, upload-time = "2026-09-11T19:04:04.77Z" }, + { url = "https://files.pythonhosted.org/packages/6d/0c/4ee66759f00d6a5d6909782f14f441d639fa18a4a43142e334351efc47f8/contourpy-1.4.0-cp314-cp314t-win32.whl", hash = "sha256:912c6afaa106e2f74ba22b30416b77ef7eb94e3bdc5a4df51ab147845dba9b6d", size = 371982, upload-time = "2026-09-11T19:04:06.233Z" }, + { url = "https://files.pythonhosted.org/packages/e6/ac/b3e5324138c3e3741f526663f4f265f4f69dfdf26415a39428940864a5f6/contourpy-1.4.0-cp314-cp314t-win_amd64.whl", hash = "sha256:ef9440f6f8506246269a82734f5ff9e2e4c5e775b3996fc883cc491c5257eca6", size = 262907, upload-time = "2026-09-11T19:04:07.882Z" }, + { url = "https://files.pythonhosted.org/packages/19/37/c9aa45e47819dc15a38fc5c81a2fb987fde55e9d3b991fbde514e3b6b5f5/contourpy-1.4.0-cp314-cp314t-win_arm64.whl", hash = "sha256:fc9feef8f1f001c5b87decadc67c4a5d1eebb62ca39c4763d1237ff62cf2b707", size = 587071, upload-time = "2026-09-11T19:04:09.898Z" }, +] + +[[package]] +name = "cycler" +version = "0.12.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a9/95/a3dbbb5028f35eafb79008e7522a75244477d2838f38cbb722248dabc2a8/cycler-0.12.1.tar.gz", hash = "sha256:88bb128f02ba341da8ef447245a9e138fae777f6a23943da4540077d3601eb1c", size = 7615, upload-time = "2023-10-07T05:32:18.335Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e7/05/c19819d5e3d95294a6f5947fb9b9629efb316b96de511b418c53d245aae6/cycler-0.12.1-py3-none-any.whl", hash = "sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30", size = 8321, upload-time = "2023-10-07T05:32:16.783Z" }, +] + +[[package]] +name = "fastapi" +version = "0.143.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "annotated-doc" }, + { name = "opentelemetry-api" }, + { name = "pydantic" }, + { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/38/d5/b0aeb0b303650ac87b0411de4aaf3f901b06042dcc3fb00f30b97b7ff585/fastapi-0.143.3.tar.gz", hash = "sha256:b9ab567ee57afb4454004ce04c889f8f0160ac47946b99795887cd6e88484848", size = 469834, upload-time = "2026-10-16T14:14:13.31Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2c/1a/03d246befcf307219bb2161c97d8c5d314f84125bf7dd245730a28589828/fastapi-0.143.3-py3-none-any.whl", hash = "sha256:75e8bd68e2f52f77d29b2879749c257d64de2d85282d25270caf2bfccce5efe5", size = 144849, upload-time = "2026-10-16T14:14:11.763Z" }, +] + +[[package]] +name = "fonttools" +version = "4.67.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/94/36/102e180f8f5dbaee88b26595b01ca8aa80bf4e62128d9aa94265b3996c96/fonttools-4.67.0.tar.gz", hash = "sha256:3cb57e6600ca77c0b1729cf8adc23bc0652633a37f18cfa934d9c7bc3de25519", size = 3750028, upload-time = "2026-10-14T13:20:28.294Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/25/5b/c418f48918e40ef8c3f0f555567fe013c0c8058a8afa8040d6baeec80683/fonttools-4.67.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:846982e89b1861d6c9d7fcd6567aec3fa5a10ad313e7f2076045fcd339cfbd8e", size = 3110155, upload-time = "2026-10-14T13:19:14.877Z" }, + { url = "https://files.pythonhosted.org/packages/30/18/49013c643c3d56fce1b7e909ef7c01c36a5bd906dfb58571c9dcdaa4dc38/fonttools-4.67.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:952eb091689545d86d16e40f719ed7bb086dd810a07dcc9ea2ca0a81004810a3", size = 2599657, upload-time = "2026-10-14T13:19:16.93Z" }, + { url = "https://files.pythonhosted.org/packages/1f/2c/b7f33fa3bd1e4afdf9bf93b760f22486350eda487ce76c47f5931f868957/fonttools-4.67.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e2b5d511ea012dce7bd6df12b279b7d7a5b01b019865717d03ae679f4b944fa5", size = 5385200, upload-time = "2026-10-14T13:19:18.868Z" }, + { url = "https://files.pythonhosted.org/packages/79/fe/fef04b2cc2930edba11095f9e9b5c2797f8594fc54316195cc39d3c3bc63/fonttools-4.67.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:916836845e4b1c1447bb61390ffb3cb5f2940fd9f5d6de4685539a81806c7764", size = 5328754, upload-time = "2026-10-14T13:19:21.179Z" }, + { url = "https://files.pythonhosted.org/packages/2e/c6/41cd4f6137f61dd059cc0609b73d9556091ecfcc8cb4d3cc543129c8ec24/fonttools-4.67.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:775364ac079e2ea7a2eedb5f9172c57b059d638ff79e2bf8d4257e5805713f32", size = 5327159, upload-time = "2026-10-14T13:19:23.153Z" }, + { url = "https://files.pythonhosted.org/packages/53/5c/08abd0a6d5c36624411e1b934745b4689d4309b03e98d8cf49f9469c63b6/fonttools-4.67.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b3ddf350e74508102b33dc6b32984b6dd751359a7c57732bcd39f9d7cb37d71e", size = 5460332, upload-time = "2026-10-14T13:19:25.454Z" }, + { url = "https://files.pythonhosted.org/packages/b5/0f/59e835023817fe3932653067fde74960a0800fb95535375d8206aa9ecd68/fonttools-4.67.0-cp314-cp314-win32.whl", hash = "sha256:72d6d316dffc92eadb771f697f289ea7b60f689580931328905a267bd170f93b", size = 2448714, upload-time = "2026-10-14T13:19:27.73Z" }, + { url = "https://files.pythonhosted.org/packages/b3/d3/5230265a5ff16aead01ce1a432a6b5bbdabe086f433988f41a1395e6dff8/fonttools-4.67.0-cp314-cp314-win_amd64.whl", hash = "sha256:4e2c1586b5b6588a47d02e2588170eefdc996b708f2659c44dbe169bd6fcacb5", size = 2500790, upload-time = "2026-10-14T13:19:29.906Z" }, + { url = "https://files.pythonhosted.org/packages/b3/38/d899d7bbbe04d27dd509ac6b8f58f73fc240bb1dfe0ada9a9d33ad3bf9f2/fonttools-4.67.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:84a3aed005de106fb1794372dace82eca50859d52ae26da4bb6c602480a41250", size = 3183808, upload-time = "2026-10-14T13:19:32.015Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f6/4f465a62972e383b3d82205841b93f625a4e5ece6e5693c5be2a691ffe6d/fonttools-4.67.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:64e56d0d6a39780fee86955c758674538387b18f911ea904a4aae8f8e30fa26f", size = 2632826, upload-time = "2026-10-14T13:19:33.854Z" }, + { url = "https://files.pythonhosted.org/packages/d7/91/ce1ae8f8baa75feb2320caf6f74d2c228eba210a13b3e0895c0403e5e987/fonttools-4.67.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8c21073cfe7129aaa070d94f575c1e2a880ae4aae1dcffd5352f174b96d27d16", size = 5557857, upload-time = "2026-10-14T13:19:36.086Z" }, + { url = "https://files.pythonhosted.org/packages/fe/1c/495fe0a6bb8625e693c1417e178aeac42a11aa47e79efd7611c7bc5fb81e/fonttools-4.67.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:720bcf27727193b0fe1883c2e036dc88e37047916e977f5c3daf6ee4316e9656", size = 5364450, upload-time = "2026-10-14T13:19:38.5Z" }, + { url = "https://files.pythonhosted.org/packages/19/9c/d9730d3dd32e39583d6db929d0867df02042539bb0ebc3ad3d92a52a6aaf/fonttools-4.67.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:6c19a770a8d273371a37969003c143eaa629ab893c3db028af8b91d04c6f9a6d", size = 5425231, upload-time = "2026-10-14T13:19:40.659Z" }, + { url = "https://files.pythonhosted.org/packages/f0/c6/d41c1163431828b0fa2172e867798e0c4517ac6606e774b9175e048fb666/fonttools-4.67.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:13d7507252c5a5d7941a5fa1be27d335c378ef07983ea2bb24988bf600eadd5e", size = 5460574, upload-time = "2026-10-14T13:19:43.22Z" }, + { url = "https://files.pythonhosted.org/packages/95/af/14885b78b1c1ff7219f890b79a5a6f76608d907c171b40e43839de995f54/fonttools-4.67.0-cp314-cp314t-win32.whl", hash = "sha256:07a2f36b3263faadf5b7b548f62fd3cac401e490189c82b16f7139ac0df91cd4", size = 2482468, upload-time = "2026-10-14T13:19:45.91Z" }, + { url = "https://files.pythonhosted.org/packages/cf/33/3d660eb850d24a81b4097ed46a1352c4ac0e4c10025526fa115e1871fc64/fonttools-4.67.0-cp314-cp314t-win_amd64.whl", hash = "sha256:fd79e36c2968e9fc3e1b082f2ba7dc63ae88a161a3d8ceaa0746b906455f3617", size = 2532326, upload-time = "2026-10-14T13:19:48.023Z" }, + { url = "https://files.pythonhosted.org/packages/3d/61/4161946319472aaa9b897bd18ad5108a5b10f5ebaa503d921a001ac4fff9/fonttools-4.67.0-py3-none-any.whl", hash = "sha256:4304f03ed7f4ba000a8dcc941ad854bfa52e2f3b6112b8f099b6f431cf98e701", size = 1213142, upload-time = "2026-10-14T13:20:26.258Z" }, +] + +[[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 = "httpcore" +version = "1.0.9" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "certifi" }, + { name = "h11" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" }, +] + +[[package]] +name = "httpx" +version = "0.28.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, + { name = "certifi" }, + { name = "httpcore" }, + { name = "idna" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" }, +] + +[[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 = "iniconfig" +version = "2.3.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/01/e1/2069291243c926a2ff1cd706c7f3eeb9b62144bf60f77c9fb9ff2fb26bd3/iniconfig-2.3.1.tar.gz", hash = "sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960", size = 21209, upload-time = "2026-10-06T22:48:38.076Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/56/43/4ca9e49d27a1fcf6bece6f6aec0ea46bb9112489b93d4b688fb415457bdb/iniconfig-2.3.1-py3-none-any.whl", hash = "sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7", size = 7552, upload-time = "2026-10-06T22:48:36.959Z" }, +] + +[[package]] +name = "jmespath" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d3/59/322338183ecda247fb5d1763a6cbe46eff7222eaeebafd9fa65d4bf5cb11/jmespath-1.1.0.tar.gz", hash = "sha256:472c87d80f36026ae83c6ddd0f1d05d4e510134ed462851fd5f754c8c3cbb88d", size = 27377, upload-time = "2026-01-22T16:35:26.279Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/14/2f/967ba146e6d58cf6a652da73885f52fc68001525b4197effc174321d70b4/jmespath-1.1.0-py3-none-any.whl", hash = "sha256:a5663118de4908c91729bea0acadca56526eb2698e83de10cd116ae0f4e97c64", size = 20419, upload-time = "2026-01-22T16:35:24.919Z" }, +] + +[[package]] +name = "jsonschema" +version = "4.26.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "attrs" }, + { name = "jsonschema-specifications" }, + { name = "referencing" }, + { name = "rpds-py" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" }, +] + +[[package]] +name = "jsonschema-path" +version = "0.3.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pathable" }, + { name = "pyyaml" }, + { name = "referencing" }, + { name = "requests" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/6e/45/41ebc679c2a4fced6a722f624c18d658dee42612b83ea24c1caf7c0eb3a8/jsonschema_path-0.3.4.tar.gz", hash = "sha256:8365356039f16cc65fddffafda5f58766e34bebab7d6d105616ab52bc4297001", size = 11159, upload-time = "2025-01-24T14:33:16.547Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cb/58/3485da8cb93d2f393bce453adeef16896751f14ba3e2024bc21dc9597646/jsonschema_path-0.3.4-py3-none-any.whl", hash = "sha256:f502191fdc2b22050f9a81c9237be9d27145b9001c55842bece5e94e382e52f8", size = 14810, upload-time = "2025-01-24T14:33:14.652Z" }, +] + +[[package]] +name = "jsonschema-specifications" +version = "2025.9.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "referencing" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" }, +] + +[[package]] +name = "kiwisolver" +version = "1.5.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ba/07/bd78e6a8fae171ea041ef5bba3ed21a003522fa088834b069b1909981f30/kiwisolver-1.5.1.tar.gz", hash = "sha256:f1303ef2eec81262a4b708c3e858afe58d7c75ad91c1c05266eda7673369859a", size = 104395, upload-time = "2026-08-28T10:28:27.153Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/dd/87/2d5dfad0daf17dcc18d98c48ed2332fc3f051cf599e60be6182a30dd4cf1/kiwisolver-1.5.1-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:0324cd2567259b7a095f6cf18a52b0ffc6f3de9e69528ff1bc0e7a37bd43ff1a", size = 62337, upload-time = "2026-08-28T10:26:18.778Z" }, + { url = "https://files.pythonhosted.org/packages/08/c8/83e1624f15d6262b470dbcc80b09979fd4d5b2ea3ddfc6b6e3327e235726/kiwisolver-1.5.1-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:74ea337e0ec3f6f342a36a4f1b5cd94dd9affddcd28ba9aae2905af932ee8c6b", size = 64513, upload-time = "2026-08-28T10:26:19.909Z" }, + { url = "https://files.pythonhosted.org/packages/c9/2d/827ec30eb07f528c08d8459ffb318ae91a56d793ee8acbea8b491f0ff906/kiwisolver-1.5.1-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:ee9df1f0d77b9c6e94f4ac0fec533fbddd5ea3a327807f18d7b069ae019ded80", size = 66287, upload-time = "2026-08-28T10:26:21.078Z" }, + { url = "https://files.pythonhosted.org/packages/53/11/5c43a562529dad8def4b81e5e1877c612a7e0298105a5939b3b409d2079c/kiwisolver-1.5.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fc271a6f0a2126958f4090e5507b9da5848927dae331f8f763bd4aa642b3d2cd", size = 123940, upload-time = "2026-08-28T10:26:22.475Z" }, + { url = "https://files.pythonhosted.org/packages/64/db/9bd6c505c95128c258a55236bfbb3a7a3fb6023f863316b6d7d9f3c69052/kiwisolver-1.5.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:9b3092d8992a1d69b7a59c3e39f35e1b9be327a17f68a7c35fc17329e337d6f2", size = 66493, upload-time = "2026-08-28T10:26:23.743Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f4/b3007a3ed5c9be73f81161140684cf7d9bdb9c4b632f5f484d2a1c713fb9/kiwisolver-1.5.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c2306e8bb53601979fcb3fa09cc65e031876d9ae01eff2fcbcd7a84ef94d5bc1", size = 64720, upload-time = "2026-08-28T10:26:24.95Z" }, + { url = "https://files.pythonhosted.org/packages/a1/13/08188f0cafa3a800403e4ff62b9aad4e7a17f9c4c7e080dc8f18c64794cf/kiwisolver-1.5.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:18a0cfb124546a4c2e6087c5f3029c7f44b37c85b142e0ced71f73a7599ac208", size = 1475867, upload-time = "2026-08-28T10:26:26.393Z" }, + { url = "https://files.pythonhosted.org/packages/8a/3e/053bdc3c9abdb8f2606225eda398adca25c0c91ab90add8222a69db65ee0/kiwisolver-1.5.1-cp314-cp314-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:34ec467940442c9943016fb2d4c81d1ba84351eeca2f1a78f8bc87f1ba0d414c", size = 1282865, upload-time = "2026-08-28T10:26:28.118Z" }, + { url = "https://files.pythonhosted.org/packages/5e/64/a44c341b36b610588cc2f1e89b3cae072a3119aa8be578e90987cd640751/kiwisolver-1.5.1-cp314-cp314-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a83ee7107df13abe42a54a6654670eef9bb39425cf2e27f65e0007465e1286ab", size = 1300865, upload-time = "2026-08-28T10:26:30.125Z" }, + { url = "https://files.pythonhosted.org/packages/60/5e/7e7d716dca38c714478b741257a5b4a321d9932b8d851551a136dcaf3984/kiwisolver-1.5.1-cp314-cp314-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bebb89489b279b2f5661bbbb2abcc87bcd4a46607bb4a5c966f04f1db6b8df9a", size = 1348071, upload-time = "2026-08-28T10:26:31.829Z" }, + { url = "https://files.pythonhosted.org/packages/10/1a/2b98fdda8bf45b7be317e48ed12393d44334394d315c74b81f4a14c0e31b/kiwisolver-1.5.1-cp314-cp314-manylinux_2_39_riscv64.whl", hash = "sha256:509735237ae0d849e8a843551d423d2500d2e0a9ac1611a145658b29c0fb9f85", size = 992191, upload-time = "2026-08-28T10:26:33.544Z" }, + { url = "https://files.pythonhosted.org/packages/b6/55/d893f5ede0e50f9e3fcf01f6015f42ec7d9cd221e26772701fe4a98745f9/kiwisolver-1.5.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:824c3d763a05ea9e9003610145186b0e9848c7584a5575c79bac5a8e7cd80bad", size = 2233854, upload-time = "2026-08-28T10:26:35.282Z" }, + { url = "https://files.pythonhosted.org/packages/b1/82/f85f6279555a6ee1639fef7bfe83adb037a03e11a6fc9eaa54b8d0380339/kiwisolver-1.5.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:1fff05e239575b1481b6ed1a782f6fad616efbf1f0b1f44e6e85c4dfe426e483", size = 2330621, upload-time = "2026-08-28T10:26:36.9Z" }, + { url = "https://files.pythonhosted.org/packages/56/31/e11aea078f66fc2fffcc179d38ca90d9da97652a241b64519169742ba46a/kiwisolver-1.5.1-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0627b9bceb9c3cdcf12b8a18655eedfed2692b038df27423383c120d0b7dc2d6", size = 1982848, upload-time = "2026-08-28T10:26:39.01Z" }, + { url = "https://files.pythonhosted.org/packages/af/ea/2956b63bf5140ca46aa2c2818e6aa03e2d5754dd2fa41db1c6b28922940c/kiwisolver-1.5.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:8a708a47ade1fe19e8371d5da076bac0dd4b0a5a7985ad6c637f7f7e361b6baa", size = 2494850, upload-time = "2026-08-28T10:26:40.837Z" }, + { url = "https://files.pythonhosted.org/packages/11/d1/3829542258d8b3fc0898d221e7ef0e2c83eca0d348709bb8dbe54f3d4005/kiwisolver-1.5.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:007a5553dfc4f4e8d184f588a0200e2cd4b63a59cc8796df3c39909e679dc7a0", size = 2298067, upload-time = "2026-08-28T10:26:42.803Z" }, + { url = "https://files.pythonhosted.org/packages/4e/0e/49522e1ab5788cbaf63a26fbd3b851f9028616828c961b8a31b35cb96df8/kiwisolver-1.5.1-cp314-cp314-win_amd64.whl", hash = "sha256:f4167e87b397f273dc2356fcf1eaf50a6bac51e6105f45103ef7129c8efb0255", size = 72282, upload-time = "2026-08-28T10:26:44.268Z" }, + { url = "https://files.pythonhosted.org/packages/f5/b6/22e7ca5315d363e6f81c9f37c9472e12e7b298731e77c0428e6a911a2c39/kiwisolver-1.5.1-cp314-cp314-win_arm64.whl", hash = "sha256:5c490db2168a508088f59140dd392556a54b8bd1048fc6383c8baff13c359673", size = 69855, upload-time = "2026-08-28T10:26:45.725Z" }, + { url = "https://files.pythonhosted.org/packages/30/8c/03a9cfbe871964c8758a816eb03ac96c806da2795a9a7cd9bf9648bfb594/kiwisolver-1.5.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:4d4ca09bf13cff792b1884f64b98ee6c2467930d632233be25c56b442d99f10e", size = 126289, upload-time = "2026-08-28T10:26:47.023Z" }, + { url = "https://files.pythonhosted.org/packages/f2/e3/14ce3041ca79dff9c9d884ca00c7bf32374e76028a865a9ecd99b4f5a517/kiwisolver-1.5.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:44b8faef94f1857e77fa0238f3390ff1ac51d2ea20a487e2e452a59fd2b5f5ca", size = 67709, upload-time = "2026-08-28T10:26:48.268Z" }, + { url = "https://files.pythonhosted.org/packages/af/c4/45030471a66ec8ef042e9f96ffe1d522c9ab12da180186a0898966fc1385/kiwisolver-1.5.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2ae70bc59790d2af72a3f76f24b272403e135070340281108b447cb77ea70819", size = 65909, upload-time = "2026-08-28T10:26:49.523Z" }, + { url = "https://files.pythonhosted.org/packages/42/73/17dce073a6ae259bb32cf9d686c4079d2e538868bc45967462bf33df914a/kiwisolver-1.5.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:43844c1a7ad6d723d5b5b4c4fc7f5bd399c40e288120d16257c7c9e8765c6e85", size = 1584907, upload-time = "2026-08-28T10:26:50.933Z" }, + { url = "https://files.pythonhosted.org/packages/8c/84/ae3c75909f507283cbfcc7e916c7e822579ef962020b97e6882b27b4478f/kiwisolver-1.5.1-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:22d5e5aaad6be121f2515765e3b1c444352cb8eb4c86510801db8f2e50757316", size = 1392474, upload-time = "2026-08-28T10:26:52.638Z" }, + { url = "https://files.pythonhosted.org/packages/34/31/8bcc83caad5bce8fa4577152389848bf6bc110e51e573a2b4e7c2aa34c89/kiwisolver-1.5.1-cp314-cp314t-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:3fa5855898f6d3d01b72ccd48a2d65cbdee301251603fefe34e2025bddba219c", size = 1405246, upload-time = "2026-08-28T10:26:54.248Z" }, + { url = "https://files.pythonhosted.org/packages/55/72/220345537d790cf4ae54f8acfff4b5cc2468e0702a384d651cf7a771c63e/kiwisolver-1.5.1-cp314-cp314t-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d66a64dd5dec136040ec2ae94aa026a912ee60fdd45bc28d3db30037fd809e88", size = 1456099, upload-time = "2026-08-28T10:26:56.042Z" }, + { url = "https://files.pythonhosted.org/packages/cd/10/3725fd2398f66d18c34b4e0f81a8d03764cd4f4f089f58a527f0b4428086/kiwisolver-1.5.1-cp314-cp314t-manylinux_2_39_riscv64.whl", hash = "sha256:9e51c119992ea8820706871c30a4642ec76de20ae82f9b50b9a45517d8e9f810", size = 1073695, upload-time = "2026-08-28T10:26:57.658Z" }, + { url = "https://files.pythonhosted.org/packages/86/cb/28d6e09e66b93e4588b2e6b7d84d020ccefea09e2f4de788510a07efeab7/kiwisolver-1.5.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:70ed9a45c7484d2b30cdacf60d220f494a1763b9fec1ad03285c6553fa0889f2", size = 2335355, upload-time = "2026-08-28T10:26:59.202Z" }, + { url = "https://files.pythonhosted.org/packages/6a/b3/a0f31d5e4e40af7dc97c36b8a74fdd3a36cf3c8bbd098da9a23466ff6a94/kiwisolver-1.5.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:98b208a7cc42c803445ef551d6753cc42a5ea13e9cab1ee66cd8b9cb70195330", size = 2426524, upload-time = "2026-08-28T10:27:01.181Z" }, + { url = "https://files.pythonhosted.org/packages/2f/c9/728f63bd58c72cafdc79fc306abeeac7391bec03b757a48dadeb30906521/kiwisolver-1.5.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:c6834b92dd2428e2dd85ef3d85f723d3c12f20aaf43a2ddd4f944ca25d833408", size = 2063430, upload-time = "2026-08-28T10:27:03.06Z" }, + { url = "https://files.pythonhosted.org/packages/84/df/ce188b96f92f9a2c958231da140768918cba53c9713dc887b82f85462118/kiwisolver-1.5.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:5d142e352eb13facc7dd047489aebdff6ba78576c239f1ea04931979caaf0567", size = 2597513, upload-time = "2026-08-28T10:27:05.072Z" }, + { url = "https://files.pythonhosted.org/packages/69/d6/76947c8203768968382e5bd74d9cc95654746703a61ea53015f2c74a2e06/kiwisolver-1.5.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f9b1c4900736e489a812c529100de4b8fb617d4db075e931e213c57424b83d9b", size = 2394488, upload-time = "2026-08-28T10:27:07.423Z" }, + { url = "https://files.pythonhosted.org/packages/e4/d4/14b21e4eb203c4d15425e8b6a2c625a320b4a1f2f7557eead63ffc30ffb7/kiwisolver-1.5.1-cp314-cp314t-win_amd64.whl", hash = "sha256:5978c3340f16a35c30f8ab2fa7bcf559973c55f1a5ef6970e1f621acf3c4db13", size = 75404, upload-time = "2026-08-28T10:27:08.892Z" }, + { url = "https://files.pythonhosted.org/packages/cb/f5/53157899fc7f45f76421b77b99eb1639dd0f83f26ff9d76300c96bb4a3b0/kiwisolver-1.5.1-cp314-cp314t-win_arm64.whl", hash = "sha256:ca307d6c259e5c98d3cb9ade55342b47a6839762caf2536f3d7b46ee660cc82e", size = 72946, upload-time = "2026-08-28T10:27:10.944Z" }, +] + +[[package]] +name = "lazy-object-proxy" +version = "1.12.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/08/a2/69df9c6ba6d316cfd81fe2381e464db3e6de5db45f8c43c6a23504abf8cb/lazy_object_proxy-1.12.0.tar.gz", hash = "sha256:1f5a462d92fd0cfb82f1fab28b51bfb209fabbe6aabf7f0d51472c0c124c0c61", size = 43681, upload-time = "2025-08-22T13:50:06.783Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ef/3a/277857b51ae419a1574557c0b12e0d06bf327b758ba94cafc664cb1e2f66/lazy_object_proxy-1.12.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c9defba70ab943f1df98a656247966d7729da2fe9c2d5d85346464bf320820a3", size = 26582, upload-time = "2025-08-22T13:49:49.366Z" }, + { url = "https://files.pythonhosted.org/packages/1a/b6/c5e0fa43535bb9c87880e0ba037cdb1c50e01850b0831e80eb4f4762f270/lazy_object_proxy-1.12.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:6763941dbf97eea6b90f5b06eb4da9418cc088fce0e3883f5816090f9afcde4a", size = 71059, upload-time = "2025-08-22T13:49:50.488Z" }, + { url = "https://files.pythonhosted.org/packages/06/8a/7dcad19c685963c652624702f1a968ff10220b16bfcc442257038216bf55/lazy_object_proxy-1.12.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fdc70d81235fc586b9e3d1aeef7d1553259b62ecaae9db2167a5d2550dcc391a", size = 71034, upload-time = "2025-08-22T13:49:54.224Z" }, + { url = "https://files.pythonhosted.org/packages/12/ac/34cbfb433a10e28c7fd830f91c5a348462ba748413cbb950c7f259e67aa7/lazy_object_proxy-1.12.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0a83c6f7a6b2bfc11ef3ed67f8cbe99f8ff500b05655d8e7df9aab993a6abc95", size = 69529, upload-time = "2025-08-22T13:49:55.29Z" }, + { url = "https://files.pythonhosted.org/packages/6f/6a/11ad7e349307c3ca4c0175db7a77d60ce42a41c60bcb11800aabd6a8acb8/lazy_object_proxy-1.12.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:256262384ebd2a77b023ad02fbcc9326282bcfd16484d5531154b02bc304f4c5", size = 70391, upload-time = "2025-08-22T13:49:56.35Z" }, + { url = "https://files.pythonhosted.org/packages/59/97/9b410ed8fbc6e79c1ee8b13f8777a80137d4bc189caf2c6202358e66192c/lazy_object_proxy-1.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:7601ec171c7e8584f8ff3f4e440aa2eebf93e854f04639263875b8c2971f819f", size = 26988, upload-time = "2025-08-22T13:49:57.302Z" }, +] + +[[package]] +name = "matplotlib" +version = "3.11.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "contourpy" }, + { name = "cycler" }, + { name = "fonttools" }, + { name = "kiwisolver" }, + { name = "numpy" }, + { name = "packaging" }, + { name = "pillow" }, + { name = "pyparsing" }, + { name = "python-dateutil" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/e7/c8/9aa712a0afb882649424dd8de8ad9aa6235e796e84c6052e8f6dc1598d0d/matplotlib-3.11.2.tar.gz", hash = "sha256:cec596316640f2b394b8f0daa0ea61a8eae82d017b620b9f202befb972a59ea4", size = 32660610, upload-time = "2026-09-11T19:05:31.214Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/54/b4/4facdb700bc236e4c676495ca3798d8134ab8668cbfe0f6b2e9ebf962a38/matplotlib-3.11.2-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:c9721f81275499da1feeb36a2cf8192ea086283b3bd16b7dc4c9d7aedb7396d6", size = 9478976, upload-time = "2026-09-11T19:04:00.12Z" }, + { url = "https://files.pythonhosted.org/packages/4c/a0/bba05f0a25bfeb0475c2f2a87958b31103aa6b7a5386017afb1a96212825/matplotlib-3.11.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1a3040b209f3968b4e84161df7b174f07a9fad33b0f2d7e48ea3bbd3075e2863", size = 9307932, upload-time = "2026-09-11T19:04:02.976Z" }, + { url = "https://files.pythonhosted.org/packages/d4/42/81d5cba4bb39b41b0998efc880e129f2d7cdb94256ca49678fdcd9c21be5/matplotlib-3.11.2-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bf3fe71fbfb8ec0e310e0bc8537c3405a01f38f25f9394ed2135e6202fed542b", size = 10674370, upload-time = "2026-09-11T19:04:06.912Z" }, + { url = "https://files.pythonhosted.org/packages/29/5e/52f56f93d5b20815ee0ae352f7a38eff25580edb180b4fa7df87cfeba68f/matplotlib-3.11.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8c8255de28f986d935a64c9ca71c0ec2d2f41d355691f5ea684725dc91413f71", size = 10954597, upload-time = "2026-09-11T19:04:09.948Z" }, + { url = "https://files.pythonhosted.org/packages/6e/ae/f8918a1b564db49c53cd603eb3c8748c5767e4ce0fb2cf1d7c38653e4c5d/matplotlib-3.11.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a8756cc73d9af9a7fe0deb54ea2e75ef73b01d9e575877e72acad5458e660943", size = 10812583, upload-time = "2026-09-11T19:04:12.887Z" }, + { url = "https://files.pythonhosted.org/packages/ea/61/4315ef0d63937fe56f451887b4a0be3b8e8b22cf1d92a8d157caac54570d/matplotlib-3.11.2-cp314-cp314-win_amd64.whl", hash = "sha256:ecea603dd2fbf8242fd31a305a8b12a4ece2de28096870c65fdd0d1e35b8d9a6", size = 9505972, upload-time = "2026-09-11T19:04:15.788Z" }, + { url = "https://files.pythonhosted.org/packages/d5/00/02398b0a1a62ef73d9af0a957fe1773363eec9a6ca7e433c72ae2790fbce/matplotlib-3.11.2-cp314-cp314-win_arm64.whl", hash = "sha256:01dc8eaaab5a9fce9ff615eca82345728f289e4715b186ee10c6d85272fc26bb", size = 9184534, upload-time = "2026-09-11T19:04:18.691Z" }, + { url = "https://files.pythonhosted.org/packages/ec/c5/1e6ca10baa7e04f113c37856aadb4adc3dbb1c55fc7da6dc830bba1292d7/matplotlib-3.11.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:79a258f58253dfa025af80a9e9bb228d75fced007f0e93ae7423fefbde81a74d", size = 9526415, upload-time = "2026-09-11T19:04:21.39Z" }, + { url = "https://files.pythonhosted.org/packages/e0/93/7561727af07ccc84747953c6a33eee3981cc436d04f465032e707ca0e429/matplotlib-3.11.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c0b83f044ce10a98027b105b3931548719a6e8c7ef986b4362651e0b5367c8dc", size = 9361064, upload-time = "2026-09-11T19:04:24.107Z" }, + { url = "https://files.pythonhosted.org/packages/c1/40/ce270ef2a6794d94a409fe28b8dabedffc07c07f9e5dbb89e0f605bd157d/matplotlib-3.11.2-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e43b188f0a5b75447bcc197728258166aa64365770ed1caa36595a5e1ca4bbba", size = 10684626, upload-time = "2026-09-11T19:04:27.201Z" }, + { url = "https://files.pythonhosted.org/packages/45/46/396e0307dbf1c1f2d0a3654caa6dbc780dd5379f5f11257369cf8d21d9fe/matplotlib-3.11.2-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3304eb5a59442a8867f6920d484591c0fa09ffc29e9260be2feec3351e25869", size = 10960602, upload-time = "2026-09-11T19:04:30.254Z" }, + { url = "https://files.pythonhosted.org/packages/1c/97/4defb84695477340aa88b27c9482cc1ca4de11f36f66b6c8c0ddd685def1/matplotlib-3.11.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:02329432ae5c6af87cf208ee575b701d698bdf0b1a3bb28cc6d53c36e967e575", size = 10822603, upload-time = "2026-09-11T19:04:32.964Z" }, + { url = "https://files.pythonhosted.org/packages/7d/e7/eab54551c1ec6b72dcd678a078b6c6da8d4c85ec1ff0016e81fe52866304/matplotlib-3.11.2-cp314-cp314t-win_amd64.whl", hash = "sha256:f2ac30cf5eb5dff1b584627ae0b0e1186551a4f69ae3c75073911da497a29170", size = 9551206, upload-time = "2026-09-11T19:04:35.811Z" }, + { url = "https://files.pythonhosted.org/packages/4e/0e/04698032cb4d8fb1e30d8ffec5ded20f6f582b03c8c58b2385c95245f158/matplotlib-3.11.2-cp314-cp314t-win_arm64.whl", hash = "sha256:cf41ecd1b0c0b6f7177ed965a54c2afbe888715c7cf6054dc12d53bc1494002c", size = 9234977, upload-time = "2026-09-11T19:04:38.972Z" }, +] + +[[package]] +name = "mtusi-messenger" +version = "0.4.0" +source = { editable = "." } +dependencies = [ + { name = "argon2-cffi" }, + { name = "boto3" }, + { name = "fastapi" }, + { name = "pillow" }, + { name = "psycopg", extra = ["binary", "pool"] }, + { name = "pydantic" }, + { name = "redis" }, + { name = "uvicorn" }, +] + +[package.dev-dependencies] +dev = [ + { name = "httpx" }, + { name = "openapi-spec-validator" }, + { name = "pytest" }, + { name = "ruff" }, +] +research = [ + { name = "matplotlib" }, +] + +[package.metadata] +requires-dist = [ + { name = "argon2-cffi", specifier = "==25.1.0" }, + { name = "boto3", specifier = "==1.43.109" }, + { name = "fastapi", specifier = "==0.143.3" }, + { name = "pillow", specifier = "==13.0.0" }, + { name = "psycopg", extras = ["binary", "pool"], specifier = "==3.3.6" }, + { name = "pydantic", specifier = "==2.14.1" }, + { name = "redis", specifier = "==8.1.0" }, + { name = "uvicorn", specifier = "==0.54.0" }, +] + +[package.metadata.requires-dev] +dev = [ + { name = "httpx", specifier = "==0.28.1" }, + { name = "openapi-spec-validator", specifier = "==0.7.2" }, + { name = "pytest", specifier = "==9.1.1" }, + { name = "ruff", specifier = "==0.17.1" }, +] +research = [{ name = "matplotlib", specifier = "==3.11.2" }] + +[[package]] +name = "numpy" +version = "2.5.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/95/b0/c7453d0b6e2073c3264468b106ee1563750cecc910965e67357e3698c83e/numpy-2.5.4.tar.gz", hash = "sha256:9a94cf751c9ad8ebaa835bcd3d40dacf8534ad086b88c38029b65123c7999d2a", size = 20866315, upload-time = "2026-10-10T20:05:31.422Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/99/ba/005cb5edd580d2f84d7ca3206b92dc17d4388e56e6f87ffe8f2762f83139/numpy-2.5.4-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:c668b2f0d651605b58892644b0e302c7157f7159544227758c896982ef384b18", size = 17005499, upload-time = "2026-10-10T20:03:37.961Z" }, + { url = "https://files.pythonhosted.org/packages/f3/49/fee7587c33ee35f7977f9051d7f2023d4e7246d62710c80f20c2361ea232/numpy-2.5.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ffa6ce09a1c6a08e9667dd9c97aa0b14184e8d18f2a14b78b2a2328c9147f076", size = 12019666, upload-time = "2026-10-10T20:03:40.606Z" }, + { url = "https://files.pythonhosted.org/packages/d5/b2/c6ce165acffceb15a82c07b9cc77d391f86b3f379ba62911908ae5d34b91/numpy-2.5.4-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:956555e0603a4d38019ae6925711cb9dc43195c076a928accf7ea5d50bddfe53", size = 5455617, upload-time = "2026-10-10T20:03:43.138Z" }, + { url = "https://files.pythonhosted.org/packages/77/7f/dd85ce260a669a89be06842cf355d7353a33e6cfbc590fb8ebb947d88dc9/numpy-2.5.4-cp314-cp314-macosx_14_0_x86_64.whl", hash = "sha256:2c2c4afffdeb7920e445028dd71eb932cac3e704792e964bc2a232426d4f1255", size = 6791932, upload-time = "2026-10-10T20:03:44.874Z" }, + { url = "https://files.pythonhosted.org/packages/63/d6/34b0a2b0741386a63025a65a2c09caaaaaad6d0ca95b66cd65c30dd7fcb5/numpy-2.5.4-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4054173604cd8658796053f1f3bc0befb68ec1c0762c57fdad61e199256a8617", size = 15710899, upload-time = "2026-10-10T20:03:46.839Z" }, + { url = "https://files.pythonhosted.org/packages/16/d5/928078d2b28f26829b138b4a6c3980045022fb409f570657a224ae60ef4e/numpy-2.5.4-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d549420b8858885cea8838a727842249218b9c1da24dd517e25c9c7a948310a3", size = 16721710, upload-time = "2026-10-10T20:03:49.489Z" }, + { url = "https://files.pythonhosted.org/packages/f9/cf/673fd1b8f4cd78eb6320e87ec4c90ac19c095644259e3749853a405c70f4/numpy-2.5.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:823874a507a84af050493b622affde94b6f7c3a0dc22cb2801381bc03b871c00", size = 17066182, upload-time = "2026-10-10T20:03:52.25Z" }, + { url = "https://files.pythonhosted.org/packages/f3/92/a77b5061b1b3e2643928c37976d79ee173e1b171ed158b7a3c61056b41bc/numpy-2.5.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:4e263278bfb5ee6409db8aedbc4cc32973b1b82bc1e8d3c668551d04d83a7e37", size = 18480315, upload-time = "2026-10-10T20:03:55.39Z" }, + { url = "https://files.pythonhosted.org/packages/bb/1d/1486ef3d3fb2279fd93c4c43c1bbbf1ca389a19816696684409f71babaab/numpy-2.5.4-cp314-cp314-win32.whl", hash = "sha256:cfd73180400042a7c532d30c5e287bdd03c59ff9ee1b4c0316af0539e29dfe23", size = 6185739, upload-time = "2026-10-10T20:03:58.186Z" }, + { url = "https://files.pythonhosted.org/packages/52/9a/e1e512ebc948d5b9dd33b08736760f0ebbed2848fd4eda1f553088a6dcee/numpy-2.5.4-cp314-cp314-win_amd64.whl", hash = "sha256:2ca144f15135b6212a5c47b1e2aeca6e412f102f95a2d5d88d8aec77eb255de3", size = 12703552, upload-time = "2026-10-10T20:04:00.28Z" }, + { url = "https://files.pythonhosted.org/packages/2c/05/de709a982d7bbcd688a3fad71f002e9ff80c2db39e03ee726609b610f1d1/numpy-2.5.4-cp314-cp314-win_arm64.whl", hash = "sha256:468397ba3c64427474706e5c9123fe266395496714dc684294eac75cd4930d1e", size = 10803901, upload-time = "2026-10-10T20:04:02.659Z" }, + { url = "https://files.pythonhosted.org/packages/13/34/083570ada3bb2a30fbe5d77c8c6fef9141144a15d33e6f793a67e9749ab8/numpy-2.5.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1ef3aa6d7e29bb13677323114280b05acc57607fa2300e66432d665d5418a162", size = 12138695, upload-time = "2026-10-10T20:04:05.012Z" }, + { url = "https://files.pythonhosted.org/packages/94/06/1f9c24db48eef0c2d1207e3b11fffb0478e39dfd8c1e1be7476936885eed/numpy-2.5.4-cp314-cp314t-macosx_14_0_arm64.whl", hash = "sha256:98b053943e5a0474ec0da309d2cb9d3f18ea57f8a2067c2ab7b5f763d1068380", size = 5574615, upload-time = "2026-10-10T20:04:07.316Z" }, + { url = "https://files.pythonhosted.org/packages/da/0f/593fba2e1560e949123bc7d2fc48b5893d56e58cd4bd5a273d2fbf60b220/numpy-2.5.4-cp314-cp314t-macosx_14_0_x86_64.whl", hash = "sha256:b64a85f40e154983960a4167d4c1d57a50c7f109b3d3264a3a984154e90a8454", size = 6889383, upload-time = "2026-10-10T20:04:09.918Z" }, + { url = "https://files.pythonhosted.org/packages/eb/9f/b799dfdce4e05e80ed4bc815c71ff343a11533b2c0ffc221cae8538cda63/numpy-2.5.4-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a813ed7719bf45463c51779e6a98d0385fe905e48447526938a4b8337333d551", size = 15753763, upload-time = "2026-10-10T20:04:12.278Z" }, + { url = "https://files.pythonhosted.org/packages/34/88/16c5f12f86f5ad2817c4d103205131fc6c8acb3d1878af05a1a4f23ec859/numpy-2.5.4-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c9b80cdf5cedba0e90d93fa5f9a333c4d65bd545cd669b71bb97ce2b703c9d73", size = 16757212, upload-time = "2026-10-10T20:04:14.799Z" }, + { url = "https://files.pythonhosted.org/packages/ff/4f/a1fe40e18a898e6a5089f4f0d891f0a493eb0574d5b34458f0fbe5aa3e5c/numpy-2.5.4-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:2199ed071f460487c8db2c0e5c0b564494190edb4772fe80f9aad88b2604def5", size = 17116471, upload-time = "2026-10-10T20:04:17.58Z" }, + { url = "https://files.pythonhosted.org/packages/aa/46/e923a11c78e65c1722e7aaad817c06bd591324174b9d28ce5d31eee4d432/numpy-2.5.4-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:64f9c9878c1938476365e11ccfb6b770f3b9e5f045ccddc514235041e6959365", size = 18524063, upload-time = "2026-10-10T20:04:20.365Z" }, + { url = "https://files.pythonhosted.org/packages/5a/fa/84ab064514440c1f64a1b21088f2c82756defdd05e07c75ab233899565b2/numpy-2.5.4-cp314-cp314t-win32.whl", hash = "sha256:64d1c8ac28a4077cf987e0a71a7a0ef7e2df70722f07f0baa42dbb7eb6938647", size = 6340926, upload-time = "2026-10-10T20:04:22.865Z" }, + { url = "https://files.pythonhosted.org/packages/7e/7e/6cd886876f435b10685db9b9f7eeb70356f99e052116f4e5f11c5792c714/numpy-2.5.4-cp314-cp314t-win_amd64.whl", hash = "sha256:067374eb538c34c745436365cf7b0112595c1d326f21ce4ff340f61230239fbb", size = 12901584, upload-time = "2026-10-10T20:04:24.99Z" }, + { url = "https://files.pythonhosted.org/packages/38/1b/3c1684f6a06f7307f2335fca6e486cb162847fb97e91d65f8eb5cabad213/numpy-2.5.4-cp314-cp314t-win_arm64.whl", hash = "sha256:e94aef2c639da4a960ad0db8e06471208d8589974953d78b61d345b4eb99e394", size = 10891152, upload-time = "2026-10-10T20:04:27.52Z" }, +] + +[[package]] +name = "openapi-schema-validator" +version = "0.6.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "jsonschema" }, + { name = "jsonschema-specifications" }, + { name = "rfc3339-validator" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/8b/f3/5507ad3325169347cd8ced61c232ff3df70e2b250c49f0fe140edb4973c6/openapi_schema_validator-0.6.3.tar.gz", hash = "sha256:f37bace4fc2a5d96692f4f8b31dc0f8d7400fd04f3a937798eaf880d425de6ee", size = 11550, upload-time = "2025-01-10T18:08:22.268Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/21/c6/ad0fba32775ae749016829dace42ed80f4407b171da41313d1a3a5f102e4/openapi_schema_validator-0.6.3-py3-none-any.whl", hash = "sha256:f3b9870f4e556b5a62a1c39da72a6b4b16f3ad9c73dc80084b1b11e74ba148a3", size = 8755, upload-time = "2025-01-10T18:08:19.758Z" }, +] + +[[package]] +name = "openapi-spec-validator" +version = "0.7.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "jsonschema" }, + { name = "jsonschema-path" }, + { name = "lazy-object-proxy" }, + { name = "openapi-schema-validator" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/82/af/fe2d7618d6eae6fb3a82766a44ed87cd8d6d82b4564ed1c7cfb0f6378e91/openapi_spec_validator-0.7.2.tar.gz", hash = "sha256:cc029309b5c5dbc7859df0372d55e9d1ff43e96d678b9ba087f7c56fc586f734", size = 36855, upload-time = "2025-06-07T14:48:56.299Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/27/dd/b3fd642260cb17532f66cc1e8250f3507d1e580483e209dc1e9d13bd980d/openapi_spec_validator-0.7.2-py3-none-any.whl", hash = "sha256:4bbdc0894ec85f1d1bea1d6d9c8b2c3c8d7ccaa13577ef40da9c006c9fd0eb60", size = 39713, upload-time = "2025-06-07T14:48:54.077Z" }, +] + +[[package]] +name = "opentelemetry-api" +version = "1.45.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/2e/02/6e0ae9cc61bd3169d401077b507b3ebc344745171e1051ab430be012dcd9/opentelemetry_api-1.45.1.tar.gz", hash = "sha256:aa38ed19bcc084ba42782a73255b3582283eced7ad6dddbd6695189e69adfb75", size = 72804, upload-time = "2026-10-06T17:32:58.133Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1e/41/f7dcf80b81ee8e71c1a2b59f14208bc723edbd89ed027a73b175abf6348e/opentelemetry_api-1.45.1-py3-none-any.whl", hash = "sha256:b31553efa588ae44bc306f863c785c5333a9ecc091248c6ee68b4b6c87fdedfb", size = 60256, upload-time = "2026-10-06T17:32:33.506Z" }, +] + +[[package]] +name = "packaging" +version = "26.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" }, +] + +[[package]] +name = "pathable" +version = "0.4.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/67/93/8f2c2075b180c12c1e9f6a09d1a985bc2036906b13dff1d8917e395f2048/pathable-0.4.4.tar.gz", hash = "sha256:6905a3cd17804edfac7875b5f6c9142a218c7caef78693c2dbbbfbac186d88b2", size = 8124, upload-time = "2025-01-10T18:43:13.247Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7d/eb/b6260b31b1a96386c0a880edebe26f89669098acea8e0318bff6adb378fd/pathable-0.4.4-py3-none-any.whl", hash = "sha256:5ae9e94793b6ef5a4cbe0a7ce9dbbefc1eec38df253763fd0aeeacf2762dbbc2", size = 9592, upload-time = "2025-01-10T18:43:11.88Z" }, +] + +[[package]] +name = "pillow" +version = "13.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ce/a4/9cc30690a394a8305e8be4c9036aa16d0dfddadd09079860b582f562496d/pillow-13.0.0.tar.gz", hash = "sha256:cdcd1ba258178f7356d74170c9a81ba4eab6a5d55748bc402a5a2a6fe6be3510", size = 47058631, upload-time = "2026-10-16T22:18:09.718Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/8e/45/fbad9c7f5e2f1745c373a434d46072bc84eddfefaa28b852425ac957fda6/pillow-13.0.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:44629d4498c9cb6b2051806155f22141df0d8a929c56134b166655232dfb2f8c", size = 4190721, upload-time = "2026-10-16T22:16:27.524Z" }, + { url = "https://files.pythonhosted.org/packages/a2/bf/2074902a259a90692c5dbf132885d21671644cbbd3f690047516243a55db/pillow-13.0.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:bf97ba1b5542050e9b0c74e632323b6d8136cc99d64e193abebee22fe6013c76", size = 4290236, upload-time = "2026-10-16T22:16:29.562Z" }, + { url = "https://files.pythonhosted.org/packages/ff/a5/3d1bb93b8ea38d15d21356c1b8e9f50971ac592aaa248f7fb71739094c0e/pillow-13.0.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:aa694c49787040943570d61c9b8fc01271bd2a2cfdd55f0d896f8aecdce1a981", size = 3723093, upload-time = "2026-10-16T22:16:31.249Z" }, + { url = "https://files.pythonhosted.org/packages/84/a1/be060135d85187b25fa8b2573786c0e45c62ae27527fff5257675eb97f4a/pillow-13.0.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:49c12af515073e9bf511e4ef736743bf70d531a643668722279314b937742ba4", size = 5572253, upload-time = "2026-10-16T22:16:33.103Z" }, + { url = "https://files.pythonhosted.org/packages/b5/f4/0bf6f1ac9ba7ee2ffe9914aeb410a1035a0c1a3c42f122388d7fc950bc4b/pillow-13.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:d9b0a2bee3f3e03e9f29057aedb807dbf1e1d96ee1b9d0f422d9db6c8583271d", size = 4852269, upload-time = "2026-10-16T22:16:35.102Z" }, + { url = "https://files.pythonhosted.org/packages/83/16/b603274617b3e6728da3a0133d4fba1ea8d7fbe0c4ea5fef9cbffa398b8b/pillow-13.0.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5933fcea5a5ba64c686f55c886a115cbfd92f2900460784a1e79909fdbafd7b6", size = 6516058, upload-time = "2026-10-16T22:16:37.228Z" }, + { url = "https://files.pythonhosted.org/packages/1d/f2/1371707ce438ba9a43f9d24089828494ec6f9396e28cd7903aa704dd6306/pillow-13.0.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e91c2b1cbeae768c98752e67e717e283d68dae45717b41f2d91eaee648e37b7d", size = 7142574, upload-time = "2026-10-16T22:16:39.172Z" }, + { url = "https://files.pythonhosted.org/packages/b9/a9/62cf68587f910bc87c5951bcb6e9430c7643a65076adf5f18b4bf350e2bd/pillow-13.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f6299e494e46253d40c34653cac369412f44ca53b5f85d848d3f95b1ed0546c", size = 6614295, upload-time = "2026-10-16T22:16:41.117Z" }, + { url = "https://files.pythonhosted.org/packages/6c/c9/9e9b48178649730299be0bafbf5f810a5b6977538f5a92d47e4ba5f5d608/pillow-13.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f9bd7d260d986f3553518c5d723544346fa48031f8aef3265d786aeb59845bc0", size = 7224841, upload-time = "2026-10-16T22:16:43.118Z" }, + { url = "https://files.pythonhosted.org/packages/8f/48/c44e91384b1b6c072a714a63d00608acc16a6a968735e478e4be4384e5ac/pillow-13.0.0-cp314-cp314-win32.whl", hash = "sha256:2e31c4e68cffd7b1f116127626813b82fcba19edf6b940a7b0c266d6484d0055", size = 6508694, upload-time = "2026-10-16T22:16:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/50/e2/7ad17747517e4c813dca78257d6bb593466f8231baf1384bc98d92745edb/pillow-13.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:f7cbb7a64e7ec664775195e4f81923bc8a93d9451b963f844e59118f63147a7a", size = 7281830, upload-time = "2026-10-16T22:16:47.725Z" }, + { url = "https://files.pythonhosted.org/packages/41/9f/e5b51f2ce8ef4563215334035403ce61a244f93a2e65c24a940131618f87/pillow-13.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:a6aaa7871aebca081eb5c45f83e845bbd9712ae99fa9286dbfdcee835e63f4b4", size = 2695468, upload-time = "2026-10-16T22:16:49.515Z" }, + { url = "https://files.pythonhosted.org/packages/97/73/a53502f731f6c84805a4ce87a8881e86d07a65aee64728b900d112dc703e/pillow-13.0.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:7b999816b5850a35ada08443e6e03945f1f6488144a83afe2d37b240a552aafa", size = 5578196, upload-time = "2026-10-16T22:16:51.291Z" }, + { url = "https://files.pythonhosted.org/packages/21/50/7e949959a56b5559c78ef172b70fc6025706acb289f3f648a15329e4fa6f/pillow-13.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:67871a13cf47275201553b536c025da777f997fa562a19eb798af4ad4b97c18f", size = 4857276, upload-time = "2026-10-16T22:16:53.399Z" }, + { url = "https://files.pythonhosted.org/packages/c9/52/43ded0ac08e77e39d17bd6d894162572201b5e8fdc4a022b14c55a1960a4/pillow-13.0.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e8ca8f69b7c77fa96dad99f8638c1fc4f1c0bed4acaa1baf7a3c31bdb80a0ab1", size = 6607008, upload-time = "2026-10-16T22:16:55.525Z" }, + { url = "https://files.pythonhosted.org/packages/0d/2e/4a57ed216d5bf877387cba4d44c02aa87abe51ad2e06404aa6b597c4da39/pillow-13.0.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6bce6a29c3898191f4c9998e4d4e8f69790caeabde46e54da4bc235ce5bde683", size = 7224281, upload-time = "2026-10-16T22:16:57.738Z" }, + { url = "https://files.pythonhosted.org/packages/5c/3d/2929b248e135752d63aaeabf53f6de797e905b7b6263f9c1e2adade20aba/pillow-13.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:816752a5ef76a80484c8c441c85593b7ea9304f6231fc5776ad1fbff7e773058", size = 6695600, upload-time = "2026-10-16T22:16:59.842Z" }, + { url = "https://files.pythonhosted.org/packages/bc/33/fb0da992cf084ed1ee6ee05e96b6191e35c351eb707ca2df874feb24ce47/pillow-13.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5bdb38ba220b61b4ec31dd1046dea6b016d3c6850a23f43ed8b58332b2fc668e", size = 7300589, upload-time = "2026-10-16T22:17:01.686Z" }, + { url = "https://files.pythonhosted.org/packages/bb/af/c30dd9ef6a3dce84ecb1b2393cac629047a32e66279056c6cb46c3ffd65c/pillow-13.0.0-cp314-cp314t-win32.whl", hash = "sha256:06903aac074d00c988e77a1fc435286dc498506d4ca8d6f69df9babddf4ecc15", size = 6517204, upload-time = "2026-10-16T22:17:03.722Z" }, + { url = "https://files.pythonhosted.org/packages/85/d5/ef3a8ae7609c8ab26570abf18194882534b480d245a9148b895a2262c004/pillow-13.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:9a635068d9793c7f0d929f39f18b58f1bd86c236e8e7b64167b86af9232ebca0", size = 7286695, upload-time = "2026-10-16T22:17:05.543Z" }, + { url = "https://files.pythonhosted.org/packages/84/3c/0861db0c69a03689ebe3e7599d35668a414deb5aaafd8255215e4e62e3d3/pillow-13.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0d1a9cf7bc6917538b20f8d06b9ab2147e542f68849e96fc58eb66bdf6acc692", size = 2698098, upload-time = "2026-10-16T22:17:07.674Z" }, +] + +[[package]] +name = "pluggy" +version = "1.7.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/bf/db/7fc19e6f2dc92a966727031389fc2e08b558f0f25eb7403c1119ad4713cd/pluggy-1.7.0.tar.gz", hash = "sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8", size = 123304, upload-time = "2026-10-15T09:50:58.343Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/40/9e/2b38731e0fc536806f16490e1a12d7f0dc2a1235aa8cc07bcc75416a7daa/pluggy-1.7.0-py3-none-any.whl", hash = "sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec", size = 27082, upload-time = "2026-10-15T09:50:56.808Z" }, +] + +[[package]] +name = "psycopg" +version = "3.3.6" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "tzdata", marker = "sys_platform == 'win32'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/76/26/3ea4ca5eaea1c0debcdf7ee7c1613fbe721dc27a03c461c0817ffd8a0601/psycopg-3.3.6.tar.gz", hash = "sha256:c081f2250df751a943036e42db6df4571c66cd0aabe8291a7a506512b12007d2", size = 168171, upload-time = "2026-09-18T13:22:55.152Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/4e/de/748bd7609c71cae5d737f0ba9192f19329f70180ecda8fff3cac02c5abe3/psycopg-3.3.6-py3-none-any.whl", hash = "sha256:a1db9f7148b06a28606767efaca51fa6f9398c5c0a3810519be69d7000bdb631", size = 215490, upload-time = "2026-09-18T13:15:29.374Z" }, +] + +[package.optional-dependencies] +binary = [ + { name = "psycopg-binary", marker = "implementation_name != 'pypy'" }, +] +pool = [ + { name = "psycopg-pool" }, +] + +[[package]] +name = "psycopg-binary" +version = "3.3.6" +source = { registry = "https://pypi.org/simple" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/6d/b9/60711317c284a442511644ea7185b56ebe627606d6741e732cd16108c47b/psycopg_binary-3.3.6-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:b3f75dee0f9afafabe4edc52c4842f1e1878ed2069bd05b22d6fe961e97e4dba", size = 4720512, upload-time = "2026-09-18T13:20:29.278Z" }, + { url = "https://files.pythonhosted.org/packages/63/da/28befc84454cbc6374550de7746f591f8fe1b6165c1fce249652cc8291c4/psycopg_binary-3.3.6-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:5927b7ba63153cd8e9862987290a2b783a5c590daf2a4ef981700cc3569166d4", size = 4782318, upload-time = "2026-09-18T13:20:35.401Z" }, + { url = "https://files.pythonhosted.org/packages/a4/8a/0d21c2c833cdc0d4244c77e858e0ed37fa2abec2623be4fd686f617109ce/psycopg_binary-3.3.6-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:0bf08b749cc144f33b44a91b78e3f71c60eb07963746a0df5a100b36ce3d7475", size = 5567460, upload-time = "2026-09-18T13:20:41.902Z" }, + { url = "https://files.pythonhosted.org/packages/49/6d/7692d0d4e656b6cc9868d8acc2e3b42f17a0db4a625400a6d093cb0533a1/psycopg_binary-3.3.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:31cd942c23f613276b81a6e6598cefa12960058b0f46e1e874b540c793f6aca5", size = 5246902, upload-time = "2026-09-18T13:20:47.661Z" }, + { url = "https://files.pythonhosted.org/packages/d4/c1/b8a1f18fb1b7558a17f57f7cb3fc8bc93189feea2958925950b3acb15743/psycopg_binary-3.3.6-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4690cf67738f0e0e49a32aeec99bf0e4595cc2b4f1af984a4345394b1dcff91a", size = 6847192, upload-time = "2026-09-18T13:20:56.874Z" }, + { url = "https://files.pythonhosted.org/packages/a5/76/404f33519167c65cca88ec4998776f1dbebccc301ee977f0e62c47fb0826/psycopg_binary-3.3.6-cp314-cp314-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ad1c785e784cfd87e8436c6b7702f2d321fc39601bbaf29bc63a41a867091638", size = 5079573, upload-time = "2026-09-18T13:21:04.155Z" }, + { url = "https://files.pythonhosted.org/packages/f0/d9/79e8fbc8f37262a415f3550f0bcc5f98037442bf3d12ef6cbae2056655ae/psycopg_binary-3.3.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:79a2a1c3449f6c3409427078ed1cec10de79f3023cb5f2504f0597d350ad46c7", size = 4613633, upload-time = "2026-09-18T13:21:10.664Z" }, + { url = "https://files.pythonhosted.org/packages/d4/47/96225db74be7d2ce04b3a58678b53cda610225055edf5faa775c9f501d8b/psycopg_binary-3.3.6-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:86147cb5d140341c3363fb5bacce31f8d5543902a46699d3c536b101bbceaf9e", size = 4293375, upload-time = "2026-09-18T13:21:16.027Z" }, + { url = "https://files.pythonhosted.org/packages/2a/d2/18e9c779a5efd565250329adaf529ecc2b8b2ed5be5cb0f6ccee208cbfd9/psycopg_binary-3.3.6-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:7308c93cf0b19bbaf8e6ff0a6ad50d3c442385739245fe15a8d593bf841734a6", size = 4019883, upload-time = "2026-09-18T13:21:21.587Z" }, + { url = "https://files.pythonhosted.org/packages/ef/28/0cc654afc6c2cda982767f5679d3646b30b1ec86545bdaa9402202d6776c/psycopg_binary-3.3.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:05a83ac9fd52b9bca7cb5ab04b3691163170bd16f53defa27216ea3aa07ee781", size = 4332607, upload-time = "2026-09-18T13:21:27.63Z" }, + { url = "https://files.pythonhosted.org/packages/f1/3e/0a753a74fbd7aef120f286c016e09d3cc3f1daf7688f4a145d27281260b2/psycopg_binary-3.3.6-cp314-cp314-win_amd64.whl", hash = "sha256:1fbd30e537dab22cafdf080608f10148fe2a5f3a61294ddb5113caac8a623840", size = 3755671, upload-time = "2026-09-18T13:21:33.855Z" }, +] + +[[package]] +name = "psycopg-pool" +version = "3.3.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/74/5e/c0664b968b102ff68b811d999c728546c48d5c1eec03e3bbaf88c0cb4472/psycopg_pool-3.3.3.tar.gz", hash = "sha256:df87b5d9d0ad7db37f6cdad4fa8ce113d250f5997f6db38e9a99192fb67f9e1d", size = 32006, upload-time = "2026-09-22T15:53:24.947Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/5d/b4/452c6607a0f479465cd8a9b0d9956919fcb150050c1f83f9f11e6b8ee8dc/psycopg_pool-3.3.3-py3-none-any.whl", hash = "sha256:9b9cd6a4fcec47a410f7e82d408540e7f77b478509e91b44c1a5457a13e5ff37", size = 40304, upload-time = "2026-09-22T15:53:23.712Z" }, +] + +[[package]] +name = "pycparser" +version = "3.11" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/da/a8/c5fdbeee588bb8ada9458774f43adf1bdd30bd59157055142183e769a024/pycparser-3.11.tar.gz", hash = "sha256:d875f09c3507d00e1aba0eecc6dcadc1352f30fff09dc6bff2f1c2935e97c2bc", size = 113796, upload-time = "2026-10-09T12:56:59.539Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/90/11/0e6f11117525ff0eec40ebac3d313376f102df93ca44ad9e893ee85e4f89/pycparser-3.11-py3-none-any.whl", hash = "sha256:51d5a8ba2be0bbe440b99d2112604c95bbbc3c2748a64260186c541e1729cd80", size = 51178, upload-time = "2026-10-09T12:56:58.131Z" }, +] + +[[package]] +name = "pydantic" +version = "2.14.1" +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/7c/0b/8e10b2e693af8ec54346a14caf36221334775975a747c9ceaa3f8371d96d/pydantic-2.14.1.tar.gz", hash = "sha256:94f478203dd03404682a1ada216965651dd74b1d2d5ffd62e00e0837caab5c26", size = 900362, upload-time = "2026-10-11T18:37:55.396Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/35/ea/a56b9fe5066f3537b7882f77e9c5dfb26d8c2eefdaed9b5fc73d57b4dc22/pydantic-2.14.1-py3-none-any.whl", hash = "sha256:9195d967ec791692a04438115466764fb8b9a27b31f14a760437694f40d6b454", size = 488106, upload-time = "2026-10-11T18:37:53.437Z" }, +] + +[[package]] +name = "pydantic-core" +version = "2.50.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/a6/24/af4ec4be49fbc810f35b0bdcacc3d433b56bbfa469fd3bfd4ae116cd9bf1/pydantic_core-2.50.1.tar.gz", hash = "sha256:e50d7b94baac6c7d09927fa5ca5800a0c7ee5015c7fcff65beb3a1931b5a6e09", size = 513515, upload-time = "2026-10-11T18:35:44.82Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/49/33/28b96e81677153715e3eafb9f26663a80841e859fde282a380359b0d3fa1/pydantic_core-2.50.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:1cf41f1ae3fa155cf167a72689ad044bcc1e3c97e064123677149bdfb5dafc4a", size = 2224428, upload-time = "2026-10-11T18:33:07.153Z" }, + { url = "https://files.pythonhosted.org/packages/94/40/15c06410c9b7b8da5805d27b64e09bd3f900e986728106db2689dbc51513/pydantic_core-2.50.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4df197990c15b5a37c5a277d131d9f2c67de6133f2e5dafd80d9bba4b99f46f9", size = 2023740, upload-time = "2026-10-11T18:33:08.763Z" }, + { url = "https://files.pythonhosted.org/packages/a1/4e/5eb629f6efc2a27e421d789dd4bfacbb5f6d09c80c28b13d1e87d73163d5/pydantic_core-2.50.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0036473f5583e6a60e50b8b21651511564277a3f05cc5dab8cf579f552cd5f6c", size = 2049435, upload-time = "2026-10-11T18:33:10.366Z" }, + { url = "https://files.pythonhosted.org/packages/ba/8e/f195aebec49ad12318876ac2368c197a7939f5d52f8e156d2238ef8a4588/pydantic_core-2.50.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:992c3514ec891fa7858099183e4d64e6bd5a5d4ff452fae29df22faa77a006bb", size = 2172975, upload-time = "2026-10-11T18:33:12.368Z" }, + { url = "https://files.pythonhosted.org/packages/e0/f5/7ad9fb83010cd5ea0948409db105676ed779c4e709e2d3d89b9fe2558794/pydantic_core-2.50.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:739dc730e6be3bd5ec2f4ab5cfc7eb047cc45fc1497b3bafec74ff2ed07df597", size = 2364197, upload-time = "2026-10-11T18:33:14.244Z" }, + { url = "https://files.pythonhosted.org/packages/ca/fb/bf0aab3e78301d202b82a0322ec968cd703b11fc0623fde9a28708936f62/pydantic_core-2.50.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:32fad3a91e51b6d2039c572db04a5a873260b399f6bd62c3552671fa7a4a2899", size = 2444259, upload-time = "2026-10-11T18:33:15.79Z" }, + { url = "https://files.pythonhosted.org/packages/45/35/38f6d6564fae57d9b12e5676dfa947e0e7d5c46dbeaa7eb3352261d6d299/pydantic_core-2.50.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:42b54c2c90ad348b5e3a85e03e715d572c1fde357ef104cdfe3b03b697a404ea", size = 2159857, upload-time = "2026-10-11T18:33:17.51Z" }, + { url = "https://files.pythonhosted.org/packages/65/a0/fb0a3ca10f139dcf765b2d312d10cf0f65c57c59993229d00ad12b14ceff/pydantic_core-2.50.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:2df1ff41884de2bc4b307bafd7c40a691094fad2ff8e767e5b45a319257bcf4e", size = 2233954, upload-time = "2026-10-11T18:33:19.591Z" }, + { url = "https://files.pythonhosted.org/packages/8c/6a/e63842252702aa4ec6e6b7178ca85e541a77459076592c23ebe2d9840b33/pydantic_core-2.50.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe90228920fd8ff2be62622b6bb8a2b11acd65046d50c6b130614b5879605a20", size = 2243876, upload-time = "2026-10-11T18:33:21.393Z" }, + { url = "https://files.pythonhosted.org/packages/39/25/5991cf8318b37e0dfab47b87541619a1df8501a793cba0d978846cba37a7/pydantic_core-2.50.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:844b869f118e22a41a091bdcedda8a71bc1b0f62c38d1a0c3211cece47e1d8fc", size = 2277908, upload-time = "2026-10-11T18:33:23.324Z" }, + { url = "https://files.pythonhosted.org/packages/a7/3e/3ee8baaa6cc25a6961c69168cf9ff0f002d56f4e0d541ad6724c18fb61f3/pydantic_core-2.50.1-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:2eb75304506894a281d346220a4f7481a1b8729577c5ed2a05395991966a8396", size = 2449285, upload-time = "2026-10-11T18:33:24.942Z" }, + { url = "https://files.pythonhosted.org/packages/c0/c7/acbec6deac13fe697a80c275a9b6661db62c4d323bac8a47347b1f39c7cd/pydantic_core-2.50.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:6b20a4bffabdad0db2927ac034ae3b8a681b1f7a0182f3e60b479ad2fde21ebb", size = 2479013, upload-time = "2026-10-11T18:33:26.925Z" }, + { url = "https://files.pythonhosted.org/packages/10/08/21a3f237b264389f6219d053ee78fc1b5c2fd402c1b1cb2b6cb8b85f9834/pydantic_core-2.50.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:99ba9bc2b8062ea0c326a990f7f00e6530c23579de66dd246e72c4cafef950a5", size = 1484400, upload-time = "2026-10-11T18:33:28.693Z" }, + { url = "https://files.pythonhosted.org/packages/09/ce/077a6d262d12ef09108377ac0717f029f420d773ace63cafd6143af75568/pydantic_core-2.50.1-cp314-cp314-win32.whl", hash = "sha256:cf356f70551d40374eaffb1aa63f1eb6d2006681cbd7a9faea173ce0f4dd7cd2", size = 2103222, upload-time = "2026-10-11T18:33:30.326Z" }, + { url = "https://files.pythonhosted.org/packages/14/4c/350a2415209c43d670eb71d3c040f332c04a30583d39e311b05c7ac15762/pydantic_core-2.50.1-cp314-cp314-win_amd64.whl", hash = "sha256:d32f3acc081cc3923386d88f422cde8892335e95f034e0104bb4cf9310d9915f", size = 2171586, upload-time = "2026-10-11T18:33:32.139Z" }, + { url = "https://files.pythonhosted.org/packages/bf/92/9bea6ca96580a0902fed366f064f0829e404f41889b34543279a1162b888/pydantic_core-2.50.1-cp314-cp314-win_arm64.whl", hash = "sha256:bed5163e03b98bc1fa2eb05d74c63d9c5c95d8ed6254985481640fbf5e237dea", size = 2155773, upload-time = "2026-10-11T18:33:33.896Z" }, + { url = "https://files.pythonhosted.org/packages/86/8c/f121f073cf32bdd5cba7e6230b1ce0ac845b0cf43e44dd597d95af272db2/pydantic_core-2.50.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:9572c1369e9c9da2d64a7b7992c786d90ff295abc93964cfe3125e4290768070", size = 2234017, upload-time = "2026-10-11T18:33:35.588Z" }, + { url = "https://files.pythonhosted.org/packages/a4/69/2bb2bcd6146cffe98d760a46c42ae71efd5151d9b2f9c9bf6619a3b32083/pydantic_core-2.50.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2005207aafe1231315718bf6ed5d064a7300fb4772754af35ee72fc68159492e", size = 2001016, upload-time = "2026-10-11T18:33:37.57Z" }, + { url = "https://files.pythonhosted.org/packages/20/b3/fbf854c7d07ec114260c26e9e2071a4381740f9ae09641dbfcbdf2a18c45/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:64f6047f62a6c5ae08d0a6afb035667aa2d97c3d20d69762e034c5ea144d92a5", size = 2023015, upload-time = "2026-10-11T18:33:39.433Z" }, + { url = "https://files.pythonhosted.org/packages/65/20/6de55b2f92cdb614b745c6e9ced639fc4fd7e1e77604825a88bdece6fcbd/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1ef800dd7d85bcdadf4c3076e4c94e43939493558a3b69a1ea830c706d4617bb", size = 2192543, upload-time = "2026-10-11T18:33:41.381Z" }, + { url = "https://files.pythonhosted.org/packages/0c/d9/19e91c94bd5c405945ce2f15526808aea37e162c253160de8ed7bf70b406/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b0135bcdcaa0f23573f286e4cb5e0fd2962700964ed13df085b85f2b97aeab9e", size = 2388704, upload-time = "2026-10-11T18:33:43.167Z" }, + { url = "https://files.pythonhosted.org/packages/b6/bc/2e24c8415eae1a25ee5a5484946a917123bad2e9d01689a759236928175a/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0b3a6f334c6a2345ca15318ff894502a90012536404b37c844a976c76c846e0b", size = 2464118, upload-time = "2026-10-11T18:33:44.856Z" }, + { url = "https://files.pythonhosted.org/packages/bd/1f/945b8053cb061c64e102bcaf7bfb9ed740c0bd4349f9bb978a7d4ddff4ab/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:06e01fbbfdb9be777b316a71b6c49efaf4a08b615d0a98d678cda3023f79d019", size = 2150142, upload-time = "2026-10-11T18:33:46.661Z" }, + { url = "https://files.pythonhosted.org/packages/2b/78/96a3e50bf0d64aaae781107eb9335b7529d05a85793ed6e7241c4cd1d931/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:a29a061fec0b4e2d714f277e70a3a18125ecff803f2fea6eade2f2e53711d112", size = 2245577, upload-time = "2026-10-11T18:33:48.574Z" }, + { url = "https://files.pythonhosted.org/packages/7a/5d/a6038a0322232758a6ebfa709f4ca14a60bf5b93940cd0b345056a557da4/pydantic_core-2.50.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f5187624823423e1d1b82b1072ac41dc837389e18d3d0572cc19bbee46cd550a", size = 2263728, upload-time = "2026-10-11T18:33:50.527Z" }, + { url = "https://files.pythonhosted.org/packages/0d/4b/76ded3333a457a9344c4f2d63f2d82d0101654b05178fa4ddfe7d3627674/pydantic_core-2.50.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:3e46a9eb0a0901dd6275e6b06ac3a464885ef350ec4121fe486869de8053e4bb", size = 2293630, upload-time = "2026-10-11T18:33:52.362Z" }, + { url = "https://files.pythonhosted.org/packages/a9/00/9eca378335c9c1b72bc779bf6e4c2a82ce784f14ec48a0e87102c9870e05/pydantic_core-2.50.1-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:756d669f04e62ec4148ecfe22be6a4484d9b1181a6ef32e205ebfd200540858b", size = 2468048, upload-time = "2026-10-11T18:33:54.118Z" }, + { url = "https://files.pythonhosted.org/packages/35/ca/e3832e9cf93651251de43c8c5c029ed680a3c1a0a1b17ee26c81bed08cbd/pydantic_core-2.50.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:c516cc5367ca3448995d42cb994bf3f4c9002d2a7c22eac9622551269ad1b807", size = 2512159, upload-time = "2026-10-11T18:33:55.99Z" }, + { url = "https://files.pythonhosted.org/packages/4b/f2/773469b5a10a39116a2cb17edaf6d722f017dd8da07161b371465311c542/pydantic_core-2.50.1-cp314-cp314t-win32.whl", hash = "sha256:9d1bed94af6a63835461f3cf7502058eb166c58c4778e11d0f433cfb1bd69e19", size = 2098406, upload-time = "2026-10-11T18:33:58.043Z" }, + { url = "https://files.pythonhosted.org/packages/ee/42/0bb74f8f25204b259b11ab7c12dc7f180893b6bd706118b385147fb6efd5/pydantic_core-2.50.1-cp314-cp314t-win_amd64.whl", hash = "sha256:c8dce1f1e0e5358b682a6ad3fa5e31b31d4560997b8e61417e9217c8d60f8a0c", size = 2148481, upload-time = "2026-10-11T18:33:59.913Z" }, + { url = "https://files.pythonhosted.org/packages/47/0d/d801646c9679a4e630e15cf521d4108b93854b42a6e6e02391bd4c6b1095/pydantic_core-2.50.1-cp314-cp314t-win_arm64.whl", hash = "sha256:ceff0acc940be2715bd6ad17b24c0e5304abf44f6efd0f81ee8499e640f9dc86", size = 2174972, upload-time = "2026-10-11T18:34:01.875Z" }, +] + +[[package]] +name = "pygments" +version = "2.21.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" }, +] + +[[package]] +name = "pyparsing" +version = "3.3.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e4/11/b213bebff182584360cb8d17c72c1677fec5c5c228de439e63bcf8ab1c8f/pyparsing-3.3.3.tar.gz", hash = "sha256:928ae7e20211f3b6f3915a72f06a0cfd29ab9d24279dd6346b6b1a7146397d36", size = 1050487, upload-time = "2026-09-20T20:59:05.609Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/38/bb/d215ee7c73b61497b28a5503f9f53523f294fcc936762b7caf90e0c1c2b5/pyparsing-3.3.3-py3-none-any.whl", hash = "sha256:ece8c00a69cf01b45d0b1dedabb469c90d8caf996d4fda40f147627a122849a4", size = 126420, upload-time = "2026-09-20T20:59:04.025Z" }, +] + +[[package]] +name = "pytest" +version = "9.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "colorama", marker = "sys_platform == 'win32'" }, + { name = "iniconfig" }, + { name = "packaging" }, + { name = "pluggy" }, + { name = "pygments" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" }, +] + +[[package]] +name = "python-dateutil" +version = "2.9.0.post0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "six" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892, upload-time = "2024-03-01T18:36:18.57Z" }, +] + +[[package]] +name = "pyyaml" +version = "6.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" }, + { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" }, + { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" }, + { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" }, + { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" }, + { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" }, + { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" }, + { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" }, + { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" }, + { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" }, + { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" }, + { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" }, + { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" }, + { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" }, + { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" }, + { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" }, + { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" }, +] + +[[package]] +name = "redis" +version = "8.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/a8/99/604f0b666d4c616d891cf77ebb9db6bb21601344c051aebf1b72b9ff915f/redis-8.1.0.tar.gz", hash = "sha256:6e1a19beef9225c83efd689c7e6b7da2d5215b1f42cd13b7fc3714d0a09c7b25", size = 5254356, upload-time = "2026-07-30T08:51:00.269Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/66/9d/c5731f6e3608663d4d3656fd8d3aecee8b509c3082818f5a13eae925baea/redis-8.1.0-py3-none-any.whl", hash = "sha256:a4fe1aac3d3b3cc791d4b3d5931c5a956045dc951ee74d1c913ee3ac4d2ee9fb", size = 560618, upload-time = "2026-07-30T08:50:58.497Z" }, +] + +[[package]] +name = "referencing" +version = "0.36.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "attrs" }, + { name = "rpds-py" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/2f/db/98b5c277be99dd18bfd91dd04e1b759cad18d1a338188c936e92f921c7e2/referencing-0.36.2.tar.gz", hash = "sha256:df2e89862cd09deabbdba16944cc3f10feb6b3e6f18e902f7cc25609a34775aa", size = 74744, upload-time = "2025-01-25T08:48:16.138Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c1/b1/3baf80dc6d2b7bc27a95a67752d0208e410351e3feb4eb78de5f77454d8d/referencing-0.36.2-py3-none-any.whl", hash = "sha256:e8699adbbf8b5c7de96d8ffa0eb5c158b3beafce084968e2ea8bb08c6794dcd0", size = 26775, upload-time = "2025-01-25T08:48:14.241Z" }, +] + +[[package]] +name = "requests" +version = "2.34.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "certifi" }, + { name = "charset-normalizer" }, + { name = "idna" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ac/c3/e2a2b89f2d3e2179abd6d00ebd70bff6273f37fb3e0cc209f48b39d00cbf/requests-2.34.2.tar.gz", hash = "sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed", size = 142856, upload-time = "2026-05-14T19:25:27.735Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a0/f4/c67b0b3f1b9245e8d266f0f112c500d50e5b4e83cb6f3b71b6528104182a/requests-2.34.2-py3-none-any.whl", hash = "sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0", size = 73075, upload-time = "2026-05-14T19:25:26.443Z" }, +] + +[[package]] +name = "rfc3339-validator" +version = "0.1.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "six" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/28/ea/a9387748e2d111c3c2b275ba970b735e04e15cdb1eb30693b6b5708c4dbd/rfc3339_validator-0.1.4.tar.gz", hash = "sha256:138a2abdf93304ad60530167e51d2dfb9549521a836871b88d7f4695d0022f6b", size = 5513, upload-time = "2021-05-12T16:37:54.178Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl", hash = "sha256:24f6ec1eda14ef823da9e36ec7113124b39c04d50a4d3d3a3c2859577e7791fa", size = 3490, upload-time = "2021-05-12T16:37:52.536Z" }, +] + +[[package]] +name = "rpds-py" +version = "2026.9.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/42/68/3bd46b8a5e01d3c2ebdf9c5e9497912e3fe0cde02bac21a7130ca866e403/rpds_py-2026.9.1.tar.gz", hash = "sha256:4793ef7f78268b124b73fa933440f01d258bbae01de9fa53e9080c9ab0425a12", size = 63948, upload-time = "2026-10-04T16:32:36.469Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/8a/f2/67b94be1532767803415c1c5a1fd88ea487643d74a673cec1ba140af77bb/rpds_py-2026.9.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:c9d1aca01f49170fdcf5c92761b1fafe97f554b721ca4570c5949fff778f0d4b", size = 347178, upload-time = "2026-10-04T16:30:00.865Z" }, + { url = "https://files.pythonhosted.org/packages/04/37/b751de2b59b0197a1d92a5dd491de88e8a5e928c2e6562581974f1e85263/rpds_py-2026.9.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3f0e9ac28fc067d4d34b88ae43c48e9489455c97fee9633d851f7eeed5a05d35", size = 341878, upload-time = "2026-10-04T16:30:02.564Z" }, + { url = "https://files.pythonhosted.org/packages/72/e2/5873bc4643c250db9e05d48dc0c93763d4aa68bc3b81164cb1af3b45b284/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:07deecbfce94c78473018bc7d10b337cc651d12df87a1eb2cb3e4024bc9c33d0", size = 373963, upload-time = "2026-10-04T16:30:04.026Z" }, + { url = "https://files.pythonhosted.org/packages/51/03/5acf7632158247f3f6386ff0af3a1ee48167d575037e8d0920594b76d92b/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:821b2755db9194409254012f429c56643416fb96ef9be090be82ec8826b7f477", size = 377975, upload-time = "2026-10-04T16:30:05.555Z" }, + { url = "https://files.pythonhosted.org/packages/e6/00/63fda451b8bffa5808fc8bb311ee7c073b340974b09f273c7b2a145d3d62/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3c91c210ae7645626c608400e3519b4a642f837cce09ca830db3beb2e9f274d4", size = 490347, upload-time = "2026-10-04T16:30:07.156Z" }, + { url = "https://files.pythonhosted.org/packages/a1/ae/c093ffd070ba0fb02f76c565d06fecc65ad6e4afdbae78f7031076d3cdac/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:54ac2158a6f96cfbabff0b2eedaf94b90c5ec7ca8317fcadc61e1c2b2e0ff6ef", size = 392962, upload-time = "2026-10-04T16:30:08.77Z" }, + { url = "https://files.pythonhosted.org/packages/22/9d/d08a1128ab199b2f0cf25bfeb0639bd05119fff4b7c47bec24ef9a8ec23f/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eac2f5dbafd585dfe31f86a23ebf0d3ba480a9d49ebc87947267b5608d4ea0cd", size = 371623, upload-time = "2026-10-04T16:30:10.501Z" }, + { url = "https://files.pythonhosted.org/packages/53/c7/4758ddcbb75609414bbccfcb11d612436f9b3ee821bd2f33f0f1604ee648/rpds_py-2026.9.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:8aa5dda18d39b6143eb24809d158f9252c88f402749b6f1b62a506cc7d96cc35", size = 376997, upload-time = "2026-10-04T16:30:12.124Z" }, + { url = "https://files.pythonhosted.org/packages/87/e4/947bd7f608ff60faf46dc9d389c3dffd0e3d767d78a0be19978448ef0ce7/rpds_py-2026.9.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5c90e7fa02e8f5de0d10c17595c568ada48c5302e749462c0ea1a4c362111a86", size = 400169, upload-time = "2026-10-04T16:30:13.804Z" }, + { url = "https://files.pythonhosted.org/packages/4b/35/fe93e020a0543b5670472c18d7e6af3197c08da571240ce1965c84f85c0f/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:e6d198bad4e49dd6732fbd636e2fc5c082f45c8cad0b4acb756b00c82c76072e", size = 551615, upload-time = "2026-10-04T16:30:15.332Z" }, + { url = "https://files.pythonhosted.org/packages/0d/4f/5d2a0136bb03b2a56a39dc6ff92d58a6e3e53a2e17079238b86228882f16/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:96beca19ec79de272e8668585380ff9092c47077c1d7a1e098e00bbd921f4785", size = 614655, upload-time = "2026-10-04T16:30:16.92Z" }, + { url = "https://files.pythonhosted.org/packages/09/1c/3f1025aaf70d9bf7272cc41f8b64ee76b48bf01726248138430e16f23b38/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5cf77eb04f20b720be95265a3e00eb2a14814074255cc27069c551b2db53118", size = 579602, upload-time = "2026-10-04T16:30:18.555Z" }, + { url = "https://files.pythonhosted.org/packages/53/0d/5c72e6204f76610608706da32b6b7e11ef7e10317558a7bb15a122e008dc/rpds_py-2026.9.1-cp314-cp314-win32.whl", hash = "sha256:a03d57b86d2a51d0a66c92177e2be154ad015f357791d306e714569999cdb4cc", size = 206315, upload-time = "2026-10-04T16:30:20.05Z" }, + { url = "https://files.pythonhosted.org/packages/a4/0b/489d48abbcc7d70cf3fbf662d9d22abf1f4650761c0a9ae05260800800d3/rpds_py-2026.9.1-cp314-cp314-win_amd64.whl", hash = "sha256:837c6b305e26fe0f75b15c92cf3b2ba29e0ae19dc40b1c557b026cb426347d0c", size = 222852, upload-time = "2026-10-04T16:30:21.604Z" }, + { url = "https://files.pythonhosted.org/packages/91/16/bbb05a7e6a10cf79ba639be7f799d770ee15f64175cc61d081b218dd402a/rpds_py-2026.9.1-cp314-cp314-win_arm64.whl", hash = "sha256:fce4b85234a0cbad67bf8e6e1201ee815d172c9aebad75f25645bc4d834f8e31", size = 218709, upload-time = "2026-10-04T16:30:23.036Z" }, + { url = "https://files.pythonhosted.org/packages/22/ac/ac507a0a4ec478ca470440a09583db4be5259ba7670aeba0620822f1e57a/rpds_py-2026.9.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:3a72c11530d71abfb66c8d7696a2f86c43e63fca8b948f1a784ac490f4ec688e", size = 349596, upload-time = "2026-10-04T16:30:24.558Z" }, + { url = "https://files.pythonhosted.org/packages/e9/f2/817a46b658d5070f477f722c298ee9a24525b0e4017347964146ef5fdd0e/rpds_py-2026.9.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:068c37bba854ec2fe42f7365c640af11dd9895890ccbf2df5070d0c059bd7f96", size = 343114, upload-time = "2026-10-04T16:30:26.048Z" }, + { url = "https://files.pythonhosted.org/packages/6c/42/6ade976b13ac1b4cb3bf2eb603f1be2fe74df19a29988d4c2b386be59d6f/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d7fca4eb6df565e2a928f1c7dad92d27db8f9df0f449e76423ed5d7e713ed445", size = 374197, upload-time = "2026-10-04T16:30:27.699Z" }, + { url = "https://files.pythonhosted.org/packages/d9/70/77cdf1d3f1a07faabe936016ae623aec7981f73108a8fe7a203ed2e21998/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c933c6678c6f116ff8af47a4c6db0868b8ace74af0343016c0ef00f00272ea69", size = 378025, upload-time = "2026-10-04T16:30:29.451Z" }, + { url = "https://files.pythonhosted.org/packages/3f/6b/18a44a3beaa9b7931acb04af7bd9539836477c630a794452d4826d6185d4/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:028ad274ea951dac64491b5d1e65712a4aeabfdbdb9fccf797b57bd899b0c495", size = 491969, upload-time = "2026-10-04T16:30:30.995Z" }, + { url = "https://files.pythonhosted.org/packages/73/27/fb39cfd6bddaf741b024f813890374578ff8ac1f1adc473659c048b03b05/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:740d0a99cf9de0b17a3943388e9294a59becf75e7c43421f387bd3c7a9901f7c", size = 393905, upload-time = "2026-10-04T16:30:32.628Z" }, + { url = "https://files.pythonhosted.org/packages/ed/71/0fa7bb77b57af0d710273964180d11b503f62b8a5c358eb2d8c3f62feff6/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0da298fb372dc192610a4b9ecbc68a0cd8b675bbbd1fc519d01b41cfd658333e", size = 374569, upload-time = "2026-10-04T16:30:34.257Z" }, + { url = "https://files.pythonhosted.org/packages/54/22/f41cfac269af3b449513ef1bc3d7f32fde52abbbd2d01c7e76b47743acd9/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:eb61be926bb81567c1f48bdc8aa22b9855048dc2efd53871f9f7e6e9a5632346", size = 377482, upload-time = "2026-10-04T16:30:35.997Z" }, + { url = "https://files.pythonhosted.org/packages/b4/fc/312b49006e7f8f9ca5f96647577b8aa6f3df30519c46bd448f5c425af0b2/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:42e75466f83cd43f6026c81eab74246efb2bdadafb307b85700632d06c68f299", size = 400040, upload-time = "2026-10-04T16:30:37.76Z" }, + { url = "https://files.pythonhosted.org/packages/cf/a6/18cca7a878dc7fa95165a83343fd4d7b65643fd22e54e47340a451121d5c/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:617f59cde379b4f648a09797b7f683d04b90a46344cddab85639da5aff0f5531", size = 551849, upload-time = "2026-10-04T16:30:39.443Z" }, + { url = "https://files.pythonhosted.org/packages/e4/6d/1f5685e20f39604691bdc3c05aaa6b8bd2f954e9e996477adf2376768e33/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3edae8c5ddfdb6985d49ae9d150516e5076888879022f91a26c2de9276ce0bdb", size = 614842, upload-time = "2026-10-04T16:30:41.231Z" }, + { url = "https://files.pythonhosted.org/packages/c6/25/98652109fd9f7e10268dd4571aa52b81987001b806f37ef1a18260de714a/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:0f045bb053c9057720d72c56dffe30dffdc05997b2897a827b9325f0ab6623fa", size = 582606, upload-time = "2026-10-04T16:30:43.345Z" }, + { url = "https://files.pythonhosted.org/packages/19/03/11ca09099bab5f53373a80a334c424ec917c13d050760a59499d2af5171e/rpds_py-2026.9.1-cp314-cp314t-win32.whl", hash = "sha256:bf35d0568abda97233239ce32896d3ad53fccc537832c104e30c94aa5fb93569", size = 203341, upload-time = "2026-10-04T16:30:44.954Z" }, + { url = "https://files.pythonhosted.org/packages/6f/8a/88909e3ffd9f47f5b58211473875d8c3c09079f0058c46fb72c55a702a26/rpds_py-2026.9.1-cp314-cp314t-win_amd64.whl", hash = "sha256:1e8d4d79d828299bf44a55db22a9388ab967b49d17132c88eab0f4360b48da8e", size = 222843, upload-time = "2026-10-04T16:30:46.486Z" }, +] + +[[package]] +name = "ruff" +version = "0.17.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/f9/e7/e6d5749983b020e6cb1055abec0a6f361a8e94f0184cdcf56d4760995f02/ruff-0.17.1.tar.gz", hash = "sha256:5bb796c5112e9fb9527f2ef2faa0a130d6312d19de92bcfaddd70dbb2d41020f", size = 5323349, upload-time = "2026-10-15T15:23:18.64Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2e/78/90c46ca6250709f7c37e397b60d06061adee8d0f7d13959ed6a8e49b14fd/ruff-0.17.1-py3-none-linux_armv6l.whl", hash = "sha256:1796c41eafec66f4635125dd1e074a7aa27b8d20c187d484360acf11d247fc4a", size = 10147528, upload-time = "2026-10-15T15:22:33.667Z" }, + { url = "https://files.pythonhosted.org/packages/aa/d2/a2e28bc35b083ae51fa07dfba5280a667c8b01ecaee7802fc8849dcd5c46/ruff-0.17.1-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:8eadb09a788010be29c895418bdfa513e4e1c65e64b94e5b19e4cd381f6cc7fb", size = 10225974, upload-time = "2026-10-15T15:22:36.328Z" }, + { url = "https://files.pythonhosted.org/packages/8e/71/7a9029a81c8206ee01a98f6cfeeb56e6c095af86857581a37045c46d7e94/ruff-0.17.1-py3-none-macosx_11_0_arm64.whl", hash = "sha256:29b454f18ca3eeaf37fbf140841dcf27d36109e29dee9aae8acecb68c26c6f74", size = 9270361, upload-time = "2026-10-15T15:22:38.651Z" }, + { url = "https://files.pythonhosted.org/packages/c0/8c/e075e9c917cb0575297880c96768304e881240171c870cbd8d9b7b54bec2/ruff-0.17.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:872e03dd231744d6c5ec5c8af6be52b71323fc6ee096e4c8b34d9f844ee3b978", size = 9938300, upload-time = "2026-10-15T15:22:41.284Z" }, + { url = "https://files.pythonhosted.org/packages/87/27/0b4bb926a49de2383f161272b4d863571a4c7ecdbf595a6bc58813a13367/ruff-0.17.1-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4c0d6cb5f8fbac77eec9af49f4fc0eaf856b05545e372b0694d24b4e76b1c640", size = 9948464, upload-time = "2026-10-15T15:22:43.681Z" }, + { url = "https://files.pythonhosted.org/packages/14/27/518d57e0e02aecb8ea4acac6b57b51a53173d25fa734952bfdd7d531e88e/ruff-0.17.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:78beced4a3c94dfedbee4b999b95b6a27b35820fdc0afbacc6d37a8da26c1cd1", size = 10638639, upload-time = "2026-10-15T15:22:46.081Z" }, + { url = "https://files.pythonhosted.org/packages/01/82/d89a4e498ade59e6cee52d67f8da569019372212b87468c1fdeae884601c/ruff-0.17.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7feefc63921202894f0e158b0e32f45a5950d70a7fb693ccb9264816c25b1c05", size = 11337238, upload-time = "2026-10-15T15:22:48.894Z" }, + { url = "https://files.pythonhosted.org/packages/a2/7c/3b0fdef9352656317c977086fe1d802902406e4f2a0d8578da90c0e6d1c5/ruff-0.17.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:684154861a819bf1f433669d2a0ce9c3e54677c65b8ebb866cc2a7ec86345785", size = 10896327, upload-time = "2026-10-15T15:22:51.45Z" }, + { url = "https://files.pythonhosted.org/packages/62/86/5566290219708ce2928f3a29c4f843a1185b341ec6111c4631a33c5ceced/ruff-0.17.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a6ef98e51de8ef38082f90653ceeb84944bd7673783eea13e1647c5b9b064189", size = 10350811, upload-time = "2026-10-15T15:22:54.401Z" }, + { url = "https://files.pythonhosted.org/packages/ad/d2/ca8462dabb3c413990d49703ba306c30c862195a75448d080fa8fcce9775/ruff-0.17.1-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:8f9aa5b5bd5fa1937803ea609c8f153b8de39bf3e0e149897ae34b0c5b52f467", size = 10569994, upload-time = "2026-10-15T15:22:57.142Z" }, + { url = "https://files.pythonhosted.org/packages/e3/ad/dd1864c1f1db17c8cfb297ce70b352388e6977620f66f7182c52855407df/ruff-0.17.1-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:80e53b0e5faa3c5667f035daaa032893ae42b7cfe708c886d39ed131e54688ab", size = 10059672, upload-time = "2026-10-15T15:23:00.084Z" }, + { url = "https://files.pythonhosted.org/packages/65/45/3f56cf1d2168c2165cdd5ac6f9668aee66a4cfdd4caf2b2cc5ccb2b1d568/ruff-0.17.1-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:056c5d5fa0ac790051ae165d7035c7bf956d02de2db557f2e9b31d877a505fca", size = 9947803, upload-time = "2026-10-15T15:23:03.132Z" }, + { url = "https://files.pythonhosted.org/packages/aa/4b/5457cb2be4c1d1ea5e919558131a0f197a4a454a0530d9e30820e8206e4c/ruff-0.17.1-py3-none-musllinux_1_2_i686.whl", hash = "sha256:bd8f5a55b10f371642eacd0e8665a42a8b97da15c9a7187c79e697b77b5e0ce4", size = 10351807, upload-time = "2026-10-15T15:23:05.628Z" }, + { url = "https://files.pythonhosted.org/packages/49/fb/db15b4f8fa24a1e36b99e1401f42ef6df16ee299a48670d5d262b771e7d7/ruff-0.17.1-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:ce05e6f3973611d9550a600e04bb531061e368baba31610eb57c1509a8f21a0a", size = 10765716, upload-time = "2026-10-15T15:23:08.092Z" }, + { url = "https://files.pythonhosted.org/packages/0a/e8/1e186578076aff7a80735f625005fde678412ab609cd323ed182eb7d6b87/ruff-0.17.1-py3-none-win32.whl", hash = "sha256:1de0030a8aa78c65c5fecb84b2e5c390ac684c0452875a02afc7c083d49a496a", size = 9895093, upload-time = "2026-10-15T15:23:10.582Z" }, + { url = "https://files.pythonhosted.org/packages/6a/2e/da3d9589bae8e8b58f3a48bd5bc0b980232fb14a83bf02c3be7660f87c1b/ruff-0.17.1-py3-none-win_amd64.whl", hash = "sha256:5df76f16580fab58d0f6c98a3ac254a4abceb7b2489b8b678335869cff77b3d7", size = 10097955, upload-time = "2026-10-15T15:23:13.309Z" }, + { url = "https://files.pythonhosted.org/packages/df/c9/0f2a4dea06a5e12c1191ee3d96b1e1233797d0d5e18f97a2b909a95a9836/ruff-0.17.1-py3-none-win_arm64.whl", hash = "sha256:42400b9a6ff8515ff27796f07f92e0195be011c86e81e381606f58ea5502fef4", size = 9853542, upload-time = "2026-10-15T15:23:16.05Z" }, +] + +[[package]] +name = "s3transfer" +version = "0.19.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "botocore" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/76/43/35e4d8aa320bffe8287fe8f65f578fa2d2db0a64212f0e710dce58267854/s3transfer-0.19.2.tar.gz", hash = "sha256:ba0309fd86be3c27dbf78cdd813c13c5e1df16e5874b99d2535ebbdfb9892993", size = 165592, upload-time = "2026-07-22T19:30:44.432Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/bc/e7/5c595c75e9f41a44f30e526eda465ea0b4eec93470e074e4a111b253f13a/s3transfer-0.19.2-py3-none-any.whl", hash = "sha256:d8168eccca828cbb2cd573675333f3bddd254313a9c42494b84c76b539e8ba25", size = 90216, upload-time = "2026-07-22T19:30:43.251Z" }, +] + +[[package]] +name = "six" +version = "1.17.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031, upload-time = "2024-12-04T17:35:28.174Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" }, +] + +[[package]] +name = "starlette" +version = "1.8.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/e9/0c/6efb252d091ecccd7d62048ae11f0ea35cd75a4fbaeea5e30f9c3bf91d10/starlette-1.8.0.tar.gz", hash = "sha256:1565dc0b35d5737a271ed1e0e04e949f4e81198799f216d2667b0a0fb9cf9522", size = 2730457, upload-time = "2026-10-13T07:54:39.53Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/c1/b0/5742e4ac7af5eb58ec3470a537a49d7aa507e5539413e504b3a65ef50ba8/starlette-1.8.0-py3-none-any.whl", hash = "sha256:dfdd6b29c26483288088d990eee59631dedadd66ce20d203402a7ca8e3c4656f", size = 79612, upload-time = "2026-10-13T07:54:38.019Z" }, +] + +[[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 = "tzdata" +version = "2026.5" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d9/68/f1b440335057bfce71b6e50a9d09445aa2ecbd08359a337976627b8409e7/tzdata-2026.5.tar.gz", hash = "sha256:8cc73c0a0bfca7dbfa59235d60b2eff82231dee33f53d206db1acd9173cfc0a7", size = 200404, upload-time = "2026-10-03T09:23:14.143Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/94/21/1e5995a1c920cce14e4bffae20c665ec10e7ed03ab25e006cd741092b718/tzdata-2026.5-py2.py3-none-any.whl", hash = "sha256:b683bd1b6659ddcd810ff02ad09ba821d4bf1065072805063eb35c49617905ac", size = 347996, upload-time = "2026-10-03T09:23:12.535Z" }, +] + +[[package]] +name = "urllib3" +version = "2.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e3/05/b17359e1cefb4f909b5e40b1b90a496d987258916dbbf88e842c729f510e/urllib3-2.8.0.tar.gz", hash = "sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63", size = 458972, upload-time = "2026-09-15T19:29:36.253Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/92/9d/c4e665119135114480843e7ab388fa94d8480650450e6f8e26b70d323a4c/urllib3-2.8.0-py3-none-any.whl", hash = "sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3", size = 135717, upload-time = "2026-09-15T19:29:34.577Z" }, +] + +[[package]] +name = "uvicorn" +version = "0.54.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "click" }, + { name = "h11" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/da/34/30e9280707135d2cfc589dfff3cb796bd07a3aeb1a3e415ba09dd89d7bb4/uvicorn-0.54.0.tar.gz", hash = "sha256:a2e33cbfaa0306f8e6b0c13e0cb89d7d7a2da3e62b90c66e18c33d9807b28620", size = 112283, upload-time = "2026-09-25T06:52:37.601Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/38/0c/b54a4fdd7f90a3af8b02ebc9ce6712c2c208b7926a2f7bad95c33ebbe943/uvicorn-0.54.0-py3-none-any.whl", hash = "sha256:505bdb0f318731d45f1f712071fc781a8981f6847a31c902c9f5e652d4f67faf", size = 87427, upload-time = "2026-09-25T06:52:35.829Z" }, +] -- 2.54.0 From 36d295e16cc9477ce10dcf92aab2d80a6d3b826f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= Date: Sat, 17 Oct 2026 20:24:22 +0300 Subject: [PATCH 2/5] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D1=82=D0=B2=D0=B5=D1=80?= =?UTF-8?q?=D0=B4=D0=B8=D1=82=D1=8C=20=D1=87=D0=B8=D1=81=D1=82=D1=8B=D0=B9?= =?UTF-8?q?=20=D0=B7=D0=B0=D0=BF=D1=83=D1=81=D0=BA=20=D0=BB=D0=B0=D0=B1?= =?UTF-8?q?=D0=BE=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=BD=D0=BE=D0=B9=20=D1=81?= =?UTF-8?q?=20=D0=BD=D0=BE=D0=B2=D1=8B=D0=BC=D0=B8=20PG=20=D0=B8=20S3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 8 +++++ evidence/audit.txt | 2 +- evidence/clean-clone.json | 68 +++++++++++++++++++++++++++++++++++++++ evidence/clean-clone.txt | 22 +++++++++++++ 4 files changed, 99 insertions(+), 1 deletion(-) create mode 100644 evidence/clean-clone.json create mode 100644 evidence/clean-clone.txt diff --git a/REPORT.md b/REPORT.md index e556f8da..89e2c6f3 100644 --- a/REPORT.md +++ b/REPORT.md @@ -84,6 +84,14 @@ docker compose --env-file .env down --volumes Скрипты не используют общий Docker prune и не останавливают другие лабораторные. +Дополнительно проверен отдельный чистый clone коммита `900182c`: новые credentials, +новые PostgreSQL/S3 volumes, сборка образа с OCI revision этого коммита, все 65 +тестов, публичные smoke и persistence. Хеши всех runtime-модулей в образе совпали +с исходниками clone и версией измерений. Временный стенд и только его новые +volumes удалены; основные данные lab4 сохранены. Доказательства: +[clean-clone.txt](evidence/clean-clone.txt), [clean-clone.json](evidence/clean-clone.json). +Workflow application.yml подготовлен, удалённый runner здесь не запускался. + ## Архитектура и версии ```mermaid diff --git a/evidence/audit.txt b/evidence/audit.txt index 1a3025df..8eb2fa6f 100644 --- a/evidence/audit.txt +++ b/evidence/audit.txt @@ -1,2 +1,2 @@ -PASS: 101 candidate/versioned files; 45 reachable objects; no requested names or local credentials. +PASS: 103 candidate/versioned files; 129 reachable objects; no requested names or local credentials. PASS: instructor files unchanged, upstream push disabled. diff --git a/evidence/clean-clone.json b/evidence/clean-clone.json new file mode 100644 index 00000000..df9f2437 --- /dev/null +++ b/evidence/clean-clone.json @@ -0,0 +1,68 @@ +{ + "tested_commit": "900182cbb405d57b20c1b8bfd7cef21592ccf4cf", + "image_revision": "900182cbb405d57b20c1b8bfd7cef21592ccf4cf", + "runtime_sha256": { + "reconcile.py": "6c96d72a8c49a03ff721029545a41c3587bc24be3272df4003bf6141dd04df9c", + "cursor.py": "a2208cba232ae0f67c4430d3e90c3962129c8fb3987ea853c624cdd2c73d7a1f", + "cache.py": "17756fa84a2c40fd4d1baf9602a7b755ca5998bc241f0657db3505b04623321d", + "service.py": "7e100756e3bb24a89bce5dfa41a471969cdb4287c1523673d1e7ff8255bf3c19", + "__init__.py": "f798dc149d6bef46d697dccdaf6be9c8d08654f18161e42c99f548c30074f4ae", + "__main__.py": "486cd5bbb3f1a814de74357e938968d219070e845cf178761a7a23e87d003ea4", + "app.py": "6dd900a5ff7b2213ace024b55dfd7313195d1fb1257bab6067b16d2b4f515941", + "settings.py": "d21f4b624767b19c80f534e608de6de6071260b5e2d642a06e6a7aec0148c161", + "auth.py": "6bebcd8d1d3ca4c2c6e8b0e5793ae13d8996cac3709b5b845d814b51a5e1a3c3", + "attachments.py": "3fbf029536834be791d39b38fb76e2eb694b46a57d891ff73763b3a7be99234f", + "storage.py": "2fd071caf423a09378d8fc162dc5f675484addf8589e0e0228057c6b7bb77d75", + "migrate.py": "f073c080e13635a01482539dbb474b9b4f49bbf5ff66f483dbda4fbe1d1eb57f", + "schemas.py": "3f94cc536beec31ec7890331abbc736445a311d03b30b9b5726dd60c17c9f6a9", + "repository.py": "d29dabc547e0071b21f8b9d5371fc5753b89766f2c3e8ea8412cdcb8a8c33384", + "domain.py": "bd8456d7423a3e12c02a57ed90d1875fc5c7acdcfc0d26b94f9ead4855160298" + }, + "runtime_matches_measurements": true, + "fresh_secrets": true, + "fresh_pg_and_s3_volumes": true, + "student_tests_passed": 65, + "public_smoke_passed": true, + "public_persistence_passed": true, + "api_instances": [ + { + "id": "f43056b397aa3639d9fe0220734c61f2e66caa5d6ce4522c35a645933787204d", + "started_at": "2026-10-17T17:22:12.959003129Z", + "pid": 9135, + "running": true, + "image": "sha256:4c8bff2f05a461167d1921b16e64fbd46342daffcaed4f1e9486dadea0ea3416", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "c4a9f8fb8759467b83f84981872cc014" + }, + { + "id": "ca95b52ce4b1976a36b4f0e1aa32a7310cacee932f4f8090b410cf957dc931c3", + "started_at": "2026-10-17T17:22:13.11128092Z", + "pid": 9269, + "running": true, + "image": "sha256:4c8bff2f05a461167d1921b16e64fbd46342daffcaed4f1e9486dadea0ea3416", + "memory": 536870912, + "nano_cpus": 1000000000, + "published_ports": {}, + "instance": "8f7362c97d3f40c48a6c72dd5504fb1e" + } + ], + "s3": { + "id": "3f7a14116acfd92ef834a5c71f2571b08c297e3786f16a7789bae5d28e4e7fae", + "started_at": "2026-10-17T17:22:12.732578545Z", + "pid": 8874, + "running": true, + "image": "sha256:ca2f62967cfd3096ef07615e356e3e6909bb6885e1672999fc0e206b478ec904", + "memory": 805306368, + "nano_cpus": 1000000000, + "published_ports": { + "9000/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "59004" + } + ] + } + } +} diff --git a/evidence/clean-clone.txt b/evidence/clean-clone.txt new file mode 100644 index 00000000..70cdbcb6 --- /dev/null +++ b/evidence/clean-clone.txt @@ -0,0 +1,22 @@ +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +python3 tests/smoke.py --base-url "http://127.0.0.1:28084" +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +uv run --locked pytest --disable-warnings +============================= test session starts ============================== +platform darwin -- Python 3.14.7, pytest-9.1.1, pluggy-1.7.0 +rootdir: +configfile: pyproject.toml +testpaths: student-tests +plugins: anyio-4.15.1 +collected 65 items + +student-tests/test_api.py .................................... [ 55%] +student-tests/test_attachments.py ................. [ 81%] +student-tests/test_cluster.py ............ [100%] + +======================= 65 passed, 2 warnings in 21.77s ======================== +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:28084" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. -- 2.54.0 From 1d8f8e6928048306b9138f9b658c1fe00ffaa4f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= Date: Fri, 30 Oct 2026 17:31:18 +0300 Subject: [PATCH 3/5] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE?= =?UTF-8?q?=D0=B2=D0=B8=D1=82=D1=8C=20=D0=BE=D1=82=D1=87=D1=91=D1=82=20?= =?UTF-8?q?=D0=B8=20=D0=BC=D0=B0=D1=82=D0=B5=D1=80=D0=B8=D0=B0=D0=BB=D1=8B?= =?UTF-8?q?=20=D1=81=D0=B4=D0=B0=D1=87=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/pull_request_template.md | 31 +++++++++++-------------------- REPORT.md | 7 ++++++- evidence/revision-map.json | 14 ++++++++++++++ 3 files changed, 31 insertions(+), 21 deletions(-) create mode 100644 evidence/revision-map.json diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index a8077206..9f60f453 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,25 +1,16 @@ ## Лабораторная 4 -Автор / группа: Горбанюк / БВТ2301 -Целевая оценка: 5. Трек 2, согласованность двух хранилищ. +Автор / группа: Горбанюк / БВТ2301. +Целевая оценка: 5. Трек: 2 — согласованность двух хранилищ. -Перенесена собственная lab3. Добавлены приватный MinIO, Attachment в PostgreSQL, -связи с Message, bounded PNG/JPEG upload, download с ACL через любую API, -раздельные S3 identities и отдельный reconciler с dry-run/grace/apply. +Реализация и воспроизводимая последовательность запуска: [REPORT.md](../REPORT.md). +Исходники приложения — src/, собственные проверки — student-tests/, результаты — evidence/. +Сохранено 65 собственных проверочных случаев; условия и результаты конкретных запусков приведены в отчёте. -Запуск: `make bootstrap`, `uv sync --locked`, `make up`, `make test`. -Первый build собирает закреплённый официальный S3 release из исходников. -Команды собственных тестов, отказов и исследования: [REPORT.md](../REPORT.md). +Контракт, исходное задание и публичные тесты сохранены. Секреты создаются локально и не входят в Git. +Ограничения и использованные первичные источники перечислены в REPORT.md. -Проверены 65 тестов, публичные smoke/persistence/failover, остановка загрузившей -API и скачивание другой, прерванный body, S3 outage, десять параллельных uploads, -реальный aged orphan и сохранение свежих/used объектов, missing/restore и повтор -apply. Измерена стоимость обхода с paging при 0/100/1100 дополнительных объектах. - -Ограничения: один host, LB/DB/S3 остаются SPOF; утраченные bytes требуют backup/ -исходника, а не восстановления из SHA. Presigned flow не заявляется. Источники приведены в отчёте. Удалённый CI пока не запускался. - -- [x] Исходный README/COURSE/CONTRIBUTING/contracts/public tests не изменены. -- [x] Все заявленные проверки приведены в evidence. -- [x] Secret values, Bearer и private keys отсутствуют в Git и отчёте. -- [x] Условия сохранения volumes, cleanup и ограничения задокументированы. +- [x] Реализован обязательный минимум и заявленный трек. +- [x] Приведены команды запуска, проверок и безопасной остановки. +- [x] Сохранены результаты проверок и ограничения выводов. +- [x] Credentials и приватные ключи находятся вне репозитория. diff --git a/REPORT.md b/REPORT.md index 89e2c6f3..b0f278a6 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,7 +1,8 @@ # Лабораторная 4 — Горбанюк, БВТ2301 + Целевая оценка: **5**, трек 2 «Согласованность двух хранилищ». Работа подготовлена -локально; fork/push/МР пока не выполнялись. Будущий заголовок: +для проверки; МР в преподавательский проект оформляется отдельно. Будущий заголовок: `ЛР 4 — БВТ2301 — Горбанюк — на 5`. Проверенная версия отмечается `lab4-verified`. Окончательную оценку выставляет преподаватель, публичный smoke — только минимум. @@ -378,3 +379,7 @@ Reconciler запускается вручную по команде; для р - [Boto3 retries](https://docs.aws.amazon.com/boto3/latest/guide/retries.html). - [AWS S3 object uploads](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html). - [Linux cgroup v2 memory interface](https://docs.kernel.org/admin-guide/cgroup-v2.html): memory.current/peak/max. + +## Соответствие ревизий + +После редактуры отчёта, шаблона и служебных метаданных сохранено соответствие прежних и текущих Git-ревизий: [revision-map.json](evidence/revision-map.json). Код приложения, миграции, зависимости, Dockerfile, конфигурация сервисов и исходные публичные проверки не изменены. Численные результаты и исторические image/source identifiers в evidence сохранены в исходном виде; их не следует трактовать как новый запуск измерений. diff --git a/evidence/revision-map.json b/evidence/revision-map.json new file mode 100644 index 00000000..cea7502e --- /dev/null +++ b/evidence/revision-map.json @@ -0,0 +1,14 @@ +{ + "scope": "Редактура документации и метаданных рисунка", + "runtime_sources_unchanged": true, + "migrations_dependencies_and_infrastructure_unchanged": true, + "instructor_contract_and_public_tests_unchanged": true, + "measurement_values_unchanged": true, + "original_head": "da6ca232c350186445c8531a0fae52d657985569", + "rewritten_history_head": "36d295e16cc9477ce10dcf92aab2d80a6d3b826f", + "commit_map": { + "900182cbb405d57b20c1b8bfd7cef21592ccf4cf": "85433e20e4102202451b2358c4a65075b2964b27", + "da6ca232c350186445c8531a0fae52d657985569": "36d295e16cc9477ce10dcf92aab2d80a6d3b826f", + "ec540a1a725862a8619fcb758daec4ad197f0dd5": "ec540a1a725862a8619fcb758daec4ad197f0dd5" + } +} -- 2.54.0 From 2c2f427750c500481ea0387bf741db73b2de760c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= Date: Fri, 30 Oct 2026 17:42:03 +0300 Subject: [PATCH 4/5] =?UTF-8?q?=D0=A3=D0=BA=D0=B0=D0=B7=D0=B0=D1=82=D1=8C?= =?UTF-8?q?=20=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D1=87=D0=BD=D1=8B=D0=B9=20?= =?UTF-8?q?=D1=84=D0=BE=D1=80=D0=BA=20=D0=B8=20=D0=BF=D0=BE=D1=80=D1=8F?= =?UTF-8?q?=D0=B4=D0=BE=D0=BA=20=D1=81=D0=B4=D0=B0=D1=87=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/REPORT.md b/REPORT.md index b0f278a6..72640387 100644 --- a/REPORT.md +++ b/REPORT.md @@ -2,7 +2,7 @@ Целевая оценка: **5**, трек 2 «Согласованность двух хранилищ». Работа подготовлена -для проверки; МР в преподавательский проект оформляется отдельно. Будущий заголовок: +для проверки. Название МР: `ЛР 4 — БВТ2301 — Горбанюк — на 5`. Проверенная версия отмечается `lab4-verified`. Окончательную оценку выставляет преподаватель, публичный smoke — только минимум. @@ -12,6 +12,8 @@ CONTRIBUTING, contracts и публичные tests именно lab4 сохранены без изменений. все заявленные результаты подтверждаются командами и evidence. +Публичный форк: . Ветка решения: `solution/bvt2301-gorbanyuk`, целевая ветка преподавателя — `main`. Отправка ветки и создание МР ещё не выполнены. + ## Запуск из отдельного чистого clone Нужны Docker Engine/Desktop + Compose v2, Git, Python 3.14.7 и uv 0.12.13. -- 2.54.0 From 48dea139a03f658981321191a7635555e4b6268d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= <152+wemiliam@noreply.gitea.privcloud.tech> Date: Fri, 30 Oct 2026 17:55:25 +0300 Subject: [PATCH 5/5] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D1=83=20=D0=BD=D0=B0=20?= =?UTF-8?q?=D0=9C=D0=A0=20=D0=BF=D1=80=D0=B5=D0=BF=D0=BE=D0=B4=D0=B0=D0=B2?= =?UTF-8?q?=D0=B0=D1=82=D0=B5=D0=BB=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/REPORT.md b/REPORT.md index 72640387..f477a583 100644 --- a/REPORT.md +++ b/REPORT.md @@ -10,9 +10,9 @@ сессии PostgreSQL, Argon2id, кэш Valkey, keyset-пагинация, две API за HAProxy, идемпотентные сообщения, отдельный migrate, action hooks. README, COURSE, CONTRIBUTING, contracts и публичные tests именно lab4 сохранены без изменений. -все заявленные результаты подтверждаются командами и evidence. +Все заявленные результаты подтверждаются командами и evidence. -Публичный форк: . Ветка решения: `solution/bvt2301-gorbanyuk`, целевая ветка преподавателя — `main`. Отправка ветки и создание МР ещё не выполнены. +Публичный форк: . Ветка решения: `solution/bvt2301-gorbanyuk`, целевая ветка преподавателя — `main`. Ветка опубликована; МР преподавателю: . ## Запуск из отдельного чистого clone -- 2.54.0