Temoc

使用(GitHub Flavored) markdown文件进行验收测试。

为什么？

这个想法是让您能够编写简单的文档与验收测试一起提交，并验证您的CI管道中的代码。Markdown文件是通用的，易于编写和理解，因此它们是进行验收测试的完美媒介。

我们使用GitHub Flavored markdown是因为我们需要支持表格。

为什么不Fitnesse？

本项目深受fitnesse的启发。我们甚至使用相同的Slim Protocol与SUT（系统测试）通信。我们的想法不是与fitnesse竞争，而是一个替代方案。如果您需要功能更丰富的软件，您可能应该使用Fitnesse。

如何测试我的项目？

我们使用Slim Protocol与系统测试进行通信。这里可以找到多个语言的插件列表。您可以在这里找到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