Testlib：竞赛编程的全能测试框架
项目地址: https://gitcode.com/gh_mirrors/te/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）脚本
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
