proxycast/docs/test/unit-tests.md

Lime 单元测试指南

针对独立模块的确定性测试

概述

单元测试是测试金字塔的基础，覆盖最小的可测试单元。Lime 的单元测试主要针对：

• 协议转换器
• Provider 模块
• 工具函数
• 数据结构

Rust 单元测试

运行命令

# 运行所有测试
cd src-tauri && cargo test

# 运行特定模块测试
cargo test converter::
cargo test provider::

# 显示详细输出
cargo test -- --nocapture

测试文件位置

src-tauri/src/
├── converter/
│   ├── mod.rs
│   └── tests.rs          # 转换器测试
├── providers/
│   ├── kiro/
│   │   └── tests.rs      # Kiro Provider 测试
│   └── gemini/
│       └── tests.rs      # Gemini Provider 测试
└── services/
    └── tests.rs          # 服务层测试

测试模板

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_basic_conversion() {
        let input = OpenAIMessage {
            role: "user".to_string(),
            content: "Hello".to_string(),
        };
        
        let result = convert_to_claude(&input);
        
        assert_eq!(result.role, "user");
        assert!(result.content.contains("Hello"));
    }

    #[test]
    fn test_edge_case_empty_content() {
        let input = OpenAIMessage {
            role: "user".to_string(),
            content: "".to_string(),
        };
        
        let result = convert_to_claude(&input);
        
        // 空内容应该被正确处理
        assert!(result.content.is_empty());
    }
}

前端单元测试

运行命令

# 运行所有测试
npm test

# 运行特定文件
npm test -- src/lib/utils.test.ts

# 监听模式
npm test -- --watch

测试文件位置

src/
├── lib/
│   ├── utils.ts
│   └── utils.test.ts     # 工具函数测试
├── hooks/
│   ├── useCredentials.ts
│   └── useCredentials.test.ts
└── components/
    └── __tests__/        # 组件测试

测试模板

import { describe, it, expect } from 'vitest';
import { formatCredentialName, validateApiKey } from './utils';

describe('formatCredentialName', () => {
  it('should format kiro credential name', () => {
    const result = formatCredentialName('kiro', 'user@example.com');
    expect(result).toBe('Kiro (user@example.com)');
  });

  it('should handle empty email', () => {
    const result = formatCredentialName('kiro', '');
    expect(result).toBe('Kiro');
  });
});

describe('validateApiKey', () => {
  it('should accept valid OpenAI key', () => {
    expect(validateApiKey('sk-1234567890abcdef')).toBe(true);
  });

  it('should reject invalid key', () => {
    expect(validateApiKey('invalid')).toBe(false);
  });
});

测试原则

1. 单一职责

每个测试只验证一个行为：

// ✅ 好：单一职责
#[test]
fn test_token_refresh_updates_expiry() {
    // 只测试过期时间更新
}

#[test]
fn test_token_refresh_preserves_scope() {
    // 只测试 scope 保留
}

// ❌ 差：多个职责
#[test]
fn test_token_refresh() {
    // 测试过期时间、scope、错误处理...
}

2. 独立性

测试之间不应该有依赖：

// ✅ 好：每个测试独立
#[test]
fn test_a() {
    let state = TestState::new();
    // ...
}

#[test]
fn test_b() {
    let state = TestState::new();
    // ...
}

// ❌ 差：共享状态
static mut SHARED_STATE: Option<TestState> = None;

3. 可读性

测试名称应该描述行为：

// ✅ 好：描述性名称
#[test]
fn test_expired_token_triggers_refresh()

#[test]
fn test_invalid_credentials_returns_error()

// ❌ 差：模糊名称
#[test]
fn test_token()

#[test]
fn test_error()

覆盖率目标

模块	目标覆盖率	说明
converter	90%+	核心转换逻辑
providers	80%+	OAuth 流程
services	70%+	业务逻辑
utils	95%+	工具函数

下一步

• 集成测试指南
• 测试用例：转换器
• 测试用例：Provider