notifyhub-client 0.1.0__tar.gz

notifyhub_client-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: notifyhub-client
+Version: 0.1.0
+Summary: NotifyHub 多语言通知推送服务 - Python 客户端
+License: MIT
+Project-URL: Homepage, https://github.com/huangwenfu750/notifyhub
+Project-URL: Repository, https://github.com/huangwenfu750/notifyhub
+Project-URL: Issues, https://github.com/huangwenfu750/notifyhub/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.60
+Provides-Extra: dev
+Requires-Dist: grpcio-tools>=1.60; extra == "dev"
+
+# NotifyHub Python SDK
+
+> English: [README.en.md](README.en.md)
+
+```bash
+pip install -e sdks/python   # 本地安装（发布到 PyPI 前的用法）
+```
+
+```python
+from notifyhub import NotifyClient, PublishRequest
+
+with NotifyClient("localhost:9987", token="ntf_xxx") as client:
+    client.publish("alert", "部署完成", "v1.2.0 上线", params={"env": "prod"})
+    print(client.ping())
+```
+
+批量发布（一条双向流，单条失败不中断）：
+
+```python
+reqs = [
+    PublishRequest(topic="alert.db", title="t1", content="c1"),
+    PublishRequest(title="缺 topic 的非法请求"),
+]
+for ack in client.publish_batch(reqs):
+    print(ack.accepted, ack.error)      # True '' / False 'INVALID_ARGUMENT: topic 不能为空'
+```
+
+订阅主题：
+
+```python
+sub = client.subscribe(["alert.*"], print)
+...
+sub.cancel()
+```
+
+用代码注册推送平台：
+
+```python
+client.upsert_platform(
+    name="ding-alert", type="dingtalk",
+    webhook="https://oapi.dingtalk.com/robot/send?access_token=xxx",
+    secret="SECxxx", topics=["alert"],
+)
+```
+
+重新生成 stub（改了 proto 之后）：
+
+```bash
+./scripts/gen-protos.sh python
+```

notifyhub_client-0.1.0/README.md

@@ -0,0 +1,50 @@
+# NotifyHub Python SDK
+
+> English: [README.en.md](README.en.md)
+
+```bash
+pip install -e sdks/python   # 本地安装（发布到 PyPI 前的用法）
+```
+
+```python
+from notifyhub import NotifyClient, PublishRequest
+
+with NotifyClient("localhost:9987", token="ntf_xxx") as client:
+    client.publish("alert", "部署完成", "v1.2.0 上线", params={"env": "prod"})
+    print(client.ping())
+```
+
+批量发布（一条双向流，单条失败不中断）：
+
+```python
+reqs = [
+    PublishRequest(topic="alert.db", title="t1", content="c1"),
+    PublishRequest(title="缺 topic 的非法请求"),
+]
+for ack in client.publish_batch(reqs):
+    print(ack.accepted, ack.error)      # True '' / False 'INVALID_ARGUMENT: topic 不能为空'
+```
+
+订阅主题：
+
+```python
+sub = client.subscribe(["alert.*"], print)
+...
+sub.cancel()
+```
+
+用代码注册推送平台：
+
+```python
+client.upsert_platform(
+    name="ding-alert", type="dingtalk",
+    webhook="https://oapi.dingtalk.com/robot/send?access_token=xxx",
+    secret="SECxxx", topics=["alert"],
+)
+```
+
+重新生成 stub（改了 proto 之后）：
+
+```bash
+./scripts/gen-protos.sh python
+```

