#file-watcher #events #utility

quadoculars

Concurrent, composable simple file watcher on top of notify-rs with fast live reloading support

6 releases

0.1.40 Mar 25, 2021
0.1.37 Mar 8, 2021

#19 in #file-watcher

Apache-2.0

24KB
474 lines

Quadoculars

Crates.io Rust

Concurrent, composable simple file watcher on top of notify-rs.

Features

  • easy to use single and multiple files watcher
  • only notify when data of the file changes
  • fault tolerant, continue watching even if the file being replaced and gracefully shutdown itself when the file no longer exist.
  • fast live reloading values for DeserializeToOwned stuct.

Installation

Add quadoculars as a dependency in your Cargo.toml:

quadoculars = "*"

or

quadoculars = { git = "https://github.com/Ar37-rs/quadoculars.git" }

Quick Example

use quadoculars::{Fstate, Watch};
use std::{
    io::Result,
    path::{Path, PathBuf},
    str::FromStr,
    sync::mpsc::channel,
};

fn main() -> Result<()> {
    let file: PathBuf;
    {
        match PathBuf::from_str("filename.extention") {
            Ok(file_) => file = file_,
            _ => file = Path::new("otherfilename.otherextension").to_path_buf(),
        }
    }

    let (tx, rx) = channel();

    while let Ok(file_exist) = Watch::new().set_timeout(0.6).single_file(&file,tx.clone()) {
        if !file_exist {
            println!("no file to watch");
            break;
        } else {
            println!("watching... {:?}", file)
        }
        for state in &rx {
            match state {
                Fstate::Changed(file) => {
                    println!("{:?} changed", file);
                    // do something...
                }
                Fstate::NotFound(file) => {
                    // handle something...
                    break;
                }
            }
        }
    }
    Ok(())
}

More Examples

Watching Multiple files and live reloading values can be found here.

Dependencies

~0.7–8MB
~57K SLoC