gilt 0.13.0

Fast, beautiful terminal formatting for Rust — styles, tables, trees, syntax highlighting, progress bars, markdown.
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

//! Toast notification examples — demonstrating status messages for CLI apps.
//!
//! This example shows the various ways to create and display toast notifications,
//! including different types, custom styling, progress bars, and the ToastManager.

use std::time::Duration;

use gilt::console::Console;
use gilt::style::Style;
use gilt::toast::{
    toast_error, toast_info, toast_success, toast_warning, Toast, ToastManager, ToastType,
};

fn main() {
    let mut console = Console::builder()
        .width(60)
        .force_terminal(true)
        .no_color(false)
        .build();

    // -- Section 1: Basic Toast Types -----------------------------------------

    println!("=== Basic Toast Types ===\n");

    Toast::success("Operation completed successfully").show(&mut console);

    Toast::error("Failed to save file").show(&mut console);

    Toast::warning("Disk space low").show(&mut console);

    Toast::info("3 new notifications").show(&mut console);

    // -- Section 2: Custom Icons ----------------------------------------------

    println!("\n=== Custom Icons ===\n");

    Toast::success("Build completed!")
        .icon("🚀")
        .show(&mut console);

    Toast::error("Connection failed")
        .icon("🔌")
        .show(&mut console);

    Toast::warning("Battery low").icon("🔋").show(&mut console);

    Toast::info("New email").icon("📧").show(&mut console);

    // -- Section 3: Custom Styling --------------------------------------------

    println!("\n=== Custom Styling ===\n");

    // Custom style with magenta color
    let custom_style = Style::parse("magenta bold").unwrap();
    Toast::new("Custom notification")
        .toast_type(ToastType::Custom(custom_style))
        .icon("🎉")
        .show(&mut console);

    // Custom style with dimmed appearance
    let subtle_style = Style::parse("dim italic").unwrap();
    Toast::new("Background task completed")
        .toast_type(ToastType::Custom(subtle_style))
        .icon("◌")
        .show(&mut console);

    // -- Section 4: Toast Manager (Multiple Toasts) ----------------------------

    println!("\n=== Toast Manager ===\n");

    let mut manager = ToastManager::new();
    manager.push(Toast::success("File uploaded"));
    manager.push(Toast::info("Processing image..."));
    manager.push(Toast::warning("Slow connection detected"));
    manager.push(Toast::error("Backup failed"));
    manager.push(Toast::info("5 tasks remaining"));

    // Only show up to 3 at a time
    manager.show_all(&mut console);

    // -- Section 5: Progress Bar Toasts ---------------------------------------

    println!("\n=== Progress Bar Toasts (non-blocking display) ===\n");

    Toast::info("Upload in progress...")
        .duration(Duration::from_secs(5))
        .show_progress(true)
        .show(&mut console);

    Toast::success("Installing packages")
        .duration(Duration::from_secs(10))
        .show_progress(true)
        .show(&mut console);

    // -- Section 6: Global Convenience Functions ------------------------------

    println!("\n=== Global Convenience Functions ===\n");

    // These use the default global console
    toast_success("Using global console!");
    toast_info("No need to create a Console instance");
    toast_warning("Quick and easy");
    toast_error("Error handling made simple");

    // -- Section 7: Builder Pattern Chaining ----------------------------------

    println!("\n=== Builder Pattern Chaining ===\n");

    Toast::new("Complex configuration")
        .toast_type(ToastType::Success)
        .duration(Duration::from_secs(8))
        .icon("✨")
        .show_progress(true)
        .width(50)
        .show(&mut console);

    // -- Section 8: Compact/Minimal Toasts ------------------------------------

    println!("\n=== Compact Toasts ===\n");

    // Very short messages
    Toast::success("Done!").show(&mut console);
    Toast::error("Oops!").show(&mut console);
    Toast::info("OK").show(&mut console);

    // -- Summary --------------------------------------------------------------

    println!("\n=== Summary ===");
    println!("Toast notifications provide:");
    println!("  • Four built-in types (success, error, warning, info)");
    println!("  • Custom icons and styling");
    println!("  • Optional progress bars for time-based feedback");
    println!("  • ToastManager for handling multiple notifications");
    println!("  • Global convenience functions for quick usage");
}