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>
79 lines
3.7 KiB
Python
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,
|
|
)
|