wecom-aibot-sdk-python 0.1.0__tar.gz

wecom_aibot_sdk_python-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      test:
+        description: 'Publish to TestPyPI'
+        required: false
+        default: 'false'
+        type: boolean
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to TestPyPI
+        if: ${{ github.event_name == 'workflow_dispatch' && inputs.test == true }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Publish to PyPI
+        if: ${{ github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.test != true) }}
+        uses: pypa/gh-action-pypi-publish@release/v1

wecom_aibot_sdk_python-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test/coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Logs
+*.log

wecom_aibot_sdk_python-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

wecom_aibot_sdk_python-0.1.0/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: wecom-aibot-sdk-python
+Version: 0.1.0
+Summary: WeCom AI Bot Python SDK - Based on WebSocket long connection, provides core capabilities including message sending/receiving, streaming replies, template cards, event callbacks, and file download decryption
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pycryptodome>=3.20.0
+Requires-Dist: websockets>=12.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# WeCom AI Bot Python SDK
+
+Enterprise WeChat AI Bot Python SDK - Based on WebSocket long connection, providing message sending/receiving, streaming replies, template cards, event callbacks, file download/decryption and other core capabilities.
+
+## Features
+
+- **WebSocket Long Connection** - Built-in default address `wss://openws.work.weixin.qq.com`, ready to use
+- **Auto Authentication** - Automatically sends authentication frame after connection (botId + secret)
+- **Heartbeat Keep-Alive** - Automatic heartbeat maintenance, auto-detects connection issues when ACKs are missing
+- **Auto Reconnect** - Exponential backoff reconnection strategy (1s → 2s → 4s → ... → 30s max)
+- **Message Dispatch** - Auto-parses message types and triggers corresponding events (text/image/mixed/voice/file)
+- **Streaming Reply** - Built-in streaming reply methods, supports Markdown and mixed content
+- **Template Cards** - Supports replying with template card messages, stream+card combo replies, card updates
+- **Proactive Push** - Proactively send Markdown or template card messages to specified chats
+- **Event Callbacks** - Supports enter_chat, template_card_event, feedback_event
+- **Serial Reply Queue** - Replies with same req_id are sent serially, auto-waits for receipt
+- **File Download & Decryption** - Built-in AES-256-CBC file decryption, each image/file message has its own aeskey
+- **Pluggable Logging** - Supports custom Logger, includes DefaultLogger with timestamps
+
+## Installation
+
+```bash
+pip install wecom-aibot-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from wecom_aibot_sdk import WSClient, generate_req_id
+
+async def main():
+    # 1. Create client instance
+    client = WSClient({
+        "bot_id": "your-bot-id",
+        "secret": "your-bot-secret",
+    })
+
+    # 2. Listen for text messages and reply with streaming
+    async def on_text(frame):
+        content = frame.body.get("text", {}).get("content", "")
+        stream_id = generate_req_id("stream")
+
+        # Send intermediate content
+        await client.reply_stream(frame, stream_id, "Thinking...", finish=False)
+
+        # Send final result
+        await client.reply_stream(frame, stream_id, f'You said: "{content}"', finish=True)
+
+    client.on("message.text", on_text)
+
+    # 3. Listen for enter_chat event (send welcome)
+    async def on_enter(frame):
+        await client.reply_welcome(frame, {
+            "msgtype": "text",
+            "text": {"content": "Hello! How can I help you?"},
+        })
+
+    client.on("event.enter_chat", on_enter)
+
+    # 4. Connect
+    await client.connect_async()
+
+    # Keep running
+    while client.is_connected:
+        await asyncio.sleep(1)
+
+asyncio.run(main())
+```
+
+## API Reference
+
+### WSClient
+
+Core client class providing connection management, message sending/receiving.
+
+```python
+client = WSClient({
+    "bot_id": "your-bot-id",
+    "secret": "your-bot-secret",
+    # Optional:
+    "reconnect_interval": 1000,     # Reconnect base delay (ms)
+    "max_reconnect_attempts": 10,   # Max reconnect attempts (-1 for infinite)
+    "heartbeat_interval": 30000,    # Heartbeat interval (ms)
+    "request_timeout": 10000,       # HTTP request timeout (ms)
+    "ws_url": "wss://...",          # Custom WebSocket URL
+    "logger": custom_logger,        # Custom logger instance
+})
+```
+
+#### Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `connect_async()` | Establish WebSocket connection | `None` |
+| `disconnect()` | Disconnect | `None` |
+| `reply(frame, body, cmd?)` | Send reply message (generic) | `None` |
+| `reply_stream(frame, stream_id, content, finish?, msg_item?, feedback?)` | Send streaming reply | `None` |
+| `reply_welcome(frame, body)` | Send welcome reply (within 5s of event) | `None` |
+| `reply_template_card(frame, template_card, feedback?)` | Reply with template card | `None` |
+| `reply_stream_with_card(frame, stream_id, content, finish?, options?)` | Send stream + card combo | `None` |
+| `update_template_card(frame, template_card, userids?)` | Update template card (within 5s) | `None` |
+| `send_message(chatid, body)` | Proactively send message | `None` |
+| `download_file(url, aes_key)` | Download and decrypt file | `tuple[bytes, str?]` |
+
+#### Events
+
+| Event | Callback | Description |
+|-------|----------|-------------|
+| `connected` | `()` | WebSocket connected |
+| `authenticated` | `()` | Authentication successful |
+| `disconnected` | `(reason)` | Connection lost |
+| `reconnecting` | `(attempt)` | Reconnecting (attempt N) |
+| `error` | `(frame)` | Error occurred |
+| `message` | `(frame)` | Any message received |
+| `message.text` | `(frame)` | Text message |
+| `message.image` | `(frame)` | Image message |
+| `message.mixed` | `(frame)` | Mixed content message |
+| `message.voice` | `(frame)` | Voice message |
+| `message.file` | `(frame)` | File message |
+| `event` | `(frame)` | Any event |
+| `event.enter_chat` | `(frame)` | User entered chat |
+| `event.template_card_event` | `(frame)` | Card button clicked |
+| `event.feedback_event` | `(frame)` | User feedback |
+
+## Project Structure
+
+```
+wecom_aibot_sdk/
+├── __init__.py          # Package entry, exports
+├── client.py            # WSClient core client
+├── ws.py                # WebSocket connection manager
+├── message_handler.py   # Message parsing and event dispatch
+├── api.py               # HTTP API client (file download)
+├── crypto.py            # AES-256-CBC file decryption
+├── logger.py            # Default logger implementation
+├── utils.py             # Utility functions (generate_req_id, etc.)
+└── types/               # Type definitions
+    ├── __init__.py
+    ├── config.py        # Configuration types
+    ├── event.py         # Event types
+    ├── message.py       # Message types
+    ├── api.py           # API/WebSocket frame types
+    └── common.py        # Common types (Logger)
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+ruff format .
+```
+
+## License
+
+MIT

