from dataclasses import dataclass, field
from typing import TypeVar, Generic

T = TypeVar('T')

class PaginatedResult(Generic[T]):
    """Wraps paginated API results with metadata."""

    def __init__(self, items: list[T], total: int, page: int, page_size: int):
        self._items = items
        self.total = total
        self.page = page
        self.page_size = page_size

    @property
    def total_pages(self) -> int:
        return (self.total + self.page_size - 1) // self.page_size

    @property
    def has_next(self) -> bool:
        return self.page < self.total_pages

    @property
    def has_prev(self) -> bool:
        return self.page > 1

    def __len__(self) -> int:
        return len(self._items)

    def __iter__(self):
        return iter(self._items)

    def __getitem__(self, index):
        return self._items[index]

    def __bool__(self) -> bool:
        return len(self._items) > 0

    def __repr__(self) -> str:
        return (
            f"PaginatedResult("
            f"page={self.page}/{self.total_pages}, "
            f"items={len(self)}, total={self.total})"
        )
OOP — Dunder Methods, @property, Encapsulation

OOP — Dunder Methods, @property, Encapsulation
