Files
mtusi2026lab5/src/infra/upload_slots.py
T
ricoromaandClaude Opus 5.5 04f859282d chore: port lab 4 solution into the lab 5 skeleton
Source: mtusi2026lab4-safronov, solution/bvt2301-safronov, 2546deb.
Contracts, public tests and evidence of lab 4 are not carried over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 03:09:12 +03:00

79 lines
3.7 KiB
Python

"""Места загрузок вложений процесса API: допуск к обработке, а не данные.
Design change `upload-memory`, решения 1–3. Процесс обрабатывает не
больше `[uploads] max_concurrent` загрузок одновременно, ещё не больше
`max_waiting` ждут места по порядку прихода (`asyncio.Semaphore` отдаёт
место первому ожидающему), но не дольше `wait_timeout_seconds`. Очередь
полна или срок вышел — `UploadsBusy` (429). Так память загрузок
ограничена числом мест, а не числом клиентов.
Состояние в памяти процесса корректности ответов не задевает: как лимит
хэшей паролей (`src/infra/password.py`), это допуск к обработке, и места
считает каждая реплика сама. Глобал `upload_slots` создаётся при импорте
из `settings.uploads`; импортирует его только `src/api/dependencies.py`,
сервис получает его конструктором (`infra.md`).
"""
import asyncio
import time
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
from src.config import settings
from src.core.exceptions import UploadsBusy
class UploadSlots:
"""Места загрузок процесса и короткая очередь ожидания."""
def __init__(
self,
*,
max_concurrent: int,
max_waiting: int,
wait_timeout_seconds: float,
) -> None:
self.max_concurrent = max_concurrent
self.max_waiting = max_waiting
self.wait_timeout_seconds = wait_timeout_seconds
self._semaphore = asyncio.Semaphore(max_concurrent)
self._waiting = 0
@asynccontextmanager
async def slot(self) -> AsyncIterator[int]:
"""Занять место на время контекста; отдаёт ожидание места в мс.
Места нет и ожидающих уже `max_waiting` — сразу `UploadsBusy`.
Иначе ожидание по порядку прихода не дольше срока, не вышло —
`UploadsBusy`. Занятое место освобождается в `finally` при любом
исходе, в том числе при отмене запроса. Отмену во время ожидания
`asyncio.Semaphore` обрабатывает сам: место, отданное отменённому
ожидающему, переходит следующему, и число мест не меняется.
"""
started = time.monotonic()
if self._semaphore.locked():
if self._waiting >= self.max_waiting:
raise UploadsBusy
self._waiting += 1
try:
async with asyncio.timeout(self.wait_timeout_seconds):
await self._semaphore.acquire()
except TimeoutError as e:
raise UploadsBusy from e
finally:
self._waiting -= 1
else:
# место свободно: acquire не уступает цикл событий
await self._semaphore.acquire()
try:
yield round((time.monotonic() - started) * 1000)
finally:
self._semaphore.release()
upload_slots = UploadSlots(
max_concurrent=settings.uploads.max_concurrent,
max_waiting=settings.uploads.max_waiting,
wait_timeout_seconds=settings.uploads.wait_timeout_seconds,
)