Struct Watch

pub struct Watch { /* private fields */ }

Watches and re-builds the library upon changes to its source code.

Implementations

impl Watch

pub fn manifest_path(&self) -> &Path

The path to the package’s Cargo.toml.

pub fn src_path(&self) -> &Path

The path to the source directory being watched.

pub fn next(&self) -> Result<Package<'_>, NextError>

Wait for the library to be re-built after some change.

Examples found in repository

examples/demo.rs (line 15)

fn main() {
    let test_crate_path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("test_crate")
        .join("Cargo.toml");
    println!("Begin watching for changes to {:?}", test_crate_path);
    let watch = hotlib::watch(&test_crate_path).unwrap();
    let mut lib = watch.package().build().unwrap().load().unwrap();
    loop {
        unsafe {
            let foo: libloading::Symbol<fn(i32, i32) -> i32> = lib.get(b"foo").unwrap();
            let res = foo(6, 7);
            println!("{}", res);
        }
        println!("Awaiting next change...");
        let pkg = watch.next().unwrap();
        lib = pkg.build().unwrap().load().unwrap();
    }
}

pub fn try_next(&self) -> Result<Option<Package<'_>>, NextError>

The same as next, but returns early if there are no pending events.

pub fn package(&self) -> Package<'_>

Manually retrieve the library’s package immediately without checking for file events.

This is useful for triggering an initial build during model initialisation.

Examples found in repository

examples/demo.rs (line 7)

fn main() {
    let test_crate_path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("test_crate")
        .join("Cargo.toml");
    println!("Begin watching for changes to {:?}", test_crate_path);
    let watch = hotlib::watch(&test_crate_path).unwrap();
    let mut lib = watch.package().build().unwrap().load().unwrap();
    loop {
        unsafe {
            let foo: libloading::Symbol<fn(i32, i32) -> i32> = lib.get(b"foo").unwrap();
            let res = foo(6, 7);
            println!("{}", res);
        }
        println!("Awaiting next change...");
        let pkg = watch.next().unwrap();
        lib = pkg.build().unwrap().load().unwrap();
    }
}