Use doc_auto_cfg, logo and favicon for docs.rs (#7145)

* Use `doc_auto_cfg` for docs.rs and add logo and icon

* Rustfmt

---------

Co-authored-by: Andrew Lamb <andrew@nerdnetworks.org>

Author: mbrobbel

arrow-arith/Cargo.toml

@@ -30,15 +30,15 @@ rust-version = { workspace = true }
 
 [lib]
 name = "arrow_arith"
-path = "src/lib.rs"
 bench = false
 
+[package.metadata.docs.rs]
+all-features = true
+
 [dependencies]
 arrow-array = { workspace = true }
 arrow-buffer = { workspace = true }
 arrow-data = { workspace = true }
 arrow-schema = { workspace = true }
 chrono = { workspace = true }
 num = { version = "0.4", default-features = false, features = ["std"] }
-
-[dev-dependencies]

arrow-arith/src/lib.rs

@@ -17,6 +17,11 @@
 
 //! Arrow arithmetic and aggregation kernels
 
+#![doc(
+    html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
+    html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
+)]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 #![warn(missing_docs)]
 pub mod aggregate;
 #[doc(hidden)] // Kernels to be removed in a future release

arrow-array/Cargo.toml

@@ -30,10 +30,8 @@ rust-version = { workspace = true }
 
 [lib]
 name = "arrow_array"
-path = "src/lib.rs"
 bench = false
 
-
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 ahash = { version = "0.8", default-features = false, features = ["compile-time-rng"] }
 
@@ -50,6 +48,9 @@ num = { version = "0.4.1", default-features = false, features = ["std"] }
 half = { version = "2.1", default-features = false, features = ["num-traits"] }
 hashbrown = { version = "0.15.1", default-features = false }
 
+[package.metadata.docs.rs]
+all-features = true
+
 [features]
 ffi = ["arrow-schema/ffi", "arrow-data/ffi"]
 force_validate = []
@@ -58,8 +59,6 @@ force_validate = []
 rand = { version = "0.8", default-features = false, features = ["std", "std_rng"] }
 criterion = { version = "0.5", default-features = false }
 
-[build-dependencies]
-
 [[bench]]
 name = "occupancy"
 harness = false

arrow-array/src/lib.rs

@@ -221,6 +221,11 @@
 //! [DataFusion]: https://github.com/apache/arrow-datafusion
 //! [RecordBatchStream]: https://docs.rs/datafusion/latest/datafusion/execution/trait.RecordBatchStream.html
 
+#![doc(
+    html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
+    html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
+)]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 #![deny(rustdoc::broken_intra_doc_links)]
 #![warn(missing_docs)]
 

arrow-avro/Cargo.toml

@@ -30,9 +30,11 @@ rust-version = { workspace = true }
 
 [lib]
 name = "arrow_avro"
-path = "src/lib.rs"
 bench = false
 
+[package.metadata.docs.rs]
+all-features = true
+
 [features]
 default = ["deflate", "snappy", "zstd"]
 deflate = ["flate2"]
@@ -49,7 +51,5 @@ snap = { version = "1.0", default-features = false, optional = true }
 zstd = { version = "0.13", default-features = false, optional = true }
 crc = { version = "3.0", optional = true }
 
-
 [dev-dependencies]
 rand = { version = "0.8", default-features = false, features = ["std", "std_rng"] }
-

arrow-avro/src/lib.rs

@@ -20,6 +20,11 @@
 //! [Apache Arrow]: https://arrow.apache.org
 //! [Apache Avro]: https://avro.apache.org/
 
+#![doc(
+    html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
+    html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
+)]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 #![warn(missing_docs)]
 #![allow(unused)] // Temporary
 

arrow-buffer/Cargo.toml

@@ -30,9 +30,11 @@ rust-version = { workspace = true }
 
 [lib]
 name = "arrow_buffer"
-path = "src/lib.rs"
 bench = false
 
+[package.metadata.docs.rs]
+all-features = true
+
 [dependencies]
 bytes = { version = "1.4" }
 num = { version = "0.4", default-features = false, features = ["std"] }
@@ -42,8 +44,6 @@ half = { version = "2.1", default-features = false }
 criterion = { version = "0.5", default-features = false }
 rand = { version = "0.8", default-features = false, features = ["std", "std_rng"] }
 
-[build-dependencies]
-
 [[bench]]
 name = "bit_mask"
 harness = false

arrow-buffer/src/lib.rs

@@ -17,6 +17,11 @@
 
 //! Low-level buffer abstractions for [Apache Arrow Rust](https://docs.rs/arrow)
 
+#![doc(
+    html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
+    html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
+)]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 // used by [`buffer::mutable::dangling_ptr`]
 #![cfg_attr(miri, feature(strict_provenance))]
 #![warn(missing_docs)]

arrow-cast/Cargo.toml

@@ -30,11 +30,10 @@ rust-version = { workspace = true }
 
 [lib]
 name = "arrow_cast"
-path = "src/lib.rs"
 bench = false
 
 [package.metadata.docs.rs]
-features = ["prettyprint"]
+all-features = true
 
 [features]
 prettyprint = ["comfy-table"]
@@ -60,8 +59,6 @@ criterion = { version = "0.5", default-features = false }
 half = { version = "2.1", default-features = false }
 rand = "0.8"
 
-[build-dependencies]
-
 [[bench]]
 name = "parse_timestamp"
 harness = false

arrow-cast/src/lib.rs

@@ -17,6 +17,11 @@
 
 //! Functions for converting from one data type to another in [Apache Arrow](https://docs.rs/arrow)
 
+#![doc(
+    html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
+    html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
+)]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 #![warn(missing_docs)]
 pub mod cast;
 pub use cast::*;