pixelarraylib 1.1.2__tar.gz → 1.1.4__tar.gz

pixelarraylib-1.1.4/PKG-INFO

@@ -0,0 +1,349 @@
+Metadata-Version: 2.4
+Name: pixelarraylib
+Version: 1.1.4
+Summary: PixelArray Python开发工具库 - 包含阿里云服务、数据库工具、装饰器、监控等功能
+Author-email: Lu qi <qi.lu@pixelarrayai.com>
+License-Expression: MIT
+Project-URL: Homepage, https://gitlab.com/pixelarrayai/general_pythondevutils_lib
+Project-URL: Bug Reports, https://gitlab.com/pixelarrayai/general_pythondevutils_lib/-/issues
+Project-URL: Source, https://gitlab.com/pixelarrayai/general_pythondevutils_lib
+Keywords: python,utils,aliyun,database,tools,pixelarray
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: alibabacloud_tea_util
+Requires-Dist: alibabacloud_cms20190101
+Requires-Dist: alibabacloud_green20220302
+Requires-Dist: alibabacloud_dm20151123
+Requires-Dist: alibabacloud_fc20230330
+Requires-Dist: alibabacloud_darabonba_stream
+Requires-Dist: alibabacloud_dysmsapi20170525
+Requires-Dist: alibabacloud_sts20150401
+Requires-Dist: alibabacloud_alidns20150109
+Requires-Dist: alibabacloud_eci20180808
+Requires-Dist: alibabacloud_bssopenapi20171214
+Requires-Dist: alibabacloud_cr20181201
+Requires-Dist: alibabacloud_vpc20160428
+Requires-Dist: alibabacloud_tea_openapi
+Requires-Dist: alibabacloud_credentials
+Requires-Dist: oss2
+Requires-Dist: pymysql
+Requires-Dist: aiomysql
+Requires-Dist: redis
+Requires-Dist: cryptography
+Requires-Dist: paramiko
+Requires-Dist: requests
+Requires-Dist: aiohttp
+Requires-Dist: aiofiles
+Requires-Dist: pandas
+Provides-Extra: monitor
+Requires-Dist: requests; extra == "monitor"
+Provides-Extra: system
+Requires-Dist: cryptography; extra == "system"
+Requires-Dist: paramiko; extra == "system"
+Requires-Dist: requests; extra == "system"
+Provides-Extra: mysql
+Requires-Dist: pymysql; extra == "mysql"
+Requires-Dist: aiomysql; extra == "mysql"
+Requires-Dist: requests; extra == "mysql"
+Provides-Extra: redis
+Requires-Dist: redis; extra == "redis"
+Requires-Dist: requests; extra == "redis"
+Provides-Extra: net
+Requires-Dist: requests; extra == "net"
+Requires-Dist: aiohttp; extra == "net"
+Provides-Extra: gitlab
+Requires-Dist: requests; extra == "gitlab"
+Requires-Dist: aiohttp; extra == "gitlab"
+Requires-Dist: pandas; extra == "gitlab"
+Provides-Extra: aliyun-oss
+Requires-Dist: oss2; extra == "aliyun-oss"
+Requires-Dist: aiohttp; extra == "aliyun-oss"
+Requires-Dist: aiofiles; extra == "aliyun-oss"
+Requires-Dist: requests; extra == "aliyun-oss"
+Requires-Dist: cryptography; extra == "aliyun-oss"
+Requires-Dist: paramiko; extra == "aliyun-oss"
+Provides-Extra: aliyun-sts
+Requires-Dist: alibabacloud_sts20150401; extra == "aliyun-sts"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-sts"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-sts"
+Requires-Dist: oss2; extra == "aliyun-sts"
+Requires-Dist: requests; extra == "aliyun-sts"
+Requires-Dist: redis; extra == "aliyun-sts"
+Provides-Extra: aliyun-sms
+Requires-Dist: alibabacloud_dysmsapi20170525; extra == "aliyun-sms"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-sms"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-sms"
+Requires-Dist: requests; extra == "aliyun-sms"
+Provides-Extra: aliyun-email
+Requires-Dist: alibabacloud_dm20151123; extra == "aliyun-email"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-email"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-email"
+Requires-Dist: requests; extra == "aliyun-email"
+Provides-Extra: aliyun-content-scanner
+Requires-Dist: alibabacloud_green20220302; extra == "aliyun-content-scanner"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-content-scanner"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-content-scanner"
+Requires-Dist: requests; extra == "aliyun-content-scanner"
+Provides-Extra: aliyun-domain
+Requires-Dist: alibabacloud_alidns20150109; extra == "aliyun-domain"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-domain"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-domain"
+Provides-Extra: aliyun-acr
+Requires-Dist: alibabacloud_cr20181201; extra == "aliyun-acr"
+Requires-Dist: alibabacloud_credentials; extra == "aliyun-acr"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-acr"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-acr"
+Requires-Dist: requests; extra == "aliyun-acr"
+Provides-Extra: aliyun-billing
+Requires-Dist: alibabacloud_bssopenapi20171214; extra == "aliyun-billing"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-billing"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-billing"
+Requires-Dist: pandas; extra == "aliyun-billing"
+Requires-Dist: requests; extra == "aliyun-billing"
+Provides-Extra: aliyun-ecs
+Requires-Dist: alibabacloud_cms20190101; extra == "aliyun-ecs"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-ecs"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-ecs"
+Provides-Extra: aliyun-eip
+Requires-Dist: alibabacloud_vpc20160428; extra == "aliyun-eip"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-eip"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-eip"
+Requires-Dist: requests; extra == "aliyun-eip"
+Provides-Extra: aliyun-eci
+Requires-Dist: alibabacloud_eci20180808; extra == "aliyun-eci"
+Requires-Dist: alibabacloud_vpc20160428; extra == "aliyun-eci"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-eci"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-eci"
+Requires-Dist: requests; extra == "aliyun-eci"
+Provides-Extra: aliyun-fc
+Requires-Dist: alibabacloud_fc20230330; extra == "aliyun-fc"
+Requires-Dist: alibabacloud_darabonba_stream; extra == "aliyun-fc"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun-fc"
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun-fc"
+Requires-Dist: requests; extra == "aliyun-fc"
+Requires-Dist: cryptography; extra == "aliyun-fc"
+Requires-Dist: paramiko; extra == "aliyun-fc"
+Provides-Extra: aliyun
+Requires-Dist: alibabacloud_tea_util; extra == "aliyun"
+Requires-Dist: alibabacloud_cms20190101; extra == "aliyun"
+Requires-Dist: alibabacloud_green20220302; extra == "aliyun"
+Requires-Dist: alibabacloud_dm20151123; extra == "aliyun"
+Requires-Dist: alibabacloud_fc20230330; extra == "aliyun"
+Requires-Dist: alibabacloud_darabonba_stream; extra == "aliyun"
+Requires-Dist: alibabacloud_dysmsapi20170525; extra == "aliyun"
+Requires-Dist: alibabacloud_sts20150401; extra == "aliyun"
+Requires-Dist: alibabacloud_alidns20150109; extra == "aliyun"
+Requires-Dist: alibabacloud_eci20180808; extra == "aliyun"
+Requires-Dist: alibabacloud_bssopenapi20171214; extra == "aliyun"
+Requires-Dist: alibabacloud_cr20181201; extra == "aliyun"
+Requires-Dist: alibabacloud_vpc20160428; extra == "aliyun"
+Requires-Dist: alibabacloud_tea_openapi; extra == "aliyun"
+Requires-Dist: alibabacloud_credentials; extra == "aliyun"
+Requires-Dist: oss2; extra == "aliyun"
+Requires-Dist: aiohttp; extra == "aliyun"
+Requires-Dist: aiofiles; extra == "aliyun"
+Requires-Dist: requests; extra == "aliyun"
+Requires-Dist: cryptography; extra == "aliyun"
+Requires-Dist: paramiko; extra == "aliyun"
+Requires-Dist: redis; extra == "aliyun"
+Requires-Dist: pandas; extra == "aliyun"
+Dynamic: license-file
+
+# PixelArrayLib - PixelArray Python开发工具库
+
+PixelArrayLib是一个功能丰富的Python开发工具库，包含阿里云服务、数据库工具、装饰器、监控等功能，同时提供便捷的命令行工具。
+
+## 安装
+
+### 基础安装
+
+```bash
+pip install pixelarraylib
+```
+
+**注意**: 基础安装会默认安装所有依赖。如果你只需要特定模块的功能，可以使用下面的可选依赖安装方式。
+
+### 可选依赖安装
+
+如果你只需要使用特定模块的功能，可以按需安装特定模块的依赖（这样可以减少安装的依赖包数量）：
+
+#### 基础模块依赖
+
+```bash
+# 只安装MySQL工具相关依赖
+pip install pixelarraylib[mysql]
+
+# 只安装Redis工具相关依赖
+pip install pixelarraylib[redis]
+
+# 只安装监控工具相关依赖
+pip install pixelarraylib[monitor]
+
+# 只安装网络工具相关依赖
+pip install pixelarraylib[net]
+
+# 只安装系统工具相关依赖
+pip install pixelarraylib[system]
+
+# 只安装GitLab工具相关依赖
+pip install pixelarraylib[gitlab]
+
+# 组合安装多个模块
+pip install pixelarraylib[mysql,redis]
+```
+
+#### 阿里云服务依赖（细分）
+
+```bash
+# 只安装OSS对象存储相关依赖
+pip install pixelarraylib[aliyun-oss]
+
+# 只安装STS安全令牌服务相关依赖
+pip install pixelarraylib[aliyun-sts]
+
+# 只安装SMS短信服务相关依赖
+pip install pixelarraylib[aliyun-sms]
+
+# 只安装邮件服务相关依赖
+pip install pixelarraylib[aliyun-email]
+
+# 只安装内容安全扫描相关依赖
+pip install pixelarraylib[aliyun-content-scanner]
+
+# 只安装域名服务相关依赖
+pip install pixelarraylib[aliyun-domain]
+
+# 只安装容器镜像服务相关依赖
+pip install pixelarraylib[aliyun-acr]
+
+# 只安装账单服务相关依赖
+pip install pixelarraylib[aliyun-billing]
+
+# 只安装ECS弹性计算相关依赖
+pip install pixelarraylib[aliyun-ecs]
+
+# 只安装EIP弹性公网IP相关依赖
+pip install pixelarraylib[aliyun-eip]
+
+# 只安装ECI容器实例相关依赖
+pip install pixelarraylib[aliyun-eci]
+
+# 只安装FC函数计算相关依赖
+pip install pixelarraylib[aliyun-fc]
+
+# 安装所有阿里云服务相关依赖
+pip install pixelarraylib[aliyun]
+
+# 组合安装多个阿里云服务
+pip install pixelarraylib[aliyun-oss,aliyun-sms]
+```
+
+#### 完整安装
+
+```bash
+# 安装所有可选依赖
+pip install pixelarraylib[all]
+```
+
+**可选依赖说明：**
+
+**基础模块：**
+- `mysql`: MySQL数据库工具（pymysql、aiomysql）及相关依赖
+- `redis`: Redis数据库工具及相关依赖
+- `monitor`: 监控告警工具（飞书通知等）及相关依赖
+- `net`: 网络请求工具（requests、aiohttp）及相关依赖
+- `system`: 系统工具（加密、SSH等）及相关依赖
+- `gitlab`: GitLab工具（PyPI包管理、代码分析等）及相关依赖
+
+**阿里云服务（细分）：**
+- `aliyun-oss`: OSS对象存储服务
+- `aliyun-sts`: STS安全令牌服务（需要redis依赖）
+- `aliyun-sms`: SMS短信服务
+- `aliyun-email`: 邮件服务（DM）
+- `aliyun-content-scanner`: 内容安全扫描服务（Green）
+- `aliyun-domain`: 域名服务（DNS）
+- `aliyun-acr`: 容器镜像服务
+- `aliyun-billing`: 账单服务
+- `aliyun-ecs`: ECS弹性计算服务
+- `aliyun-eip`: EIP弹性公网IP服务
+- `aliyun-eci`: ECI容器实例服务（需要eip依赖）
+- `aliyun-fc`: FC函数计算服务（需要system依赖）
+- `aliyun`: 所有阿里云服务依赖（完整版）
+
+**完整安装：**
+- `all`: 所有可选依赖
+
+## 使用方法
+
+### 1. Python程序中使用
+
+```python
+# 导入pixelarraylib模块
+import pixelarraylib
+
+# 使用各种功能模块
+from pixelarraylib.aliyun import some_service
+from pixelarraylib.db_utils import database_tools
+from pixelarraylib.decorators import useful_decorators
+```
+
+### 2. 命令行工具使用
+
+安装后，你可以在命令行中直接使用 `pixelarraylib` 命令：
+
+#### 创建测试用例文件
+```bash
+# 一键创建所有测试用例文件
+pixelarraylib create_test_case_files
+```
+
+## 功能特性
+
+- **阿里云服务集成**: 包含CMS、Green、DM、FC、SMS、STS等服务
+- **数据库工具**: MySQL、Redis等数据库操作工具
+- **Web框架**: FastAPI集成
+- **实用工具**: 二维码生成、加密解密、XML处理等
+- **命令行工具**: 测试用例生成、代码统计等实用脚本
+
+## 开发
+
+### 本地开发安装
+
+```bash
+# 克隆仓库
+git clone https://gitlab.com/pixelarrayai/general_pythondevutils_lib.git
+cd general_pythondevutils_lib
+
+# 安装开发依赖
+pip install -e .
+
+# 测试命令行工具
+pixelarraylib --help
+```
+
+### 添加新的命令行工具
+
+1. 在 `pixelarraylib/scripts/` 目录下创建新的脚本文件
+2. 在 `pixelarraylib/__main__.py` 中添加新的命令选项
+3. 更新 `pixelarraylib/scripts/__init__.py` 导出新功能
+
+## 许可证
+
+MIT License
+
+## 作者
+
+Lu qi (qi.lu@pixelarrayai.com) 

