Struct watchexec::Watchexec

pub struct Watchexec { /* private fields */ }

The main watchexec runtime.

All this really does is tie the pieces together in one convenient interface.

It creates the correct channels, spawns every available event sources, the action worker, the error hook, and provides an interface to change the runtime configuration during the runtime, inject synthetic events, and wait for graceful shutdown.

Implementations

impl Watchexec

pub fn new(
    init: InitConfig,
    runtime: RuntimeConfig
) -> Result<Arc<Self>, CriticalError>

Instantiates a new Watchexec runtime from configuration.

Returns an Arc for convenience; use try_unwrap to get the value directly if needed.

pub fn reconfigure(&self, config: RuntimeConfig) -> Result<(), ReconfigError>

Applies a new RuntimeConfig to the runtime.

pub async fn send_event(&self, event: Event) -> Result<(), CriticalError>

Inputs an Event directly.

This can be useful for testing, for custom event sources, or for one-off action triggers (for example, on start).

Hint: use Event::default() to send an empty event (which won’t be filtered).

pub fn main(&self) -> JoinHandle<Result<(), CriticalError>>

Start watchexec and obtain the handle to its main task.

This must only be called once.

Panics

Panics if called twice.

Trait Implementations

impl Debug for Watchexec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.