fix: docsrs builds final (#2235)

* fix

* fix: middleware

* fix: update rustc flags

* docs: add comment

Cargo.toml

@@ -38,6 +38,7 @@ default-members = [
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [package.metadata.playground]

ethers-contract/Cargo.toml

@@ -57,4 +57,5 @@ openssl = ["ethers-contract-abigen/openssl"]
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]

ethers-contract/ethers-contract-abigen/Cargo.toml

@@ -43,6 +43,7 @@ getrandom = { version = "0.2", features = ["js"] }
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [features]

ethers-contract/ethers-contract-derive/Cargo.toml

@@ -30,4 +30,5 @@ eyre = "0.6"
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]

ethers-contract/src/lib.rs

@@ -69,7 +69,8 @@ pub use once_cell::sync::Lazy;
 #[cfg(feature = "eip712")]
 pub use ethers_derive_eip712::*;
 
-// For Abigen expansions in docs.rs builds.
+// For macro expansions only, not public API.
+// See: [#2235](https://github.com/gakonst/ethers-rs/pull/2235)
 
 #[doc(hidden)]
 #[allow(unused_extern_crates)]
@@ -77,23 +78,15 @@ extern crate self as ethers_contract;
 
 #[doc(hidden)]
 #[allow(unused_extern_crates)]
-#[cfg(docsrs)]
 extern crate self as ethers;
 
 #[doc(hidden)]
-#[cfg(docsrs)]
-pub mod core {
-    pub use ethers_core::*;
-}
-
-#[doc(hidden)]
-#[cfg(docsrs)]
 pub mod contract {
     pub use crate::*;
 }
 
 #[doc(hidden)]
-#[cfg(docsrs)]
+pub use ethers_core as core;
-pub mod providers {
+
-    pub use ethers_providers::*;
+#[doc(hidden)]
-}
+pub use ethers_providers as providers;

ethers-core/Cargo.toml

@@ -66,4 +66,5 @@ macros = ["syn", "cargo_metadata", "once_cell"]
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]

ethers-etherscan/Cargo.toml

@@ -42,6 +42,7 @@ tracing-subscriber = { version = "0.3", default-features = false, features = ["e
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [features]

ethers-middleware/Cargo.toml

@@ -12,6 +12,7 @@ keywords = ["ethereum", "web3", "celo", "ethers"]
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [dependencies]

ethers-middleware/src/lib.rs

@@ -40,3 +40,19 @@ pub use timelag::TimeLag;
 /// [`Middleware`](ethers_providers::Middleware) in a concise way
 pub mod builder;
 pub use builder::MiddlewareBuilder;
+
+// For macro expansions only, not public API.
+// See: [#2235](https://github.com/gakonst/ethers-rs/pull/2235)
+
+#[doc(hidden)]
+#[allow(unused_extern_crates)]
+extern crate self as ethers;
+
+#[doc(hidden)]
+pub use ethers_contract as contract;
+
+#[doc(hidden)]
+pub use ethers_core as core;
+
+#[doc(hidden)]
+pub use ethers_providers as providers;

ethers-providers/Cargo.toml

@@ -12,6 +12,7 @@ keywords = ["ethereum", "web3", "celo", "ethers"]
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [dependencies]

ethers-signers/Cargo.toml

@@ -12,6 +12,7 @@ keywords = ["ethereum", "web3", "celo", "ethers"]
 
 [package.metadata.docs.rs]
 all-features = true
+rustc-args = ["--cfg", "docsrs"]
 rustdoc-args = ["--cfg", "docsrs"]
 
 [dependencies]

src/lib.rs

@@ -83,11 +83,6 @@
 #![deny(rustdoc::broken_intra_doc_links)]
 #![doc(test(no_crate_inject, attr(deny(rust_2018_idioms), allow(dead_code, unused_variables))))]
 
-// For macro expansion
-#[doc(hidden)]
-#[allow(unused_extern_crates)]
-extern crate self as ethers;
-
 #[doc(inline)]
 pub use ethers_addressbook as addressbook;
 #[doc(inline)]
@@ -129,3 +124,8 @@ pub mod prelude {
     #[cfg(feature = "ethers-solc")]
     pub use super::solc::*;
 }
+
+// For macro expansions only, not public API.
+#[doc(hidden)]
+#[allow(unused_extern_crates)]
+extern crate self as ethers;