如何选择不运行文档测试?

2023-12-29

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

  1. 编译作为运行的一部分cargo test
  2. do not run.

这可能吗?

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

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


这记录在rustdoc 书 https://doc.rust-lang.org/rustdoc/,具体来说关于属性的章节 https://doc.rust-lang.org/rustdoc/documentation-tests.html#attributes.

您的起始代码块分隔符应如下所示:

/// ```no_run

摘自书中:

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

The no_run属性将编译您的代码,但不会运行它。这是 对于诸如“以下是如何检索网页”之类的示例很重要, 您希望确保编译,但可能会在测试中运行 没有网络访问的环境。

要完全省略构建,请使用ignore代替no_run.

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

如何选择不运行文档测试? 的相关文章

随机推荐

  • 如何生成具有多个值的直方图动画

    迭代更新非常慢 每次只有n 3 但我的数据有10000个元素 就像 它尝试更新每一帧 n 1 n 2 n 3 但 hist 函数确实很耗电 我不知道是否有任何方法可以跳过帧 例如从 n 1 直接跳到 n 500 和 n 1000 impor
  • 使用本地包

    我在本地目录中有一个 Elm 包 源代码 所有构建工件 我想从另一个 Elm 包中使用它 而不发布库 所以我的目录设置如下所示 my lib elm package json my app elm package json 首先 跑步elm
  • 如何访问 Google 日历的事件时间?

    我正在使用 Google Calendar API 和 Google Client Library for Python 我使用的代码给出了给定日期范围内但缺少时间的事件列表 我想要一个给出事件列表以及时间的输出 这是代码 page tok
  • 在保持某些变量不变的情况下最小化函数

    我有一个形式的函数 def tmp x n R s a T x 0 x 1 x 2 x 3 经过一长段计算后 它返回一个浮点数 我需要最小化这个函数 为此我使用了 scipy optimize minimize minimize tmp 0
  • 以编程方式,如何识别信标属于 Eddystone 还是 iBeacon?

    我创建了一个 Android 应用程序来使用蓝牙 LEscanner 扫描 BLE 现在我需要我的应用程序来识别信标是否属于 iBeacon 还是 Eddystone 到目前为止 我通过解析AD帧成功确定了ibeacon的UUID Majo
  • 如何使用 render 方法为 VueJS 组件指定分隔符?

    我有一个vuejs webpack simple项目生成通过vue cli 但是 我在使用时无法设置分隔符render函数来渲染我的App成分 new Vue delimiters el app render h gt h App 如果我不
  • SQLAlchemy PyODBC MS SQL Server DSN-less 连接

    通过 pyodbc 使用 python 2 7 和 MS odbc 驱动程序 我的连接字符串如下所示 mssql pyodbc myuser mypass serverip instancename driver ODBC Driver 1
  • 如果未找到单行,则返回默认值

    我有以下 select 语句来获取流的下一个计划项目 如果没有匹配的行 我希望它返回默认值 这是我正在使用的 SQL SELECT file FROM show schedule WHERE channel 1 AND start time
  • Android studio 中的日期和时间(Kotlin 语言)

    我和我的朋友正在 android studio 中使用 Kotlin 开发一个应用程序 我们在应用程序开发方面还很陌生 但我们拥有良好的编程技能 对于我们的功能之一 我们需要获取当前日期和时间 我们尝试了各种导入和方法 但似乎都不适用于低于
  • Html 文件作为 AngularJS 指令中 Bootstrap 弹出窗口中的内容

    我有一个 Angular 指令来处理 Bootstrap 弹出窗口 如下面的代码所示 在我的指令中 我将弹出窗口内容设置为 HTML 字符串 我认为这很难看 我想要做的是使用 template html 文件而不是 HTMLstring 这
  • 浏览工作簿的所有用户表单

    我想编写一个 VBA 程序来打印工作簿中所有用户窗体的名称 例如 如果工作簿有一个名为的用户窗体frmHello 我只想打印UserForm frmHello 有谁知道哪个集合是关于用户表单的 以及如何查找用户表单的名称 这对我有用 Dim
  • 如何从 Rust 访问在 C 中声明的以零结尾的函数指针数组?

    我有以下带有以零结尾的函数指针数组的 C 代码 include
  • 为什么 Rebol 中的“上下文”和“对象”功能不同,但本质上是相同的?

    一方面我们有 gt gt source object object make function Defines a unique object blk block Object words and values make object ap
  • 将列表传递给 RESTful Web 服务

    有没有办法将列表传递给 Jersey 中的 RESTFul Web 服务方法 像 PathParam list 列表列表之类的东西 希望这对您有帮助 Java代码 import java util List Path customers p
  • 如何比较 Serial.read() 中的字符串?

    我在下面有这段代码 是我从哪里得到的这个论坛 http forum arduino cc index php topic 204484 0 html我遵循了这一点 它对我不起作用 但他们声称代码很好 我已经尝试了几种字符串比较方法 例如st
  • 多站点登录 ala Google

    不确定标题是否适合这个问题 但我想不出任何其他方式来表达它 假设您想要创建多个不同的 Web 应用程序 但您希望登录一个应用程序的用户能够直接访问您的其他应用程序而无需重新登录 假设他们也有权查看其他应用程序 如果我没记错的话 如果您登录了
  • 如何将 HTML5“必需”属性添加到 woocommerce_form_field

    我目前正在我的 WordPress 主题中开发 WooCommerce 注册页面 并添加了一个钩子供用户接受条款和条件 请参阅添加的 PHP 代码 HTML5为输入字段提供了一个超级有用的功能 就是在标签中添加 必填 新浏览器会自动提示警告
  • 当 phantomjs 在与 selenium hub 不同的机器上运行时,连接被拒绝

    是否可以在一台机器上有一个selenium集线器 并在另一台计算机上有一个phantomjs实例 以与selenium节点相同的方式连接到集线器 如果我在同一台机器上启动 selenium hub 和 phantomjs 实例 我可以成功运
  • jquery 可以在 iphone 的 safari 上运行吗?

    我正在开发一个网站 我使用 slimbox2 插件 类似于 lightbox 来使用 jquery 来生成照片放大 该插件适用于我尝试过的所有浏览器 除了 iPhone 上的 Safari 它在 Windows 版 Safari 上确实可以
  • 如何选择不运行文档测试?

    我正在编写一个 Rust 库 我想在我的文档中提供示例 编译作为运行的一部分cargo test do not run 这可能吗 我正在编写一个数据库客户端库 这些示例使用了一个假设的 不存在的数据库服务器 因此 这些示例在运行时总是会失败