wecom_aibot_sdk_python-0.1.0/README.md

@@ -0,0 +1,162 @@
+# WeCom AI Bot Python SDK
+
+Enterprise WeChat AI Bot Python SDK - Based on WebSocket long connection, providing message sending/receiving, streaming replies, template cards, event callbacks, file download/decryption and other core capabilities.
+
+## Features
+
+- **WebSocket Long Connection** - Built-in default address `wss://openws.work.weixin.qq.com`, ready to use
+- **Auto Authentication** - Automatically sends authentication frame after connection (botId + secret)
+- **Heartbeat Keep-Alive** - Automatic heartbeat maintenance, auto-detects connection issues when ACKs are missing
+- **Auto Reconnect** - Exponential backoff reconnection strategy (1s → 2s → 4s → ... → 30s max)
+- **Message Dispatch** - Auto-parses message types and triggers corresponding events (text/image/mixed/voice/file)
+- **Streaming Reply** - Built-in streaming reply methods, supports Markdown and mixed content
+- **Template Cards** - Supports replying with template card messages, stream+card combo replies, card updates
+- **Proactive Push** - Proactively send Markdown or template card messages to specified chats
+- **Event Callbacks** - Supports enter_chat, template_card_event, feedback_event
+- **Serial Reply Queue** - Replies with same req_id are sent serially, auto-waits for receipt
+- **File Download & Decryption** - Built-in AES-256-CBC file decryption, each image/file message has its own aeskey
+- **Pluggable Logging** - Supports custom Logger, includes DefaultLogger with timestamps
+
+## Installation
+
+```bash
+pip install wecom-aibot-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from wecom_aibot_sdk import WSClient, generate_req_id
+
+async def main():
+    # 1. Create client instance
+    client = WSClient({
+        "bot_id": "your-bot-id",
+        "secret": "your-bot-secret",
+    })
+
+    # 2. Listen for text messages and reply with streaming
+    async def on_text(frame):
+        content = frame.body.get("text", {}).get("content", "")
+        stream_id = generate_req_id("stream")
+
+        # Send intermediate content
+        await client.reply_stream(frame, stream_id, "Thinking...", finish=False)
+
+        # Send final result
+        await client.reply_stream(frame, stream_id, f'You said: "{content}"', finish=True)
+
+    client.on("message.text", on_text)
+
+    # 3. Listen for enter_chat event (send welcome)
+    async def on_enter(frame):
+        await client.reply_welcome(frame, {
+            "msgtype": "text",
+            "text": {"content": "Hello! How can I help you?"},
+        })
+
+    client.on("event.enter_chat", on_enter)
+
+    # 4. Connect
+    await client.connect_async()
+
+    # Keep running
+    while client.is_connected:
+        await asyncio.sleep(1)
+
+asyncio.run(main())
+```
+
+## API Reference
+
+### WSClient
+
+Core client class providing connection management, message sending/receiving.
+
+```python
+client = WSClient({
+    "bot_id": "your-bot-id",
+    "secret": "your-bot-secret",
+    # Optional:
+    "reconnect_interval": 1000,     # Reconnect base delay (ms)
+    "max_reconnect_attempts": 10,   # Max reconnect attempts (-1 for infinite)
+    "heartbeat_interval": 30000,    # Heartbeat interval (ms)
+    "request_timeout": 10000,       # HTTP request timeout (ms)
+    "ws_url": "wss://...",          # Custom WebSocket URL
+    "logger": custom_logger,        # Custom logger instance
+})
+```
+
+#### Methods
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `connect_async()` | Establish WebSocket connection | `None` |
+| `disconnect()` | Disconnect | `None` |
+| `reply(frame, body, cmd?)` | Send reply message (generic) | `None` |
+| `reply_stream(frame, stream_id, content, finish?, msg_item?, feedback?)` | Send streaming reply | `None` |
+| `reply_welcome(frame, body)` | Send welcome reply (within 5s of event) | `None` |
+| `reply_template_card(frame, template_card, feedback?)` | Reply with template card | `None` |
+| `reply_stream_with_card(frame, stream_id, content, finish?, options?)` | Send stream + card combo | `None` |
+| `update_template_card(frame, template_card, userids?)` | Update template card (within 5s) | `None` |
+| `send_message(chatid, body)` | Proactively send message | `None` |
+| `download_file(url, aes_key)` | Download and decrypt file | `tuple[bytes, str?]` |
+
+#### Events
+
+| Event | Callback | Description |
+|-------|----------|-------------|
+| `connected` | `()` | WebSocket connected |
+| `authenticated` | `()` | Authentication successful |
+| `disconnected` | `(reason)` | Connection lost |
+| `reconnecting` | `(attempt)` | Reconnecting (attempt N) |
+| `error` | `(frame)` | Error occurred |
+| `message` | `(frame)` | Any message received |
+| `message.text` | `(frame)` | Text message |
+| `message.image` | `(frame)` | Image message |
+| `message.mixed` | `(frame)` | Mixed content message |
+| `message.voice` | `(frame)` | Voice message |
+| `message.file` | `(frame)` | File message |
+| `event` | `(frame)` | Any event |
+| `event.enter_chat` | `(frame)` | User entered chat |
+| `event.template_card_event` | `(frame)` | Card button clicked |
+| `event.feedback_event` | `(frame)` | User feedback |
+
+## Project Structure
+
+```
+wecom_aibot_sdk/
+├── __init__.py          # Package entry, exports
+├── client.py            # WSClient core client
+├── ws.py                # WebSocket connection manager
+├── message_handler.py   # Message parsing and event dispatch
+├── api.py               # HTTP API client (file download)
+├── crypto.py            # AES-256-CBC file decryption
+├── logger.py            # Default logger implementation
+├── utils.py             # Utility functions (generate_req_id, etc.)
+└── types/               # Type definitions
+    ├── __init__.py
+    ├── config.py        # Configuration types
+    ├── event.py         # Event types
+    ├── message.py       # Message types
+    ├── api.py           # API/WebSocket frame types
+    └── common.py        # Common types (Logger)
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+ruff format .
+```
+
+## License
+
+MIT

