15 releases

0.5.2 Apr 13, 2022
0.5.1 Jan 6, 2022
0.5.0 Dec 13, 2021
0.4.5 Jan 22, 2021
0.2.0 Sep 10, 2018

#12 in #service

Download history 49/week @ 2022-06-10 111/week @ 2022-06-17 17/week @ 2022-06-24 31/week @ 2022-07-01 33/week @ 2022-07-08 19/week @ 2022-07-15 85/week @ 2022-07-22 46/week @ 2022-07-29 49/week @ 2022-08-05 61/week @ 2022-08-12 73/week @ 2022-08-19 60/week @ 2022-08-26 95/week @ 2022-09-02 120/week @ 2022-09-09 115/week @ 2022-09-16 59/week @ 2022-09-23

414 downloads per month

MIT/Apache

49KB
1K SLoC

ceviche-rs

Cargo Documentation Build Status Build Status Appveyor

Service/daemon wrapper. Supports Windows and macOS.


lib.rs:

ceviche is a wrapper to write a service/daemon.

At the moment only Windows services are supported. The Service macro is inspired from the winservice crate.

A service implements a service main function and is generated by invoking the Service! macro. The events are sent to the service over the rx channel.

 enum CustomServiceEvent {}

fn my_service_main(
    rx: mpsc::Receiver<ServiceEvent<CustomServiceEvent>>,
    _tx: mpsc::Sender<ServiceEvent<CustomServiceEvent>>,
    args: Vec<String>,
    standalone_mode: bool) -> u32 {
   loop {
       if let Ok(control_code) = rx.recv() {
           match control_code {
               ServiceEvent::Stop => break,
               _ => (),
           }
       }
   }
   0
}

Service!("Foobar", my_service_main);

The Controller is a helper to create, remove, start or stop the service on the system. ceviche also supports a standalone mode were the service code runs as a normal executable which can be useful for development and debugging.

static SERVICE_NAME: &'static str = "foobar";
static DISPLAY_NAME: &'static str = "FooBar Service";
static DESCRIPTION: &'static str = "This is the FooBar service";

fn main() {
    let yaml = load_yaml!("cli.yml");
    let app = App::from_yaml(yaml);
    let matches = app.version(crate_version!()).get_matches();
    let cmd = matches.value_of("cmd").unwrap_or("").to_string();

    let mut controller = Controller::new(SERVICE_NAME, DISPLAY_NAME, DESCRIPTION);

    match cmd.as_str() {
        "create" => controller.create(),
        "delete" => controller.delete(),
        "start" => controller.start(),
        "stop" => controller.stop(),
        "standalone" => {
            let (tx, rx) = mpsc::channel();

            ctrlc::set_handler(move || {
                let _ = tx.send(ServiceEvent::Stop);
            }).expect("Failed to register Ctrl-C handler");

            my_service_main(rx, vec![], true);
        }
        _ => {
            let _result = controller.register(service_main_wrapper);
        }
    }
}

Dependencies

~74–770KB
~14K SLoC