模块测试指南

1. 【强制】一个正向的合法测试用例声明格式为：@testing: case = “testName”，测试用例中断言需要使用 assert 语句。

   正例：

   @testing:case="test_sum_int_vetcor" re = sum([1,2,3])
                 assert
               1,eqObj(re,6)

2. 【强制】一个异常测试用例声明格式为：@testing: case = “testName”, exception=1。

   正例：

   @testing:case="sum_not_support_matrix_zero_column", exception=1
                 m = matrix(`INT, 10, 0);
                 sum(m)

3. 【强制】由于解析错误抛出的异常，异常测试用例声明格式为：@testing: case = “testName”, syntaxError=1。

   正例：

   @testing:case="parse_constant_vector_void_type", syntaxError=1
                 {,}

4. 【推荐】同一测试用例中多个结果比较时，每个比较对应一个断言，断言编号不能重复。否则某断言失败时，无法定位具体断言。

   正例：

   @testing:case="test_sum_int_vetcor" re = sum([1,2,3])
                 assert 1,eqObj(re,6)
                 re = sum([1]) assert
               2,eqObj(re,1)

   反例：

   @testing:case="test_sum_int_vetcor" re = sum([1,2,3])
                 assert 1,eqObj(re,6)
                 re = sum([1]) assert
               1,eqObj(re,1)

5. 【推荐】测试用例名不要重复，否则难以根据结果定位失败用例。

6. 【推荐】比较实际结果和预期是否完全一致时，推荐使用eqObj函数，避免直接使用== 或 eq函数。因为eqObj只有当类型和值都相同时，函数才会返回 true。 如果值相同但类型不同，则此函数仍返回 false。

7. 【推荐】断言时，如果要比较两个表的结果是否一致，推荐使用each(eqObj, re.values(),ex.values())的比较方式，避使用eqObj(re.values(),ex.values())。前者是逐列比较，返回的是一个和表的列数长度相同的向量；后者是将表转换成字典再作比较，返回的是一个标量。推荐使用前者的原因是，如果两个表的某几列不相同的话，前者可以非常直观地看出哪个列不相同，而后者无法定位差异列。

try { use demo; }catch(x) { print(x) }
@testing:case="test_demo_minmax_table", exception=1
demo::minmax(table([1] as c1))
@testing:case="test_demo_minmax_scalar"
ret = demo::minmax(1);
assert 1, eqObj([1,1], ret)
@testing:case="test_demo_minmax_vector"
ret = demo::minmax([12,3,4]);
assert 1, eqObj([3,12], ret)
@testing:case="test_demo_echo_no_input", syntaxError=1
demo::echo(1,2,3);
@testing:case="test_demo_echo_string"
ret = demo::echo("foo");
assert 1, eqObj("foo",ret)

基本的参数校验

不合理使用

内存泄漏和文件描述符泄漏

结果校验

• 如果是计算类的接口，需要校验结果正确性。

• 如果是订阅类的接口，需要校验数据正确性和完整性。

关注模块的错误提示和日志输出

• 错误提示是否合理。

• 终端中的输出是否过多。

• 日志中的输入是否过多。