sycommon-python-lib 0.2.2a3__py3-none-any.whl → 0.2.2a4__py3-none-any.whl

command/cli.py

@@ -49,6 +49,12 @@ def create_init_parser(subparsers) -> None:
   web   - 标准 FastAPI Web 服务，适合 RESTful API 开发
   agent - AI Agent 服务，基于 langgraph 实现状态图
 
+CLI 项目结构:
+  commands/         - 子命令目录
+  model/            - 数据模型
+  client/           - 外部服务客户端
+  app.py            - CLI 入口 (argparse)
+
 Agent 项目结构:
   agent/           - Agent 核心 (main_agent, nodes, states, enums)
   api/sse/         - SSE 流式接口
@@ -79,7 +85,7 @@ Web 项目结构:
     # 位置参数
     init_parser.add_argument(
         "project_type",
-        choices=["web", "agent"],
+        choices=["web", "agent", "cli"],
         help="项目类型：web / agent"
     )
     init_parser.add_argument(
@@ -221,6 +227,8 @@ def _detect_project_type(project_path) -> str | None:
     if (project_path / "agent" / "main_agent.py").exists() or \
        (project_path / "agent" / "enums").is_dir():
         return "agent"
+    if (project_path / "commands").is_dir() and (project_path / "app.py").exists():
+        return "cli"
     if (project_path / "api").is_dir():
         return "web"
     return None
@@ -247,13 +255,19 @@ def handle_doctor_command(args) -> bool:
         warnings.append("无法识别项目类型 (非 web / agent 标准结构)")
 
     # 1. 检查必要文件
-    required_files = ["app.py", "requirements.txt"]
+    if project_type == "cli":
+        required_files = ["app.py", "pyproject.toml"]
+    else:
+        required_files = ["app.py", "requirements.txt"]
     for file in required_files:
         if not (project_path / file).exists():
             issues.append(f"缺少必要文件: {file}")
 
     # 2. 检查配置文件
-    config_files = ["app.yaml", ".env"]
+    if project_type == "cli":
+        config_files = [".env"]
+    else:
+        config_files = ["app.yaml", ".env"]
     for file in config_files:
         if not (project_path / file).exists():
             warnings.append(f"缺少配置文件: {file}")
@@ -276,6 +290,8 @@ def handle_doctor_command(args) -> bool:
                 issues.append(f"缺少 Agent 核心文件: {file}")
     elif project_type == "web":
         required_dirs = ["api", "model", "tools", "client"]
+    elif project_type == "cli":
+        required_dirs = ["commands", "model", "tools"]
     else:
         required_dirs = ["api", "model", "tools"]
 
@@ -351,6 +367,11 @@ def handle_list_command(args) -> bool:
                      "api/sse/", "api/query.py", "tools/", "model/", "db/"],
             "features": "nacos, kafka_log, llm, sentry (默认启用)",
         },
+        "cli": {
+            "desc": "Python CLI 命令行工具 (argparse)",
+            "dirs": ["commands/", "model/", "client/"],
+            "features": "无默认依赖 (精简模板)",
+        },
     }
 
     for name, info in templates.items():

command/core/models.py

@@ -13,6 +13,19 @@ AGENT_DEFAULTS = {
     "llm": True,
 }
 
+# CLI 项目默认关闭所有服务依赖
+CLI_DEFAULTS = {
+    "database": False,
+    "rabbitmq": False,
+    "nacos": False,
+    "kafka_log": False,
+    "sse": False,
+    "llm": False,
+    "redis": False,
+    "elasticsearch": False,
+    "sentry": False,
+}
+
 
 @dataclass
 class FeatureOptions:
@@ -32,6 +45,8 @@ class FeatureOptions:
         """根据项目类型返回推荐默认配置"""
         if project_type == "agent":
             return cls(**AGENT_DEFAULTS)
+        if project_type == "cli":
+            return cls(**CLI_DEFAULTS)
         return cls()
 
     def to_template_vars(self) -> dict:

command/core/project.py

@@ -153,13 +153,19 @@ def init_project(
             'db/', 'db/service.py', 'db/model/', 'db/model/entity.py',
         ],
     }
+    # CLI 项目不需要的服务端文件
+    cli_skip_files = {'app.yaml', 'app.yaml.tpl', 'requirements.txt', 'requirements.txt.tpl', 'Dockerfile', 'Dockerfile.tpl'}
     disabled_features = {
         key for key, flag_val in features.to_template_vars().items()
         if flag_val == 'false' and key in feature_map
     }
 
     def _should_skip(rel_path: str) -> bool:
