1个不稳定版本
0.1.0 | 2023年12月8日 |
---|
#5 in #acceptance
用于 rust_slim
5KB
89 行
Temoc
使用(GitHub Flavored)Markdown文件进行验收测试。
为什么?
这个想法是让您能够编写简单的文档并带有验收测试,将其与代码一起提交,并在CI管道中验证。Markdown文件是通用的,易于编写和理解,因此它们是承载验收测试的完美媒介。
我们使用GitHub Flavored markdown,因为我们需要支持表格扩展。
为什么不使用Fitnesse?
该项目深受Fitnesse的启发。我们甚至使用了相同的Slim协议与SUT(被测试系统)通信。我们的想法不是与Fitnesse竞争,而是提供一个替代方案。如果您需要更丰富的功能,可能应该使用Fitnesse。
如何测试我的项目?
我们使用Slim协议与被测试系统进行通信。您可以在这里找到多个语言的插件列表。您可以在这里找到Rust的不完整实现。
您将使用这些插件之一来编写项目的测试固定值。固定值是介于Temoc和您的软件之间的粘合代码。
完成此操作后,您可以编写您的验收测试Markdown。请参阅我们的计算器示例这里。请查看原始Markdown文件,因为其中包含隐藏的指令。要运行它,您可以运行cargo run -- -c Config.toml.example
。
构建Temoc
Temoc是用Rust编写的,您可以在这里安装Rust工具链。之后,您可以使用以下命令编译所有内容:cargo build --release
。这应该在./target/release/temoc
中创建一个编译后的二进制文件。
运行Temoc
编译完成后,您可以通过运行./temoc --help
来查看命令列表。基本上,您需要指定一个启动瘦服务器的命令(您的插件应该会帮助您完成此操作),用于连接的端口(目前我们不支持STDIN、STOUT通信),以及要测试的Markdown文件列表。您还可以编写一个配置文件来设置默认参数列表,您可以在此示例中查看。
以下是在计算器示例中运行Temoc的输出示例。
Testing file temoc/examples/calculator.md...OK
Testing file temoc/examples/calculator_2.md...SNOOZED
依赖项
~0.8–1.3MB
~25K SLoC