sycommon-python-lib 0.2.2a3__tar.gz → 0.2.2a4__tar.gz

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/PKG-INFO

@@ -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 → sycommon_python_lib-0.2.2a4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.2a3"
+version = "0.2.2a4"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -12,18 +12,18 @@ dependencies = [
     "decorator>=5.2.1",
     "deepagents>=0.5.3",
     "elasticsearch>=9.3.0",
-    "fastapi>=0.136.0",
+    "fastapi>=0.136.1",
     "jinja2>=3.1.6",
     "kafka-python>=2.3.1",
     "langchain>=1.2.15",
-    "langchain-core>=1.3.0",
+    "langchain-core>=1.3.1",
     "langchain-openai>=1.2.0",
     "langfuse>=4.5.0",
     "langgraph>=1.1.9",
     "langgraph-checkpoint-redis>=0.4.1",
     "ldap3>=2.9.1",
     "loguru>=0.7.3",
-    "mysql-connector-python>=9.6.0",
+    "mysql-connector-python>=9.7.0",
     "nacos-sdk-python>=2.0.11,<3.0",
     "psutil>=7.2.2",
     "pyxxl>=0.4.6",
@@ -36,7 +36,7 @@ dependencies = [
     "sqlalchemy[asyncio]>=2.0.48",
     "starlette[full]>=1.0.0",
     "tiktoken>=0.12.0",
-    "uvicorn>=0.45.0",
+    "uvicorn>=0.46.0",
     "wecom-aibot-python-sdk>=1.0.2",
 ]
 

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/src/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():

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/src/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:

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/src/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")

sycommon_python_lib-0.2.2a4/src/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)
+```

sycommon_python_lib-0.2.2a4/src/command/templates/cli/__init__.py

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

sycommon_python_lib-0.2.2a4/src/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()

sycommon_python_lib-0.2.2a4/src/command/templates/cli/commands/__init__.py.tpl

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

sycommon_python_lib-0.2.2a4/src/command/templates/cli/commands/hello.py.tpl

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

sycommon_python_lib-0.2.2a4/src/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"

sycommon_python_lib-0.2.2a4/src/command/templates/web/tools/__init__.py.tpl

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

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/src/sycommon_python_lib.egg-info/PKG-INFO

@@ -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 → sycommon_python_lib-0.2.2a4}/src/sycommon_python_lib.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/command/core/models.py
 src/command/core/project.py
 src/command/core/utils.py
 src/command/templates/__init__.py
+src/command/templates/__pycache__/__init__.cpython-311.pyc
 src/command/templates/agent/README.md.tpl
 src/command/templates/agent/__init__.py
 src/command/templates/agent/app.py.tpl
@@ -42,6 +43,13 @@ src/command/templates/base/client/FileServiceClient.py.tpl
 src/command/templates/base/client/__init__.py.tpl
 src/command/templates/base/model/__init__.py.tpl
 src/command/templates/base/model/file_info.py.tpl
+src/command/templates/cli/README.md.tpl
+src/command/templates/cli/__init__.py
+src/command/templates/cli/app.py.tpl
+src/command/templates/cli/pyproject.toml.tpl
+src/command/templates/cli/commands/__init__.py.tpl
+src/command/templates/cli/commands/hello.py.tpl
+src/command/templates/cli/tools/__init__.py.tpl
 src/command/templates/web/README.md.tpl
 src/command/templates/web/__init__.py
 src/command/templates/web/app.py.tpl

{sycommon_python_lib-0.2.2a3 → sycommon_python_lib-0.2.2a4}/src/sycommon_python_lib.egg-info/requires.txt

@@ -5,18 +5,18 @@ anyio>=4.12.1
 decorator>=5.2.1
 deepagents>=0.5.3
 elasticsearch>=9.3.0
-fastapi>=0.136.0
+fastapi>=0.136.1
 jinja2>=3.1.6
 kafka-python>=2.3.1
 langchain>=1.2.15
-langchain-core>=1.3.0
+langchain-core>=1.3.1
 langchain-openai>=1.2.0
 langfuse>=4.5.0
 langgraph>=1.1.9
 langgraph-checkpoint-redis>=0.4.1
 ldap3>=2.9.1
 loguru>=0.7.3
-mysql-connector-python>=9.6.0
+mysql-connector-python>=9.7.0
 nacos-sdk-python<3.0,>=2.0.11
 psutil>=7.2.2
 pyxxl>=0.4.6
@@ -29,5 +29,5 @@ sentry-sdk[fastapi]>=2.58.0
 sqlalchemy[asyncio]>=2.0.48
 starlette[full]>=1.0.0
 tiktoken>=0.12.0
-uvicorn>=0.45.0
+uvicorn>=0.46.0
 wecom-aibot-python-sdk>=1.0.2