Skip to content

Exceptions

glpi_utils.exceptions.GlpiError

Bases: Exception

Base exception for all glpi_utils errors.

Source code in glpi_utils/exceptions.py 
18
19
class GlpiError(Exception):
    """Base exception for all glpi_utils errors."""

glpi_utils.exceptions.GlpiAPIError

Bases: GlpiError

Raised when the GLPI server returns an API-level error response.

Attributes:

Name Type Description
status_code int or None

HTTP status code returned by the server.
error_code str or None

GLPI error identifier (e.g. "ERROR_SESSION_TOKEN_INVALID").
message str

Human-readable error message.
Source code in glpi_utils/exceptions.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
class GlpiAPIError(GlpiError):
    """Raised when the GLPI server returns an API-level error response.

    Attributes
    ----------
    status_code : int or None
        HTTP status code returned by the server.
    error_code : str or None
        GLPI error identifier (e.g. ``"ERROR_SESSION_TOKEN_INVALID"``).
    message : str
        Human-readable error message.
    """

    def __init__(
        self,
        message: str,
        status_code: Optional[int] = None,
        error_code: Optional[str] = None,
    ) -> None:
        super().__init__(message)
        self.status_code = status_code
        self.error_code = error_code
        self.message = message

    def __repr__(self) -> str:
        return (
            f"{self.__class__.__name__}("
            f"status_code={self.status_code!r}, "
            f"error_code={self.error_code!r}, "
            f"message={self.message!r})"
        )

glpi_utils.exceptions.GlpiAuthError

Bases: GlpiAPIError

Raised on authentication failures (HTTP 401 or invalid session token).

Source code in glpi_utils/exceptions.py 
59
60
class GlpiAuthError(GlpiAPIError):
    """Raised on authentication failures (HTTP 401 or invalid session token)."""

glpi_utils.exceptions.GlpiNotFoundError

Bases: GlpiAPIError

Raised when the requested resource does not exist (HTTP 404).

Source code in glpi_utils/exceptions.py 
63
64
class GlpiNotFoundError(GlpiAPIError):
    """Raised when the requested resource does not exist (HTTP 404)."""

glpi_utils.exceptions.GlpiPermissionError

Bases: GlpiAPIError

Raised when the authenticated user lacks the required rights (HTTP 403).

Source code in glpi_utils/exceptions.py 
67
68
class GlpiPermissionError(GlpiAPIError):
    """Raised when the authenticated user lacks the required rights (HTTP 403)."""

glpi_utils.exceptions.GlpiConnectionError

Bases: GlpiError

Raised when a network or transport error occurs.

Source code in glpi_utils/exceptions.py 
22
23
class GlpiConnectionError(GlpiError):
    """Raised when a network or transport error occurs."""