42 lines
1.6 KiB
Python
42 lines
1.6 KiB
Python
"""Versioned keyset position, bound to a list and its resource, never an offset."""
|
|
|
|
import base64
|
|
import binascii
|
|
import json
|
|
from datetime import UTC, datetime
|
|
from uuid import UUID
|
|
|
|
from messenger.domain import HistoryKey, invalid
|
|
|
|
|
|
def encode_cursor(scope: str, position: HistoryKey) -> str:
|
|
value = {"v": 1, "scope": scope, "created_at": position[0], "id": position[1]}
|
|
return (
|
|
base64.urlsafe_b64encode(json.dumps(value, separators=(",", ":")).encode())
|
|
.decode()
|
|
.rstrip("=")
|
|
)
|
|
|
|
|
|
def decode_cursor(value: str | None, scope: str) -> HistoryKey | None:
|
|
if value is None:
|
|
return None
|
|
try:
|
|
if not value or len(value) > 1024:
|
|
raise ValueError
|
|
raw = base64.b64decode(value + "=" * (-len(value) % 4), altchars=b"-_", validate=True)
|
|
data = json.loads(raw)
|
|
if not isinstance(data, dict) or set(data) != {"v", "scope", "created_at", "id"}:
|
|
raise ValueError
|
|
if type(data["v"]) is not int or data["v"] != 1 or data["scope"] != scope:
|
|
raise ValueError
|
|
if not isinstance(data["created_at"], str) or not data["created_at"].endswith("Z"):
|
|
raise ValueError
|
|
stamp = datetime.fromisoformat(data["created_at"])
|
|
if stamp.tzinfo != UTC or not isinstance(data["id"], str):
|
|
raise ValueError
|
|
identity = str(UUID(data["id"]))
|
|
return stamp.isoformat(timespec="microseconds").replace("+00:00", "Z"), identity
|
|
except ValueError, TypeError, KeyError, UnicodeError, binascii.Error:
|
|
raise invalid("Некорректный cursor или другая область пагинации") from None
|