pixelarraylib-1.1.4/README.md

@@ -0,0 +1,185 @@
+# PixelArrayLib - PixelArray Python开发工具库
+
+PixelArrayLib是一个功能丰富的Python开发工具库，包含阿里云服务、数据库工具、装饰器、监控等功能，同时提供便捷的命令行工具。
+
+## 安装
+
+### 基础安装
+
+```bash
+pip install pixelarraylib
+```
+
+**注意**: 基础安装会默认安装所有依赖。如果你只需要特定模块的功能，可以使用下面的可选依赖安装方式。
+
+### 可选依赖安装
+
+如果你只需要使用特定模块的功能，可以按需安装特定模块的依赖（这样可以减少安装的依赖包数量）：
+
+#### 基础模块依赖
+
+```bash
+# 只安装MySQL工具相关依赖
+pip install pixelarraylib[mysql]
+
+# 只安装Redis工具相关依赖
+pip install pixelarraylib[redis]
+
+# 只安装监控工具相关依赖
+pip install pixelarraylib[monitor]
+
+# 只安装网络工具相关依赖
+pip install pixelarraylib[net]
+
+# 只安装系统工具相关依赖
+pip install pixelarraylib[system]
+
+# 只安装GitLab工具相关依赖
+pip install pixelarraylib[gitlab]
+
+# 组合安装多个模块
+pip install pixelarraylib[mysql,redis]
+```
+
+#### 阿里云服务依赖（细分）
+
+```bash
+# 只安装OSS对象存储相关依赖
+pip install pixelarraylib[aliyun-oss]
+
+# 只安装STS安全令牌服务相关依赖
+pip install pixelarraylib[aliyun-sts]
+
+# 只安装SMS短信服务相关依赖
+pip install pixelarraylib[aliyun-sms]
+
+# 只安装邮件服务相关依赖
+pip install pixelarraylib[aliyun-email]
+
+# 只安装内容安全扫描相关依赖
+pip install pixelarraylib[aliyun-content-scanner]
+
+# 只安装域名服务相关依赖
+pip install pixelarraylib[aliyun-domain]
+
+# 只安装容器镜像服务相关依赖
+pip install pixelarraylib[aliyun-acr]
+
+# 只安装账单服务相关依赖
+pip install pixelarraylib[aliyun-billing]
+
+# 只安装ECS弹性计算相关依赖
+pip install pixelarraylib[aliyun-ecs]
+
+# 只安装EIP弹性公网IP相关依赖
+pip install pixelarraylib[aliyun-eip]
+
+# 只安装ECI容器实例相关依赖
+pip install pixelarraylib[aliyun-eci]
+
+# 只安装FC函数计算相关依赖
+pip install pixelarraylib[aliyun-fc]
+
+# 安装所有阿里云服务相关依赖
+pip install pixelarraylib[aliyun]
+
+# 组合安装多个阿里云服务
+pip install pixelarraylib[aliyun-oss,aliyun-sms]
+```
+
+#### 完整安装
+
+```bash
+# 安装所有可选依赖
+pip install pixelarraylib[all]
+```
+
+**可选依赖说明：**
+
+**基础模块：**
+- `mysql`: MySQL数据库工具（pymysql、aiomysql）及相关依赖
+- `redis`: Redis数据库工具及相关依赖
+- `monitor`: 监控告警工具（飞书通知等）及相关依赖
+- `net`: 网络请求工具（requests、aiohttp）及相关依赖
+- `system`: 系统工具（加密、SSH等）及相关依赖
+- `gitlab`: GitLab工具（PyPI包管理、代码分析等）及相关依赖
+
+**阿里云服务（细分）：**
+- `aliyun-oss`: OSS对象存储服务
+- `aliyun-sts`: STS安全令牌服务（需要redis依赖）
+- `aliyun-sms`: SMS短信服务
+- `aliyun-email`: 邮件服务（DM）
+- `aliyun-content-scanner`: 内容安全扫描服务（Green）
+- `aliyun-domain`: 域名服务（DNS）
+- `aliyun-acr`: 容器镜像服务
+- `aliyun-billing`: 账单服务
+- `aliyun-ecs`: ECS弹性计算服务
+- `aliyun-eip`: EIP弹性公网IP服务
+- `aliyun-eci`: ECI容器实例服务（需要eip依赖）
+- `aliyun-fc`: FC函数计算服务（需要system依赖）
+- `aliyun`: 所有阿里云服务依赖（完整版）
+
+**完整安装：**
+- `all`: 所有可选依赖
+
+## 使用方法
+
+### 1. Python程序中使用
+
+```python
+# 导入pixelarraylib模块
+import pixelarraylib
+
+# 使用各种功能模块
+from pixelarraylib.aliyun import some_service
+from pixelarraylib.db_utils import database_tools
+from pixelarraylib.decorators import useful_decorators
+```
+
+### 2. 命令行工具使用
+
+安装后，你可以在命令行中直接使用 `pixelarraylib` 命令：
+
+#### 创建测试用例文件
+```bash
+# 一键创建所有测试用例文件
+pixelarraylib create_test_case_files
+```
+
+## 功能特性
+
+- **阿里云服务集成**: 包含CMS、Green、DM、FC、SMS、STS等服务
+- **数据库工具**: MySQL、Redis等数据库操作工具
+- **Web框架**: FastAPI集成
+- **实用工具**: 二维码生成、加密解密、XML处理等
+- **命令行工具**: 测试用例生成、代码统计等实用脚本
+
+## 开发
+
+### 本地开发安装
+
+```bash
+# 克隆仓库
+git clone https://gitlab.com/pixelarrayai/general_pythondevutils_lib.git
+cd general_pythondevutils_lib
+
+# 安装开发依赖
+pip install -e .
+
+# 测试命令行工具
+pixelarraylib --help
+```
+
+### 添加新的命令行工具
+
+1. 在 `pixelarraylib/scripts/` 目录下创建新的脚本文件
+2. 在 `pixelarraylib/__main__.py` 中添加新的命令选项
+3. 更新 `pixelarraylib/scripts/__init__.py` 导出新功能
+
+## 许可证
+
+MIT License
+
+## 作者
+
+Lu qi (qi.lu@pixelarrayai.com) 