wecom_aibot_sdk_python-0.1.0/docs/README_zh.md

@@ -0,0 +1,162 @@
+# 企业微信智能机器人 Python SDK
+
+基于 WebSocket 长连接通道，提供消息收发、流式回复、模板卡片、事件回调、文件下载解密等核心能力。
+
+## 功能特性
+
+- **WebSocket 长连接** - 内置默认地址 `wss://openws.work.weixin.qq.com`，开箱即用
+- **自动认证** - 连接后自动发送认证帧（botId + secret）
+- **心跳保活** - 自动维护心跳，ACK 缺失时自动检测连接问题
+- **自动重连** - 指数退避重连策略（1s → 2s → 4s → ... → 最大 30s）
+- **消息分发** - 自动解析消息类型并触发相应事件（text/image/mixed/voice/file）
+- **流式回复** - 内置流式回复方法，支持 Markdown 和混合内容
+- **模板卡片** - 支持回复模板卡片消息、流式+卡片组合回复、卡片更新
+- **主动推送** - 主动向指定会话发送 Markdown 或模板卡片消息
+- **事件回调** - 支持 enter_chat、template_card_event、feedback_event
+- **串行回复队列** - 相同 req_id 的回复串行发送，自动等待回执
+- **文件下载解密** - 内置 AES-256-CBC 文件解密，每条图片/文件消息有独立 aeskey
+- **可插拔日志** - 支持自定义 Logger，内置带时间戳的 DefaultLogger
+
+## 安装
+
+```bash
+pip install wecom-aibot-sdk
+```
+
+## 快速开始
+
+```python
+import asyncio
+from wecom_aibot_sdk import WSClient, generate_req_id
+
+async def main():
+    # 1. 创建客户端实例
+    client = WSClient({
+        "bot_id": "your-bot-id",
+        "secret": "your-bot-secret",
+    })
+
+    # 2. 监听文本消息并以流式方式回复
+    async def on_text(frame):
+        content = frame.body.get("text", {}).get("content", "")
+        stream_id = generate_req_id("stream")
+
+        # 发送中间内容
+        await client.reply_stream(frame, stream_id, "正在思考...", finish=False)
+
+        # 发送最终结果
+        await client.reply_stream(frame, stream_id, f'你说："{content}"', finish=True)
+
+    client.on("message.text", on_text)
+
+    # 3. 监听进入会话事件（发送欢迎语）
+    async def on_enter(frame):
+        await client.reply_welcome(frame, {
+            "msgtype": "text",
+            "text": {"content": "你好！有什么可以帮助你的吗？"},
+        })
+
+    client.on("event.enter_chat", on_enter)
+
+    # 4. 建立连接
+    await client.connect_async()
+
+    # 保持运行
+    while client.is_connected:
+        await asyncio.sleep(1)
+
+asyncio.run(main())
+```
+
+## API 参考
+
+### WSClient
+
+核心客户端类，提供连接管理、消息收发。
+
+```python
+client = WSClient({
+    "bot_id": "your-bot-id",
+    "secret": "your-bot-secret",
+    # 可选配置：
+    "reconnect_interval": 1000,     # 重连基础延迟（毫秒）
+    "max_reconnect_attempts": 10,   # 最大重连次数（-1 为无限）
+    "heartbeat_interval": 30000,    # 心跳间隔（毫秒）
+    "request_timeout": 10000,       # HTTP 请求超时（毫秒）
+    "ws_url": "wss://...",          # 自定义 WebSocket URL
+    "logger": custom_logger,        # 自定义日志实例
+})
+```
+
+#### 方法
+
+| 方法 | 描述 | 返回值 |
+|------|------|--------|
+| `connect_async()` | 建立 WebSocket 连接 | `None` |
+| `disconnect()` | 断开连接 | `None` |
+| `reply(frame, body, cmd?)` | 发送回复消息（通用） | `None` |
+| `reply_stream(frame, stream_id, content, finish?, msg_item?, feedback?)` | 发送流式回复 | `None` |
+| `reply_welcome(frame, body)` | 发送欢迎回复（事件后 5 秒内） | `None` |
+| `reply_template_card(frame, template_card, feedback?)` | 回复模板卡片 | `None` |
+| `reply_stream_with_card(frame, stream_id, content, finish?, options?)` | 发送流式 + 卡片组合 | `None` |
+| `update_template_card(frame, template_card, userids?)` | 更新模板卡片（5 秒内） | `None` |
+| `send_message(chatid, body)` | 主动发送消息 | `None` |
+| `download_file(url, aes_key)` | 下载并解密文件 | `tuple[bytes, str?]` |
+
+#### 事件
+
+| 事件 | 回调 | 描述 |
+|------|------|------|
+| `connected` | `()` | WebSocket 已连接 |
+| `authenticated` | `()` | 认证成功 |
+| `disconnected` | `(reason)` | 连接断开 |
+| `reconnecting` | `(attempt)` | 正在重连（第 N 次） |
+| `error` | `(frame)` | 发生错误 |
+| `message` | `(frame)` | 收到任意消息 |
+| `message.text` | `(frame)` | 文本消息 |
+| `message.image` | `(frame)` | 图片消息 |
+| `message.mixed` | `(frame)` | 混合内容消息 |
+| `message.voice` | `(frame)` | 语音消息 |
+| `message.file` | `(frame)` | 文件消息 |
+| `event` | `(frame)` | 任意事件 |
+| `event.enter_chat` | `(frame)` | 用户进入会话 |
+| `event.template_card_event` | `(frame)` | 卡片按钮点击 |
+| `event.feedback_event` | `(frame)` | 用户反馈 |
+
+## 项目结构
+
+```
+wecom_aibot_sdk/
+├── __init__.py          # 包入口，导出
+├── client.py            # WSClient 核心客户端
+├── ws.py                # WebSocket 连接管理器
+├── message_handler.py   # 消息解析和事件分发
+├── api.py               # HTTP API 客户端（文件下载）
+├── crypto.py            # AES-256-CBC 文件解密
+├── logger.py            # 默认日志实现
+├── utils.py             # 工具函数（generate_req_id 等）
+└── types/               # 类型定义
+    ├── __init__.py
+    ├── config.py        # 配置类型
+    ├── event.py         # 事件类型
+    ├── message.py       # 消息类型
+    ├── api.py           # API/WebSocket 帧类型
+    └── common.py        # 通用类型（Logger）
+```
+
+## 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 格式化代码
+ruff format .
+```
+
+## 许可证
+
+MIT

wecom_aibot_sdk_python-0.1.0/examples/basic.py

@@ -0,0 +1,105 @@
+"""
+Basic usage example for WeCom AI Bot SDK
+"""
+
+import asyncio
+import signal
+
+from wecom_aibot_sdk import WSClient, generate_req_id
+
+
+async def main():
+    # 1. Create client instance
+    client = WSClient({
+        "bot_id": "your-bot-id",       # Get from WeCom admin console
+        "secret": "your-bot-secret",   # Get from WeCom admin console
+    })
+
+    # 2. Register event handlers
+
+    # Handle authentication success
+    async def on_authenticated(frame):
+        print("Authenticated successfully")
+
+    client.on("authenticated", on_authenticated)
+
+    # Handle text messages with streaming reply
+    async def on_text_message(frame):
+        content = frame.body.get("text", {}).get("content", "")
+        print(f"Received text: {content}")
+
+        stream_id = generate_req_id("stream")
+
+        # Send streaming intermediate content
+        await client.reply_stream(frame, stream_id, "Thinking...", finish=False)
+
+        # Send final result
+        await asyncio.sleep(1)
+        await client.reply_stream(
+            frame,
+            stream_id,
+            f'Hello! You said: "{content}"',
+            finish=True,
+        )
+
+    client.on("message.text", on_text_message)
+
+    # Handle enter chat event (send welcome message)
+    async def on_enter_chat(frame):
+        await client.reply_welcome(frame, {
+            "msgtype": "text",
+            "text": {"content": "Hello! I'm your AI assistant. How can I help you?"},
+        })
+
+    client.on("event.enter_chat", on_enter_chat)
+
+    # Handle image messages
+    async def on_image_message(frame):
+        body = frame.body
+        image = body.get("image", {})
+        url = image.get("url", "")
+        aeskey = image.get("aeskey", "")
+
+        if url and aeskey:
+            buffer, filename = await client.download_file(url, aeskey)
+            print(f"Downloaded image: {filename}, size: {len(buffer)} bytes")
+
+    client.on("message.image", on_image_message)
+
+    # Handle errors
+    async def on_error(frame):
+        print(f"Error: {frame.body}")
+
+    client.on("error", on_error)
+
+    # 3. Connect
+    print("Connecting...")
+    await client.connect_async()
+
+    # 4. Graceful shutdown
+    loop = asyncio.get_event_loop()
+
+    def signal_handler():
+        print("\nShutting down...")
+        asyncio.create_task(client.disconnect())
+
+    for sig in (signal.SIGINT, signal.SIGTERM):
+        try:
+            loop.add_signal_handler(sig, signal_handler)
+        except NotImplementedError:
+            # Windows doesn't support add_signal_handler
+            pass
+
+    # Keep running
+    print("Client running. Press Ctrl+C to exit.")
+    try:
+        while client.is_connected:
+            await asyncio.sleep(1)
+    except asyncio.CancelledError:
+        pass
+    finally:
+        await client.disconnect()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

wecom_aibot_sdk_python-0.1.0/main.py

@@ -0,0 +1,5 @@
+"""Entry point for development/testing"""
+
+from wecom_aibot_sdk import WSClient, generate_req_id, DefaultLogger
+
+__all__ = ["WSClient", "generate_req_id", "DefaultLogger"]