_exceptions.py

from __future__ import annotations

from typing import Any


class HCloudException(Exception):
    """There was an error while using the hcloud library.

    All exceptions in the hcloud library inherit from this exception. It may be used as
    catch-all exception.
    """


class APIException(HCloudException):
    """There was an error while performing an API Request."""

    def __init__(
        self,
        code: int | str,
        message: str,
        details: Any,
        *,
        correlation_id: str | None = None,
    ):
        extras = [str(code)]
        if correlation_id is not None:
            extras.append(correlation_id)

        error = f"{message} ({', '.join(extras)})"

        super().__init__(error)
        self.code = code
        self.message = message
        self.details = details
        self.correlation_id = correlation_id