wechatpay-python 0.0.1__py3-none-any.whl

wechat_py/__init__.py

@@ -0,0 +1,6 @@
+"""Foundation for WeChat API integrations."""
+
+from .client import WeChatClient
+from .exceptions import WeChatAPIError, WeChatError, WeChatTransportError
+
+__all__ = ["WeChatClient", "WeChatError", "WeChatAPIError", "WeChatTransportError"]

wechat_py/client.py

@@ -0,0 +1,58 @@
+"""A small synchronous HTTP client for WeChat APIs."""
+
+from typing import Any, Dict, Optional
+
+import httpx
+
+from .exceptions import WeChatAPIError, WeChatTransportError
+
+
+class WeChatClient:
+    """Send requests to WeChat APIs.
+
+    An injected HTTP client remains owned by its caller. Otherwise this instance
+    owns and closes its HTTP client.
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: str = "https://api.weixin.qq.com/",
+        timeout: float = 10.0,
+        http_client: Optional[httpx.Client] = None,
+    ) -> None:
+        self._owns_client = http_client is None
+        self._client = (
+            http_client
+            if http_client is not None
+            else httpx.Client(base_url=base_url, timeout=timeout)
+        )
+
+    def request(self, method: str, path: str, **kwargs: Any) -> Dict[str, Any]:
+        """Request a JSON object and raise an exception for HTTP or API errors."""
+        try:
+            response = self._client.request(method, path, **kwargs)
+            response.raise_for_status()
+            data = response.json()
+        except (httpx.HTTPError, ValueError) as exc:
+            raise WeChatTransportError(
+                "WeChat request failed or returned invalid JSON"
+            ) from exc
+
+        if not isinstance(data, dict):
+            raise WeChatTransportError("WeChat response must be a JSON object")
+        code = data.get("errcode", 0)
+        if code != 0:
+            raise WeChatAPIError(code, str(data.get("errmsg", "")))
+        return data
+
+    def close(self) -> None:
+        """Close the HTTP client if it was created by this instance."""
+        if self._owns_client:
+            self._client.close()
+
+    def __enter__(self) -> "WeChatClient":
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()

wechat_py/exceptions.py

@@ -0,0 +1,18 @@
+"""Exceptions raised by the SDK."""
+
+
+class WeChatError(Exception):
+    """Base class for SDK errors."""
+
+
+class WeChatTransportError(WeChatError):
+    """The HTTP request failed or the response was not a JSON object."""
+
+
+class WeChatAPIError(WeChatError):
+    """WeChat returned a nonzero error code."""
+
+    def __init__(self, code: int, message: str) -> None:
+        self.code = code
+        self.message = message
+        super().__init__(f"WeChat API error {code}: {message}")

wechatpay_python-0.0.1.dist-info/METADATA

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: wechatpay-python
+Version: 0.0.1
+Summary: A Python SDK foundation for WeChat APIs
+Project-URL: Homepage, https://github.com/tiyee/wechat-py
+Project-URL: Repository, https://github.com/tiyee/wechat-py
+Project-URL: Issues, https://github.com/tiyee/wechat-py/issues
+Author: TiyeeJiang
+License: MIT License
+        
+        Copyright (c) 2026 TiyeeJiang
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: api,sdk,wechat,weixin
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Description-Content-Type: text/markdown
+
+# wechat-py
+
+微信 API 的 Python SDK 基础框架，使用 uv 管理依赖，支持 Python 3.9 及以上版本。
+
+## 安装
+
+发布到 PyPI 后，可以使用以下命令安装：
+
+```bash
+uv add wechatpay-python
+# 或 pip install wechatpay-python
+```
+
+## 开发
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check .
+uv build
+```
+
+## 使用
+
+```python
+from wechat_py import WeChatAPIError, WeChatClient
+
+try:
+    with WeChatClient() as client:
+        result = client.request(
+            "GET", "/some/api", params={"access_token": "YOUR_ACCESS_TOKEN"}
+        )
+        print(result)
+except WeChatAPIError as exc:
+    print(exc.code, exc.message)
+```
+
+示例中的路径是占位符，使用时请替换为实际接口。当前框架提供同步 JSON 请求、HTTP 和微信 API 错误处理；业务接口、access token 获取和刷新尚未实现。调用方负责凭证管理，避免将密钥提交到仓库。网络或 HTTP 错误以及非 JSON 对象响应会抛出 `WeChatTransportError`。
+
+可通过 `http_client` 注入已配置的 `httpx.Client`；注入的客户端由调用方负责关闭。默认客户端可通过 `base_url` 和 `timeout` 配置，并由 `WeChatClient` 关闭。
+
+## 发布到 PyPI
+
+构建并发布当前版本：
+
+```bash
+uv build
+uv publish dist/wechatpay_python-0.0.1.tar.gz dist/wechatpay_python-0.0.1-py3-none-any.whl
+```
+
+发布前需具备 PyPI 项目发布权限，并按 uv 提示提供 PyPI API token。请勿将 token 写入项目文件或提交到仓库。

wechatpay_python-0.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+wechat_py/__init__.py,sha256=k_7jtn1r5xPZKDxGXVJOab9F0_9Uvl866pP93AY4fYA,239
+wechat_py/client.py,sha256=BuoT2CgH3gy9Qxk_KU2X_Gv1G-QR3CxzpO-MKSf9qaU,1829
+wechat_py/exceptions.py,sha256=d-kH6llERjIq9Ts-VRJPs4b3VI0hwDs6H3k4Cmsihtc,484
+wechatpay_python-0.0.1.dist-info/METADATA,sha256=aoHpM2hdXkKnNxyJDyXNEuj5G4vc2vo4Iih6M3dHq4M,3472
+wechatpay_python-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+wechatpay_python-0.0.1.dist-info/licenses/LICENSE,sha256=ZrKzYat2vy2EQzTVpYheUM-WOPSyYJ20P6RFOGgaltI,1067
+wechatpay_python-0.0.1.dist-info/RECORD,,

wechatpay_python-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

wechatpay_python-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TiyeeJiang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.