gwp 0.2.1

A standalone, pure Rust gRPC wire protocol for GQL (ISO/IEC 39075)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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
57

"""Exception hierarchy for GWP."""

from __future__ import annotations

from dataclasses import dataclass


class GqlError(Exception):
    """Base exception for all GWP errors."""


class ConnectionError(GqlError):
    """Failed to connect to the server."""


class SessionError(GqlError):
    """Session-level error (not found, expired)."""


class TransactionError(GqlError):
    """Transaction state error."""


@dataclass
class DiagnosticRecord:
    """Diagnostic context from a GQLSTATUS error."""

    operation: str
    operation_code: int
    current_schema: str = ""


class GqlStatusError(GqlError):
    """GQL-domain error carrying a GQLSTATUS code."""

    def __init__(
        self,
        code: str,
        message: str,
        diagnostic: DiagnosticRecord | None = None,
    ):
        super().__init__(f"[{code}] {message}")
        self.code = code
        self.gql_message = message
        self.diagnostic = diagnostic

    def is_success(self) -> bool:
        return self.code[:2] == "00"

    def is_warning(self) -> bool:
        return self.code[:2] == "01"

    def is_exception(self) -> bool:
        c = self.code[:2]
        if c[0].isalpha():
            return True
        return c >= "08"