1 unstable release
0.1.0 | Feb 15, 2022 |
---|
#1746 in Rust patterns
15KB
212 lines
user-panic
Custom Panic Messages According to the error.
Handles panics by calling a custom function using
std::panic::set_hook
and a Yaml File to generate the custom structs.
This allows for seperate error messages for seperate error and also allows the user to run some simple fixes (if possible).
Output Example
Example of an API error's panic output
The Program Crashed
Error: There was an error during the API request
It seems like an error that can be fixed by you!
Please follow the following instructions to try and fix the Error
1: Try to check your Internet Connection.
2: Check if your API request quota has been exhausted.
1. Instructions on how
2. to check
3. API quota
If the error still persists
Contact the Developer at xyz@wkl.com
Code Example
To replicate the above output you need to first create a yaml file as follows.
API:
message: There was an error during the API request
fix instructions:
- Try to check your Internet Connection.
- Check if your API request quota has been exhausted.
- - Instructions on how
- to check
- API quota
then you need to create the build script make sure userpanic is present in both dependencies and build dependencies in cargo.toml file
[dependencies]
user-panic = "0.1.0"
[build-dependencies]
user-panic = "0.1.0"
and make build.rs file as follows
fn main() {
println!("cargo:rerun-if-changed=errors.yaml");
println!("cargo:rerun-if-changed=build.rs");
userpanic::panic_setup!("errors.yaml"); // Enter the yaml file path here
}
This will create panic_strucs.rs
file in src directory
This file can be then imported and used with panic_any to display the custom panics
mod panic_structs;
use std::panic::panic_any;
use crate::panic_structs::API;
fn main(){
// This sets the custom hook for panic messages
userpanic::set_hooks(Some("If the error still persists\nContact the developer at xyz@wkl.com"));
// If None is passed then No developer info/message is shown.
panic_any(API);
}
Dependencies
~275KB