{pixelarraylib-1.1.2 → pixelarraylib-1.1.4}/pixelarraylib/__init__.py

@@ -20,7 +20,7 @@ PixelArray Python开发工具库
     from pixelarraylib.gitlab import pypi_package_manager
 """
 
-__version__ = "1.1.2"
+__version__ = "1.1.4"
 __author__ = "PixelArray"
 __email__ = "qi.lu@pixelarrayai.com"
 

{pixelarraylib-1.1.2 → pixelarraylib-1.1.4}/pixelarraylib/__main__.py

@@ -1,12 +1,13 @@
 #!/usr/bin/env python3
 """
-ArrayLib 命令行工具入口点
+PixelArrayLib 命令行工具入口点
 支持的命令：
 - pixelarraylib create_test_case_files
 - pixelarraylib collect_code_to_txt [options]
 - pixelarraylib nginx_proxy_to_ecs [options]
 - pixelarraylib remove_empty_lines <input_file> [output_file]
 - pixelarraylib build_website
+- pixelarraylib tson_convert [options]
 """
 
 import sys
@@ -17,7 +18,7 @@ def main():
     # 检查是否有子命令
     if len(sys.argv) < 2:
         parser = argparse.ArgumentParser(
-            description="ArrayLib 命令行工具",
+            description="PixelArrayLib 命令行工具",
             formatter_class=argparse.RawDescriptionHelpFormatter,
             epilog="""
 示例用法:
