How to write documentation tests for an internal API?

狂风中的少年 提交于 2020-01-21 09:04:47

问题


I'm writing a library which contains private structs and methods:

/// Constructs a new `Object`
///
/// Internal API
///
/// # Example
/// ```rust
/// use lib::object::Object;
///
/// let tn = Object::new();
/// ```

When I run cargo test, the doctest fails because Object is a private struct.

Is it possible to make it compile and run?


回答1:


I don't think it is possible if you want the test to compile and run, see this related question.

I you only want to include the code as a sample in the documentation, without trying to compile and run it, you can exclude it from the tests by adding the ignore flag:

/// ```rust,ignore
/// use lib::object::Object;
///
/// let tn = Object::new();
/// ```


来源:https://stackoverflow.com/questions/47698062/how-to-write-documentation-tests-for-an-internal-api

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!