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