Allow configuring of the i_overlay dep, Rayon transitive dep, and d…

…ocument more features.

.github/workflows/test.yml

@@ -116,7 +116,7 @@ jobs:
         uses: actions/checkout@v3
       - run: cargo check --all-targets --no-default-features
       # we don't want to test `proj-network` because it only enables the `proj` feature
-      - run: cargo test --features "use-proj use-serde"
+      - run: cargo test --features "use-proj use-serde i_overlay earcutr multithreading"
 
   geo_traits:
     name: geo-traits

geo/Cargo.toml

@@ -13,10 +13,11 @@ rust-version = "1.75"
 categories = ["science::geo"]
 
 [features]
-default = ["earcutr", "spade"]
+default = ["earcutr", "spade", "i_overlay", "multithreading"]
 use-proj = ["proj"]
 proj-network = ["use-proj", "proj/network"]
 use-serde = ["serde", "geo-types/serde"]
+multithreading = ["i_overlay/allow_multithreading"]
 
 [dependencies]
 earcutr = { version = "0.4.2", optional = true }
@@ -30,7 +31,7 @@ proj = { version = "0.27.0", optional = true }
 robust = "1.1.0"
 rstar = "0.12.0"
 serde = { version = "1.0", optional = true, features = ["derive"] }
-i_overlay = "1.7.2"
+i_overlay = { version = "1.7.2", optional = true }
 
 [dev-dependencies]
 approx = ">= 0.4.0, < 0.6.0"

geo/src/algorithm/bool_ops/mod.rs

@@ -8,6 +8,8 @@ use crate::geometry::{LineString, MultiLineString, MultiPolygon, Polygon};
 
 /// Boolean Operations on geometry.
 ///
+/// Requires the `"i_overlay"` feature, which is enabled by default.
+///
 /// Boolean operations are set operations on geometries considered as a subset
 /// of the 2-D plane. The operations supported are: intersection, union, xor or
 /// symmetric difference, and set-difference on pairs of 2-D geometries and

geo/src/algorithm/mod.rs

@@ -6,8 +6,12 @@ pub use kernels::{Kernel, Orientation};
 pub mod area;
 pub use area::Area;
 
-/// Boolean Ops such as union, xor, difference;
+/// Boolean Ops such as union, xor, difference.
+///
+/// Requires the `"i_overlay"` feature, which is enabled by default.
+#[cfg(feature = "i_overlay")]
 pub mod bool_ops;
+#[cfg(feature = "i_overlay")]
 pub use bool_ops::{BooleanOps, OpType};
 
 /// Calculate the bounding rectangle of a `Geometry`.
@@ -254,6 +258,8 @@ pub mod translate;
 pub use translate::Translate;
 
 /// Triangulate polygons using an [ear-cutting algorithm](https://www.geometrictools.com/Documentation/TriangulationByEarClipping.pdf).
+///
+/// Requires the `"earcutr"` feature.
 #[cfg(feature = "earcutr")]
 pub mod triangulate_earcut;
 #[cfg(feature = "earcutr")]

geo/src/algorithm/triangulate_earcut.rs

@@ -1,6 +1,8 @@
 use crate::{coord, CoordFloat, CoordsIter, Polygon, Triangle};
 
 /// Triangulate polygons using an [ear-cutting algorithm](https://www.geometrictools.com/Documentation/TriangulationByEarClipping.pdf).
+///
+/// Requires the `"earcutr"` feature, which is enabled by default.
 pub trait TriangulateEarcut<T: CoordFloat> {
     /// # Examples
     ///

geo/src/lib.rs

@@ -67,7 +67,7 @@
 //!
 //! ## Boolean Operations
 //!
-//! - **[`BooleanOps`]**: combine or split (Multi)Polygons using intersecton, union, xor, or difference operations
+//! - **[`BooleanOps`]**: combine or split (Multi)Polygons using intersecton, union, xor, or difference operations. Requires the `"i_overlay"` feature, which is enabled by default.
 //!
 //! ## Outlier Detection
 //!
@@ -112,7 +112,7 @@
 //!
 //! ## Triangulation
 //!
-//! - **[`TriangulateEarcut`](triangulate_earcut)**: Triangulate polygons using the earcut algorithm (requires the `earcutr` feature).
+//! - **[`TriangulateEarcut`](triangulate_earcut)**: Triangulate polygons using the earcut algorithm. Requires the `"earcutr"` feature, which is enabled by default.
 //!
 //! ## Winding
 //!
@@ -177,9 +177,25 @@
 //!
 //! The following optional [Cargo features] are available:
 //!
-//! - `proj-network`: Enables [network grid] support for the [`proj` crate]. After enabling this feature, [further configuration][proj crate file download] is required to use the network grid
-//! - `use-proj`: Enables coordinate conversion and transformation of `Point` geometries using the [`proj` crate]
-//! - `use-serde`: Allows geometry types to be serialized and deserialized with [Serde]
+//! - `i_overlay`:
+//!     - Enables the `i_overlay` crate, which provides boolean operations on geometries.
+//!     - ☑ Enabled by default.
+//! - `earcutr`:
+//!     - Enables the `earcutr` crate, which provides triangulation of polygons using the earcut algorithm.
+//!     - ☑ Enabled by default.
+//! - `proj-network`:
+//!     - Enables [network grid] support for the [`proj` crate].
+//!     - After enabling this feature, [further configuration][proj crate file download] is required to use the network grid.
+//!     - ☐ Disabled by default.
+//! - `use-proj`:
+//!     - Enables coordinate conversion and transformation of `Point` geometries using the [`proj` crate]
+//!     - ☐ Disabled by default.
+//! - `use-serde`:
+//!     - Allows geometry types to be serialized and deserialized with [Serde].
+//!     - ☐ Disabled by default.
+//! - `multithreading`:
+//!     - Enables multithreading support for the `i_overlay` crate.
+//!     - ☑ Enabled by default.
 //!
 //! # Ecosystem
 //!