卡伊卢亚测试框架。

卡伊卢亚中的大多数集成测试由输入、预期输出和预期报告到 kailua_diag::Report 组成。这不能用单元测试轻松完成，因此这个库简化了为单个应用程序创建此类测试框架的过程。

可以将以下部分添加到其 Cargo.toml...

[[test]]
name = "integration-test"
harness = false

...并将以下内容放入相应的源文件。

extern crate kailua_env;
extern crate kailua_diag;
extern crate kailua_test;

use std::cell::RefCell;
use std::rc::Rc;
use std::collections::HashMap;
use kailua_env::{Source, Span};
use kailua_diag::Report;

struct Testing;
impl kailua_test::Testing for Testing {
    fn run(&self, source: Rc<RefCell<Source>>, span: Span,
           filespans: &HashMap<String, Span>, report: Rc<Report>) -> String {
        format!("Expected test output")
    }
}

fn main() {
    kailua_test::Tester::new("integration-test", Testing).scan("src/tests").done();
}

这将扫描 src/tests 中的所有 *.lua 文件，并根据命令行选项测试它们。可以向 Testing 添加更多方法以进一步自定义测试应用程序。

测试格式

this part is ignored, put some descriptions here.


--8<-- test-name-1 -- options options ...
--@v Error: this error should occur in the following line
local x = 'some testing code' --@< Note: this note should occur in this exact line
--@^ Warning: this warning should occur in the preceding line

--@v-vvv Fatal: this fatal error should span following three lines
do
    return
end

--! expected output here; long line can be concatenated \
--!     like this, where preceding whitespaces are ignored in this line.


-->8-- test-name-2
this test is ignored unless `-f` is given.


--8<-- test-name-3
local a = require 'x'

--& x
-- it is possible to use multiple input files.
return 42

--&
-- duplicate input file names are invalid, except for the empty file name.
-- this means that the preceding file (named or not) should be trimmed following whitespaces,
-- required by parser tests which tend to be sensitive to the final whitespaces.
-- the code block itself gets ignored.

关于报告格式的更多信息

• 显式行也可以给出（--@3-8 ...）；行号从1开始，并为每个代码块重新编号。

• 行号也可以省略，在这种情况下，报告不应有任何相关的范围。

• 除了 Kind::Info 之外的所有报告 Kind 都可以使用。通常，info 报告用于调试信息，因此不能被抑制或进行检查。

支持的测试选项

• exact 表示测试不应该容忍额外的报告（通常仅在提供 -e 时启用）。

• feature:FEATURE 仅在启用特定功能时启用测试。可以有多个功能选项，所有这些选项都需要启用测试。请注意，这与 Cargo 功能不同；您应该手动使用 Tester::feature 在 main 函数中设置标志。

• feature:!FEATURE 仅当特定功能被禁用时才启用测试。