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 abrupt 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.
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()
}
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 is MIT
Official documentation is hosted on docs.rs.
Please head to our Gitter or use StackOverflow
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!
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 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.