tui-theme-builder 0.2.2

Theme deserializer for Ratatui
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

<div align="center">

# tui-theme-builder
 
[![Crates.io Badge]][Crates.io] [![Deps.rs Badge]][Deps.rs]

A theme builder macro for [ratatui](https://github.com/ratatui/ratatui) apps.

</div>


```rust
use ratatui::style::{Color, Style};
use ratatui::widgets::BorderType;
use serde::Deserialize;
use tui_theme_builder::ThemeBuilder;

#[derive(Debug, Deserialize)]
pub struct Config {
    pub orange: Color,
    pub purple: Color,
    pub border_type: BorderType,
}

#[derive(ThemeBuilder)]
#[builder(context=Config)]
pub struct Theme {
    /// Annotate styles with 'fg=color', 'bg=color' or add modifiers,
    /// e.g. 'bold' or 'underlined'.
    #[style(fg=orange, bg=purple, bold, underlined)]
    pub base: Style,

    /// Annotate border types with 'value=field' to reference a context field,
    /// or use a variant name directly, e.g. 'plain', 'rounded', 'thick', etc.
    /// Note: If accessed with 'value=field' the 'field' must start with a
    /// capital letter.
    #[border_type(value = border_type)]
    pub border: BorderType,
}

impl Default for Config {
    fn default() -> Self {
        let s = r##"
        "orange" = "#ffb86c"
        "purple" = "#bd93f9"
        "border_type" = "Rounded"
        "##;
        toml::from_str(s).unwrap()
    }
}

fn main() {
    let config = Config::default();
    let theme = Theme::build(&config);
}
```

## Apps using `tui-theme-builder`

- [Mantui](https://github.com/preiter93/mantui/blob/main/src/ui/theme.rs)

[Deps.rs Badge]: https://deps.rs/repo/github/preiter93/tui-theme-builder/status.svg?path=tui-theme-builder&style=flat-square
[Deps.rs]: https://deps.rs/repo/github/preiter93/tui-theme-builder?path=tui-theme-builder
[Crates.io Badge]: https://img.shields.io/crates/v/tui-theme-builder?logo=rust&style=flat-square&logoColor=E05D44&color=E05D44
[Crates.io]: https://crates.io/crates/tui-theme-builder