# traceback-error

traceback-error is a Rust crate for efficient error handling and traceback functionality. It simplifies error tracking, serialization, and handling in your Rust projects, making it easier to manage and diagnose errors.

## Features

Efficient Error Handling: traceback-error provides a structured way to handle errors, allowing you to track and manage them effectively.

Traceback Functionality: Easily create error traces that include detailed information about the error, its location, and any relevant context.

Serialization: Serialize errors to JSON for storage or debugging purposes.

## Installation

Add this crate to your Cargo.toml:

```toml
[dependencies]
traceback-error = "0.1.9"
```

## Usage

```rust
use traceback_error::{serde_json::json, traceback, TracebackError};

fn main() {
    // Should an error occur, handle it
    if let Err(e) = do_something_that_might_fail() {
        // Handle the error here
        // You can also log or serialize it
        println!("Error: {}", e);
        // Or continue tracing
        traceback!(err e, "The thing that might fail failed");
    }
}

fn do_something_that_might_fail() -> Result<(), TracebackError> {
    // Your code here
    // Use the traceback! macro to create and handle errors
    Err(traceback!("Something went wrong").with_extra_data(json!({
        "details": "Additional information about the error"
    })))
}
```

## Documentation

Documentation is available at [docs.rs](https://docs.rs/traceback-error/latest/traceback_error/)

## Contributing

Contributions are welcome! Feel free to open issues or pull requests on the GitHub repository.
This project is still in very early development, and proper contribution guidelines have not yet been established

## License

This crate is dual-licensed under the [MIT License](LICENSE-MIT) and the [Apache License, Version 2.0](LICENSE-APACHE). You may choose either of these licenses when using this crate. See the [LICENSE-MIT](LICENSE-MIT) and [LICENSE-APACHE](LICENSE-APACHE) files for the full text of the licenses.