forked from mtusi2026/mtusi2026lab5
Скопировано из mtusi2026lab4 (ветка solution/bvt2302-bodanyuk, commit 17c33cd) через git archive: исходники, миграции, собственные тесты, Dockerfile, compose, конфигурации infra/, скрипты и bench/. README, COURSE, contracts/, tests/ и отчёт lab4 не копировались. Makefile и .env.example — версии lab4 (skeleton-часть совпадает с lab5, строки broker добавляются в следующих коммитах). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
58 lines
1.7 KiB
Python
58 lines
1.7 KiB
Python
"""Swagger UI for manual experiments: http://127.0.0.1:8080/docs
|
|
|
|
The page shows the course contract contracts/openapi.json as is (it is not
|
|
generated from our code). Only `servers` is replaced with "/" so that the
|
|
"Try it out" requests go to the same host the page was opened from.
|
|
Swagger UI itself (JS/CSS) is loaded by the browser from the jsDelivr CDN.
|
|
Disable with DOCS_ENABLED=false.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
from functools import lru_cache
|
|
from pathlib import Path
|
|
|
|
from starlette.requests import Request
|
|
from starlette.responses import HTMLResponse, JSONResponse
|
|
|
|
SPEC_PATH = Path(__file__).resolve().parents[2] / "contracts" / "openapi.json"
|
|
SWAGGER_UI = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.33.0"
|
|
|
|
PAGE = f"""<!doctype html>
|
|
<html lang="ru">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<title>Messenger lab1 — Swagger UI</title>
|
|
<link rel="stylesheet" href="{SWAGGER_UI}/swagger-ui.css">
|
|
</head>
|
|
<body>
|
|
<div id="swagger-ui"></div>
|
|
<script src="{SWAGGER_UI}/swagger-ui-bundle.js"></script>
|
|
<script>
|
|
window.ui = SwaggerUIBundle({{
|
|
url: "/openapi.json",
|
|
dom_id: "#swagger-ui",
|
|
tryItOutEnabled: true, // fields are editable right away
|
|
persistAuthorization: true, // X-User-Id from "Authorize" survives page reload
|
|
displayRequestDuration: true,
|
|
}});
|
|
</script>
|
|
</body>
|
|
</html>
|
|
"""
|
|
|
|
|
|
@lru_cache(maxsize=1)
|
|
def _spec() -> dict:
|
|
spec = json.loads(SPEC_PATH.read_text(encoding="utf-8"))
|
|
spec["servers"] = [{"url": "/", "description": "этот сервер"}]
|
|
return spec
|
|
|
|
|
|
async def swagger_page(request: Request) -> HTMLResponse:
|
|
return HTMLResponse(PAGE)
|
|
|
|
|
|
async def openapi_json(request: Request) -> JSONResponse:
|
|
return JSONResponse(_spec())
|