обновила тесты и health.py

This commit is contained in:
vasyukova
2026-10-02 14:02:14 +03:00
parent 1bbd29df44
commit f1fe9d7beb
2 changed files with 128 additions and 97 deletions
+13 -15
View File
@@ -1,4 +1,4 @@
from fastapi import APIRouter, Response
from fastapi import APIRouter
from ..models.schemas import Health
from ..storage import db as _db
from ..storage.sessions import _redis_client, _store
@@ -22,19 +22,17 @@ def liveness() -> Health:
summary="Проверка готовности принимать трафик",
response_model=Health,
)
def readiness(response: Response) -> Health:
"""200, если PostgreSQL и (в режиме redis) Redis доступны; иначе 503."""
try:
with _db.connection() as conn, conn.cursor() as cur:
cur.execute("SELECT 1")
cur.fetchone()
except Exception:
response.status_code = 503
return Health(status="ok")
def readiness() -> Health:
"""200, если PostgreSQL и (в режиме redis) Redis доступны.
При недоступности зависимости исключение вылетает наверх, и main.py
конвертирует его в 503 с телом Error из contracts/openapi.json.
"""
with _db.connection() as conn, conn.cursor() as cur:
cur.execute("SELECT 1")
cur.fetchone()
if _store() == "redis":
try:
_redis_client().ping()
except Exception:
response.status_code = 503
return Health(status="ok")
# _redis_client() сам поднимает RuntimeError("redis_unavailable")
# при ошибке; main.runtime_error_handler → 503 Error.
_redis_client().ping()
return Health(status="ok")
+115 -82
View File
@@ -8,10 +8,12 @@
4) python student-tests/test_lab2_level4.py --base-url http://localhost:8080
5) перед smoke/persistence вернуть SESSION_TTL_SECONDS=3600 и снова up -d --force-recreate api
Про TTL=5. Методичка (contracts/README.md) разрешает короткий TTL именно
для теста истечения. TTL=5 достаточно, чтобы успеть проверить валидность
токена до истечения, и достаточно коротко, чтобы дождаться истечения
в рамках теста.
Порядок тестов: тяжёлые по данным и конкурентные — ДО expiry-теста,
потому что при коротком TTL любой долгий шаг съедает окно жизни сессии.
Expiry-тест запускается последним и использует свежие сессии.
test_explain не зависит от TTL вообще: он сидирует данные напрямую
через psql и проверяет план SQL-запроса, а не HTTP-слой.
"""
import base64
import datetime as dt
@@ -28,52 +30,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests"))
from client import Client, Failure, arguments, check, run # noqa: E402
def test_short_ttl_expiry(c):
"""TTL=5. Проверяем полный цикл: токен валиден -> истекает -> 401."""
suffix = uuid.uuid4().hex[:10]
username = "ttl_" + suffix
password = "T3st-" + uuid.uuid4().hex
user = c.call("POST", "/api/v1/users", 201,
body={"username": username, "display_name": "TTL", "password": password},
schema="User")["json"]
cred = base64.b64encode((username + ":" + password).encode()).decode()
session = c.call("POST", "/api/v1/auth/sessions", 201,
headers={"Authorization": "Basic " + cred},
schema="Session")["json"]
token = session["token"]
# Контроль: сервер выдал короткий TTL, иначе тест бессмыслен.
expires_at = dt.datetime.fromisoformat(session["expires_at"].replace("Z", "+00:00"))
ttl_actual = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds()
check(3.0 <= ttl_actual <= 10,
"SESSION_TTL_SECONDS не короткий (получено %.1f c). "
"Поставь SESSION_TTL_SECONDS=5 в .env и перезапусти API." % ttl_actual)
# До истечения токен должен работать.
me = c.call("GET", "/api/v1/users/me", 200,
headers={"Authorization": "Bearer " + token},
schema="User")["json"]
check(me["id"] == user["id"], "token must identify its owner before expiry")
# Ждём гарантированного истечения TTL + запас.
remaining = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds()
time.sleep(max(remaining, 0.0) + 1.0)
# Истёкший токен — 401.
c.call("GET", "/api/v1/users/me", 401,
headers={"Authorization": "Bearer " + token})
# Второй вход тем же пользователем даёт рабочий токен: истёк именно
# первый токен, а не пользователь/хранилище целиком.
session2 = c.call("POST", "/api/v1/auth/sessions", 201,
headers={"Authorization": "Basic " + cred},
schema="Session")["json"]
c.call("GET", "/api/v1/users/me", 200,
headers={"Authorization": "Bearer " + session2["token"]},
schema="User")
# ---------- 2. Конкурентная регистрация одинакового username ----------
# ---------- 1. Конкурентная регистрация одинакового username ----------
def test_concurrent_registration(c):
"""Один и тот же username с 8 потоков — ровно одна 201, остальные 409."""
username = "race_" + uuid.uuid4().hex[:10]
@@ -98,7 +55,7 @@ def test_concurrent_registration(c):
check(results.count(409) == 7, "expected seven 409, got %s" % results)
# ---------- 3. EXPLAIN на реальной БД ----------
# ---------- 2. EXPLAIN на реальной БД ----------
def _read_dsn() -> str:
dsn = os.environ.get("DATABASE_URL")
if not dsn:
@@ -128,32 +85,16 @@ def _psql(dsn_in_container: str, sql: str) -> str:
return r.stdout + r.stderr
def _seed_messages(c, chat, actor, count: int):
"""Доливает count сообщений в чат через API параллельно, батчами."""
print(" сидируем %d сообщений в чат %s ..." % (count, chat["id"]))
batch = 64
def one(i):
local = Client(c.base, timeout=15)
local.message(actor, chat, "seed-%06d-%s" % (i, uuid.uuid4().hex[:6]))
done = 0
with ThreadPoolExecutor(max_workers=16) as pool:
while done < count:
n = min(batch, count - done)
list(pool.map(one, range(done, done + n)))
done += n
if done % 1024 == 0 or done == count:
print(" ... %d/%d" % (done, count))
def test_explain(c):
"""EXPLAIN (ANALYZE, BUFFERS) истории сообщений на >=10 000 строк.
Методичка: индекс истории обоснован запросом и EXPLAIN на >=10 000
сообщениях. На пустой таблице планировщик выбирает Seq Scan, поэтому
тест сам доводит messages до >=10 000 строк, делает ANALYZE и
проверяет план для самого крупного чата.
тест сам доводит messages до >=10 000 строк и делает ANALYZE.
Данные сидируются напрямую через psql, без API: тест не зависит от
SESSION_TTL_SECONDS и скорости scrypt. Это корректно, потому что
EXPLAIN проверяет план SQL-запроса, а не HTTP-слой.
"""
dsn_in_container = _read_dsn()
@@ -165,13 +106,55 @@ def test_explain(c):
target_total = 10_000
if have < target_total:
need = target_total - have
# Один чат для сидинга: берём первый доступный или создаём новый.
alice, bob, eve, chat = c.bootstrap()
_seed_messages(c, chat, alice, need)
print(" сидируем %d сообщений напрямую через psql ..." % need)
# Один чат: берём существующий или создаём минимальный.
# gen_random_uuid() доступен в PG13+ без расширений.
seed_sql = """
DO $$
DECLARE
v_user UUID;
v_chat UUID;
BEGIN
SELECT id INTO v_user FROM users LIMIT 1;
IF v_user IS NULL THEN
v_user := gen_random_uuid();
INSERT INTO users (id, username, display_name, password_hash, created_at)
VALUES (v_user, 'seed_' || substr(v_user::text, 1, 8), 'Seed',
'scrypt$16384$8$1$00$00', now());
END IF;
SELECT id INTO v_chat FROM chats LIMIT 1;
IF v_chat IS NULL THEN
v_chat := gen_random_uuid();
INSERT INTO chats (id, title, created_at) VALUES (v_chat, 'Seed chat', now());
INSERT INTO chat_members (chat_id, user_id) VALUES (v_chat, v_user);
END IF;
-- Доливаем ровно need строк в этот чат.
INSERT INTO messages (id, chat_id, sender_id, text, created_at)
SELECT gen_random_uuid(), v_chat, v_user,
'seed-' || g, now() - (g || ' milliseconds')::interval
FROM generate_series(1, %d) AS g;
END $$;
""" % need
r = subprocess.run(
[
"docker", "run", "--rm",
"--add-host=host.docker.internal:host-gateway",
"postgres:18-alpine",
"psql", dsn_in_container, "-c", seed_sql,
],
capture_output=True, text=True, timeout=120,
)
seed_out = r.stdout + r.stderr
check("ERROR" not in seed_out, "сидирование не удалось:\n" + seed_out)
# ANALYZE обязателен: без него планировщик не знает реальных размеров.
_psql(dsn_in_container, "ANALYZE messages;")
_psql(dsn_in_container, "ANALYZE chat_members;")
_psql(dsn_in_container, "ANALYZE chats;")
print(" сидирование завершено")
# EXPLAIN по САМОМУ БОЛЬШОМУ чату, чтобы планировщик имел основания
# выбрать индекс, а не Seq Scan.
@@ -204,7 +187,7 @@ def test_explain(c):
"EXPLAIN не показал использования индекса:\n" + out)
# ---------- 4. Недоступность Redis ----------
# ---------- 3. Недоступность Redis ----------
def _compose(action):
return subprocess.run(
["docker", "compose", "--env-file", ".env", action, "redis"],
@@ -252,17 +235,63 @@ def test_redis_unavailable(c):
_wait_ready(c, timeout=60)
# ---------- 4. Expiry TTL ----------
def test_short_ttl_expiry(c):
"""TTL=5. Проверяем полный цикл: токен валиден -> истекает -> 401.
Идёт ПОСЛЕДНИМ: при коротком TTL любая долгая подготовка съедает
окно жизни сессии, поэтому соседние тесты работают раньше.
"""
suffix = uuid.uuid4().hex[:10]
username = "ttl_" + suffix
password = "T3st-" + uuid.uuid4().hex
user = c.call("POST", "/api/v1/users", 201,
body={"username": username, "display_name": "TTL", "password": password},
schema="User")["json"]
cred = base64.b64encode((username + ":" + password).encode()).decode()
session = c.call("POST", "/api/v1/auth/sessions", 201,
headers={"Authorization": "Basic " + cred},
schema="Session")["json"]
token = session["token"]
# Контроль: сервер выдал короткий TTL, иначе тест бессмыслен.
expires_at = dt.datetime.fromisoformat(session["expires_at"].replace("Z", "+00:00"))
ttl_actual = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds()
check(3.0 <= ttl_actual <= 10,
"SESSION_TTL_SECONDS не короткий (получено %.1f c). "
"Поставь SESSION_TTL_SECONDS=5 в .env и перезапусти API." % ttl_actual)
# До истечения токен должен работать.
me = c.call("GET", "/api/v1/users/me", 200,
headers={"Authorization": "Bearer " + token},
schema="User")["json"]
check(me["id"] == user["id"], "token must identify its owner before expiry")
# Ждём гарантированного истечения TTL + запас.
remaining = (expires_at - dt.datetime.now(dt.timezone.utc)).total_seconds()
time.sleep(max(remaining, 0.0) + 1.0)
# Истёкший токен — 401.
c.call("GET", "/api/v1/users/me", 401,
headers={"Authorization": "Bearer " + token})
# Второй вход тем же пользователем даёт рабочий токен: истёк именно
# первый токен, а не пользователь/хранилище целиком.
session2 = c.call("POST", "/api/v1/auth/sessions", 201,
headers={"Authorization": "Basic " + cred},
schema="Session")["json"]
c.call("GET", "/api/v1/users/me", 200,
headers={"Authorization": "Bearer " + session2["token"]},
schema="User")
# ---------- main ----------
def main():
args = arguments("Lab2 level 4 checks")
c = Client(args.base_url, args.ca_file)
# Expiry-тест запускается первым: при коротком TTL любая подготовка
# (bootstrap, конкурентная регистрация) съедает окно жизни сессии.
print("=== test_short_ttl_expiry ===")
test_short_ttl_expiry(c)
print("PASS: session valid before TTL, expires after TTL, 401 on expired token")
# Порядок: сначала тяжёлые/долгие тесты, expiry — последним,
# потому что при коротком TTL он «сжигает» сессии.
print("=== test_concurrent_registration ===")
test_concurrent_registration(c)
print("PASS: concurrent registration produces exactly one user")
@@ -275,6 +304,10 @@ def main():
test_redis_unavailable(c)
print("PASS: readiness 503 без Redis, затем восстановление")
print("=== test_short_ttl_expiry ===")
test_short_ttl_expiry(c)
print("PASS: session valid before TTL, expires after TTL, 401 on expired token")
print("PASS: all lab2 level-4 checks passed")