build: Doc test README using macro

Author: tesuji

README.md

@@ -60,10 +60,7 @@ pyo3 = "0.7"
 numpy = "0.6.0"
 ```
 
-``` rust
-extern crate numpy;
-extern crate pyo3;
-
+```rust
 use numpy::{PyArray1, get_array_module};
 use pyo3::prelude::{ObjectProtocol, PyResult, Python};
 use pyo3::types::PyDict;
@@ -110,10 +107,6 @@ features = ["extension-module"]
 ```
 
 ```rust
-extern crate ndarray;
-extern crate numpy;
-extern crate pyo3;
-
 use ndarray::{ArrayD, ArrayViewD, ArrayViewMutD};
 use numpy::{IntoPyArray, PyArrayDyn};
 use pyo3::prelude::{pymodule, Py, PyModule, PyResult, Python};

appveyor.yml

@@ -23,5 +23,4 @@ build_script:
 
 test_script:
   - cargo test --verbose --features %FEATURES% -- --test-threads=1
-  - rustdoc --test README.md -L native="%PYTHON%\\libs" -L target/debug/deps/
   - cd examples/simple-extension && python setup.py install && python setup.py test

ci/travis/test.sh

@@ -4,7 +4,6 @@ set -ex
 
 cargo build --verbose --features $FEATURES
 cargo test --verbose --features $FEATURES -- --test-threads=1
-rustdoc -L target/debug/deps/ --test README.md
 
 for example in examples/*; do
     if [ $example != 'examples/linalg' ]; then

src/lib.rs

@@ -52,3 +52,20 @@ pub use crate::error::{ArrayShape, ErrorKind, IntoPyErr, IntoPyResult};
 pub use crate::npyffi::{PY_ARRAY_API, PY_UFUNC_API};
 pub use crate::types::{c32, c64, NpyDataType, TypeNum};
 pub use ndarray::{Ix1, Ix2, Ix3, Ix4, Ix5, Ix6, IxDyn};
+
+/// Test readme
+#[doc(hidden)]
+pub mod doc_test {
+    macro_rules! doc_comment {
+        ($x:expr, $($tt:tt)*) => {
+            #[doc = $x]
+            $($tt)*
+        };
+    }
+    macro_rules! doctest {
+        ($x: literal, $y:ident) => {
+            doc_comment!(include_str!($x), mod $y {});
+        };
+    }
+    doctest!("../README.md", readme_md);
+}