npien 1.0.0__py3-none-any.whl

npien/__init__.py

@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+from .core import Npien, PeerInfo
+from .crypto import Ticket
+from .exceptions import (
+    ConnectionTimeoutError,
+    NotConnectedError,
+    NpienError,
+    PeerNotFoundError,
+    ProtocolError,
+    TicketError,
+)
+
+__version__ = "1.0.0"
+
+_default: Npien | None = None
+
+
+def default() -> Npien:
+    global _default
+    if _default is None:
+        _default = Npien()
+    return _default
+
+
+def set_appid(appid: str) -> Npien:
+    return default().set_appid(appid)
+
+
+def set_name(name: str) -> Npien:
+    return default().set_name(name)
+
+
+def connect(room: str, peer=None, ticket: str | None = None, tickets=None,
+            timeout: float = 8.0, discover: bool = True):
+    return default().connect(
+        room,
+        peer=peer,
+        ticket=ticket,
+        tickets=tickets,
+        timeout=timeout,
+        discover=discover,
+    )
+
+
+def listen(room: str, advertise: bool = True) -> Npien:
+    return default().listen(room, advertise=advertise)
+
+
+def join_room(room: str, advertise: bool = True) -> Npien:
+    return default().join_room(room, advertise=advertise)
+
+
+def send(data, to=None) -> int:
+    return default().send(data, to=to)
+
+
+def sendto(data, peer) -> int:
+    return default().sendto(data, peer)
+
+
+def receive(timeout: float | None = None):
+    return default().receive(timeout=timeout)
+
+
+def receive_nowait():
+    return default().receive_nowait()
+
+
+def advsecure(enabled: bool = True) -> Npien:
+    return default().advsecure(enabled)
+
+
+def disablesecure() -> Npien:
+    return default().disablesecure()
+
+
+def create_ticket(room: str | None = None) -> str:
+    return default().create_ticket(room)
+
+
+def add_peer(ticket: str) -> None:
+    return default().add_peer(ticket)
+
+
+def known_peers(room: str | None = None):
+    return default().known_peers(room)
+
+
+def peers(room: str | None = None):
+    return default().peers(room)
+
+
+def on_message(callback):
+    return default().on_message(callback)
+
+
+def get_stun_info() -> dict:
+    return default().get_stun_info()
+
+
+def connection_info() -> dict:
+    return default().connection_info()
+
+
+def disconnect(target=None) -> None:
+    return default().disconnect(target)
+
+
+def close() -> None:
+    global _default
+    if _default is not None:
+        _default.close()
+        _default = None
+
+
+__all__ = [
+    "Npien",
+    "PeerInfo",
+    "Ticket",
+    "NpienError",
+    "ProtocolError",
+    "TicketError",
+    "NotConnectedError",
+    "PeerNotFoundError",
+    "ConnectionTimeoutError",
+    "default",
+    "set_appid",
+    "set_name",
+    "connect",
+    "listen",
+    "join_room",
+    "send",
+    "sendto",
+    "receive",
+    "receive_nowait",
+    "advsecure",
+    "disablesecure",
+    "create_ticket",
+    "add_peer",
+    "known_peers",
+    "peers",
+    "on_message",
+    "get_stun_info",
+    "connection_info",
+    "disconnect",
+    "close",
+]