shear

Signed-off-by: Robert Kruszewski <github@robertk.io>

Author: robert3005

CONTRIBUTING.md

@@ -82,6 +82,20 @@ Read the [Rust version compatibility policy](README.md#rust-version-compatibilit
 changing `rust-version`; when the MSRV job fails, the usual fix is in the code or the dependency
 update, not the MSRV.
 
+### Pruning Rust dependencies
+
+Use [cargo-shear](https://github.com/Boshen/cargo-shear) to find unused dependencies. Install it
+and inspect the workspace from the repository root:
+
+```bash
+cargo install --locked cargo-shear
+cargo shear
+```
+
+Run `cargo shear --fix` to apply suggested fixes, then review the manifest changes. Dependencies
+used only by generated code or to enable transitive features may need an entry in the affected
+crate's `[package.metadata.cargo-shear]` `ignored` list, with a comment explaining why.
+
 ### Python bindings
 
 `vortex-data` is a mixed Python and Rust package. `uv` manages its Python environment, and

encodings/fsst/Cargo.toml

@@ -56,5 +56,5 @@ name = "chunked_dict_fsst_builder"
 harness = false
 required-features = ["_test-harness"]
 
-[package.metadata.cargo-machete]
+[package.metadata.cargo-shear]
 ignored = ["fsst-rs"]

vortex-array/Cargo.toml

@@ -19,10 +19,6 @@ all-features = true
 # Referenced only by the generated Protocol Buffers bindings.
 ignored = ["prost-types"]
 
-[package.metadata.cargo-machete]
-# Referenced only by the generated Protocol Buffers bindings.
-ignored = ["prost-types"]
-
 [lints]
 workspace = true
 

vortex-cuda/cub/Cargo.toml

@@ -17,9 +17,6 @@ version = { workspace = true }
 publish = false
 
 [package.metadata.cargo-shear]
-ignored = ["libloading"]
-
-[package.metadata.cargo-machete]
 # Referenced only by bindgen's generated dynamic library loader.
 ignored = ["libloading"]
 

vortex-cuda/nvcomp/Cargo.toml

@@ -14,9 +14,6 @@ version = { workspace = true }
 publish = false
 
 [package.metadata.cargo-shear]
-ignored = ["libloading"]
-
-[package.metadata.cargo-machete]
 # Referenced only by bindgen's generated dynamic library loader.
 ignored = ["libloading"]
 

vortex-layout/Cargo.toml

@@ -93,5 +93,5 @@ harness = false
 [lints]
 workspace = true
 
-[package.metadata.cargo-machete]
+[package.metadata.cargo-shear]
 ignored = ["uuid"]