如何选择不运行doc测试？

Question

我正在写一个Rust库,我想在我的文档中提供一些示例

1. 编译作为运行的一部分 cargo test
2. 也不会运行.

这可能吗？

我正在编写一个数据库客户端库,这些示例使用了一个假设的,不存在的数据库服务器.因此,示例在运行时总是会失败,但重要的是示例在语法上是有效的.因此我的要求如上.

如果没有办法做我想做的事,那么如何选择不cargo test运行特定的文档测试？即,cargo run编译并运行一些文档测试但完全忽略其他一些？

Answer 1

这在Rust编程语言中有记载,特别是关于文档的章节.

您的打开代码块分隔符应如下所示:

/// ```rust,no_run

从书中:

/// ```rust,no_run
/// loop {
///     println!("Hello, world");
/// }
/// ```

该no_run属性将编译您的代码,但不会运行它.这对于您希望确保编译的"以下是如何检索网页"等示例非常重要,但可能会在没有网络访问权限的测试环境中运行.

Answer 2

把它放在 Cargo.toml 中：

[lib]
doctest = false

在这里找到：https : //doc.rust-lang.org/cargo/commands/cargo-test.html