py-chanjet-toolkit 1.0.0__tar.gz

py_chanjet_toolkit-1.0.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_chanjet_toolkit-1.0.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: py-chanjet-toolkit
+Version: 1.0.0
+Summary: 畅捷通 T+ Python 客户端库，提供与畅捷通 T+ 智慧社区系统的 WebService 接口交互能力，支持同步和异步调用。
+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_chanjet_toolkit
+Project-URL: Repository, https://gitee.com/guolei19850528/py_chanjet_toolkit.git
+Project-URL: Issues, https://gitee.com/guolei19850528/py_chanjet_toolkit/issues
+Project-URL: Documentation, https://gitee.com/guolei19850528/py_chanjet_toolkit/wikis
+Keywords: chanjet,tplus,畅捷通,智慧社区,webservice,soap,api,client,async
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+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
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Framework :: AsyncIO
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: jsonpath-ng>=1.5.3
+Requires-Dist: jsonschema>=4.21.0
+Requires-Dist: xmltodict>=1.0.4
+Requires-Dist: arrow>=1.4.0
+Requires-Dist: py-httpx-toolkit>=1.0.1
+Dynamic: license-file
+
+# py-chajet-toolkit
+
+畅捷通 T+ 系列产品的 Python 客户端库，提供与畅捷通 T+ 系统的 API 交互能力。
+
+## 功能特性
+
+- 提供畅捷通 T+ 智慧社区 WebService 接口的同步和异步调用
+- 封装 SOAP 请求的构建和响应解析
+- 提供数据校验、日期处理、SQL 生成等辅助工具函数
+- 支持 JSONPath 查询和 JSON Schema 校验
+
+## 安装方式
+
+### 使用 pip 安装
+
+```bash
+pip install py-chajet-toolkit
+```
+
+### 使用 uv 安装
+
+```bash
+uv add py-chajet-toolkit
+```
+
+## 快速开始
+
+### 基础使用示例
+
+```python
+from py_chajet_toolkit.tplus.zkhb import ForcelandEstateService
+from py_chajet_toolkit.tplus.zkhb.utils import (
+    build_get_data_set_post_xml,
+    build_get_data_set_results,
+    build_actual_payment_items_query_sql
+)
+
+# 初始化服务客户端
+service = ForcelandEstateService(base_url="http://your-server/estate")
+
+# 构建 SOAP 请求体
+xml_data = build_get_data_set_post_xml({"sql": "SELECT * FROM EstateDetail"})
+
+# 同步调用接口
+response = service.get_data_set(content=xml_data)
+
+# 解析响应数据
+results = build_get_data_set_results(response)
+print(results)
+```
+
+### 异步调用示例
+
+```python
+import asyncio
+from py_chajet_toolkit.tplus.zkhb import ForcelandEstateService
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_post_xml, build_get_data_set_results
+
+async def main():
+    service = ForcelandEstateService(base_url="http://your-server/estate")
+    xml_data = build_get_data_set_post_xml({"sql": "SELECT * FROM ChargeMasterList"})
+    
+    # 异步调用接口
+    response = await service.async_get_data_set(content=xml_data)
+    results = build_get_data_set_results(response)
+    print(results)
+
+asyncio.run(main())
+```
+
+## API 说明
+
+### ForcelandEstateService
+
+畅捷通T+智慧社区服务客户端类，封装了与畅捷通T+智慧社区系统的WebService接口交互。
+
+#### 初始化
+
+```python
+service = ForcelandEstateService(
+    base_url="http://your-server/estate",
+    client_kwargs={"timeout": 120}
+)
+```
+
+#### 同步方法
+
+- `get_data_set(client=None, client_kwargs=None, **kwargs)` - 调用 GetDataSet 接口
+
+#### 异步方法
+
+- `async_get_data_set(client=None, client_kwargs=None, **kwargs)` - 异步调用 GetDataSet 接口
+
+## Utils 工具函数
+
+### json_find_first
+
+使用 JSONPath 表达式从嵌套的 JSON 数据中查找第一个匹配项。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import json_find_first
+
+data = {"users": [{"id": 1, "name": "Alice"}, {"id": 2, "name": "Bob"}]}
+result = json_find_first("$.users[0].name", data)
+# 返回: 'Alice'
+```
+
+### json_is_valid
+
+校验 JSON 数据是否符合指定的 JSON Schema 规范。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import json_is_valid
+
+schema = {
+    "type": "object",
+    "properties": {"id": {"type": "string"}},
+    "required": ["id"]
+}
+is_valid = json_is_valid(schema, {"id": "123"})
+# 返回: True
+```
+
+### build_get_data_set_post_xml
+
+将请求数据转换为 SOAP GetDataSet 接口所需的 XML 格式。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_post_xml
+
+xml = build_get_data_set_post_xml({"sql": "SELECT * FROM EstateDetail"})
+```
+
+### build_get_data_set_results
+
+从 GetDataSet 接口响应中提取实际数据列表。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_results
+
+results = build_get_data_set_results(response)
+```
+
+### build_actual_payment_items_query_sql
+
+生成查询实际支付项目的 SQL 语句。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_actual_payment_items_query_sql
+
+sql = build_actual_payment_items_query_sql(
+    conditions="and cml.EstateID='E001'",
+    order_by="order by cml.CreateTime desc"
+)
+```
+
+### payment_date_range_is_valid
+
+验证支付金额与日期范围是否匹配。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import payment_date_range_is_valid
+
+is_valid = payment_date_range_is_valid(
+    daily_fee=10,
+    total_amount=300,
+    start="2024-01-01",
+    end="2024-01-31"
+)
+# 返回: True
+```
+
+### filter_actual_payment_items
+
+过滤实际支付记录，移除配对的充值和退款记录。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import filter_actual_payment_items
+
+filtered_items = filter_actual_payment_items(actual_payment_items)
+```
+
+## 项目结构
+
+```
+py_chajet_toolkit/
+├── tplus/
+│   ├── zkhb/
+│   │   ├── __init__.py    # 智慧社区服务客户端类
+│   │   ├── utils.py       # 工具函数集合
+│   │   └── responses.py   # 响应处理模块
+│   └── __init__.py
+└── __init__.py
+```
+
+## 依赖
+
+- arrow - 日期时间处理
+- httpx - HTTP 客户端
+- jsonpath_ng - JSONPath 查询
+- jsonschema - JSON Schema 校验
+- xmltodict - XML 与字典转换
+- py_httpx_toolkit - HTTP 工具封装
+
+## 项目主页
+
+[https://gitee.com/guolei19850528/py_chanjet_toolkit](https://gitee.com/guolei19850528/py_chanjet_toolkit)
+
+## 作者
+
+**Author**: Lei Guo  
+**Email**: guolei@example.com
+
+## 许可证
+
+MIT License

py_chanjet_toolkit-1.0.0/README.md

@@ -0,0 +1,216 @@
+# py-chajet-toolkit
+
+畅捷通 T+ 系列产品的 Python 客户端库，提供与畅捷通 T+ 系统的 API 交互能力。
+
+## 功能特性
+
+- 提供畅捷通 T+ 智慧社区 WebService 接口的同步和异步调用
+- 封装 SOAP 请求的构建和响应解析
+- 提供数据校验、日期处理、SQL 生成等辅助工具函数
+- 支持 JSONPath 查询和 JSON Schema 校验
+
+## 安装方式
+
+### 使用 pip 安装
+
+```bash
+pip install py-chajet-toolkit
+```
+
+### 使用 uv 安装
+
+```bash
+uv add py-chajet-toolkit
+```
+
+## 快速开始
+
+### 基础使用示例
+
+```python
+from py_chajet_toolkit.tplus.zkhb import ForcelandEstateService
+from py_chajet_toolkit.tplus.zkhb.utils import (
+    build_get_data_set_post_xml,
+    build_get_data_set_results,
+    build_actual_payment_items_query_sql
+)
+
+# 初始化服务客户端
+service = ForcelandEstateService(base_url="http://your-server/estate")
+
+# 构建 SOAP 请求体
+xml_data = build_get_data_set_post_xml({"sql": "SELECT * FROM EstateDetail"})
+
+# 同步调用接口
+response = service.get_data_set(content=xml_data)
+
+# 解析响应数据
+results = build_get_data_set_results(response)
+print(results)
+```
+
+### 异步调用示例
+
+```python
+import asyncio
+from py_chajet_toolkit.tplus.zkhb import ForcelandEstateService
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_post_xml, build_get_data_set_results
+
+async def main():
+    service = ForcelandEstateService(base_url="http://your-server/estate")
+    xml_data = build_get_data_set_post_xml({"sql": "SELECT * FROM ChargeMasterList"})
+    
+    # 异步调用接口
+    response = await service.async_get_data_set(content=xml_data)
+    results = build_get_data_set_results(response)
+    print(results)
+
+asyncio.run(main())
+```
+
+## API 说明
+
+### ForcelandEstateService
+
+畅捷通T+智慧社区服务客户端类，封装了与畅捷通T+智慧社区系统的WebService接口交互。
+
+#### 初始化
+
+```python
+service = ForcelandEstateService(
+    base_url="http://your-server/estate",
+    client_kwargs={"timeout": 120}
+)
+```
+
+#### 同步方法
+
+- `get_data_set(client=None, client_kwargs=None, **kwargs)` - 调用 GetDataSet 接口
+
+#### 异步方法
+
+- `async_get_data_set(client=None, client_kwargs=None, **kwargs)` - 异步调用 GetDataSet 接口
+
+## Utils 工具函数
+
+### json_find_first
+
+使用 JSONPath 表达式从嵌套的 JSON 数据中查找第一个匹配项。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import json_find_first
+
+data = {"users": [{"id": 1, "name": "Alice"}, {"id": 2, "name": "Bob"}]}
+result = json_find_first("$.users[0].name", data)
+# 返回: 'Alice'
+```
+
+### json_is_valid
+
+校验 JSON 数据是否符合指定的 JSON Schema 规范。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import json_is_valid
+
+schema = {
+    "type": "object",
+    "properties": {"id": {"type": "string"}},
+    "required": ["id"]
+}
+is_valid = json_is_valid(schema, {"id": "123"})
+# 返回: True
+```
+
+### build_get_data_set_post_xml
+
+将请求数据转换为 SOAP GetDataSet 接口所需的 XML 格式。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_post_xml
+
+xml = build_get_data_set_post_xml({"sql": "SELECT * FROM EstateDetail"})
+```
+
+### build_get_data_set_results
+
+从 GetDataSet 接口响应中提取实际数据列表。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_get_data_set_results
+
+results = build_get_data_set_results(response)
+```
+
+### build_actual_payment_items_query_sql
+
+生成查询实际支付项目的 SQL 语句。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import build_actual_payment_items_query_sql
+
+sql = build_actual_payment_items_query_sql(
+    conditions="and cml.EstateID='E001'",
+    order_by="order by cml.CreateTime desc"
+)
+```
+
+### payment_date_range_is_valid
+
+验证支付金额与日期范围是否匹配。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import payment_date_range_is_valid
+
+is_valid = payment_date_range_is_valid(
+    daily_fee=10,
+    total_amount=300,
+    start="2024-01-01",
+    end="2024-01-31"
+)
+# 返回: True
+```
+
+### filter_actual_payment_items
+
+过滤实际支付记录，移除配对的充值和退款记录。
+
+```python
+from py_chajet_toolkit.tplus.zkhb.utils import filter_actual_payment_items
+
+filtered_items = filter_actual_payment_items(actual_payment_items)
+```
+
+## 项目结构
+
+```
+py_chajet_toolkit/
+├── tplus/
+│   ├── zkhb/
+│   │   ├── __init__.py    # 智慧社区服务客户端类
+│   │   ├── utils.py       # 工具函数集合
+│   │   └── responses.py   # 响应处理模块
+│   └── __init__.py
+└── __init__.py
+```
+
+## 依赖
+
+- arrow - 日期时间处理
+- httpx - HTTP 客户端
+- jsonpath_ng - JSONPath 查询
+- jsonschema - JSON Schema 校验
+- xmltodict - XML 与字典转换
+- py_httpx_toolkit - HTTP 工具封装
+
+## 项目主页
+
+[https://gitee.com/guolei19850528/py_chanjet_toolkit](https://gitee.com/guolei19850528/py_chanjet_toolkit)
+
+## 作者
+
+**Author**: Lei Guo  
+**Email**: guolei@example.com
+
+## 许可证
+
+MIT License

py_chanjet_toolkit-1.0.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "py-chanjet-toolkit"
+version = "1.0.0"
+requires-python = ">=3.10"
+authors = [
+    { name = "Guolei", email = "174000902@qq.com" }
+]
+description = "畅捷通 T+ Python 客户端库，提供与畅捷通 T+ 智慧社区系统的 WebService 接口交互能力，支持同步和异步调用。"
+keywords = ["chanjet", "tplus", "畅捷通", "智慧社区", "webservice", "soap", "api", "client", "async"]
+license = { file = "LICENSE" }
+readme = "README.md"
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Framework :: AsyncIO",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pydantic>=2.0",
+    "jsonpath-ng>=1.5.3",
+    "jsonschema>=4.21.0",
+    "xmltodict>=1.0.4",
+    "arrow>=1.4.0",
+    "py-httpx-toolkit>=1.0.1",
+]
+
+[project.urls]
+"Homepage" = "https://gitee.com/guolei19850528/py_chanjet_toolkit"
+"Repository" = "https://gitee.com/guolei19850528/py_chanjet_toolkit.git"
+"Issues" = "https://gitee.com/guolei19850528/py_chanjet_toolkit/issues"
+"Documentation" = "https://gitee.com/guolei19850528/py_chanjet_toolkit/wikis"
+
+[tool.setuptools.packages.find]
+where = ["src"]

py_chanjet_toolkit-1.0.0/setup.cfg

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

py_chanjet_toolkit-1.0.0/src/py_chajet_toolkit/__init__.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+"""
+py_chajet 包入口模块
+
+该包是畅捷通 T+ 系列产品的 Python 客户端库，提供与畅捷通 T+ 系统的 API 交互能力。
+
+包结构：
+- py_chajet/
+  - tplus/           # T+ 系列产品模块
+    - zkhb/         # 智慧社区业务模块
+      - __init__.py # 智慧社区服务客户端类
+      - utils.py    # 工具函数集合
+
+主要功能：
+- 提供畅捷通 T+ 智慧社区 WebService 接口的同步和异步调用
+- 封装 SOAP 请求的构建和响应解析
+- 提供数据校验、日期处理、SQL 生成等辅助工具函数
+
+使用示例：
+    from py_chajet.tplus.zkhb import ForcelandEstateService
+    
+    service = ForcelandEstateService(base_url="http://your-server/estate")
+    response = service.get_data_set()
+    data = convert_to_get_data_set_results(response)
+"""

py_chanjet_toolkit-1.0.0/src/py_chajet_toolkit/tplus/__init__.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+"""
+py_chajet.tplus 模块
+
+该模块包含畅捷通 T+ 系列产品的客户端实现，目前主要包含智慧社区（zkhb）业务模块。
+
+子模块：
+- zkhb: 智慧社区业务模块，提供与智慧社区系统的 WebService 接口交互能力
+
+未来扩展计划：
+- 添加更多 T+ 产品线的客户端支持
+- 提供统一的 API 调用接口
+- 增加数据模型和类型定义
+"""