notifyhub_client-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "notifyhub-client"
+version = "0.1.0"
+description = "NotifyHub 多语言通知推送服务 - Python 客户端"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+dependencies = ["grpcio>=1.60"]
+
+[project.urls]
+Homepage = "https://github.com/huangwenfu750/notifyhub"
+Repository = "https://github.com/huangwenfu750/notifyhub"
+Issues = "https://github.com/huangwenfu750/notifyhub/issues"
+
+[project.optional-dependencies]
+dev = ["grpcio-tools>=1.60"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+notifyhub = ["notify/v1/*.pyi"]

notifyhub_client-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

notifyhub_client-0.1.0/src/notifyhub/__init__.py

@@ -0,0 +1,38 @@
+"""NotifyHub Python 客户端（gRPC 薄封装）。
+
+用法::
+
+    from notifyhub import NotifyClient
+
+    client = NotifyClient("localhost:9987", token="xxx")
+    client.publish("alert", "部署完成", "v1.2.0 上线")
+    client.close()
+
+批量发布（双向流）::
+
+    from notifyhub import NotifyClient, PublishRequest
+
+    reqs = [PublishRequest(topic="a.b", title="t1"),
+            PublishRequest(title="非法：缺 topic")]
+    for ack in client.publish_batch(reqs):
+        print(ack.accepted, ack.error)
+"""
+
+from .client import Event, NotifyClient, NotifyError, PublishAck, Subscription
+from .notify.v1 import notify_pb2
+
+Options = notify_pb2.Options
+PublishRequest = notify_pb2.PublishRequest
+PlatformConfig = notify_pb2.PlatformConfig
+
+__all__ = [
+    "NotifyClient",
+    "NotifyError",
+    "PublishAck",
+    "Event",
+    "Subscription",
+    "PublishRequest",
+    "Options",
+    "PlatformConfig",
+]
+__version__ = "0.1.0"

notifyhub_client-0.1.0/src/notifyhub/client.py

@@ -0,0 +1,227 @@
+"""NotifyClient: NotifyHub gRPC 客户端薄封装。
+
+发布、订阅、Admin（代码配置推送平台）三类操作；token 通过 metadata 注入。
+"""
+
+from __future__ import annotations
+
+from typing import Callable, Iterable, Optional
+
+import grpc
+
+from .notify.v1 import notify_pb2 as pb
+from .notify.v1 import notify_pb2_grpc as pb_grpc
+
+
+class NotifyError(Exception):
+    """服务端返回的错误（对应 gRPC Status）。"""
+
+    def __init__(self, code: grpc.StatusCode, details: str):
+        self.code = code
+        self.details = details
+        super().__init__(f"{code.name}: {details}")
+
+
+class Event:
+    """订阅收到的事件。"""
+
+    def __init__(self, msg: pb.Event):
+        self.topic = msg.topic
+        self.title = msg.title
+        self.content = msg.content
+        self.params = dict(msg.params)
+        self.event_id = msg.event_id
+        self.timestamp = msg.timestamp
+
+    def __repr__(self) -> str:  # pragma: no cover
+        return f"Event(topic={self.topic!r}, title={self.title!r}, event_id={self.event_id!r})"
+
+
+class PublishAck:
+    """发布回执。"""
+
+    def __init__(self, ack: pb.PublishAck):
+        self.event_id = ack.event_id
+        self.accepted = ack.accepted
+        self.deduplicated = ack.deduplicated
+        self.matched_platforms = list(ack.matched_platforms)
+        self.error = ack.error
+
+    def __repr__(self) -> str:  # pragma: no cover
+        return (f"PublishAck(accepted={self.accepted}, deduplicated={self.deduplicated}, "
+                f"matched={self.matched_platforms})")
+
+
+class Subscription:
+    """订阅句柄：close() 主动退订。"""
+
+    def __init__(self, call: grpc.Future | object, close: Callable[[], None]):
+        self._call = call
+        self._close = close
+
+    def cancel(self) -> None:
+        self._close()
+
+    close = cancel
+
+
+def _wrap_grpc_error(fn):
+    def inner(*args, **kwargs):
+        try:
+            return fn(*args, **kwargs)
+        except grpc.RpcError as e:
+            raise NotifyError(e.code(), e.details()) from e
+    return inner
+
+
+class NotifyClient:
+    """与 NotifyHub 服务端的连接。线程安全，可在多线程间共享。"""
+
+    def __init__(self, target: str, token: Optional[str] = None):
+        """target 形如 "localhost:9987"。token 为服务端 auth.tokens 中的一项。"""
+        self._token = token
+        self._raw_channel = grpc.insecure_channel(target)
+        if token:
+            # 用拦截器把 x-api-token 注入每次调用
+            self._channel = grpc.intercept_channel(self._raw_channel, self._make_interceptor(token))
+        else:
+            self._channel = self._raw_channel
+        self._stub = pb_grpc.NotifyStub(self._channel)
+
+    @staticmethod
+    def _make_interceptor(token: str):
+        class _Invoker(grpc.UnaryUnaryClientInterceptor,
+                       grpc.UnaryStreamClientInterceptor,
+                       grpc.StreamUnaryClientInterceptor,
+                       grpc.StreamStreamClientInterceptor):
+            def intercept_unary_unary(self, continuation, client_call_details, request):
+                return continuation(self._with_token(client_call_details), request)
+
+            def intercept_unary_stream(self, continuation, client_call_details, request):
+                return continuation(self._with_token(client_call_details), request)
+
+            def intercept_stream_unary(self, continuation, client_call_details, request_iterator):
+                return continuation(self._with_token(client_call_details), request_iterator)
+
+            def intercept_stream_stream(self, continuation, client_call_details, request_iterator):
+                return continuation(self._with_token(client_call_details), request_iterator)
+
+            @staticmethod
+            def _with_token(client_call_details):
+                md = list(client_call_details.metadata or [])
+                md.append(("x-api-token", token))
+                return client_call_details._replace(metadata=md)
+
+        return _Invoker()
+
+    # ---------- 发布 ----------
+
+    @_wrap_grpc_error
+    def publish(self, topic: str, title: str = "", content: str = "",
+                params: Optional[dict] = None,
+                platforms: Optional[Iterable[str]] = None,
+                dedup_key: str = "",
+                skip_subscribers: bool = False,
+                skip_platforms: bool = False,
+                timeout: float = 10.0) -> PublishAck:
+        """发布一条通知：按路由推送平台 + 广播给订阅者。"""
+        req = pb.PublishRequest(
+            topic=topic, title=title, content=content,
+            params=params or {},
+            platforms=list(platforms or []),
+            options=pb.Options(dedup_key=dedup_key,
+                               skip_subscribers=skip_subscribers,
+                               skip_platforms=skip_platforms),
+        )
+        return PublishAck(self._stub.Publish(req, timeout=timeout))
+
+    # ---------- 批量发布（双向流） ----------
+
+    @_wrap_grpc_error
+    def publish_batch(self, requests, timeout: float = 10.0) -> list:
+        """批量发布（双向流）：逐条发送并收集回执。
+
+        requests 为 pb.PublishRequest 的可迭代对象；单条错误（topic 为空、平台不存在）
+        不中断流，对应回执的 accepted=False 且带 error。
+        """
+        return [PublishAck(ack) for ack in self._stub.PublishStream(iter(requests), timeout=timeout)]
+
+    def publish_stream(self, requests):
+        """底层双向流：返回回执迭代器，由调用方自行消费（适合边生成边发送）。"""
+        return self._stub.PublishStream(iter(requests))
+
+    # ---------- 订阅 ----------
+
+    def subscribe(self, topics: Iterable[str], on_event: Callable[[Event], None],
+                  on_error: Optional[Callable[[Exception], None]] = None) -> Subscription:
+        """订阅主题，回调在后台线程触发。"""
+        import threading
+
+        call = self._stub.Subscribe(pb.SubscribeRequest(topics=list(topics)))
+        stop = threading.Event()
+        finished = threading.Event()
+
+        def pump():
+            try:
+                for msg in call:
+                    if stop.is_set():
+                        break
+                    on_event(Event(msg))
+            except grpc.RpcError as e:
+                if e.code() != grpc.StatusCode.CANCELLED and on_error:
+                    on_error(e)
+            finally:
+                finished.set()
+
+        t = threading.Thread(target=pump, daemon=True, name="notifyhub-sub")
+        t.start()
+
+        def close():
+            stop.set()
+            call.cancel()
+
+        return Subscription(call, close)
+
+    # ---------- Admin ----------
+
+    @_wrap_grpc_error
+    def upsert_platform(self, name: str, type: str, webhook: str,
+                        secret: str = "", topics: Optional[Iterable[str]] = None,
+                        template: str = "", at_mobiles: Optional[Iterable[str]] = None,
+                        extra: Optional[dict] = None,
+                        rate_limit_qps: int = 0,
+                        timeout: float = 10.0) -> dict:
+        """用代码注册/更新推送平台（运行时生效，重启后需重新注册或写入配置文件）。"""
+        cfg = pb.PlatformConfig(
+            name=name, type=type, webhook=webhook, secret=secret,
+            topics=list(topics or ["*"]), template=template,
+            at_mobiles=list(at_mobiles or []), extra=extra or {},
+            rate_limit_qps=rate_limit_qps)
+        out = self._stub.UpsertPlatform(cfg, timeout=timeout)
+        return {"name": out.name, "type": out.type, "topics": list(out.topics)}
+
+    @_wrap_grpc_error
+    def list_platforms(self, timeout: float = 10.0) -> list:
+        out = self._stub.ListPlatforms(pb.Empty(), timeout=timeout)
+        return [{"name": p.name, "type": p.type, "webhook": p.webhook,
+                 "topics": list(p.topics)} for p in out.platforms]
+
+    @_wrap_grpc_error
+    def remove_platform(self, name: str, timeout: float = 10.0) -> None:
+        self._stub.RemovePlatform(pb.PlatformRef(name=name), timeout=timeout)
+
+    @_wrap_grpc_error
+    def ping(self, timeout: float = 5.0) -> dict:
+        out = self._stub.Ping(pb.Empty(), timeout=timeout)
+        return {"version": out.version, "uptime_seconds": out.uptime_seconds}
+
+    # ---------- 生命周期 ----------
+
+    def close(self):
+        self._raw_channel.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc):
+        self.close()

