flk 0.6.2

A CLI tool for managing flake.nix devShell environments
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

//! # Visual Output Utilities
//!
//! Terminal formatting, progress indicators, and display helpers.
//!
//! This module provides consistent styling for CLI output including
//! colored text, spinners, and formatted lists/tables.

use crate::flake::interfaces::profiles::Package;
use anyhow::Result;
use colored::Colorize;
use indicatif::{ProgressBar, ProgressStyle};

/// Execute a function with a spinning progress indicator.
///
/// Shows a spinner animation with the given message while the function
/// executes. The spinner is cleared after completion.
///
/// # Arguments
///
/// * `message` - Status message to display alongside the spinner
/// * `f` - Function to execute
///
/// # Example
///
/// ```rust,ignore
/// let result = with_spinner("Searching packages...", || {
///     search_nixpkgs("ripgrep")
/// })?;
/// ```
pub fn with_spinner<F, T>(message: &str, f: F) -> Result<T>
where
    F: FnOnce() -> Result<T>,
{
    let spinner = ProgressBar::new_spinner();
    spinner.set_style(
        ProgressStyle::default_spinner()
            .template("{spinner:.cyan} {msg} [{elapsed_precise}]")
            .unwrap()
            .tick_strings(&["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]),
    );
    spinner.set_message(message.to_string());
    spinner.enable_steady_tick(std::time::Duration::from_millis(80));

    let result = f();

    spinner.finish_and_clear();
    result
}

/// Display a numbered list of packages.
///
/// Each package is shown with an index number and optional version.
pub fn display_list(packages: &[Package]) -> String {
    if packages.is_empty() {
        return String::new();
    }

    let mut output = String::new();

    for (i, pkg) in packages.iter().enumerate() {
        output.push_str(&format!(
            "{} {}\n",
            format!("[{}]", i + 1).cyan().bold(),
            pkg.name.green()
        ));

        if let Some(version) = &pkg.version {
            output.push_str(&format!("  {} {}\n", "Version:".bold(), version.yellow()));
        }

        output.push('\n');
    }

    output
}

/// Display packages in a table format with columns.
///
/// Shows package names and versions in aligned columns.
pub fn display_table(packages: &[Package]) -> String {
    if packages.is_empty() {
        return String::new();
    }

    let max_name_len = packages
        .iter()
        .map(|p| p.name.len())
        .max()
        .unwrap_or(0)
        .max(4);

    let mut output = format!("{:<width$}  Version\n", "Name", width = max_name_len);

    for pkg in packages {
        if let Some(version) = &pkg.version {
            output.push_str(&format!(
                "{:<width$}  {}\n",
                pkg.name.cyan().bold(),
                version.bright_black(),
                width = max_name_len
            ));
        } else {
            output.push_str(&format!("{}\n", pkg.name.cyan().bold()));
        }
    }

    output
}