Exceptions

from funstat_api import FunstatError, ResolveError, ApiError

`FunstatError`

Base exception for all funstat errors. Catch this to handle any library error:

from funstat_api import FunstatError

try:
    result = fs.stats("someone")
except FunstatError as e:
    print(f"Something went wrong: {e}")

Raised when a username or group cannot be resolved to a numeric ID. See resolve_username and username_usage for context.

from funstat_api import ResolveError

try:
    result = fs.stats("nonexistent_xyz_404")
except ResolveError as e:
    print(f"Not found: {e}")

Raised when the API returns a non-200 HTTP status code.

Attribute	Type	Description
`status_code`	`int`	HTTP status code returned by the API
`path`	`str`	API path that was requested

from funstat_api import ApiError

try:
    result = fs.stats("durov")
except ApiError as e:
    print(f"HTTP {e.status_code} on {e.path}")

FunstatError
├── ResolveError   # username/group not found
└── ApiError       # non-200 HTTP response