Files
mtusi2026lab2/src/cursor.py
T
2026-10-08 16:50:41 +03:00

70 lines
2.1 KiB
Python

import base64
from datetime import UTC, datetime
import hashlib
import hmac
import json
from secrets import token_bytes
from uuid import UUID
_secret = token_bytes(32)
class CursorError(ValueError):
"""Недопустимый, повреждённый или применённый не к тому ресурсу курсор."""
def _encode_bytes(value: bytes) -> str:
return base64.urlsafe_b64encode(value).decode().rstrip("=")
def _decode_bytes(value: str) -> bytes:
try:
return base64.urlsafe_b64decode(value + "=" * (-len(value) % 4))
except (ValueError, UnicodeEncodeError) as error:
raise CursorError from error
def encode_cursor(scope: str, created_at: datetime, item_id: str) -> str:
payload = json.dumps(
{
"scope": scope,
"created_at": created_at.astimezone(UTC)
.isoformat()
.replace("+00:00", "Z"),
"id": item_id,
},
separators=(",", ":"),
sort_keys=True,
).encode()
signature = hmac.new(_secret, payload, hashlib.sha256).digest()
return _encode_bytes(payload) + "." + _encode_bytes(signature)
def decode_cursor(cursor: str, expected_scope: str) -> tuple[datetime, str]:
try:
encoded_payload, encoded_signature = cursor.split(".")
payload = _decode_bytes(encoded_payload)
signature = _decode_bytes(encoded_signature)
except ValueError as error:
raise CursorError from error
expected_signature = hmac.new(_secret, payload, hashlib.sha256).digest()
if not hmac.compare_digest(signature, expected_signature):
raise CursorError
try:
data = json.loads(payload)
if set(data) != {"scope", "created_at", "id"}:
raise CursorError
if data["scope"] != expected_scope:
raise CursorError
item_id = str(UUID(data["id"]))
created_at = datetime.fromisoformat(data["created_at"].replace("Z", "+00:00"))
if created_at.tzinfo is None:
raise CursorError
return created_at.astimezone(UTC), item_id
except (TypeError, ValueError, KeyError) as error:
raise CursorError from error