BDD风格可执行文件的Rust长测试名称[已关闭]

kgqe7b3p 于 2022-11-12 发布在其他

关注(0)|答案(1)|浏览(88)

已关闭。此问题为opinion-based。当前不接受答案。
**想要改进此问题吗？**请更新问题，以便editing this post可以用事实与引用来回答.

28天前关闭。
Improve this question
我试图找到一种方法来记录我的测试，这可能是相当长的，以充分解释上下文和所需的行为（多达10-12个字）。
我更习惯于使用嵌套上下文和冗长期望的BDD样式规范，但标准[test]属性也很好。

**我的问题是：**下面的这个快乐之路片段可以重写以获得更好的可读性吗？


# [test]

fn test_when_user_this_and_than_it_does_something_special() {
  // ...
}

我正在寻找类似#[test(name="plain text test case description")]的东西（以避免heave snake_case命名），但没有太大的成功。或者也许有一个板条箱来缓解这个问题？

1条答案

Rust没有任何类型的测试 * 命名 * 与函数名分开。为了包含有关测试目的的信息，我建议您编写一个简洁的名称和包含其余单词的文档：

/// When the user does this and that, the special thing should happen.

# [test]

fn this_that_then_special() {
    // ...
}

如果需要，还可以使用内部doc-comment语法//!将注解放在块中：


# [test]

fn this_that_then_special() {
    //! When the user does this and that, the special thing should happen.

    // ...
}

当然，测试文档不会出现在生成的文档文件中，因此使用特定的语法并没有太多的意义，但它 * 是 * 一种标准的语法，可以将解释附加到任何项上。