notifyhub_client-0.1.0/src/notifyhub/notify/v1/notify_pb2.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: notify/v1/notify.proto
+# Protobuf Python Version: 7.35.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    7,
+    35,
+    1,
+    '',
+    'notify/v1/notify.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x16notify/v1/notify.proto\x12\tnotify.v1\"\x07\n\x05\x45mpty\"/\n\x04Pong\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x16\n\x0euptime_seconds\x18\x02 \x01(\x03\"N\n\x07Options\x12\x11\n\tdedup_key\x18\x01 \x01(\t\x12\x18\n\x10skip_subscribers\x18\x02 \x01(\x08\x12\x16\n\x0eskip_platforms\x18\x03 \x01(\x08\"\xdd\x01\n\x0ePublishRequest\x12\r\n\x05topic\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\t\x12\x35\n\x06params\x18\x04 \x03(\x0b\x32%.notify.v1.PublishRequest.ParamsEntry\x12\x11\n\tplatforms\x18\x05 \x03(\t\x12#\n\x07options\x18\x06 \x01(\x0b\x32\x12.notify.v1.Options\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"p\n\nPublishAck\x12\x10\n\x08\x65vent_id\x18\x01 \x01(\t\x12\x10\n\x08\x61\x63\x63\x65pted\x18\x02 \x01(\x08\x12\x14\n\x0c\x64\x65\x64uplicated\x18\x03 \x01(\x08\x12\x19\n\x11matched_platforms\x18\x04 \x03(\t\x12\r\n\x05\x65rror\x18\x05 \x01(\t\"\"\n\x10SubscribeRequest\x12\x0e\n\x06topics\x18\x01 \x03(\t\"\xca\x01\n\x05\x45vent\x12\r\n\x05topic\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\t\x12,\n\x06params\x18\x04 \x03(\x0b\x32\x1c.notify.v1.Event.ParamsEntry\x12\x10\n\x08platform\x18\x05 \x01(\t\x12\x10\n\x08\x65vent_id\x18\x06 \x01(\t\x12\x11\n\ttimestamp\x18\x07 \x01(\x03\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xa5\x02\n\x0ePlatformConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x0f\n\x07webhook\x18\x03 \x01(\t\x12\x0e\n\x06secret\x18\x04 \x01(\t\x12\x0e\n\x06topics\x18\x05 \x03(\t\x12\x10\n\x08template\x18\x06 \x01(\t\x12\x12\n\nat_mobiles\x18\x07 \x03(\t\x12\x33\n\x05\x65xtra\x18\x08 \x03(\x0b\x32$.notify.v1.PlatformConfig.ExtraEntry\x12%\n\x05retry\x18\t \x01(\x0b\x32\x16.notify.v1.RetryPolicy\x12\x16\n\x0erate_limit_qps\x18\n \x01(\x05\x1a,\n\nExtraEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"7\n\x0bRetryPolicy\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x12\n\nbackoff_ms\x18\x02 \x01(\x03\"\x1b\n\x0bPlatformRef\x12\x0c\n\x04name\x18\x01 \x01(\t\"<\n\x0cPlatformList\x12,\n\tplatforms\x18\x01 \x03(\x0b\x32\x19.notify.v1.PlatformConfig2\xb5\x03\n\x06Notify\x12;\n\x07Publish\x12\x19.notify.v1.PublishRequest\x1a\x15.notify.v1.PublishAck\x12<\n\tSubscribe\x12\x1b.notify.v1.SubscribeRequest\x1a\x10.notify.v1.Event0\x01\x12\x45\n\rPublishStream\x12\x19.notify.v1.PublishRequest\x1a\x15.notify.v1.PublishAck(\x01\x30\x01\x12\x46\n\x0eUpsertPlatform\x12\x19.notify.v1.PlatformConfig\x1a\x19.notify.v1.PlatformConfig\x12:\n\rListPlatforms\x12\x10.notify.v1.Empty\x1a\x17.notify.v1.PlatformList\x12:\n\x0eRemovePlatform\x12\x16.notify.v1.PlatformRef\x1a\x10.notify.v1.Empty\x12)\n\x04Ping\x12\x10.notify.v1.Empty\x1a\x0f.notify.v1.PongBc\n\x0fio.notifyhub.v1B\x0bNotifyProtoP\x01ZAgithub.com/huangwenfu750/notifyhub/sdks/go/gen/notify/v1;notifyv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'notify.v1.notify_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\017io.notifyhub.v1B\013NotifyProtoP\001ZAgithub.com/huangwenfu750/notifyhub/sdks/go/gen/notify/v1;notifyv1'
+  _globals['_PUBLISHREQUEST_PARAMSENTRY']._loaded_options = None
+  _globals['_PUBLISHREQUEST_PARAMSENTRY']._serialized_options = b'8\001'
+  _globals['_EVENT_PARAMSENTRY']._loaded_options = None
+  _globals['_EVENT_PARAMSENTRY']._serialized_options = b'8\001'
+  _globals['_PLATFORMCONFIG_EXTRAENTRY']._loaded_options = None
+  _globals['_PLATFORMCONFIG_EXTRAENTRY']._serialized_options = b'8\001'
+  _globals['_EMPTY']._serialized_start=37
+  _globals['_EMPTY']._serialized_end=44
+  _globals['_PONG']._serialized_start=46
+  _globals['_PONG']._serialized_end=93
+  _globals['_OPTIONS']._serialized_start=95
+  _globals['_OPTIONS']._serialized_end=173
+  _globals['_PUBLISHREQUEST']._serialized_start=176
+  _globals['_PUBLISHREQUEST']._serialized_end=397
+  _globals['_PUBLISHREQUEST_PARAMSENTRY']._serialized_start=352
+  _globals['_PUBLISHREQUEST_PARAMSENTRY']._serialized_end=397
+  _globals['_PUBLISHACK']._serialized_start=399
+  _globals['_PUBLISHACK']._serialized_end=511
+  _globals['_SUBSCRIBEREQUEST']._serialized_start=513
+  _globals['_SUBSCRIBEREQUEST']._serialized_end=547
+  _globals['_EVENT']._serialized_start=550
+  _globals['_EVENT']._serialized_end=752
+  _globals['_EVENT_PARAMSENTRY']._serialized_start=352
+  _globals['_EVENT_PARAMSENTRY']._serialized_end=397
+  _globals['_PLATFORMCONFIG']._serialized_start=755
+  _globals['_PLATFORMCONFIG']._serialized_end=1048
+  _globals['_PLATFORMCONFIG_EXTRAENTRY']._serialized_start=1004
+  _globals['_PLATFORMCONFIG_EXTRAENTRY']._serialized_end=1048
+  _globals['_RETRYPOLICY']._serialized_start=1050
+  _globals['_RETRYPOLICY']._serialized_end=1105
+  _globals['_PLATFORMREF']._serialized_start=1107
+  _globals['_PLATFORMREF']._serialized_end=1134
+  _globals['_PLATFORMLIST']._serialized_start=1136
+  _globals['_PLATFORMLIST']._serialized_end=1196
+  _globals['_NOTIFY']._serialized_start=1199
+  _globals['_NOTIFY']._serialized_end=1636
+# @@protoc_insertion_point(module_scope)

