4 stable releases (3 major)

4.0.0 Oct 14, 2024
3.0.0 Apr 20, 2024
2.0.1 Nov 29, 2023
1.1.0 Nov 26, 2023
1.0.0 Mar 18, 2023

#516 in Parser implementations

Download history 9812/week @ 2024-08-14 8892/week @ 2024-08-21 8213/week @ 2024-08-28 10085/week @ 2024-09-04 8503/week @ 2024-09-11 9126/week @ 2024-09-18 11595/week @ 2024-09-25 8560/week @ 2024-10-02 6384/week @ 2024-10-09 8165/week @ 2024-10-16 7411/week @ 2024-10-23 8626/week @ 2024-10-30 10331/week @ 2024-11-06 9820/week @ 2024-11-13 9162/week @ 2024-11-20 6920/week @ 2024-11-27

37,594 downloads per month
Used in 30 crates (9 directly)

Apache-2.0 OR MIT

54KB
988 lines

watchexec-events

Watchexec's event types.

Fundamentally, events in watchexec have three purposes:

  1. To trigger the launch, restart, or other interruption of a process;
  2. To be filtered upon according to whatever set of criteria is desired;
  3. To carry information about what caused the event, which may be provided to the process.

Outside of Watchexec, this library is particularly useful if you're building a tool that runs under it, and want to easily read its events (with --emit-events-to=json-file and --emit-events-to=json-stdio).

use std::io::{stdin, Result};
use watchexec_events::Event;

fn main() -> Result<()> {
    for line in stdin().lines() {
        let event: Event = serde_json::from_str(&line?)?;
        dbg!(event);
    }

    Ok(())
}

Features

  • serde: enables serde support.
  • notify: use Notify's file event types (default).

If you disable notify, you'll get a leaner dependency tree that's still able to parse the entire events, but isn't type compatible with Notify. In most deserialisation usecases, this is fine, but it's not the default to avoid surprises.

Dependencies

~2–13MB
~96K SLoC