3 releases

0.2.2 Jan 11, 2022
0.2.1 Oct 19, 2021
0.2.0 Oct 17, 2021

#4 in #availability

Download history 456/week @ 2024-06-15 608/week @ 2024-06-22 329/week @ 2024-06-29 503/week @ 2024-07-06 316/week @ 2024-07-13 424/week @ 2024-07-20 303/week @ 2024-07-27 234/week @ 2024-08-03 295/week @ 2024-08-10 238/week @ 2024-08-17 337/week @ 2024-08-24 201/week @ 2024-08-31 259/week @ 2024-09-07 249/week @ 2024-09-14 217/week @ 2024-09-21 231/week @ 2024-09-28

998 downloads per month
Used in bodo_connect

MPL-2.0 license

58KB
943 lines

reachable

Rust crate to check if a "Target" is available. The crate comes with the trait "Target" and ICMP/TCP based implementations of it. Additionally, the crate offers an async task executor to perform availability checks of "Targets" on a regular basis.

Usage

With this crate you can easily check if a computer is currently reachable over the network. Since all targets are implementations of trait "Target" the availability check behavior is customizable. For example, it is easy to implement a custom Target to check if a Process is running or not.

Example (from examples/usage/src/main.rs)

use std::str::FromStr;

use reachable::*;

fn main() {
    // Construct ICMP Target check if the target is availabile
    let icmp_target = IcmpTarget::from_str("www.google.de").unwrap();
    match icmp_target.check_availability() {
        Ok(status) => println!("{} is {}", icmp_target.get_id(), status),
        Err(error) => println!("Check failed for {} reason {}", icmp_target.get_id(), error),
    }
}

Async Example (from examples/async_usage/src/main.rs)

use std::str::FromStr;
use std::thread::sleep;
use std::time::Duration;

use reachable::*;

fn main() {
    // Setup AsyncTargets
    let icmp_target = IcmpTarget::from_str("www.google.de").unwrap();
    let tcp_target = TcpTarget::from_str("www.google.de:80").unwrap();

    let handler = |target: &dyn Target, status, old_status, error| {
        print!("Target \"{}\"", target.get_id());
        print!(", old status \"{}\"", old_status);
        print!(", new status \"{}\"", status);
        match error {
            None => println!(""),
            Some(err) => println!(", Error: \"{}\"", err),
        }
    };

    // Spawn Async execution
    let mut exec = AsyncTargetExecutor::new();
    exec.start(vec![
        AsyncTarget::from((icmp_target, handler, Duration::from_secs(1))),
        AsyncTarget::from((tcp_target, handler, Duration::from_secs(1))),
    ]);
    sleep(Duration::from_secs(3));
    exec.stop();
}

Dependencies

~0.3–6MB
~31K SLoC