Discovered that doctests can actually run, tested all feature combinations with cargo hack test --feature-powerset, edited some testing documentation

Author: Andrew J Westlake

Cargo.toml

@@ -47,7 +47,7 @@ required-features = ["attributes", "tokio-runtime"]
 name = "test_async_std_asyncio"
 path = "pytests/test_async_std_asyncio.rs"
 harness = false
-required-features = ["async-std-runtime", "testing"]
+required-features = ["async-std-runtime", "testing", "attributes"]
 
 [[test]]
 name = "test_async_std_run_forever"
@@ -59,7 +59,7 @@ required-features = ["async-std-runtime", "testing"]
 name = "test_tokio_current_thread_asyncio"
 path = "pytests/test_tokio_current_thread_asyncio.rs"
 harness = false
-required-features = ["tokio-runtime", "testing"]
+required-features = ["tokio-runtime", "testing", "attributes"]
 
 [[test]]
 name = "test_tokio_current_thread_run_forever"
@@ -71,7 +71,7 @@ required-features = ["tokio-runtime", "testing"]
 name = "test_tokio_multi_thread_asyncio"
 path = "pytests/test_tokio_multi_thread_asyncio.rs"
 harness = false
-required-features = ["tokio-runtime", "testing"]
+required-features = ["tokio-runtime", "testing", "attributes"]
 
 [[test]]
 name = "test_tokio_multi_thread_run_forever"

Makefile

@@ -14,5 +14,9 @@ lint: fmt clippy
 test: lint
 	cargo test --all-features
 
-publish: test
+test-feature-powerset:
+	cargo install cargo-hack
+	cargo hack test --feature-powerset	
+
+publish: test-feature-powerset
 	cargo publish

README.md

@@ -28,7 +28,7 @@ Here we initialize the runtime, import Python's `asyncio` library and run the gi
 
 More details on the usage of this library can be found in the [API docs](https://awestlake87.github.io/pyo3-asyncio/master/doc).
 
-```rust no_run
+```rust
 use pyo3::prelude::*;
 
 #[pyo3_asyncio::async_std::main]

src/async_std.rs

@@ -51,7 +51,7 @@ impl Runtime for AsyncStdRuntime {
 ///
 /// # Examples
 ///
-/// ```no_run
+/// ```
 /// # use std::time::Duration;
 /// #
 /// # use pyo3::prelude::*;
@@ -85,7 +85,7 @@ where
 ///
 /// # Examples
 ///
-/// ```no_run
+/// ```
 /// use std::time::Duration;
 ///
 /// use pyo3::prelude::*;

src/generic.rs

@@ -77,6 +77,7 @@ pub trait Runtime {
 /// #
 /// # Python::with_gil(|py| {
 /// # pyo3_asyncio::with_runtime(py, || {
+/// # #[cfg(feature = "tokio-runtime")]
 /// pyo3_asyncio::generic::run_until_complete::<MyCustomRuntime, _>(py, async move {
 ///     tokio::time::sleep(Duration::from_secs(1)).await;
 ///     Ok(())

src/lib.rs

@@ -115,19 +115,22 @@ use pyo3::{exceptions::PyKeyboardInterrupt, prelude::*, PyNativeType};
 /// Test README
 #[doc(hidden)]
 pub mod doc_test {
+    #[allow(unused)]
     macro_rules! doc_comment {
         ($x:expr, $module:item) => {
             #[doc = $x]
             $module
         };
     }
 
+    #[allow(unused)]
     macro_rules! doctest {
         ($x:expr, $y:ident) => {
             doc_comment!(include_str!($x), mod $y {});
         };
     }
 
+    #[cfg(feature = "async-std-runtime attributes")]
     doctest!("../README.md", readme_md);
 }
 
@@ -151,7 +154,7 @@ static CREATE_FUTURE: OnceCell<PyObject> = OnceCell::new();
 ///
 /// # Examples
 ///
-/// ```no_run
+/// ```
 /// use pyo3::prelude::*;
 ///
 /// fn main() {
@@ -225,12 +228,13 @@ pub fn get_event_loop(py: Python) -> &PyAny {
 ///
 /// # Examples
 ///
-/// ```no_run
+/// ```
 /// # use std::time::Duration;
 /// # use pyo3::prelude::*;
 /// # Python::with_gil(|py| {
 /// # pyo3_asyncio::with_runtime(py, || {
 /// // Wait 1 second, then stop the event loop
+/// # #[cfg(feature = "async-std-runtime")]
 /// async_std::task::spawn(async move {
 ///     async_std::task::sleep(Duration::from_secs(1)).await;
 ///     Python::with_gil(|py| {
@@ -250,6 +254,7 @@ pub fn get_event_loop(py: Python) -> &PyAny {
 /// });        
 ///
 /// // block until stop is called
+/// # #[cfg(feature = "async-std-runtime")]
 /// pyo3_asyncio::run_forever(py)?;
 /// # Ok(())
 /// # })
@@ -324,7 +329,7 @@ impl PyTaskCompleter {
 ///
 /// # Examples
 ///
-/// ```no_run
+/// ```
 /// use std::time::Duration;
 ///
 /// use pyo3::prelude::*;
@@ -398,10 +403,10 @@ fn dump_err(py: Python<'_>) -> impl FnOnce(PyErr) + '_ {
 
 /// Alias crate as pyo3_asyncio for test_structs! macro expansion
 #[cfg(test)]
-#[cfg(feature = "testing")]
+#[cfg(feature = "testing attributes")]
 use crate as pyo3_asyncio;
 
 // Expand test structs in crate root to allow lib tests to be compile-checked (but not ran)
 #[cfg(test)]
-#[cfg(feature = "testing")]
+#[cfg(feature = "testing attributes")]
 testing::test_structs!();