panicui 0.1.0

The needed solution for panicking with user interface.
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

<div align="center">
    <h1>panicui</h1>
    <img src="assets/images/icon.png" alt="panicui icon" width="300" height="300">
</div>

---

## Description


[panicui](https://crates.io/crates/panicui) provides a simple solution to easier debugging by utilizing user interface.

panicui allows you to create panic hooks that open a crash log window in just 7 lines of code.

![panicui UI preview](assets/screenshots/Screenshot_1.png)

## Why use panicui?


### 1. Extremely lightweight


Binary size of the program shown above (no strip, with debug symbols): ~1,010KB (0.98MB)

### 2. Fast build times


panicui only uses one direct dependency, [fltk-rs](https://crates.io/crates/fltk).

### 3. Portable across every platform


panicui uses [fltk](https://www.fltk.org/) for UI, which works across practically every platform. This includes:

- UNIX
- Linux (X11)
- Windows
- MacOS X

---

## Example usage


<sub>More examples are available in the <a href="https://github.com/imajindevon/panicui/tree/main/examples/">examples</a> folder.</sub>

```rust
#![windows_subsystem = "windows"]


use panicui::app::PanicApplication;
use panicui::style::Style;
use panicui::window::PanicWindow;
use std::backtrace::Backtrace;
use std::panic;
use std::panic::PanicInfo;

fn panic_hook(info: &PanicInfo) {
    let backtrace = Backtrace::force_capture();
    let crash_text = format!("{info}\n{backtrace}");

    let win = PanicWindow::new(Style::default(), crash_text);

    let mut app = PanicApplication::new(win);
    app.run().expect("Unable to run application.");
}

fn main() {
    panic::set_hook(Box::new(panic_hook));

    // Cause some random panic.
    Result::<(), _>::Err(5i32).unwrap();
}
```