Testlib：竞赛编程的全能测试框架

核心价值：为什么选择Testlib？

你是否在为竞赛编程题目开发测试系统时遇到这些问题：如何验证输入数据合法性？怎样生成多样化测试用例？如何公平比较不同解法的输出？Testlib就像你的竞赛编程测试团队，提供从数据验证、生成到结果评判的全流程工具链，让你专注于题目设计而非测试细节。

核心组件地图

如何快速定位Testlib的核心功能？这里是按场景分类的功能地图：

数据验证场景

• Validator（验证器）：就像考试阅卷老师，严格检查输入数据是否符合题目要求（如数值范围、格式规范）
• 代表实现：validators目录下的ival.cpp（整数验证）、sval.cpp（字符串验证）等

数据生成场景

• Generator（生成器）：如同自动出题机，可生成随机数、树结构、二分图等多样化测试数据
• 代表实现：generators目录下的gen-tree-graph.cpp（树生成）、gen-array-with-opt.cpp（数组生成）等

结果比较场景

• Checker（校验器）：作为客观评分员，支持精确比较、模糊比较、自定义规则比较等多种评判方式
• 代表实现：checkers目录下的fcmp.cpp（浮点比较）、lcmp.cpp（行比较）、yesno.cpp（是非题比较）等

交互测试场景

• Interactor（交互器）：模拟实时交互环境，适用于需要程序间动态通信的题目
• 代表实现：interactors目录下的interactor-a-plus-b.cpp（A+B交互示例）

快速上手：从零开始使用Testlib

开发入口指南

如何开始第一个Testlib项目？只需三个步骤：

获取源码

• 克隆仓库：git clone https://gitcode.com/gh_mirrors/te/testlib
• 核心文件：testlib.h（所有功能的入口头文件）

第一个验证器

• 创建文件：validator.cpp
• 基本框架：

#include "testlib.h"
int main(int argc, char* argv[]) {
    registerValidation(argc, argv); // 注册验证器模式
    // 添加你的验证逻辑，如：
    inf.readInt(1, 100, "n"); // 读取1-100范围内的整数n
    inf.readEoln(); // 验证行结束符
    inf.readEof(); // 验证文件结束
}

第一个生成器

• 创建文件：generator.cpp
• 基本框架：

#include "testlib.h"
int main(int argc, char* argv[]) {
    registerGen(argc, argv, 1); // 注册生成器模式，版本号1
    // 添加你的生成逻辑，如：
    int n = rnd.next(1, 100); // 生成1-100的随机数
    println(n); // 输出到标准输出
}

编译运行

• 编译命令：g++ validator.cpp -o validator
• 运行验证器：./validator < input.txt
• 运行生成器：./generator > output.txt

深度解析：Testlib高级应用

环境适配方案

如何让Testlib完美融入你的开发流程？

编译器配置

• 要求：支持C++11及以上标准的编译器（g++、clang++、MSVC等）
• 编译选项：无需额外链接库，只需包含testlib.h头文件

构建系统集成

• Makefile示例：

validator: validator.cpp
    g++ $< -o $@ -std=c++11
generator: generator.cpp
    g++ $< -o $@ -std=c++11

• CMakeLists.txt：添加testlib.h所在目录到包含路径

测试工作流建议

• 开发阶段：使用tests目录下的脚本快速验证组件功能
• 部署阶段：结合test-000_compile-all-cpp等测试用例确保兼容性
• 维护阶段：利用test-007_validators等验证集回归测试

关键功能场景

数据验证进阶

• 输入流操作：inf.readInt()/readString()等方法支持类型检查和范围限制
• 错误处理：使用quitf(_wa, "message")输出标准化错误信息
• 实用示例：validators/bipartite-graph-validator.cpp（二分图验证）

智能测试生成

• 随机数控制：通过registerGen的版本号确保结果可复现
• 复杂结构生成：rnd.perm()（排列）、gen-tree-graph.cpp（树结构）
• 参数化生成：通过opt(1)获取命令行参数控制生成规模

灵活结果比较

• 精确比较：icmp.cpp（整数精确比较）
• 容错比较：wcmp.cpp（忽略空格比较）、fcmp.cpp（浮点误差容忍）
• 自定义比较：pointscmp.cpp（按点集规则比较）

交互测试实现

• 通信模型：通过inf（输入）、ouf（输出）、tout（交互日志）管理数据流
• 示例参考：interactors/interactor-a-plus-b.cpp（A+B问题交互器）

扩展与定制

Testlib不仅提供现成工具，还支持深度定制：

自定义Checker

• 基础框架：继承Testlib的Checker接口，实现check()方法
• 示例参考：checkers目录下的acmp.cpp（自定义答案比较）

配置参数处理

• 命令行参数：通过opt()方法解析自定义参数
• 选项控制：支持参数默认值、类型转换和合法性检查

跨平台兼容

• 文件格式：自动处理Windows/Linux换行符差异
• 测试支持：tests目录下提供t.sh（Linux）和t.bat（Windows）脚本