cjschneider2 / bastion

Bastion: Fault-tolerant Runtime for Rust applications

---

Bastion: Fault-tolerant Runtime for Rust applications

The breeze of the cold winter had come. This time of the year, Crashers arrive in the village. These are the giants who can't be evaded. They born to destroy and take people to the Paniks Heights. Suddenly, The developer descried the blurry silhouettes of Crashers from afar.

With cold and cracked voice, he whispered:

It is time to go to Bastion Fort.

---

Latest Release
License
Build Status
Downloads
Gitter

---

Bastion is a Fault-tolerant Runtime for Rust applications. It detect panics during runs of your code and serves a runtime to prevent abrubt exits. Also, it enables you to continue serving in case of a failure. You can select your own recovery scenario, scale your workers and define whole application on top of it.

---

Usage

Bastion comes with a default one-for-one strategy root supervisor. You can use this to launch automatically supervised tasks.

Check root supervisor example in examples.

Examples cover all the use cases in the frame of the crate.

Include bastion to your project with, it requires nightly features to do it's job:

bastion = "*"

In most simple way you can use Bastion like here:

use bastion::bastion::Bastion;
use bastion::spawn::RuntimeSpawn;
use bastion::child::Message;

fn main() {
    Bastion::platform();

    let message = String::from("Some message to be passed");

    Bastion::spawn(
        |_context, msg: Box<dyn Message>| {
            let received_msg = msg.as_any().downcast_ref::<String>().unwrap();

            println!("Received message: {:?}", received_msg);
            println!("root supervisor - spawn_at_root - 1");
        },
        message,
    );

    Bastion::start()
}

Structure of the Runtime

Runtime is structured by the user. Only root supervision comes in batteries-included fashion. Worker code, worker group redundancy, supervisors and their supervision strategies are defined by the user.

You can see overall architecture of the framework here:

License

License is MIT

Documentation

Official documentation is hosted on docs.rs.

Getting Help

Please head to our Gitter or use StackOverflow

Discussion and Development

We use Gitter for development discussions. Also please don't hesitate to open issues on GitHub ask for features, report bugs, comment on design and more! More interaction and more ideas are better!

Contributing to Bastion

All contributions, bug reports, bug fixes, documentation improvements, enhancements and ideas are welcome.

A detailed overview on how to contribute can be found in the CONTRIBUTING guide on GitHub.

Thanks

Thanks to my dear mom (Günnur Bulut) who is an artist with many things to do but spending her efforts without any hesitation on small things that I requested (Like this logo). My shining star.

Also thanks to my friend Berkan Yavrı who came with the idea of making this. Debated over the approaches that I took, spent time on thinking of this project with me.