add github workflow

Author: codeskyblue

.github/workflows/poetry.yml

@@ -0,0 +1,57 @@
+name: Python Package
+
+on:
+  push:
+    branches: [master]
+    tags:
+      - v*
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+      
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.8
+      
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install poetry
+        poetry install
+      
+    - name: Run tests with coverage
+      run: |
+        poetry run pytest tests -vv
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: test # 声明依赖于先前的测试作业
+    if: startsWith(github.ref, 'refs/tags/') # 仅在标签推送时运行
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: 3.9
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install poetry
+    
+    - name: Build
+      run: |
+        poetry self add "poetry-dynamic-versioning[plugin]"
+        rm -fr dist/ && poetry build
+
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_TOKEN }}

pytest.ini

@@ -0,0 +1,5 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*

tests/conftest.py

@@ -0,0 +1,18 @@
+import os
+import pytest
+
+@pytest.fixture(autouse=True)
+def clean_env():
+    """清理测试环境变量"""
+    # 备份现有环境变量
+    old_env = {}
+    for key in ["SERVEFS_ROOT", "SERVEFS_DEBUG"]:
+        if key in os.environ:
+            old_env[key] = os.environ[key]
+            del os.environ[key]
+    
+    yield
+    
+    # 恢复环境变量
+    for key, value in old_env.items():
+        os.environ[key] = value

tests/test_cli.py

@@ -0,0 +1,89 @@
+import os
+from pathlib import Path
+from unittest.mock import patch
+
+import pytest
+from typer.testing import CliRunner
+
+from servefs.cli import app
+
+runner = CliRunner()
+
+def test_version():
+    """测试版本信息显示"""
+    result = runner.invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert "servefs version:" in result.stdout
+
+def test_help():
+    """测试帮助信息显示"""
+    result = runner.invoke(app, ["--help"])
+    assert result.exit_code == 0
+    assert "Usage:" in result.stdout
+
+def test_invalid_port():
+    """测试无效端口号"""
+    result = runner.invoke(app, ["--port", "99999"])
+    assert result.exit_code == 2
+    assert "Invalid value for '--port'" in result.stdout
+
+def test_invalid_root():
+    """测试无效根目录"""
+    result = runner.invoke(app, ["--root", "/nonexistent/path"])
+    assert result.exit_code == 2
+    assert "Invalid value for '--root'" in result.stdout
+
+@pytest.fixture
+def temp_dir(tmp_path):
+    """创建临时目录"""
+    return tmp_path
+
+def test_server_start(temp_dir):
+    """测试服务器启动"""
+    with patch("servefs.cli.uvicorn.run") as mock_run:
+        result = runner.invoke(app, [
+            "--root", str(temp_dir),
+            "--port", "8888",
+            "--host", "127.0.0.1",
+            "--debug"
+        ])
+        
+        assert result.exit_code == 0
+        # 验证环境变量设置
+        assert os.environ["SERVEFS_ROOT"] == str(temp_dir.absolute())
+        assert os.environ["SERVEFS_DEBUG"] == "true"
+        
+        # 验证服务器启动参数
+        mock_run.assert_called_once_with(
+            "servefs.main:app",
+            host="127.0.0.1",
+            port=8888,
+            log_level="info"
+        )
+
+def test_default_options():
+    """测试默认选项"""
+    with patch("servefs.cli.uvicorn.run") as mock_run:
+        result = runner.invoke(app)
+        
+        assert result.exit_code == 0
+        # 验证默认环境变量
+        assert os.environ["SERVEFS_ROOT"] == str(Path(".").absolute())
+        assert os.environ["SERVEFS_DEBUG"] == "false"
+        
+        # 验证默认服务器参数
+        mock_run.assert_called_once_with(
+            "servefs.main:app",
+            host="0.0.0.0",
+            port=8000,
+            log_level="info"
+        )
+
+def test_debug_mode():
+    """测试调试模式"""
+    with patch("servefs.cli.uvicorn.run") as mock_run:
+        result = runner.invoke(app, ["--debug"])
+        
+        assert result.exit_code == 0
+        assert os.environ["SERVEFS_DEBUG"] == "true"
+        assert "Developer mode: enabled" in result.stdout