qing-client 0.0.0__tar.gz

qing_client-0.0.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: qing-client
+Version: 0.0.0
+Summary: Qing 平台统一 SDK - Python 客户端（与 npm 版 qing-client 对齐）
+Author-email: xiaoyue9527 <xiaoyue9527@example.com>
+License: MIT
+Keywords: qing,sdk,api-client
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.20.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+
+# qing-client (Python)
+
+Qing 平台统一 SDK 的 Python 版本，与 npm 包 `qing-client` 的 API 设计对齐。
+
+## 安装
+
+```bash
+pip install -e /path/to/client/pip
+# 或发布后
+pip install qing-client
+```
+
+## 使用
+
+### 网关模式（前端/统一网关）
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig
+
+config = ClientConfig(
+    gateway_url="https://your-gateway.example.com",
+    project_id="your-project-id",
+    # 可选: org_id, app_id
+)
+client = Client(config)
+
+# 登录后设置 token
+res = client.auth.login("user", "password")
+client.set_token(res.access_token)
+
+# 调用各服务
+user = client.user.get_current_user()
+messages = client.msg.get_messages()
+```
+
+### 后端模式（直连各服务）
+
+直连时各服务 URL 需包含该服务在后端的路径前缀，例如 token 服务为 `.../api/token`，这样 path `/wxh5/accesstoken` 才会请求到正确的完整路径。详见根目录 [client/README.md](../README.md) 的「SDK 与现有架构对齐说明」。
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig, UserContext
+
+config = ClientConfig(
+    auth_service_url="http://auth-svc",
+    msg_service_url="http://msg-svc",
+    user_service_url="http://user-svc",
+    token_service_url="http://token-svc/api/token",  # 含路径前缀
+    # ... 其他服务 URL
+)
+client = Client(config)
+
+# 设置用户上下文（模拟请求方）
+client.set_user_context(UserContext(
+    user_id="uid",
+    role="ADMIN",
+    project_id="pid",
+))
+
+# 调用服务
+messages = client.msg.get_messages()
+```
+
+### 服务列表（与 npm 一致）
+
+- `client.auth` - 认证
+- `client.msg` - 消息
+- `client.user` - 用户
+- `client.token` - Token 中控（公众号/小程序 access_token、jsapi_ticket、签名、小程序登录与获取手机号等）
+- `client.file` - 文件
+- `client.ai` - AI 对话
+- `client.aigc` - AIGC
+- `client.provider` - 提供商
+- `client.usage` - 用量
+- `client.audit` - 审计日志
+- `client.fronthost` - 前端托管
+- `client.org` - 组织
+- `client.delivery_stream` - 投递流
+- `client.ez_ability` - Ez 能力
+- `client.im` - IM
+- `client.hub` - 能力枢纽
+- `client.task` - 任务
+
+## 版本
+
+与 npm 包版本号对齐，见 `pyproject.toml` / setuptools-scm 或根目录 client 版本说明。

qing_client-0.0.0/README.md

@@ -0,0 +1,87 @@
+# qing-client (Python)
+
+Qing 平台统一 SDK 的 Python 版本，与 npm 包 `qing-client` 的 API 设计对齐。
+
+## 安装
+
+```bash
+pip install -e /path/to/client/pip
+# 或发布后
+pip install qing-client
+```
+
+## 使用
+
+### 网关模式（前端/统一网关）
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig
+
+config = ClientConfig(
+    gateway_url="https://your-gateway.example.com",
+    project_id="your-project-id",
+    # 可选: org_id, app_id
+)
+client = Client(config)
+
+# 登录后设置 token
+res = client.auth.login("user", "password")
+client.set_token(res.access_token)
+
+# 调用各服务
+user = client.user.get_current_user()
+messages = client.msg.get_messages()
+```
+
+### 后端模式（直连各服务）
+
+直连时各服务 URL 需包含该服务在后端的路径前缀，例如 token 服务为 `.../api/token`，这样 path `/wxh5/accesstoken` 才会请求到正确的完整路径。详见根目录 [client/README.md](../README.md) 的「SDK 与现有架构对齐说明」。
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig, UserContext
+
+config = ClientConfig(
+    auth_service_url="http://auth-svc",
+    msg_service_url="http://msg-svc",
+    user_service_url="http://user-svc",
+    token_service_url="http://token-svc/api/token",  # 含路径前缀
+    # ... 其他服务 URL
+)
+client = Client(config)
+
+# 设置用户上下文（模拟请求方）
+client.set_user_context(UserContext(
+    user_id="uid",
+    role="ADMIN",
+    project_id="pid",
+))
+
+# 调用服务
+messages = client.msg.get_messages()
+```
+
+### 服务列表（与 npm 一致）
+
+- `client.auth` - 认证
+- `client.msg` - 消息
+- `client.user` - 用户
+- `client.token` - Token 中控（公众号/小程序 access_token、jsapi_ticket、签名、小程序登录与获取手机号等）
+- `client.file` - 文件
+- `client.ai` - AI 对话
+- `client.aigc` - AIGC
+- `client.provider` - 提供商
+- `client.usage` - 用量
+- `client.audit` - 审计日志
+- `client.fronthost` - 前端托管
+- `client.org` - 组织
+- `client.delivery_stream` - 投递流
+- `client.ez_ability` - Ez 能力
+- `client.im` - IM
+- `client.hub` - 能力枢纽
+- `client.task` - 任务
+
+## 版本
+
+与 npm 包版本号对齐，见 `pyproject.toml` / setuptools-scm 或根目录 client 版本说明。

