test: 新增ci

Author: CNFeffery

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, dev ]
+  pull_request:
+    branches: [ main, dev ]
+
+jobs:
+  test-cli:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+        pip install pytest
+    
+    - name: Run CLI tests with pytest
+      run: |
+        python -m pytest tests/test_cli.py -v

magic_dash.egg-info/PKG-INFO

@@ -69,6 +69,12 @@ magic-dash list
 
 ### 2.2 生成指定项目模板
 
+- ⭐ 推荐：交互式选择项目模板（不指定 `--name` 参数时会弹出选择菜单）
+
+```bash
+magic-dash create
+```
+
 - 默认生成到当前路径
 
 ```bash
@@ -81,6 +87,20 @@ magic-dash create --name magic-dash
 magic-dash create --name magic-dash --path 目标路径
 ```
 
+- 项目生成完成后，进入项目目录运行应用
+
+```bash
+cd magic-dash
+pip install -r requirements.txt
+python app.py
+```
+
+- 对于 `magic-dash-pro` 模板，需要额外初始化数据库
+
+```bash
+python -m models.init_db
+```
+
 ### 2.3 查看当前`magic-dash`版本
 
 ```bash

magic_dash.egg-info/SOURCES.txt

@@ -109,4 +109,5 @@ magic_dash/templates/magic-dash/views/status_pages/_404.py
 magic_dash/templates/magic-dash/views/status_pages/_500.py
 magic_dash/templates/magic-dash/views/status_pages/__init__.py
 magic_dash/templates/simple-tool/app.py
-magic_dash/templates/simple-tool/requirements.txt
+magic_dash/templates/simple-tool/requirements.txt
+tests/test_cli.py

magic_dash/__init__.py

@@ -112,7 +112,7 @@ def _create(name, path):
         for template in BUILTIN_TEMPLATES.keys():
             console.print(f"  - [cyan]{template}[/cyan]")
         console.print()
-        return
+        raise click.ClickException("无效的模板名称")
 
     # 显示模板信息
     template_info = BUILTIN_TEMPLATES[name]

tests/test_cli.py

@@ -0,0 +1,71 @@
+import os
+import subprocess
+import shutil
+import pytest
+
+
+def run_command(cmd, input_text=None):
+    """执行命令并返回结果"""
+    if input_text:
+        process = subprocess.Popen(
+            cmd,
+            shell=True,
+            stdin=subprocess.PIPE,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+        )
+        stdout, stderr = process.communicate(input=input_text)
+        returncode = process.returncode
+    else:
+        result = subprocess.run(
+            cmd,
+            shell=True,
+            capture_output=True,
+            text=True,
+        )
+        returncode = result.returncode
+        stdout = result.stdout
+        stderr = result.stderr
+    return returncode, stdout, stderr
+
+
+def test_version():
+    """测试版本号查看"""
+    returncode, stdout, stderr = run_command("magic-dash --version")
+    assert returncode == 0, f"命令执行失败: {stderr}"
+    assert stdout.strip(), "无版本号输出"
+
+
+def test_list():
+    """测试 list 命令列出模板"""
+    returncode, stdout, stderr = run_command("magic-dash list")
+    assert returncode == 0, f"命令执行失败: {stderr}"
+    assert "magic-dash" in stdout, "未找到模板 'magic-dash'"
+    assert "simple-tool" in stdout, "未找到模板 'simple-tool'"
+
+
+def test_create_with_name(tmp_path):
+    """测试 create 命令创建项目"""
+    project_path = tmp_path / "simple-tool"
+
+    input_text = "\n\n"
+    returncode, stdout, stderr = run_command(
+        f"magic-dash create --name simple-tool --path {tmp_path}", input_text=input_text
+    )
+
+    assert returncode == 0, f"命令执行失败: {stderr}"
+    assert os.path.exists(project_path), f"项目目录未创建: {project_path}"
+    assert os.path.exists(os.path.join(project_path, "app.py")), "app.py 不存在"
+
+
+def test_create_invalid_name():
+    """测试错误处理 - 不存在的模板名称"""
+    returncode, stdout, stderr = run_command(
+        "magic-dash create --name nonexistent-template"
+    )
+    assert returncode != 0, "应该返回错误但成功了"
+    assert (
+        "不存在的Dash应用项目模板名称" in stdout
+        or "不存在的Dash应用项目模板名称" in (stderr or "")
+    ), "未显示期望的错误信息"