GitHub top language Latest Version Rust Documentation GitHub issues GitHub pull requests GitHub Workflow Status

RUC

Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition.

The painful experience of using error-chain gave birth to this project. It can adapt to almost all scenes without any special implementation.

``` [features] default = ["ansi"] ansi = [] compact = []

rich = ["uau", "cmd"] uau = ["nix", "rand"] cmd = [] ```

Documents

shell make doc

Usage

Tips: you can easily implement your own Error type.

```rust use ruc::{err::*, *};

[derive(Debug, Eq, PartialEq)]

struct CustomErr(i32);

fn willpanic() { let l1 = || -> Result<()> { Err(eg!("The final error message!")) }; let l2 = || -> Result<()> { l1().c(d!()) }; let l3 = || -> Result<()> { l2().c(d!("A custom message!")) }; let l4 = || -> Result<()> { l3().c(d!("ERRUNKNOWN")) }; let l5 = || -> Result<()> { l4().c(d!(@CustomErr(-1))) };

pnk!(l5());

} ```

OutPut Sample

Non-Color View

features = ["ansi"]

```

2021-09-09 9:23:56 [pid: 20837] [pidns: 4026531836]

ERROR: ... |-- file: src/lib.rs |-- line: 270 -- column: 9 Caused By: ... |-- file: src/lib.rs |-- line: 264 -- column: 16 Caused By: CustomErr(-1) |-- file: src/lib.rs |-- line: 262 -- column: 44 Caused By: ERR_UNKNOWN |-- file: src/lib.rs |-- line: 261 -- column: 44 Caused By: A custom message! |-- file: src/lib.rs |-- line: 260 -- column: 44 Caused By: ... |-- file: src/lib.rs |-- line: 259 -- column: 69 Caused By: The final error message! |-- file: src/lib.rs |-- line: 258 `-- column: 41 ```

Colorful View

```

2021-09-09 9:23:57 [pid: 20909] [pidns: 4026531836]

ERROR: ... ├── file: src/lib.rs ├── line: 270 └── column: 9 Caused By: ... ├── file: src/lib.rs ├── line: 264 └── column: 16 Caused By: CustomErr(-1) ├── file: src/lib.rs ├── line: 262 └── column: 44 Caused By: ERR_UNKNOWN ├── file: src/lib.rs ├── line: 261 └── column: 44 Caused By: A custom message! ├── file: src/lib.rs ├── line: 260 └── column: 44 Caused By: ... ├── file: src/lib.rs ├── line: 259 └── column: 69 Caused By: The final error message! ├── file: src/lib.rs ├── line: 258 └── column: 41 ```

Compact View

features = ["compact"]

```

2022-01-12 5:56:13 [pid: 73002] [pidns: NULL] 》INFO: ... 》file: src/lib.rs 》line: 354 》column: 9 》Caused By: ... 》file: src/lib.rs 》line: 354 》column: 33

```