结合 doctests 和 `extern crate`

编程问答 2022-05-02

问题描述

例如，在 Rust 2018 中，我可以使用 extern self as crate_name，然后使用完全限定的语法

extern crate self as crate_name; //set our crate name
pub struct Member;
fn test() { 
    ::crate_name::Member; //use fully-qualified name
}

但是我似乎无法让它在 doctest 中工作：

/// ```
/// extern crate self as crate_name; //set the crate name
/// pub struct Member;
/// fn test() { 
/// ::crate_name::Member; //use fully-qualified name
/// }
/// ```
fn example() { }

错误[E0425]：在模块Member中找不到值crate_name

我应该提一下，我实际上是在对 procmacro 进行文档测试。也就是说，a) 测试需要包含完全限定的语法，因为 procmacro 扩展到那个，b) 我需要调整测试前奏，以便扩展能够编译。基本上 doctest 应该模拟类型/路径，以便 procmacro 可以工作。

解决方法

这是因为 as described here 如果 2015-08-04T04:05:44 没有出现在 doctest 中，rustdoc 会将测试包装在一个 fn main() 中，所以模拟类型实际上是在这个函数中声明的。

在测试中包含 main 函数会选择退出此功能并允许控制声明类型的位置

main
rustrustdoc