py-lmobile 0.1.0__tar.gz

py_lmobile-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 郭磊
+
+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.

py_lmobile-0.1.0/PKG-INFO

@@ -0,0 +1,290 @@
+Metadata-Version: 2.4
+Name: py-lmobile
+Version: 0.1.0
+Summary: 一个用于与微网通联 API 交互的 Python 客户端库
+Author-email: Guolei <174000902@qq.com>
+License: MIT License
+        
+        Copyright (c) 2026 郭磊
+        
+        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.
+        
+Project-URL: Homepage, https://gitee.com/guolei19850528/py_lmobile
+Project-URL: Repository, https://gitee.com/guolei19850528/py_lmobile.git
+Keywords: lmobile,python,client,api,微网通联,短信
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: jsonpath-ng>=1.5.3
+Requires-Dist: jsonschema>=4.21.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: setuptools>=61.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# py-lmobile
+
+微网通联短信服务 Python SDK
+
+## 简介
+
+`py_lmobile` 是一个用于接入微网通联（51welink）短信服务的 Python SDK，提供同步和异步两种发送方式，支持请求签名认证。
+
+## 安装
+
+```bash
+pip install py_lmobile
+```
+
+## 快速开始
+
+### 同步发送短信
+
+```python
+from py_lmobile.sms import Sms
+
+# 初始化客户端
+sms = Sms(
+    base_url="https://api.51welink.com/",
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id"
+)
+
+# 发送短信
+response = sms.send(
+    phone_nos="13800138000",
+    content="您的验证码是：123456"
+)
+
+# 处理响应
+print(response.json())
+```
+
+### 异步发送短信
+
+```python
+import asyncio
+from py_lmobile.sms import Sms
+
+async def main():
+    # 初始化客户端
+    sms = Sms(
+        base_url="https://api.51welink.com/",
+        account_id="your_account_id",
+        password="your_password",
+        product_id="your_product_id"
+    )
+    
+    # 异步发送短信
+    response = await sms.async_send(
+        phone_nos=["13800138000", "13900139000"],
+        content="您的验证码是：123456"
+    )
+    
+    # 处理响应
+    print(response.json())
+
+asyncio.run(main())
+```
+
+## API 文档
+
+### Sms 类
+
+#### 初始化参数
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| base_url | str | 否 | `https://api.51welink.com/` | API服务器地址 |
+| account_id | str | 是 | - | 账号ID |
+| password | str | 是 | - | 密码 |
+| product_id | str/int | 是 | - | 产品ID |
+| smms_encrypt_key | str | 否 | `SMmsEncryptKey` | 加密密钥 |
+| client_kwargs | dict | 否 | - | 传递给httpx.Client的额外配置 |
+
+#### 方法
+
+##### `send()` - 同步发送短信
+
+```python
+def send(
+    client: Optional[httpx.Client] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.Client | 可选的HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.Client.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+##### `async_send()` - 异步发送短信
+
+```python
+async def async_send(
+    client: Optional[httpx.AsyncClient] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.AsyncClient | 可选的异步HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.AsyncClient.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+## 工具函数
+
+### `timestamp()`
+
+生成当前时间戳（毫秒）
+
+```python
+from py_lmobile.sms.utils import timestamp
+
+ts = timestamp()  # 返回示例: 1630000000000
+```
+
+### `random_digits(length: int = 10)`
+
+生成指定长度的随机数字
+
+```python
+from py_lmobile.sms.utils import random_digits
+
+digits = random_digits(10)  # 返回示例: 1234567890
+```
+
+### `sha256_signature()`
+
+生成SHA256签名，用于请求认证
+
+```python
+from py_lmobile.sms.utils import sha256_signature
+
+signature = sha256_signature(
+    account_id="your_account_id",
+    password="your_password",
+    phone_nos="13800138000",
+    random_digits="1234567890",
+    timestamp="1630000000000",
+    smms_encrypt_key="SMmsEncryptKey"
+)
+```
+
+### `convert_to_result_eq_succ()`
+
+将HTTP响应转换为标准化的响应模型
+
+```python
+from py_lmobile.sms.utils import convert_to_result_eq_succ
+
+response = sms.send(phone_nos="13800138000", content="test")
+result = convert_to_result_eq_succ(response)
+print(result.Result)  # "succ"
+```
+
+### `result_eq_succ_validator()`
+
+校验响应是否符合成功响应的JSON Schema
+
+```python
+from py_lmobile.sms.utils import result_eq_succ_validator
+
+response = sms.send(phone_nos="13800138000", content="test")
+is_valid = result_eq_succ_validator(response)  # True 或 False
+```
+
+## 响应模型
+
+### `RESULT_EQ_SUCC`
+
+成功响应模型，继承自Base模型
+
+```python
+from py_lmobile.sms.responses import RESULT_EQ_SUCC
+
+result = RESULT_EQ_SUCC(Result="succ")
+print(result.Result)  # "succ"
+```
+
+## 配置说明
+
+### httpx 客户端配置
+
+可以通过 `client_kwargs` 参数自定义 httpx 客户端配置：
+
+```python
+sms = Sms(
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id",
+    client_kwargs={
+        "timeout": 30,
+        "verify": True,
+        "proxies": "http://proxy:8080"
+    }
+)
+```
+
+## 注意事项
+
+1. 密码会在内部进行MD5加密后参与签名计算
+2. 签名算法使用SHA256，按照API要求的参数顺序拼接
+3. 多个手机号请使用逗号分隔或传入列表
+4. 建议复用HTTP客户端以提高性能
+
+## 许可证
+
+MIT License
+
+## 主页
+[https://gitee.com/guolei19850528/py_lmobile](https://gitee.com/guolei19850528/py_lmobile)
+
+## 作者
+Guolei<174000902@qq.com>

py_lmobile-0.1.0/README.md

@@ -0,0 +1,237 @@
+# py-lmobile
+
+微网通联短信服务 Python SDK
+
+## 简介
+
+`py_lmobile` 是一个用于接入微网通联（51welink）短信服务的 Python SDK，提供同步和异步两种发送方式，支持请求签名认证。
+
+## 安装
+
+```bash
+pip install py_lmobile
+```
+
+## 快速开始
+
+### 同步发送短信
+
+```python
+from py_lmobile.sms import Sms
+
+# 初始化客户端
+sms = Sms(
+    base_url="https://api.51welink.com/",
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id"
+)
+
+# 发送短信
+response = sms.send(
+    phone_nos="13800138000",
+    content="您的验证码是：123456"
+)
+
+# 处理响应
+print(response.json())
+```
+
+### 异步发送短信
+
+```python
+import asyncio
+from py_lmobile.sms import Sms
+
+async def main():
+    # 初始化客户端
+    sms = Sms(
+        base_url="https://api.51welink.com/",
+        account_id="your_account_id",
+        password="your_password",
+        product_id="your_product_id"
+    )
+    
+    # 异步发送短信
+    response = await sms.async_send(
+        phone_nos=["13800138000", "13900139000"],
+        content="您的验证码是：123456"
+    )
+    
+    # 处理响应
+    print(response.json())
+
+asyncio.run(main())
+```
+
+## API 文档
+
+### Sms 类
+
+#### 初始化参数
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| base_url | str | 否 | `https://api.51welink.com/` | API服务器地址 |
+| account_id | str | 是 | - | 账号ID |
+| password | str | 是 | - | 密码 |
+| product_id | str/int | 是 | - | 产品ID |
+| smms_encrypt_key | str | 否 | `SMmsEncryptKey` | 加密密钥 |
+| client_kwargs | dict | 否 | - | 传递给httpx.Client的额外配置 |
+
+#### 方法
+
+##### `send()` - 同步发送短信
+
+```python
+def send(
+    client: Optional[httpx.Client] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.Client | 可选的HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.Client.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+##### `async_send()` - 异步发送短信
+
+```python
+async def async_send(
+    client: Optional[httpx.AsyncClient] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.AsyncClient | 可选的异步HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.AsyncClient.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+## 工具函数
+
+### `timestamp()`
+
+生成当前时间戳（毫秒）
+
+```python
+from py_lmobile.sms.utils import timestamp
+
+ts = timestamp()  # 返回示例: 1630000000000
+```
+
+### `random_digits(length: int = 10)`
+
+生成指定长度的随机数字
+
+```python
+from py_lmobile.sms.utils import random_digits
+
+digits = random_digits(10)  # 返回示例: 1234567890
+```
+
+### `sha256_signature()`
+
+生成SHA256签名，用于请求认证
+
+```python
+from py_lmobile.sms.utils import sha256_signature
+
+signature = sha256_signature(
+    account_id="your_account_id",
+    password="your_password",
+    phone_nos="13800138000",
+    random_digits="1234567890",
+    timestamp="1630000000000",
+    smms_encrypt_key="SMmsEncryptKey"
+)
+```
+
+### `convert_to_result_eq_succ()`
+
+将HTTP响应转换为标准化的响应模型
+
+```python
+from py_lmobile.sms.utils import convert_to_result_eq_succ
+
+response = sms.send(phone_nos="13800138000", content="test")
+result = convert_to_result_eq_succ(response)
+print(result.Result)  # "succ"
+```
+
+### `result_eq_succ_validator()`
+
+校验响应是否符合成功响应的JSON Schema
+
+```python
+from py_lmobile.sms.utils import result_eq_succ_validator
+
+response = sms.send(phone_nos="13800138000", content="test")
+is_valid = result_eq_succ_validator(response)  # True 或 False
+```
+
+## 响应模型
+
+### `RESULT_EQ_SUCC`
+
+成功响应模型，继承自Base模型
+
+```python
+from py_lmobile.sms.responses import RESULT_EQ_SUCC
+
+result = RESULT_EQ_SUCC(Result="succ")
+print(result.Result)  # "succ"
+```
+
+## 配置说明
+
+### httpx 客户端配置
+
+可以通过 `client_kwargs` 参数自定义 httpx 客户端配置：
+
+```python
+sms = Sms(
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id",
+    client_kwargs={
+        "timeout": 30,
+        "verify": True,
+        "proxies": "http://proxy:8080"
+    }
+)
+```
+
+## 注意事项
+
+1. 密码会在内部进行MD5加密后参与签名计算
+2. 签名算法使用SHA256，按照API要求的参数顺序拼接
+3. 多个手机号请使用逗号分隔或传入列表
+4. 建议复用HTTP客户端以提高性能
+
+## 许可证
+
+MIT License
+
+## 主页
+[https://gitee.com/guolei19850528/py_lmobile](https://gitee.com/guolei19850528/py_lmobile)
+
+## 作者
+Guolei<174000902@qq.com>

py_lmobile-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "py-lmobile"
+version = "0.1.0"
+requires-python = ">=3.10"
+authors = [
+    { name = "Guolei", email = "174000902@qq.com" }
+]
+description = "一个用于与微网通联 API 交互的 Python 客户端库"
+keywords = ["lmobile", "python", "client", "api", "微网通联","短信"]
+license = { file = "LICENSE" }
+readme = "README.md"
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "pydantic>=2.0",
+    "jsonpath-ng>=1.5.3",
+    "jsonschema>=4.21.0",
+]
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "setuptools>=61.0",
+    "twine>=4.0",
+]
+
+[project.urls]
+"Homepage" = "https://gitee.com/guolei19850528/py_lmobile"
+"Repository" = "https://gitee.com/guolei19850528/py_lmobile.git"
+
+[tool.setuptools.packages.find]
+where = ["src"]

py_lmobile-0.1.0/setup.cfg

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

py_lmobile-0.1.0/src/py_lmobile/__init__.py

@@ -0,0 +1,2 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-

py_lmobile-0.1.0/src/py_lmobile/sms/__init__.py

@@ -0,0 +1,177 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+from typing import Optional, Union
+
+import httpx
+from pydantic import HttpUrl
+
+from .utils import timestamp, random_digits, sha256_signature
+
+
+class Sms:
+    def __init__(
+            self,
+            base_url: Optional[HttpUrl] = "https://api.51welink.com/",
+            account_id: Optional[str] = None,
+            password: Optional[str] = None,
+            product_id: Optional[Union[str, int]] = None,
+            smms_encrypt_key: Optional[str] = "SMmsEncryptKey",
+            client_kwargs: Optional[dict] = None
+    ):
+        """
+        初始化短信客户端
+        Args:
+            base_url: API 服务器地址，如 "https://api.51welink.com/"
+            account_id:
+            password:
+            product_id:
+            smms_encrypt_key:
+            client_kwargs: 传递给 httpx.Client 的额外配置参数
+        """
+        self.base_url = base_url or ""
+        self.base_url = self.base_url[:-1] if self.base_url.endswith("/") else self.base_url
+        self.account_id = account_id or ""
+        self.password = password or ""
+        self.product_id = product_id or ""
+        self.smms_encrypt_key = smms_encrypt_key or ""
+        self.client_kwargs = client_kwargs or {}
+        self.client_kwargs = {
+            **{
+                "base_url": self.base_url,
+                "verify": False,
+                "timeout": 60,
+            },
+            **self.client_kwargs,
+        }
+
+    def client(self) -> httpx.Client:
+        """
+        创建并返回同步HTTP客户端
+
+        Returns:
+            httpx.Client: 配置好的同步HTTP客户端实例
+        """
+        return httpx.Client(**self.client_kwargs)
+
+    def async_client(self) -> httpx.AsyncClient:
+        """
+        创建并返回异步HTTP客户端
+
+        Returns:
+            httpx.AsyncClient: 配置好的异步HTTP客户端实例
+        """
+        return httpx.AsyncClient(**self.client_kwargs)
+
+    def send(
+            self,
+            client: Optional[httpx.Client] = None,
+            phone_nos: Optional[Union[str, list, tuple]] = None,
+            content: Optional[str] = None,
+            **kwargs
+    ) -> httpx.Response:
+        """
+        同步发送短信
+        
+        Args:
+            client: 可选的HTTP客户端实例，若不传则自动创建
+            phone_nos: 接收短信的手机号码，支持单个字符串或列表/元组
+            content: 短信内容
+            **kwargs: 传递给 httpx.Client.request 的额外参数
+            
+        Returns:
+            httpx.Response: HTTP响应对象
+            
+        Raises:
+            Exception: 发送过程中可能抛出的异常
+        """
+        if isinstance(phone_nos, (list, tuple)):
+            phone_nos = ",".join(phone_nos)
+        ts = timestamp()
+        digits = random_digits()
+        kwargs = kwargs or {}
+        kwargs = {
+            **{
+                "method": "POST",
+                "url": "/EncryptionSubmit/SendSms.ashx",
+                "data": {
+                    "AccountID": self.account_id,
+                    "ProductID": self.product_id,
+                    "PhoneNos": phone_nos,
+                    "Timestamp": ts,
+                    "Random": digits,
+                    "Content": content,
+                    "AccessKey": sha256_signature(
+                        account_id=self.account_id,
+                        password=self.password,
+                        phone_nos=phone_nos,
+                        random_digits=digits,
+                        timestamp=ts,
+                        smms_encrypt_key=self.smms_encrypt_key,
+                    )
+                },
+            },
+            **kwargs
+        }
+        if isinstance(client, httpx.Client):
+            response = client.request(**kwargs)
+        else:
+            with self.client() as _client:
+                response = _client.request(**kwargs)
+        return response
+
+    async def async_send(
+            self,
+            client: Optional[httpx.AsyncClient] = None,
+            phone_nos: Optional[Union[str, list, tuple]] = None,
+            content: Optional[str] = None,
+            **kwargs
+    ) -> httpx.Response:
+        """
+        异步发送短信
+        
+        Args:
+            client: 可选的异步HTTP客户端实例，若不传则自动创建
+            phone_nos: 接收短信的手机号码，支持单个字符串或列表/元组
+            content: 短信内容
+            **kwargs: 传递给 httpx.AsyncClient.request 的额外参数
+            
+        Returns:
+            httpx.Response: HTTP响应对象
+            
+        Raises:
+            Exception: 发送过程中可能抛出的异常
+        """
+        if isinstance(phone_nos, (list, tuple)):
+            phone_nos = ",".join(phone_nos)
+        ts = timestamp()
+        digits = random_digits()
+        kwargs = kwargs or {}
+        kwargs = {
+            **{
+                "method": "POST",
+                "url": "/EncryptionSubmit/SendSms.ashx",
+                "data": {
+                    "AccountID": self.account_id,
+                    "ProductID": self.product_id,
+                    "PhoneNos": phone_nos,
+                    "Timestamp": ts,
+                    "Random": digits,
+                    "Content": content,
+                    "AccessKey": sha256_signature(
+                        account_id=self.account_id,
+                        password=self.password,
+                        phone_nos=phone_nos,
+                        random_digits=digits,
+                        timestamp=ts,
+                        smms_encrypt_key=self.smms_encrypt_key,
+                    )
+                },
+            },
+            **kwargs
+        }
+        if isinstance(client, httpx.AsyncClient):
+            response = await client.request(**kwargs)
+        else:
+            async with self.async_client() as _client:
+                response = await _client.request(**kwargs)
+        return response

py_lmobile-0.1.0/src/py_lmobile/sms/responses.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+from pydantic import BaseModel
+from pydantic import Field
+from typing import Literal, Union, Any, Optional
+
+
+class Base(BaseModel):
+    """
+    lmobile响应基类
+    
+    所有API响应都包含错误码和错误信息字段
+    """
+    Result: str = Field(..., title="错误码", description="错误码，succ表示成功，其他表示失败")
+
+    model_config = {
+        "extra": "allow"  # 允许额外动态字段
+    }
+
+
+class RESULT_EQ_SUCC(Base):
+    """
+    成功响应模型
+    
+    继承自Base，用于成功接口的响应
+    """
+    Result: Literal["succ"] = Field(..., title="错误码", description="成功，值为succ")

py_lmobile-0.1.0/src/py_lmobile/sms/utils.py

@@ -0,0 +1,151 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+import hashlib
+import random
+import string
+from datetime import datetime
+from typing import Any, Optional, Union
+
+import httpx
+from jsonpath_ng import parse
+from jsonschema.validators import Draft202012Validator
+
+from .responses import RESULT_EQ_SUCC
+
+
+def json_find_first(expression: str, data: Any) -> Any:
+    """
+    使用 JSONPath 表达式从数据中查找第一个匹配项
+
+    Args:
+        expression: JSONPath 表达式，用于指定要查找的数据路径
+        data: 待查询的 JSON 数据
+
+    Returns:
+        Any: 第一个匹配的值，如果没有匹配项则返回 None
+    """
+    results = [i.value for i in parse(expression).find(data)]
+    if isinstance(results, list) and len(results) > 0:
+        return results[0]
+    return None
+
+
+def json_is_valid(schema: Optional[dict], data: Any) -> bool:
+    """
+    校验 JSON 数据是否符合指定的 JSON Schema
+
+    Args:
+        schema: JSON Schema 字典
+        data: 待校验的 JSON 数据
+
+    Returns:
+        bool: 校验是否成功
+    """
+    return Draft202012Validator(schema).is_valid(data)
+
+
+def timestamp() -> int:
+    """
+    生成当前时间戳（毫秒）
+
+    返回:
+        int: 当前时间戳（毫秒），用于请求的时效性验证
+
+    示例:
+        >>> ts = utils.timestamp()
+        >>> print(ts)  # 输出示例: 1630000000000
+    """
+    return int((datetime.now().timestamp() * 1000))
+
+
+def random_digits(length: int = 10) -> int:
+    return int("".join(random.sample(string.digits, length)))
+
+
+def sha256_signature(
+        account_id: str = "",
+        password: str = "",
+        phone_nos: str = "",
+        random_digits: Optional[Union[int, str]] = "",
+        timestamp: Optional[Union[int, str]] = "",
+        smms_encrypt_key: str = ""
+) -> str:
+    """
+    生成SHA256签名
+
+    按照微网通联API要求的格式生成签名，用于短信发送请求的认证
+
+    Args:
+        account_id: 账号ID
+        password: 密码
+        phone_nos: 手机号，多个手机号用逗号分隔
+        random_digits: 随机数字
+        timestamp: 时间戳
+        smms_encrypt_key: 加密密钥
+
+    Returns:
+        str: SHA256签名结果
+    """
+    # 构建签名字符串 - 按照API要求的顺序和格式拼接参数
+    # 1. 先对密码进行MD5加密，使用加密密钥作为盐值
+    password_md5 = hashlib.md5(f"{password}{smms_encrypt_key}".encode('utf-8')).hexdigest()
+
+    # 2. 按照API要求的格式拼接参数
+    temp_string = "&".join([
+        f"AccountId={account_id}",
+        f"PhoneNos={phone_nos.split(',')[0]}",  # 只取第一个手机号用于签名
+        f"Password={password_md5.upper()}",  # 密码使用MD5加密后转大写
+        f"Random={random_digits}",
+        f"Timestamp={timestamp}",
+    ])
+
+    # 3. 对拼接后的字符串进行SHA256加密
+    return hashlib.sha256(temp_string.encode("utf-8")).hexdigest()
+
+
+
+def convert_to_result_eq_succ(response: Union[httpx.Response, dict]) -> RESULT_EQ_SUCC:
+    """
+    将 HTTP 响应或字典转换为 RESULT_EQ_SUCC 模型对象
+
+    统一处理 httpx.Response 对象和字典，将其转换为标准化的 RESULT_EQ_SUCC 响应模型。
+
+    参数:
+        response (Union[httpx.Response, dict]): HTTP 响应对象或字典数据
+
+    返回:
+        RESULT_EQ_SUCC: 标准化的响应模型对象，包含 Result 字段
+
+    处理逻辑:
+        - 如果输入是 httpx.Response 对象，先调用 json() 方法解析响应体
+        - 如果输入是字典，直接传入 RESULT_EQ_SUCC 构造函数
+    """
+    if isinstance(response, httpx.Response):
+        return RESULT_EQ_SUCC(**response.json())
+    return RESULT_EQ_SUCC(**response)
+
+
+def result_eq_succ_validator(
+        response: Union[httpx.Response, dict] = None,
+        schema: dict = {
+            "type": "object",
+            "properties": {
+                "Result": {
+                    "oneOf": [
+                        {"type": "string", "const": "succ"}
+                    ]
+                },
+            },
+            "required": ["Result"]
+        }
+):
+    """
+    校验 HTTP 响应或字典是否符合指定的 JSON Schema
+
+    :param response: HTTP 响应对象或字典数据
+    :param schema: JSON Schema 字典
+    :return: 校验是否成功
+    """
+    if isinstance(response, httpx.Response):
+        return json_is_valid(schema, response.json())
+    return json_is_valid(schema, response)

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

@@ -0,0 +1,290 @@
+Metadata-Version: 2.4
+Name: py-lmobile
+Version: 0.1.0
+Summary: 一个用于与微网通联 API 交互的 Python 客户端库
+Author-email: Guolei <174000902@qq.com>
+License: MIT License
+        
+        Copyright (c) 2026 郭磊
+        
+        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.
+        
+Project-URL: Homepage, https://gitee.com/guolei19850528/py_lmobile
+Project-URL: Repository, https://gitee.com/guolei19850528/py_lmobile.git
+Keywords: lmobile,python,client,api,微网通联,短信
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: jsonpath-ng>=1.5.3
+Requires-Dist: jsonschema>=4.21.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: setuptools>=61.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# py-lmobile
+
+微网通联短信服务 Python SDK
+
+## 简介
+
+`py_lmobile` 是一个用于接入微网通联（51welink）短信服务的 Python SDK，提供同步和异步两种发送方式，支持请求签名认证。
+
+## 安装
+
+```bash
+pip install py_lmobile
+```
+
+## 快速开始
+
+### 同步发送短信
+
+```python
+from py_lmobile.sms import Sms
+
+# 初始化客户端
+sms = Sms(
+    base_url="https://api.51welink.com/",
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id"
+)
+
+# 发送短信
+response = sms.send(
+    phone_nos="13800138000",
+    content="您的验证码是：123456"
+)
+
+# 处理响应
+print(response.json())
+```
+
+### 异步发送短信
+
+```python
+import asyncio
+from py_lmobile.sms import Sms
+
+async def main():
+    # 初始化客户端
+    sms = Sms(
+        base_url="https://api.51welink.com/",
+        account_id="your_account_id",
+        password="your_password",
+        product_id="your_product_id"
+    )
+    
+    # 异步发送短信
+    response = await sms.async_send(
+        phone_nos=["13800138000", "13900139000"],
+        content="您的验证码是：123456"
+    )
+    
+    # 处理响应
+    print(response.json())
+
+asyncio.run(main())
+```
+
+## API 文档
+
+### Sms 类
+
+#### 初始化参数
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| base_url | str | 否 | `https://api.51welink.com/` | API服务器地址 |
+| account_id | str | 是 | - | 账号ID |
+| password | str | 是 | - | 密码 |
+| product_id | str/int | 是 | - | 产品ID |
+| smms_encrypt_key | str | 否 | `SMmsEncryptKey` | 加密密钥 |
+| client_kwargs | dict | 否 | - | 传递给httpx.Client的额外配置 |
+
+#### 方法
+
+##### `send()` - 同步发送短信
+
+```python
+def send(
+    client: Optional[httpx.Client] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.Client | 可选的HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.Client.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+##### `async_send()` - 异步发送短信
+
+```python
+async def async_send(
+    client: Optional[httpx.AsyncClient] = None,
+    phone_nos: Optional[Union[str, list, tuple]] = None,
+    content: Optional[str] = None,
+    **kwargs
+) -> httpx.Response
+```
+
+**参数**:
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| client | httpx.AsyncClient | 可选的异步HTTP客户端实例 |
+| phone_nos | str/list/tuple | 接收短信的手机号码 |
+| content | str | 短信内容 |
+| **kwargs | - | 传递给httpx.AsyncClient.request的额外参数 |
+
+**返回**: `httpx.Response` - HTTP响应对象
+
+## 工具函数
+
+### `timestamp()`
+
+生成当前时间戳（毫秒）
+
+```python
+from py_lmobile.sms.utils import timestamp
+
+ts = timestamp()  # 返回示例: 1630000000000
+```
+
+### `random_digits(length: int = 10)`
+
+生成指定长度的随机数字
+
+```python
+from py_lmobile.sms.utils import random_digits
+
+digits = random_digits(10)  # 返回示例: 1234567890
+```
+
+### `sha256_signature()`
+
+生成SHA256签名，用于请求认证
+
+```python
+from py_lmobile.sms.utils import sha256_signature
+
+signature = sha256_signature(
+    account_id="your_account_id",
+    password="your_password",
+    phone_nos="13800138000",
+    random_digits="1234567890",
+    timestamp="1630000000000",
+    smms_encrypt_key="SMmsEncryptKey"
+)
+```
+
+### `convert_to_result_eq_succ()`
+
+将HTTP响应转换为标准化的响应模型
+
+```python
+from py_lmobile.sms.utils import convert_to_result_eq_succ
+
+response = sms.send(phone_nos="13800138000", content="test")
+result = convert_to_result_eq_succ(response)
+print(result.Result)  # "succ"
+```
+
+### `result_eq_succ_validator()`
+
+校验响应是否符合成功响应的JSON Schema
+
+```python
+from py_lmobile.sms.utils import result_eq_succ_validator
+
+response = sms.send(phone_nos="13800138000", content="test")
+is_valid = result_eq_succ_validator(response)  # True 或 False
+```
+
+## 响应模型
+
+### `RESULT_EQ_SUCC`
+
+成功响应模型，继承自Base模型
+
+```python
+from py_lmobile.sms.responses import RESULT_EQ_SUCC
+
+result = RESULT_EQ_SUCC(Result="succ")
+print(result.Result)  # "succ"
+```
+
+## 配置说明
+
+### httpx 客户端配置
+
+可以通过 `client_kwargs` 参数自定义 httpx 客户端配置：
+
+```python
+sms = Sms(
+    account_id="your_account_id",
+    password="your_password",
+    product_id="your_product_id",
+    client_kwargs={
+        "timeout": 30,
+        "verify": True,
+        "proxies": "http://proxy:8080"
+    }
+)
+```
+
+## 注意事项
+
+1. 密码会在内部进行MD5加密后参与签名计算
+2. 签名算法使用SHA256，按照API要求的参数顺序拼接
+3. 多个手机号请使用逗号分隔或传入列表
+4. 建议复用HTTP客户端以提高性能
+
+## 许可证
+
+MIT License
+
+## 主页
+[https://gitee.com/guolei19850528/py_lmobile](https://gitee.com/guolei19850528/py_lmobile)
+
+## 作者
+Guolei<174000902@qq.com>

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

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/py_lmobile/__init__.py
+src/py_lmobile.egg-info/PKG-INFO
+src/py_lmobile.egg-info/SOURCES.txt
+src/py_lmobile.egg-info/dependency_links.txt
+src/py_lmobile.egg-info/requires.txt
+src/py_lmobile.egg-info/top_level.txt
+src/py_lmobile/sms/__init__.py
+src/py_lmobile/sms/responses.py
+src/py_lmobile/sms/utils.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,10 @@
+httpx>=0.27.0
+pydantic>=2.0
+jsonpath-ng>=1.5.3
+jsonschema>=4.21.0
+
+[dev]
+pytest>=7.0
+pytest-cov>=4.0
+setuptools>=61.0
+twine>=4.0

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

@@ -0,0 +1 @@
+py_lmobile