@@ -26,6 +27,7 @@ def main():
   pixelarraylib nginx_proxy_to_ecs --help                        # 查看Nginx反向代理到ECS工具帮助
   pixelarraylib remove_empty_lines --help                        # 查看去除空行工具帮助
   pixelarraylib build_website --help                              # 查看一键构建网站工具帮助
+  pixelarraylib tson_convert --help                               # 查看TSON转换工具帮助
             """,
         )
         parser.print_help()
@@ -50,7 +52,7 @@ def main():
         try:
             from pixelarraylib.scripts.collect_code_to_txt import main as collect_main
 
-            # 修改sys.argv，移除第一个参数（arraylib），让collect_code_to_txt正确处理参数
+            # 修改sys.argv，移除第一个参数（pixelarraylib），让collect_code_to_txt正确处理参数
             original_argv = sys.argv
             sys.argv = [original_argv[0]] + original_argv[2:]
             collect_main()
@@ -66,7 +68,7 @@ def main():
                 main as nginx_proxy_to_ecs,
             )
 
-            # 修改sys.argv，移除第一个参数（arraylib），让nginx_proxy_to_ecs正确处理参数
+            # 修改sys.argv，移除第一个参数（pixelarraylib），让nginx_proxy_to_ecs正确处理参数
             original_argv = sys.argv
             sys.argv = [original_argv[0]] + original_argv[2:]
             nginx_proxy_to_ecs()
@@ -82,7 +84,7 @@ def main():
                 main as remove_empty_lines_main,
             )
 
-            # 修改sys.argv，移除第一个参数（arraylib），让remove_empty_lines正确处理参数
+            # 修改sys.argv，移除第一个参数（pixelarraylib），让remove_empty_lines正确处理参数
             original_argv = sys.argv
             sys.argv = [original_argv[0]] + original_argv[2:]
             remove_empty_lines_main()
@@ -103,9 +105,21 @@ def main():
             print(f"错误：无法导入 build_website 模块: {e}")
             sys.exit(1)
 
+    elif command == "tson_convert":
+        # 导入并执行TSON转换功能
+        try:
+            from pixelarraylib.scripts.tson_convert import main as tson_convert_main
+            original_argv = sys.argv
+            sys.argv = [original_argv[0]] + original_argv[2:]
+            tson_convert_main()
+            sys.argv = original_argv
+        except ImportError as e:
+            print(f"错误：无法导入 tson_convert 模块: {e}")
+            sys.exit(1)
+
     elif command in ["-h", "--help"]:
         parser = argparse.ArgumentParser(
-            description="ArrayLib 命令行工具",
+            description="PixelArrayLib 命令行工具",
             formatter_class=argparse.RawDescriptionHelpFormatter,
             epilog="""
 示例用法:
