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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
#
# Ouroboros - Copyright (C) 2016 - 2026
#
# Python API for Ouroboros
#
# Dimitri Staessens <dimitri@ouroboros.rocks>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public License
# version 2.1 as published by the Free Software Foundation.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., http://www.fsf.org/about/contact/.
#
"""Public Python API for Ouroboros.
The package surface only re-exports pure-Python helpers (errors and
QoS). Applications import the load-bearing parts of the API from
their submodule explicitly: flows from :mod:`ouroboros.dev`, the
event loop from :mod:`ouroboros.event`, and the control plane from
:mod:`ouroboros.irm` (or :mod:`ouroboros.cli`). Submodule paths
make the caller's intent explicit and keep the package importable
in environments that have no business loading the libouroboros CFFI
extensions (see ``CLAUDE.md`` for the underlying init-on-load
behaviour that makes this contract load-bearing in practice).
"""
from __future__ import annotations
from importlib.metadata import PackageNotFoundError, version
from ouroboros.errors import (
BindError,
FlowAuthError,
FlowCryptError,
FlowDeallocWarning,
FlowDownError,
FlowError,
FlowEventError,
FlowPeerError,
FlowPermissionError,
FlowReplayError,
InvalidNameError,
IpcpBootstrapError,
IpcpConnectError,
IpcpCreateError,
IpcpEnrollError,
IpcpStateError,
IpcpTypeError,
IpcpdError,
IrmError,
IrmdError,
NameExistsError,
NameNotFoundError,
OuroborosError,
)
from ouroboros.qos import (
QOS_MSG,
QOS_RAW,
QOS_RAW_SAFE,
QOS_RT,
QOS_RT_SAFE,
QOS_STREAM,
QoSService,
QoSSpec,
)
try:
__version__ = version("PyOuroboros")
except PackageNotFoundError:
__version__ = "0.0.0+unknown"
__all__ = [
"__version__",
# qos
"QoSService", "QoSSpec",
"QOS_MSG", "QOS_RAW", "QOS_RAW_SAFE",
"QOS_RT", "QOS_RT_SAFE", "QOS_STREAM",
# errors
"OuroborosError",
"IrmError", "IrmdError", "IpcpdError",
"IpcpCreateError", "IpcpBootstrapError", "IpcpEnrollError",
"IpcpConnectError", "IpcpTypeError", "IpcpStateError",
"BindError",
"NameNotFoundError", "NameExistsError", "InvalidNameError",
"FlowError", "FlowDownError", "FlowPeerError",
"FlowPermissionError", "FlowEventError",
"FlowCryptError", "FlowAuthError", "FlowReplayError",
"FlowDeallocWarning",
]
|
