Skip to content

Errors & Constants Reference

Exception Hierarchy

tickertape.errors

Exception hierarchy for the TickerTape client.

Keep exceptions focused, practical, and small.

TickerTapeError

Bases: Exception

Base exception for all TickerTape client errors.

Source code in src/tickertape/errors.py 
11
12
class TickerTapeError(Exception):
    """Base exception for all TickerTape client errors."""

TickerTapeHTTPError

Bases: TickerTapeError

Raised when an HTTP request to TickerTape fails.

Source code in src/tickertape/errors.py 
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
class TickerTapeHTTPError(TickerTapeError):
    """Raised when an HTTP request to TickerTape fails."""

    def __init__(
        self,
        message: str,
        status_code: int,
        response_data: Any | None = None,
    ) -> None:
        super().__init__(message)
        self.status_code = status_code
        self.response_data = response_data

    def __str__(self) -> str:
        base = super().__str__()
        if self.response_data:
            return f"[{self.status_code}] {base} - {self.response_data}"
        return f"[{self.status_code}] {base}"

TickerTapeNotFoundError

Bases: TickerTapeHTTPError

Raised when the requested TickerTape resource is not found (HTTP 404).

Source code in src/tickertape/errors.py 
35
36
class TickerTapeNotFoundError(TickerTapeHTTPError):
    """Raised when the requested TickerTape resource is not found (HTTP 404)."""

TickerTapeParseError

Bases: TickerTapeError

Raised when parsing response data (XML sitemap, HTML, NEXT_DATA) fails.

Source code in src/tickertape/errors.py 
39
40
class TickerTapeParseError(TickerTapeError):
    """Raised when parsing response data (XML sitemap, HTML, __NEXT_DATA__) fails."""

Constants

tickertape.constants

Constants required for proper execution of TickerTapeClient.