qing_client-0.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel", "setuptools-scm"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools_scm]
+version_file = "version.txt"
+write_to = "qingclient/_version.py"
+local_scheme = "no-local-version"
+fallback_version = "0.0.0"
+
+[tool.setuptools]
+packages = ["qingclient", "qingclient.types"]
+package-dir = {"" = "."}
+
+[project]
+name = "qing-client"
+dynamic = ["version"]
+description = "Qing 平台统一 SDK - Python 客户端（与 npm 版 qing-client 对齐）"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+    { name = "xiaoyue9527", email = "xiaoyue9527@example.com" },
+]
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+keywords = ["qing", "sdk", "api-client"]
+
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.20.0",
+    "twine>=4.0.0",
+    "build>=0.10.0",
+]

qing_client-0.0.0/qing_client.egg-info/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: qing-client
+Version: 0.0.0
+Summary: Qing 平台统一 SDK - Python 客户端（与 npm 版 qing-client 对齐）
+Author-email: xiaoyue9527 <xiaoyue9527@example.com>
+License: MIT
+Keywords: qing,sdk,api-client
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.20.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+
+# qing-client (Python)
+
+Qing 平台统一 SDK 的 Python 版本，与 npm 包 `qing-client` 的 API 设计对齐。
+
+## 安装
+
+```bash
+pip install -e /path/to/client/pip
+# 或发布后
+pip install qing-client
+```
+
+## 使用
+
+### 网关模式（前端/统一网关）
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig
+
+config = ClientConfig(
+    gateway_url="https://your-gateway.example.com",
+    project_id="your-project-id",
+    # 可选: org_id, app_id
+)
+client = Client(config)
+
+# 登录后设置 token
+res = client.auth.login("user", "password")
+client.set_token(res.access_token)
+
+# 调用各服务
+user = client.user.get_current_user()
+messages = client.msg.get_messages()
+```
+
+### 后端模式（直连各服务）
+
+直连时各服务 URL 需包含该服务在后端的路径前缀，例如 token 服务为 `.../api/token`，这样 path `/wxh5/accesstoken` 才会请求到正确的完整路径。详见根目录 [client/README.md](../README.md) 的「SDK 与现有架构对齐说明」。
+
+```python
+from qingclient import Client
+from qingclient.types import ClientConfig, UserContext
+
+config = ClientConfig(
+    auth_service_url="http://auth-svc",
+    msg_service_url="http://msg-svc",
+    user_service_url="http://user-svc",
+    token_service_url="http://token-svc/api/token",  # 含路径前缀
+    # ... 其他服务 URL
+)
+client = Client(config)
+
+# 设置用户上下文（模拟请求方）
+client.set_user_context(UserContext(
+    user_id="uid",
+    role="ADMIN",
+    project_id="pid",
+))
+
+# 调用服务
+messages = client.msg.get_messages()
+```
+
+### 服务列表（与 npm 一致）
+
+- `client.auth` - 认证
+- `client.msg` - 消息
+- `client.user` - 用户
+- `client.token` - Token 中控（公众号/小程序 access_token、jsapi_ticket、签名、小程序登录与获取手机号等）
+- `client.file` - 文件
+- `client.ai` - AI 对话
+- `client.aigc` - AIGC
+- `client.provider` - 提供商
+- `client.usage` - 用量
+- `client.audit` - 审计日志
+- `client.fronthost` - 前端托管
+- `client.org` - 组织
+- `client.delivery_stream` - 投递流
+- `client.ez_ability` - Ez 能力
+- `client.im` - IM
+- `client.hub` - 能力枢纽
+- `client.task` - 任务
+
+## 版本
+
+与 npm 包版本号对齐，见 `pyproject.toml` / setuptools-scm 或根目录 client 版本说明。

qing_client-0.0.0/qing_client.egg-info/SOURCES.txt

@@ -0,0 +1,64 @@
+README.md
+pyproject.toml
+setup.py
+./qingclient/__init__.py
+./qingclient/_version.py
+./qingclient/ai_service.py
+./qingclient/aigc_service.py
+./qingclient/audit_service.py
+./qingclient/auth_service.py
+./qingclient/base_client.py
+./qingclient/client.py
+./qingclient/delivery_stream_service.py
+./qingclient/ez_ability_service.py
+./qingclient/file_service.py
+./qingclient/fronthost_service.py
+./qingclient/hub_service.py
+./qingclient/im_service.py
+./qingclient/msg_service.py
+./qingclient/org_service.py
+./qingclient/provider_service.py
+./qingclient/task_service.py
+./qingclient/token_service.py
+./qingclient/usage_service.py
+./qingclient/user_service.py
+./qingclient/types/__init__.py
+./qingclient/types/auth.py
+./qingclient/types/base.py
+./qingclient/types/config.py
+./qingclient/types/msg.py
+./qingclient/types/token.py
+./qingclient/types/user.py
+qing_client.egg-info/PKG-INFO
+qing_client.egg-info/SOURCES.txt
+qing_client.egg-info/dependency_links.txt
+qing_client.egg-info/requires.txt
+qing_client.egg-info/top_level.txt
+qingclient/__init__.py
+qingclient/_version.py
+qingclient/ai_service.py
+qingclient/aigc_service.py
+qingclient/audit_service.py
+qingclient/auth_service.py
+qingclient/base_client.py
+qingclient/client.py
+qingclient/delivery_stream_service.py
+qingclient/ez_ability_service.py
+qingclient/file_service.py
+qingclient/fronthost_service.py
+qingclient/hub_service.py
+qingclient/im_service.py
+qingclient/msg_service.py
+qingclient/org_service.py
+qingclient/provider_service.py
+qingclient/task_service.py
+qingclient/token_service.py
+qingclient/usage_service.py
+qingclient/user_service.py
+qingclient/types/__init__.py
+qingclient/types/auth.py
+qingclient/types/base.py
+qingclient/types/config.py
+qingclient/types/msg.py
+qingclient/types/token.py
+qingclient/types/user.py

qing_client-0.0.0/qing_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

qing_client-0.0.0/qing_client.egg-info/requires.txt

@@ -0,0 +1,7 @@
+requests>=2.28.0
+
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.20.0
+twine>=4.0.0
+build>=0.10.0

qing_client-0.0.0/qing_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+qingclient

qing_client-0.0.0/qingclient/__init__.py

@@ -0,0 +1,49 @@
+"""
+Qing 平台统一 SDK - Python 客户端（与 npm 版 qing-client 对齐）。
+"""
+from ._version import __version__
+from .client import Client
+from .base_client import BaseClient
+from . import types
+
+from .auth_service import AuthService
+from .msg_service import MsgService
+from .user_service import UserService
+from .token_service import TokenService
+from .file_service import FileService
+from .ai_service import AiService
+from .aigc_service import AigcService
+from .provider_service import ProviderService
+from .usage_service import UsageService
+from .audit_service import AuditLogService
+from .fronthost_service import FrontHostService
+from .org_service import OrgService
+from .delivery_stream_service import DeliveryStreamService
+from .ez_ability_service import EzAbilityService
+from .im_service import ImService
+from .hub_service import HubService
+from .task_service import TaskService
+
+__all__ = [
+    "__version__",
+    "Client",
+    "BaseClient",
+    "AuthService",
+    "MsgService",
+    "UserService",
+    "TokenService",
+    "FileService",
+    "AiService",
+    "AigcService",
+    "ProviderService",
+    "UsageService",
+    "AuditLogService",
+    "FrontHostService",
+    "OrgService",
+    "DeliveryStreamService",
+    "EzAbilityService",
+    "ImService",
+    "HubService",
+    "TaskService",
+    "types",
+]

qing_client-0.0.0/qingclient/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.0.0'
+__version_tuple__ = version_tuple = (0, 0, 0)
+
+__commit_id__ = commit_id = None

qing_client-0.0.0/qingclient/ai_service.py

@@ -0,0 +1,91 @@
+"""AI 服务（与 npm AiService 对齐）。"""
+from typing import Any, Optional
+
+from .base_client import BaseClient
+from .types import ClientConfig, RequestOptions, TokenStorage
+
+
+class AiService(BaseClient):
+    service_path = "ai"
+
+    def __init__(
+        self,
+        config: ClientConfig,
+        token_storage: Optional[TokenStorage] = None,
+    ) -> None:
+        super().__init__(config, token_storage=token_storage)
+
+    @property
+    def service_name(self) -> str:
+        return "ai"
+
+    def chat_completion(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/chat", RequestOptions(method="POST", body=request))
+
+    def chat_completion_stream(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/chat/stream", RequestOptions(method="POST", body=request))
+
+    def create_session(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/session", RequestOptions(method="POST", body=request))
+
+    def get_sessions(
+        self,
+        params: Optional[dict] = None,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/session", RequestOptions(
+            method="GET",
+            params=params or {},
+        ))
+
+    def get_session(
+        self,
+        session_id: str,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request(f"/session/{session_id}", RequestOptions(method="GET"))
+
+    def update_session(
+        self,
+        session_id: str,
+        update_data: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request(f"/session/{session_id}", RequestOptions(
+            method="PUT",
+            body=update_data,
+        ))
+
+    def add_message(
+        self,
+        session_id: str,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request(f"/session/{session_id}/messages", RequestOptions(
+            method="POST",
+            body=request,
+        ))
+
+    def switch_model(
+        self,
+        session_id: str,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request(f"/session/{session_id}/switch-model", RequestOptions(
+            method="POST",
+            body=request,
+        ))

qing_client-0.0.0/qingclient/aigc_service.py

@@ -0,0 +1,41 @@
+"""AIGC 服务（与 npm AigcService 对齐）。"""
+from typing import Any, Optional
+
+from .base_client import BaseClient
+from .types import ClientConfig, RequestOptions, TokenStorage
+
+
+class AigcService(BaseClient):
+    service_path = "aigc"
+
+    def __init__(
+        self,
+        config: ClientConfig,
+        token_storage: Optional[TokenStorage] = None,
+    ) -> None:
+        super().__init__(config, token_storage=token_storage)
+
+    @property
+    def service_name(self) -> str:
+        return "aigc"
+
+    def text_generation(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/text/generate", RequestOptions(method="POST", body=request))
+
+    def image_generation(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/image/generate", RequestOptions(method="POST", body=request))
+
+    def get_task_status(
+        self,
+        task_id: str,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request(f"/task/{task_id}/status", RequestOptions(method="GET"))

qing_client-0.0.0/qingclient/audit_service.py

@@ -0,0 +1,37 @@
+"""审计日志服务（与 npm AuditLogService 对齐，servicePath: logs）。"""
+from typing import Any, Optional
+
+from .base_client import BaseClient
+from .types import ClientConfig, RequestOptions, TokenStorage, PaginatedResponse
+
+
+class AuditLogService(BaseClient):
+    service_path = "logs"
+
+    def __init__(
+        self,
+        config: ClientConfig,
+        token_storage: Optional[TokenStorage] = None,
+    ) -> None:
+        super().__init__(config, token_storage=token_storage)
+
+    @property
+    def service_name(self) -> str:
+        return "audit"
+
+    def list_logs(
+        self,
+        params: Optional[dict] = None,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("", RequestOptions(
+            method="GET",
+            params=params or {},
+        ))
+
+    def create_test_log(
+        self,
+        request: dict,
+        options: Optional[RequestOptions] = None,
+    ) -> Any:
+        return self.request("/test", RequestOptions(method="POST", body=request))