class LobstersError(Exception):
    """Base exception for the lobste.rs client."""

class LobstersAPIError(LobstersError):
    """Base exception for API-related failures."""

    def __init__(
        self,
        *,
        resource: str,
        identifier: str | int,
        endpoint: URL,
        status_code: int,
    ) -> None:
        self.identifier = identifier
        self.endpoint = endpoint
        self.status_code = status_code

        identifier_repr = (
            repr(identifier) if isinstance(identifier, str) else str(identifier)
        )

        super().__init__(
            f"{resource} {identifier_repr} not found "
            f"(GET {endpoint} returned {status_code})"
        )

class ResourceNotFound(LobstersAPIError):
    """Base exception for missing Lobsters resources."""

    resource_name = "Resource"
    status_code = 404

    def __init__(
        self,
        identifier: str | int,
        *,
        endpoint: URL,
    ) -> None:
        super().__init__(
            resource=self.resource_name,
            identifier=identifier,
            endpoint=endpoint,
            status_code=self.status_code,
        )

class StoryNotFound(ResourceNotFound):
    resource_name = "Story"

    def __init__(self, story_id: str, *, endpoint: URL) -> None:
        self.story_id = story_id
        super().__init__(
            identifier=story_id,
            endpoint=endpoint,
        )

class CommentNotFound(ResourceNotFound):
    resource_name = "Comment"
    status_code = 400

    def __init__(self, comment_id: str, *, endpoint: URL) -> None:
        self.comment_id = comment_id
        super().__init__(
            identifier=comment_id,
            endpoint=endpoint,
        )

class UserNotFound(ResourceNotFound):
    resource_name = "User"

    def __init__(self, username: str, *, endpoint: URL) -> None:
        self.username = username
        super().__init__(
            identifier=username,
            endpoint=endpoint,
        )

class TagNotFound(ResourceNotFound):
    resource_name = "Tag"

    def __init__(self, tag: str, *, endpoint: URL) -> None:
        self.tag = tag
        super().__init__(
            identifier=tag,
            endpoint=endpoint,
        )

class FeedPageNotFound(ResourceNotFound):
    resource_name = "Feed page"

    def __init__(self, page: int, *, endpoint: URL) -> None:
        self.page = page
        super().__init__(
            identifier=page,
            endpoint=endpoint,
        )