@@ -114,13 +128,14 @@ def main():
   pixelarraylib nginx_proxy_to_ecs --help                        # 查看Nginx反向代理到ECS工具帮助
   pixelarraylib remove_empty_lines --help                        # 查看去除空行工具帮助
   pixelarraylib build_website --help                              # 查看一键构建网站工具帮助
+  pixelarraylib tson_convert --help                               # 查看TSON转换工具帮助
             """,
         )
         parser.print_help()
     else:
         print(f"错误：未知命令 '{command}'")
         print(
-            "可用命令：create_test_case_files, collect_code_to_txt, nginx_proxy_to_ecs, remove_empty_lines, build_website"
+            "可用命令：create_test_case_files, collect_code_to_txt, nginx_proxy_to_ecs, remove_empty_lines, build_website, tson_convert"
         )
         print("使用 'pixelarraylib --help' 查看帮助")
         sys.exit(1)

{pixelarraylib-1.1.2 → pixelarraylib-1.1.4}/pixelarraylib/decorators/decorators.py

@@ -18,6 +18,17 @@ def catch_exception(
     addtional_alert: str = "",
     alert_channel: str = "devtoolkit服务报警",
 ):
+    """
+    description:
+        异常捕获装饰器，当函数执行失败时发送飞书告警
+    parameters:
+        exception_return(Any): 异常时返回的默认值
+        alert_params(bool): 是否在告警中包含函数参数
+        addtional_alert(str): 额外的告警信息
+        alert_channel(str): 飞书告警频道名称
+    return:
+        decorator(Callable): 装饰器函数
+    """
     feishu_alert = Feishu(alert_channel)
     def get_caller_function_name():
         """
