1个不稳定版本

0.1.0 2023年12月8日

#5 in #acceptance


用于 rust_slim

MIT/Apache

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