workspace-filter

Crates.ioworkspace-filter
lib.rsworkspace-filter
version0.1.0
created_at2025-08-14 21:28:52.622309+00
updated_at2025-08-14 21:28:52.622309+00
descriptionSimple framework to compile env filters for all packages in a workspace
homepage
repositoryhttps://github.com/ozwaldorf/workspace-filter
max_upload_size
id1795831
size5,085
(ozwaldorf)

documentation

README

Workspace Filter

Simple framework to compile env filters for all packages in a workspace.

Setup

First, add the two dependencies to your crate:

[dependencies]
workspace-filter = "0.1"

[build-dependencies]
workspace-filter-build = "0.1"

Then, call the build function in your build.rs file:

fn main() -> Result<(), Box<dyn std::error::Error> {
    // NOTE: This will rerun the entire build script if Cargo.lock changes
    workspace_filter_build::build()?;
}

The macro can then be used in your crate, with a few example use-cases shown below:

Simple Usage

If you only care to set the filter for your workspace dependencies:

let filter = workspace_filter!("debug");
let env_filter = EnvFilter::builder().parse_lossy(filter);

Manual filters can be included, for example to make workspace crates at debug and everything else at info:

let filter = workspace_filter!("debug", "info");
let env_filter = EnvFilter::builder().parse_lossy(filter);

In the catchall argument, {level} can be also used anywhere to substitute the given workspace level.

let filter = workspace_filter!("debug", "trace,my-bin={level}");
let env_filter = EnvFilter::builder().parse_lossy(filter);

Verbosity level Example

Example that overrides with RUST_LOG, or falls back to increasing the verbosity for the workspace and other deps depending on a given number

let filter = std::env::var("RUST_LOG").unwrap_or_else(|_| {
    // Fallback which is directed by the verbosity flag
    match args.verbose {
        0 => "info".into(),
        1 => workspace_filter!("debug", "info"),
        2 => workspace_filter!("trace", "info"),
        3 => workspace_filter!("trace", "debug"),
        _ => "trace".into(),
    }
});
let env_filter = EnvFilter::builder().parse_lossy(filter);
Commit count: 0

cargo fmt