mabe 1.4.0

A simple framework for creating debug-friendly error enums in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

<p align="center">
  <h1 align="center">Mabe</h1>
  <p align="center">Contributions, corrections, and requests can be made through GitHub, and the documentation is available on the platforms linked bellow.</p>
  <p align="center">Thank you for your interest in the project, enjoy your reading! 🚀</p>
</p>

<p align="center">
  <a href="https://github.com/AmonRayfa/mabe"><img alt="GitHub: created in" src="https://img.shields.io/github/created-at/AmonRayfa/mabe?logo=github&label=created%20in&color=red"/></a>
  <a href="https://github.com/AmonRayfa/mabe"><img alt="GitHub: last commit" src="https://img.shields.io/github/last-commit/AmonRayfa/mabe?display_timestamp=committer&logo=github&color=yellow"/></a>
  <a href="https://github.com/AmonRayfa/mabe"><img alt="GitHub: milestones" src="https://img.shields.io/github/milestones/all/AmonRayfa/mabe?logo=github&color=blue"/></a>
  <a href="https://github.com/AmonRayfa/mabe"><img alt="GitHub: CI/CD" src="https://img.shields.io/github/actions/workflow/status/AmonRayfa/mabe/ci-cd.yaml?branch=main&logo=github&label=CI%2FCD"/></a>
  <br/>
  <a href="https://crates.io/crates/mabe"><img alt="Crates.io: size" src="https://img.shields.io/crates/size/mabe?logo=rust&logoColor=black&color=black"/></a>
  <a href="https://crates.io/crates/mabe"><img alt="Crates.io: dependents" src="https://img.shields.io/crates/dependents/mabe?logo=rust&logoColor=black&color=black"/></a>
</p>

## WARNING

This crate is not published on [crates.io](https://crates.io) anymore. If you want the latest version of this crate, go to [GitHub](https://github.com/AmonRayfa/mabe).

## Introduction

**Mabe** is a simple framework for creating debug-friendly error enums in Rust. Each variant in the enum can encapsulate an error and a debug message, and errors are presented in a structured format, displaying the messages defined for the variant. This allows for a more detailed and clear debugging process.

## Getting Started

In order to use **Mabe** in your project, you need to add it as a dependency in your `Cargo.toml` file:

```toml
[dependencies]
mabe = "1"
```

You can now use the [`Mabe`](https://docs.rs/mabe/latest/mabe/derive.Mabe.html) derive macro and its attributes to create your own error enums by following the examples below.

## Examples

Here is a simple example of how to create a debug-friendly error enum:

```rust
use mabe::Mabe;

#[derive(Mabe)]
pub enum ServerError {
    #[error("You are not authorized to access this resource.")]
    #[debug("Try using a different account.")]
    Unauthorized,
}

let error = ServerError::Unauthorized;
println!("{}", error);
```

```plaintext
Output:
[error] You are not authorized to access this resource.
[debug] Try using a different account.
```

You can also interpolate the values of variant fields in the error and debug messages as shown below:

```rust
use mabe::Mabe;

#[derive(Mabe)]
pub enum ServerError {
    // Interpolates the values of the 1st and 2nd field in the error message.
    #[error("Network failure. --> Code {0}: {1}.")]
    NetworkFailure(u32, String),

    // Interpolates the value of the `cause` field in the error message.
    #[error("Connection lost. --> {cause}.")]
    // Interpolates the value of the `retry_in` field in the debug message.
    #[debug("Retry in {retry_in} seconds.")]
    ConnectionLost { cause: String, retry_in: u32 }
}

let error1 = ServerError::NetworkFailure(404, "Not Found".to_string());
println!("{}", error1);

let error2 = ServerError::ConnectionLost { cause: "Server down".to_string(), retry_in: 10 };
println!("{}", error2);
```

```plaintext
Output:
[error] Network failure. --> Code 404: Not Found.

[error] Connection lost. --> Server down.
[debug] Retry in 10 seconds.
```

## Contributing

This project is open to contributions and suggestions, and any help or feedback is highly appreciated. There is no code of conduct, but please be respectful and considerate when engaging with the community.

This project adheres to the [Koseka Standard](https://koseka.net/book/standard), which provides standardized versioning and contribution rules. So, make sure to read it first before contributing to the project in any way. Additionally, please refer to the [DEVELOPMENT](DEVELOPMENT.md) file for setup instructions and guidance on developing and testing the project.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, shall be licensed as bellow, without any additional terms or conditions.

## License

Copyright 2026 Amon Rayfa.

This project is licensed under the [Apache License (Version 2.0)](LICENSE).