如何在doctest中使用自定義模塊？

Question

mod simulation; 

use simulation::factory::FactoryType; 

在main.rs工作正常，但不是在裏面simulation/factory.rs一個文檔測試：

impl product_type::ProductType for FactoryType { 
    /// Lorem Ipsum 
    /// 
    /// # Examples 
    /// 
    /// ``` 
    /// use simulation::factory::FactoryType; 
    /// 
    /// ... 
    /// ``` 
    fn human_id(&self) -> &String { 
     ... 
    } 
} 

cargo test給我的錯誤

---- simulation::factory::human_id_0 stdout ---- 
    <anon>:2:9: 2:19 error: unresolved import `simulation::factory::FactoryType`. Maybe a missing `extern crate simulation`? 
<anon>:2  use simulation::factory::FactoryType; 
       ^~~~~~~~~~ 
error: aborting due to previous error 
thread 'simulation::factory::human_id_0' panicked at 'Box<Any>', /home/rustbuild/src/rust-buildbot/slave/stable-dist-rustc-linux/build/src/libsyntax/diagnostic.rs:192 

我怎樣才能得到文檔測試工作？

Answer 1

當您編寫文檔測試時，您必須充當代碼的用戶。鑑於這些文件：

的src/lib.rs

pub mod simulation { 
    pub mod factory { 
     pub struct FactoryType; 

     impl FactoryType { 
      /// ``` 
      /// use foo::simulation::factory::FactoryType; 
      /// 
      /// let f = FactoryType; 
      /// assert_eq!(42, f.human_id()) 
      /// ``` 
      pub fn human_id(&self) -> u8 { 41 } 
     } 
    } 
} 

的src/main.rs

extern crate foo; 
use foo::simulation::factory::FactoryType; 

fn main() { 
    let f = FactoryType; 
    println!("{}", f.human_id()); 
} 

一切正常。請注意，在main.rs，你必須說extern crate，那麼你所有的引用需要包括箱子名稱。 doctest是一樣的，只有extern crate自動包含給你。

Answer 2

正如huon-dbaupp指出的，bin箱不能從doc測試中導入。

解決方案是將大部分代碼定義爲庫箱，並且只有一個二進制文件，它只是一個shell。

例如，racer採用這種技術。