C3语言编译器测试框架支持自定义参数传递的演进

在C3语言编译器(c3c)的最新开发中，测试框架获得了一项重要增强：测试运行器现在可以接收自定义命令行参数。这一改进为开发者提供了更大的灵活性，使得测试用例能够根据运行时参数动态调整行为。

背景与需求

传统的C3测试运行器被编译为一个独立的可执行程序build/testrun，其入口函数原本是固定签名的bool main()。这种设计限制了测试用例的灵活性，开发者无法通过命令行参数来控制测试行为。

实际开发中，测试用例经常需要根据不同参数执行不同测试路径。例如：

• 控制测试的详细输出级别
• 指定特定测试子集运行
• 调整测试的迭代次数或超时设置

技术实现方案

新实现的关键点包括：

1. 函数签名变更：测试运行器的主函数签名从bool main()变更为bool testfn(String[] args)，允许接收字符串数组参数。

2. 参数传递机制：编译器(c3c)会将测试相关参数传递给生成的testrun可执行文件。参数传递方式与常规程序运行一致，使用--分隔符来区分编译器选项和测试参数。

3. 兼容性考虑：保持向后兼容，未指定参数时测试运行器仍能正常工作。

使用示例

开发者现在可以这样使用增强后的测试框架：

# 通过c3c直接运行测试并传递参数
c3c test -- --verbose --iterations=1000

# 或者先编译测试再单独运行
c3c compile-test
./build/testrun --filter=network_tests

在测试代码中，可以这样处理传入的参数：

bool testfn(String[] args) 
{
    bool verbose = false;
    foreach (arg in args) {
        if (arg == "--verbose") verbose = true;
    }
    // ...测试逻辑根据verbose值调整输出...
    return true;
}

设计考量

在实现过程中，开发团队考虑了多种参数传递方案：

1. 专用编译器参数：为测试特定需求设计专用编译器选项
2. 通用参数传递：使用--分隔符传递任意参数

最终选择了通用方案，因为：

• 与c3c run命令的行为保持一致
• 提供最大灵活性，不需要为每个新需求修改编译器
• 允许直接运行testrun可执行文件时使用相同参数格式

未来展望

这一改进为测试框架打开了更多可能性：

• 实现复杂的测试过滤和分组
• 支持性能测试时的动态参数调整
• 集成到CI系统时更精细的控制
• 开发者可以创建自定义测试运行器替代默认实现

C3语言通过这样的持续改进，正在构建一个既简单又强大的测试生态系统，满足从单元测试到系统级测试的各种需求。