Crates.io | bevy_anyhow_alert |
lib.rs | bevy_anyhow_alert |
version | 0.2.0 |
source | src |
created_at | 2024-07-01 11:03:05.218333 |
updated_at | 2024-07-15 19:21:07.641695 |
description | Easy system error handling with Bevy; let your systems return `Result`! |
homepage | |
repository | https://github.com/snendev-labs/bevy_anyhow_alert |
max_upload_size | |
id | 1288660 |
size | 391,162 |
This crate offers an extension trait for systems that helps with system- and application-level error management in Bevy. Mildly configurable using the re-export of bevy_ui_mod_alerts
. The main benefit: your systems can return Result
(or even Result<T, Vec<E>>
)!
When writing your systems, return one of the two accepted types:
Result<T, E>
bevy_anyhow_alert::ResultVec<T, E>
: an alias for Result<T, Vec<Error>>
Then call my_system.anyhow_alert()
or my_system.anyhow_alerts
! When the result is Err
, you'll see toast UI elements show up (assuming there is a camera).
let mut app = App::new();
// ...
app.add_system(fire_error.anyhow_alert());
// ..
app.run();
Feel free to define whatever types of errors your want throughout your application. They must implement Debug
and Display
, which is especially easy if you derive thiserror::Error
on your Error type.
#[derive(Debug, Error)]
#[error("testing!")]
pub struct MyError;
fn fire_error(inputs: Res<ButtonInput<KeyCode>>) -> anyhow::Result<()> {
if inputs.just_pressed(KeyCode::Space) {
Err(anyhow::Error::new(MyError))
} else {
Ok(())
}
}