ui-cli 0.3.13

A CLI to add components to your app.
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

use clap::{Arg, ArgMatches, Command};

use crate::command_add::tree_parser::TreeParser;
use crate::command_list::_list::{filter_by_query, format_list, format_list_json};
use crate::shared::cli_error::CliResult;
use crate::shared::rust_ui_client::RustUIClient;

/* ========================================================== */
/*                         🦀 MAIN 🦀                         */
/* ========================================================== */

pub fn command_search() -> Command {
    Command::new("search")
        .about("Search available components by name")
        .arg(Arg::new("query").help("Search query (case-insensitive)").required(true))
        .arg(Arg::new("json").long("json").help("Output as JSON").action(clap::ArgAction::SetTrue))
}

pub async fn process_search(matches: &ArgMatches) -> CliResult<()> {
    let query = matches.get_one::<String>("query").map(|s| s.as_str()).unwrap_or("");
    let json = matches.get_flag("json");

    let tree_content = RustUIClient::fetch_tree_md().await?;
    let tree_parser = TreeParser::parse_tree_md(&tree_content)?;
    let by_category = tree_parser.get_components_by_category();
    let filtered = filter_by_query(&by_category, query);

    let output = if json { format_list_json(&filtered)? } else { format_search_result(&filtered, query) };
    println!("{output}");
    Ok(())
}

/* ========================================================== */
/*                     ✨ HELPERS ✨                          */
/* ========================================================== */

/// Wraps `format_list` with a search-specific header.
pub fn format_search_result(filtered: &std::collections::BTreeMap<String, Vec<String>>, query: &str) -> String {
    let total: usize = filtered.values().map(|v| v.len()).sum();

    if total == 0 {
        return format!("No components found matching \"{query}\".");
    }

    let list = format_list(filtered);
    // Replace the generic header with a search-specific one
    list.replacen(
        &format!("Available components ({total} total)"),
        &format!("Search results for \"{query}\" ({total} found)"),
        1,
    )
}

/* ========================================================== */
/*                        🧪 TESTS 🧪                         */
/* ========================================================== */

#[cfg(test)]
mod tests {
    use std::collections::BTreeMap;

    use super::*;

    fn make_map(entries: &[(&str, &[&str])]) -> BTreeMap<String, Vec<String>> {
        entries
            .iter()
            .map(|(cat, names)| (cat.to_string(), names.iter().map(|n| n.to_string()).collect()))
            .collect()
    }

    #[test]
    fn no_match_shows_query_in_message() {
        let map = make_map(&[("ui", &["button"])]);
        let result = format_search_result(&filter_by_query(&map, "zzz"), "zzz");
        assert!(result.contains("zzz"));
        assert!(result.contains("No components found"));
    }

    #[test]
    fn match_shows_search_header_with_query() {
        let map = make_map(&[("ui", &["button", "badge"])]);
        let result = format_search_result(&filter_by_query(&map, "button"), "button");
        assert!(result.contains("Search results for \"button\""));
        assert!(result.contains("1 found"));
    }

    #[test]
    fn match_lists_components() {
        let map = make_map(&[("ui", &["button", "badge"]), ("demos", &["demo_button"])]);
        let result = format_search_result(&filter_by_query(&map, "button"), "button");
        assert!(result.contains("button"));
        assert!(result.contains("demo_button"));
        assert!(!result.contains("badge"));
    }

    #[test]
    fn search_across_multiple_categories() {
        let map = make_map(&[("ui", &["button"]), ("demos", &["demo_button"])]);
        let filtered = filter_by_query(&map, "button");
        assert!(filtered.contains_key("ui"));
        assert!(filtered.contains_key("demos"));
    }

    #[test]
    fn empty_query_returns_all() {
        let map = make_map(&[("ui", &["button", "badge"])]);
        let filtered = filter_by_query(&map, "");
        assert_eq!(filtered["ui"].len(), 2);
    }
}