@@ -65,6 +76,15 @@ def with_retry(
     retry_times: int = 3,
     retry_interval: int = 1,
 ) -> Callable:
+    """
+    description:
+        重试装饰器，当函数执行失败时自动重试
+    parameters:
+        retry_times(int): 重试次数，默认为3
+        retry_interval(int): 重试间隔时间（秒），默认为1
+    return:
+        decorator(Callable): 装饰器函数
+    """
     def decorator(func: Callable) -> Callable:
         @functools.wraps(func)
         def wrapper(*args, **kwargs) -> Any:
@@ -85,6 +105,14 @@ def with_retry(
 
 
 def with_timeout(seconds):
+    """
+    description:
+        超时装饰器，限制函数执行时间
+    parameters:
+        seconds(int): 超时时间（秒）
+    return:
+        decorator(Callable): 装饰器函数
+    """
     def decorator(func):
         @wraps(func)
         def wrapper(*args, **kwargs):
@@ -103,6 +131,14 @@ def with_timeout(seconds):
 
 
 def avoid_chinese_filename(func):
+    """
+    description:
+        避免中文文件名的装饰器，自动处理包含中文的文件路径
+    parameters:
+        func(Callable): 被装饰的函数
+    return:
+        wrapper(Callable): 包装后的函数
+    """
     def contains_chinese(text):
         if not text:
             return False