simpleonshutdown

This crate consists of a convenient macro to specify on shutdown callbacks called on_shutdown!. It takes code that should be executed when your program exits (gracefully). See https://docs.rs/simpleonshutdown for more info.

Useful with "runtimes you do not have control over", like for example actix-web framework doesn't let you specify shutdown callbacks by yourself. In such cases my macro may be a better option.

Usage

Recommended

```rust use simpleonshutdown::on_shutdown;

fn main() { // macro can take: direct expression onshutdown!(println!("shut down with success")); // closure expression onshutdown!(|| println!("shut down with success")); // move closure expression onshutdown!(move || println!("shut down with success")); // block onshutdown!({ println!("shut down with success") }); // identifier let identifier = || println!("shut down with success"); on_shutdown!(identifier); }

```

Examples

See "examples/"-dir in repository!.

⚠ Restrictions ⚠

• There is no guarantee that this gets executed in "non-regular" shutdown scenarios, like CTRL+C / SIGINT / SIGTERM
• your application must handle SIGINT/SIGTERM (and other signals) properly to allow a gracefully "non-regular" shutdown (Actix web framework does this for example)
  • i.e. if you don't handle signals CTRL+C will immediately shut down your app
• Even in that case: there is no guarantee in every case that the operating system gives your application more time after it has been (forcefully) killed
• this behaviour differs a little between Windows and UNIX. See example/src/bin/simple_example_ctrl_c_signal for more details.