notifyhub_client-0.1.0/src/notifyhub/notify/v1/notify_pb2_grpc.py

@@ -0,0 +1,366 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from notifyhub.notify.v1 import notify_pb2 as notify_dot_v1_dot_notify__pb2
+
+GRPC_GENERATED_VERSION = '1.84.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in notify/v1/notify_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class NotifyStub:
+    """NotifyHub —— 多语言通知推送服务。
+    本文件是唯一契约：服务端将来重写（Go/Rust/Zig）时不得变更既有字段的编号与语义。
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Publish = channel.unary_unary(
+                '/notify.v1.Notify/Publish',
+                request_serializer=notify_dot_v1_dot_notify__pb2.PublishRequest.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.PublishAck.FromString,
+                _registered_method=True)
+        self.Subscribe = channel.unary_stream(
+                '/notify.v1.Notify/Subscribe',
+                request_serializer=notify_dot_v1_dot_notify__pb2.SubscribeRequest.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.Event.FromString,
+                _registered_method=True)
+        self.PublishStream = channel.stream_stream(
+                '/notify.v1.Notify/PublishStream',
+                request_serializer=notify_dot_v1_dot_notify__pb2.PublishRequest.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.PublishAck.FromString,
+                _registered_method=True)
+        self.UpsertPlatform = channel.unary_unary(
+                '/notify.v1.Notify/UpsertPlatform',
+                request_serializer=notify_dot_v1_dot_notify__pb2.PlatformConfig.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.PlatformConfig.FromString,
+                _registered_method=True)
+        self.ListPlatforms = channel.unary_unary(
+                '/notify.v1.Notify/ListPlatforms',
+                request_serializer=notify_dot_v1_dot_notify__pb2.Empty.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.PlatformList.FromString,
+                _registered_method=True)
+        self.RemovePlatform = channel.unary_unary(
+                '/notify.v1.Notify/RemovePlatform',
+                request_serializer=notify_dot_v1_dot_notify__pb2.PlatformRef.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.Empty.FromString,
+                _registered_method=True)
+        self.Ping = channel.unary_unary(
+                '/notify.v1.Notify/Ping',
+                request_serializer=notify_dot_v1_dot_notify__pb2.Empty.SerializeToString,
+                response_deserializer=notify_dot_v1_dot_notify__pb2.Pong.FromString,
+                _registered_method=True)
+
+
+class NotifyServicer:
+    """NotifyHub —— 多语言通知推送服务。
+    本文件是唯一契约：服务端将来重写（Go/Rust/Zig）时不得变更既有字段的编号与语义。
+    """
+
+    def Publish(self, request, context):
+        """发布通知：按路由推送到外部平台 + 广播给在线订阅者。
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def Subscribe(self, request, context):
+        """订阅主题，服务端流式推送。
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def PublishStream(self, request_iterator, context):
+        """批量发布（双向流：每收到一条请求，回执一条 Ack）。
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UpsertPlatform(self, request, context):
+        """用代码配置推送平台（运行时生效；重启后需重新注册，或写入配置文件）。
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def ListPlatforms(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def RemovePlatform(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def Ping(self, request, context):
+        """健康检查（无需鉴权）。
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_NotifyServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Publish': grpc.unary_unary_rpc_method_handler(
+                    servicer.Publish,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.PublishRequest.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.PublishAck.SerializeToString,
+            ),
+            'Subscribe': grpc.unary_stream_rpc_method_handler(
+                    servicer.Subscribe,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.SubscribeRequest.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.Event.SerializeToString,
+            ),
+            'PublishStream': grpc.stream_stream_rpc_method_handler(
+                    servicer.PublishStream,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.PublishRequest.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.PublishAck.SerializeToString,
+            ),
+            'UpsertPlatform': grpc.unary_unary_rpc_method_handler(
+                    servicer.UpsertPlatform,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.PlatformConfig.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.PlatformConfig.SerializeToString,
+            ),
+            'ListPlatforms': grpc.unary_unary_rpc_method_handler(
+                    servicer.ListPlatforms,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.Empty.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.PlatformList.SerializeToString,
+            ),
+            'RemovePlatform': grpc.unary_unary_rpc_method_handler(
+                    servicer.RemovePlatform,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.PlatformRef.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.Empty.SerializeToString,
+            ),
+            'Ping': grpc.unary_unary_rpc_method_handler(
+                    servicer.Ping,
+                    request_deserializer=notify_dot_v1_dot_notify__pb2.Empty.FromString,
+                    response_serializer=notify_dot_v1_dot_notify__pb2.Pong.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'notify.v1.Notify', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('notify.v1.Notify', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class Notify:
+    """NotifyHub —— 多语言通知推送服务。
+    本文件是唯一契约：服务端将来重写（Go/Rust/Zig）时不得变更既有字段的编号与语义。
+    """
+
+    @staticmethod
+    def Publish(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/notify.v1.Notify/Publish',
+            notify_dot_v1_dot_notify__pb2.PublishRequest.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.PublishAck.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def Subscribe(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            '/notify.v1.Notify/Subscribe',
+            notify_dot_v1_dot_notify__pb2.SubscribeRequest.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.Event.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def PublishStream(request_iterator,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.stream_stream(
+            request_iterator,
+            target,
+            '/notify.v1.Notify/PublishStream',
+            notify_dot_v1_dot_notify__pb2.PublishRequest.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.PublishAck.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def UpsertPlatform(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/notify.v1.Notify/UpsertPlatform',
+            notify_dot_v1_dot_notify__pb2.PlatformConfig.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.PlatformConfig.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def ListPlatforms(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/notify.v1.Notify/ListPlatforms',
+            notify_dot_v1_dot_notify__pb2.Empty.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.PlatformList.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def RemovePlatform(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/notify.v1.Notify/RemovePlatform',
+            notify_dot_v1_dot_notify__pb2.PlatformRef.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.Empty.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def Ping(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/notify.v1.Notify/Ping',
+            notify_dot_v1_dot_notify__pb2.Empty.SerializeToString,
+            notify_dot_v1_dot_notify__pb2.Pong.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

notifyhub_client-0.1.0/src/notifyhub_client.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: notifyhub-client
+Version: 0.1.0
+Summary: NotifyHub 多语言通知推送服务 - Python 客户端
+License: MIT
+Project-URL: Homepage, https://github.com/huangwenfu750/notifyhub
+Project-URL: Repository, https://github.com/huangwenfu750/notifyhub
+Project-URL: Issues, https://github.com/huangwenfu750/notifyhub/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.60
+Provides-Extra: dev
+Requires-Dist: grpcio-tools>=1.60; extra == "dev"
+
+# NotifyHub Python SDK
+
+> English: [README.en.md](README.en.md)
+
+```bash
+pip install -e sdks/python   # 本地安装（发布到 PyPI 前的用法）
+```
+
+```python
+from notifyhub import NotifyClient, PublishRequest
+
+with NotifyClient("localhost:9987", token="ntf_xxx") as client:
+    client.publish("alert", "部署完成", "v1.2.0 上线", params={"env": "prod"})
+    print(client.ping())
+```
+
+批量发布（一条双向流，单条失败不中断）：
+
+```python
+reqs = [
+    PublishRequest(topic="alert.db", title="t1", content="c1"),
+    PublishRequest(title="缺 topic 的非法请求"),
+]
+for ack in client.publish_batch(reqs):
+    print(ack.accepted, ack.error)      # True '' / False 'INVALID_ARGUMENT: topic 不能为空'
+```
+
+订阅主题：
+
+```python
+sub = client.subscribe(["alert.*"], print)
+...
+sub.cancel()
+```
+
+用代码注册推送平台：
+
+```python
+client.upsert_platform(
+    name="ding-alert", type="dingtalk",
+    webhook="https://oapi.dingtalk.com/robot/send?access_token=xxx",
+    secret="SECxxx", topics=["alert"],
+)
+```
+
+重新生成 stub（改了 proto 之后）：
+
+```bash
+./scripts/gen-protos.sh python
+```

notifyhub_client-0.1.0/src/notifyhub_client.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/notifyhub/__init__.py
+src/notifyhub/client.py
+src/notifyhub/notify/__init__.py
+src/notifyhub/notify/v1/__init__.py
+src/notifyhub/notify/v1/notify_pb2.py
+src/notifyhub/notify/v1/notify_pb2_grpc.py
+src/notifyhub_client.egg-info/PKG-INFO
+src/notifyhub_client.egg-info/SOURCES.txt
+src/notifyhub_client.egg-info/dependency_links.txt
+src/notifyhub_client.egg-info/requires.txt
+src/notifyhub_client.egg-info/top_level.txt

notifyhub_client-0.1.0/src/notifyhub_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

notifyhub_client-0.1.0/src/notifyhub_client.egg-info/requires.txt

@@ -0,0 +1,4 @@
+grpcio>=1.60
+
+[dev]
+grpcio-tools>=1.60

notifyhub_client-0.1.0/src/notifyhub_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+notifyhub