12 releases (breaking)

0.9.0 Jun 18, 2024
0.8.0 Jun 22, 2022
0.7.2 Mar 22, 2022
0.7.1 Jul 13, 2021
0.2.0 Nov 23, 2019

#318 in Filesystem

Download history 9168/week @ 2024-10-21 9835/week @ 2024-10-28 12118/week @ 2024-11-04 16945/week @ 2024-11-11 10146/week @ 2024-11-18 7127/week @ 2024-11-25 9661/week @ 2024-12-02 8749/week @ 2024-12-09 8850/week @ 2024-12-16 2661/week @ 2024-12-23 5722/week @ 2024-12-30 8999/week @ 2025-01-06 8542/week @ 2025-01-13 11892/week @ 2025-01-20 11273/week @ 2025-01-27 13856/week @ 2025-02-03

46,352 downloads per month
Used in 5 crates (4 directly)

MIT license

200KB
4.5K SLoC

This crate provides a client to the watchman file watching service.

Start with the Connector struct and use it to connect and return a Client struct, Client::resolve_root to resolve a path and initiate a watch, and then Client::query to perform a query, or Client::subscribe to subscribe to file changes in real time.

This example shows how to connect and expand a glob from the current working directory:

use watchman_client::prelude::*;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = Connector::new().connect().await?;
    let resolved = client
        .resolve_root(CanonicalPath::canonicalize(".")?)
        .await?;

    // Basic globs -> names
    let files = client.glob(&resolved, &["**/*.rs"]).await?;
    println!("files: {:#?}", files);
    Ok(())
}

Dependencies

~4–11MB
~109K SLoC