//! Synthetic event type, derived from inputs, triggers actions. //! //! 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. use std::{ collections::HashMap, path::{Path, PathBuf}, }; use crate::signal::Signal; /// An event, as far as watchexec cares about. #[derive(Clone, Debug, Default, Eq, PartialEq)] pub struct Event { pub particulars: Vec, pub metadata: HashMap>, } /// Something which can be used to filter an event. #[derive(Clone, Debug, Eq, PartialEq)] #[non_exhaustive] pub enum Particle { Path(PathBuf), Source(Source), Process(u32), Signal(Signal), } /// The general origin of the event. #[derive(Clone, Copy, Debug, Eq, PartialEq)] #[non_exhaustive] pub enum Source { Filesystem, Keyboard, Mouse, Os, Time, } impl Event { /// Return all paths in the event's particulars. pub fn paths(&self) -> impl Iterator { self.particulars.iter().filter_map(|p| match p { Particle::Path(p) => Some(p.as_path()), _ => None, }) } /// Return all signals in the event's particulars. pub fn signals(&self) -> impl Iterator + '_ { self.particulars.iter().filter_map(|p| match p { Particle::Signal(s) => Some(*s), _ => None, }) } }