-        """检查文件是否因功能关闭而应跳过"""
+        """检查文件是否因功能关闭或项目类型而应跳过"""
+        # CLI 项目跳过不需要的服务端文件
+        if project_type == "cli":
+            if rel_path in cli_skip_files or rel_path.replace('.tpl', '') in cli_skip_files:
+                return True
         for feat_key in disabled_features:
             for pattern in feature_map[feat_key]:
                 if pattern in rel_path:
@@ -191,7 +197,7 @@ def init_project(
     copied_files = _render_files(file_mappings, context, project_path, verbose)
 
     if copied_files > 0:
-        _print_success_message(project_path, project_name, copied_files)
+        _print_success_message(project_path, project_name, copied_files, project_type)
         return True
     else:
         print_warning("未创建任何文件，可能是缺少模板文件或模板路径配置错误")
@@ -284,7 +290,8 @@ def _render_files(
 def _print_success_message(
     project_path: Path,
     project_name: str,
-    copied_files: int
+    copied_files: int,
+    project_type: str = "web",
 ) -> None:
     """打印成功信息"""
     print_success(f"模板工程 {project_name} 创建完成！")
@@ -293,7 +300,11 @@ def _print_success_message(
     print()
     print_info("下一步操作:")
     print(f"  cd {project_name}")
-    print(f"  # 建议先创建虚拟环境")
-    print(f"  python -m venv .venv && source .venv/bin/activate")
-    print(f"  pip install -r requirements.txt")
-    print(f"  python app.py")
+    if project_type == "cli":
+        print(f"  uv sync")
+        print(f"  uv run python app.py")
+    else:
+        print(f"  # 建议先创建虚拟环境")
+        print(f"  python -m venv .venv && source .venv/bin/activate")
+        print(f"  pip install -r requirements.txt")
+        print(f"  python app.py")

command/templates/cli/README.md.tpl

@@ -0,0 +1,54 @@
+# {{ project_name }}
+
+{{ project_name }} - Python CLI 命令行工具
+
+## 项目结构
+
+```
+{{ project_name }}/
+├── commands/             # 子命令目录
+│   ├── __init__.py
+│   └── hello.py          # 示例子命令
+├── tools/                # 工具函数
+├── model/                # 数据模型
+├── client/               # 外部服务客户端
+├── app.py                # CLI 入口
+├── pyproject.toml        # uv 项目配置
+└── README.md
+```
+
+## 快速开始
+
+### 安装依赖
+```bash
+uv sync
+```
+
+### 使用
+```bash
+# 查看帮助
+uv run python app.py -h
+
+# hello 命令
+uv run python app.py hello --name "World"
+
+# 查看版本
+uv run python app.py version
+```
+
+### 添加新子命令
+
+1. 在 `commands/` 目录下创建新模块，例如 `commands/xxx.py`
+2. 实现 `handle_xxx(args)` 函数
+3. 在 `app.py` 中注册子命令：
+
+```python
+from commands.xxx import handle_xxx
+
+# 在 create_parser() 中添加：
+xxx_parser = subparsers.add_parser("xxx", help="xxx 说明")
+
+# 在 main() 中添加：
+elif args.command == "xxx":
+    handle_xxx(args)
+```

command/templates/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI 项目模板"""

command/templates/cli/app.py.tpl

@@ -0,0 +1,45 @@
+"""
+{{ project_name }} - CLI 工具入口
+创建时间: {{ create_time }}
+作者: {{ author }}
+"""
+import argparse
+import sys
+
+from commands.hello import handle_hello
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """创建命令行解析器"""
+    parser = argparse.ArgumentParser(
+        prog="{{ project_name }}",
+        description="{{ project_name }} - CLI 命令行工具",
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="子命令")
+
+    # hello 子命令
+    hello_parser = subparsers.add_parser("hello", help="打招呼")
+    hello_parser.add_argument("--name", default="World", help="名字")
+
+    # version 子命令
+    subparsers.add_parser("version", help="显示版本")
+
+    return parser
+
+
+def main() -> None:
+    """CLI 主入口"""
+    parser = create_parser()
+    args = parser.parse_args()
+
+    if args.command == "hello":
+        handle_hello(args)
+    elif args.command == "version":
+        print("{{ project_name }} 1.0.0")
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

command/templates/cli/commands/__init__.py.tpl

@@ -0,0 +1 @@
+"""子命令模块"""

command/templates/cli/commands/hello.py.tpl

@@ -0,0 +1,6 @@
+"""hello 子命令"""
+
+
+def handle_hello(args) -> None:
+    """处理 hello 命令"""
+    print(f"Hello, {args.name}!")

command/templates/cli/pyproject.toml.tpl

@@ -0,0 +1,14 @@
+[project]
+name = "{{ project_name }}"
+version = "0.1.0"
+description = "{{ project_name }} - CLI 命令行工具"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
+
+[project.scripts]
+{{ short_project_name }} = "app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

command/templates/cli/tools/__init__.py.tpl

@@ -0,0 +1,3 @@
+"""
+工具函数模块
+"""

{sycommon_python_lib-0.2.2a3.dist-info → sycommon_python_lib-0.2.2a4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.2a3
+Version: 0.2.2a4
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -11,18 +11,18 @@ Requires-Dist: anyio>=4.12.1
 Requires-Dist: decorator>=5.2.1
 Requires-Dist: deepagents>=0.5.3
 Requires-Dist: elasticsearch>=9.3.0
-Requires-Dist: fastapi>=0.136.0
+Requires-Dist: fastapi>=0.136.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: kafka-python>=2.3.1
 Requires-Dist: langchain>=1.2.15
-Requires-Dist: langchain-core>=1.3.0
+Requires-Dist: langchain-core>=1.3.1
 Requires-Dist: langchain-openai>=1.2.0
 Requires-Dist: langfuse>=4.5.0
 Requires-Dist: langgraph>=1.1.9
 Requires-Dist: langgraph-checkpoint-redis>=0.4.1
 Requires-Dist: ldap3>=2.9.1
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mysql-connector-python>=9.6.0
+Requires-Dist: mysql-connector-python>=9.7.0
 Requires-Dist: nacos-sdk-python<3.0,>=2.0.11
 Requires-Dist: psutil>=7.2.2
 Requires-Dist: pyxxl>=0.4.6
@@ -35,7 +35,7 @@ Requires-Dist: sentry-sdk[fastapi]>=2.58.0
 Requires-Dist: sqlalchemy[asyncio]>=2.0.48
 Requires-Dist: starlette[full]>=1.0.0
 Requires-Dist: tiktoken>=0.12.0
-Requires-Dist: uvicorn>=0.45.0
+Requires-Dist: uvicorn>=0.46.0
 Requires-Dist: wecom-aibot-python-sdk>=1.0.2
 
 # sycommon-python-lib

{sycommon_python_lib-0.2.2a3.dist-info → sycommon_python_lib-0.2.2a4.dist-info}/RECORD

@@ -1,11 +1,12 @@
 command/__init__.py,sha256=FQYIr-EnMOm1pBdQbQbDXM0GXf0DSO0nEyEnAOCSyP8,496
-command/cli.py,sha256=-0pFHr-ykvb-amQrcuH8gZmwgxz9T6oky3hjnXJEirI,15228
+command/cli.py,sha256=6JOVT8BgLjqAYkPt2Xjl6RzsCNJlO3YpctkbSwbOLiM,15984
 command/core/__init__.py,sha256=pm4iGEGmKMPgRCF-sC9kd3kGVVX68xYvGt1Z64wnRyQ,480
 command/core/console.py,sha256=U2vKA2L7Yp9EzdyzyZzgt4EACjc_y0tXx4hl1emJG-M,752
-command/core/models.py,sha256=LG8Be4nYgE5mqWaCBo6izqrJ1lUxKEdZYKyUx13VQzA,1960
-command/core/project.py,sha256=8X2EFby8h9kEoFsxwJ0Egatsz0IpU0mRp1bUMHV-l98,10516
+command/core/models.py,sha256=AS8vCPSctJoG7yqAvjADOpmdZ285kUGUQCp_nu4VswU,2291
+command/core/project.py,sha256=-2mT0jyf2qoj7SxLb-V-vCACs2ubbva43RC0bfkpN3A,11081
 command/core/utils.py,sha256=SHwxTBgZ5qoABkKGvyldGai1MlA2EQB9ioZFwMjIWiw,768
 command/templates/__init__.py,sha256=tA-BvD00oALAAn9Iam-3YPAoJXIAgnEIBsLiyjarATM,19
+command/templates/__pycache__/__init__.cpython-311.pyc,sha256=lh9KKCjSkZqpuuIj8xjDZXcD2PyqZbQbyEOoApR0CMg,236
 command/templates/agent/README.md.tpl,sha256=fJ1GVxHBncnAafckloDzIqpeXUsgj42n6ok3KDr9ePM,2200
 command/templates/agent/__init__.py,sha256=7zsuCBh_av1qD1oCTeTPDG7FAtSneIYV5DDEsuwS78M,25
 command/templates/agent/app.py.tpl,sha256=mYkXraQtJ2o8dHEryK7b_OlUL7QsL4EUHysPKRbTG0I,2788
@@ -40,6 +41,13 @@ command/templates/base/client/FileServiceClient.py.tpl,sha256=t5_bx484rvpwFAe1d0
 command/templates/base/client/__init__.py.tpl,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 command/templates/base/model/__init__.py.tpl,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 command/templates/base/model/file_info.py.tpl,sha256=N_sFB9kR2Bxlzexu53KuG9voraNtRdOsVd30f3qBCfU,653
+command/templates/cli/README.md.tpl,sha256=r8fVuuXr3BK4ZktSPqxK4XR35xIvLmmdJC15JSvtGVw,1126
+command/templates/cli/__init__.py,sha256=BTnJYTp-jUJi5N7cfwmd62SX4tIKuT9Edvk79lZYIhM,23
+command/templates/cli/app.py.tpl,sha256=8sjXr0tnbzJ1wAI3_k6k2kBcK9O0PE8UZo_33kAbmTI,1056
+command/templates/cli/pyproject.toml.tpl,sha256=LrcSYleLbKKg412_2Kxc4Z-CFzwC_hmp_dRJ7I7BCQM,311
+command/templates/cli/commands/__init__.py.tpl,sha256=4FrbV9-EL4hF-upzGoMCHJg2bNoUK_qY4ATChSfyh5Q,22
+command/templates/cli/commands/hello.py.tpl,sha256=rFdawL-6gHiz_qw58PS3KfHGn-nkp84b5NbAQSuFnY0,120
+command/templates/cli/tools/__init__.py.tpl,sha256=A_YW5Gb8wmc9FwtRi7lkiCz8otVgwQgSqdtzkNrmkHs,27
 command/templates/web/README.md.tpl,sha256=Slv0EXn4qQmNvUbDJEZYCwLem85qX68aG7DXpnxhiPY,1728
 command/templates/web/__init__.py,sha256=iBr-dkP_jukCaGfKkAxxCe7bcQEjhQdg0sX8DyX84b8,23
 command/templates/web/app.py.tpl,sha256=As9zsXmkeNAMR3VWf3uiryOcjqQTbpNcfMSQJuZRGQk,2864
@@ -246,8 +254,8 @@ sycommon/tools/syemail.py,sha256=BDFhgf7WDOQeTcjxJEQdu0dQhnHFPO_p3eI0-Ni3LhQ,561
 sycommon/tools/timing.py,sha256=OiiE7P07lRoMzX9kzb8sZU9cDb0zNnqIlY5pWqHcnkY,2064
 sycommon/xxljob/__init__.py,sha256=7eoBlQxv-B39IfRSCY2bkqdGYs1QRe1umAWd88VMEEM,86
 sycommon/xxljob/xxljob_service.py,sha256=JIEJaGXhqrTLcyxlyynSrsHg9bBnDNzX-D4qIWLRPUE,6815
-sycommon_python_lib-0.2.2a3.dist-info/METADATA,sha256=JzdlgU0tqIPnpanKWQWPVrHCKAtpd_gq-8noMxPKdRo,7683
-sycommon_python_lib-0.2.2a3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-sycommon_python_lib-0.2.2a3.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
-sycommon_python_lib-0.2.2a3.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
-sycommon_python_lib-0.2.2a3.dist-info/RECORD,,
+sycommon_python_lib-0.2.2a4.dist-info/METADATA,sha256=6N7cf-QKXkNkrczrflLXX4aK3-wtxCzPWeeU0fhBH6w,7683
+sycommon_python_lib-0.2.2a4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sycommon_python_lib-0.2.2a4.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
+sycommon_python_lib-0.2.2a4.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
+sycommon_python_lib-0.2.2a4.dist-info/RECORD,,