all-smi 0.26.2

// Copyright 2025 Lablup Inc. and Jeongkyu Shin
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use std::borrow::Cow;
use std::io::Write;

use crossterm::{
    queue,
    style::{Color, Print, ResetColor, SetBackgroundColor, SetForegroundColor},
};

// Helper function to get display width of a single character
pub fn char_display_width(c: char) -> usize {
    match c {
        // Arrow characters that display as 1 character width
        '←' | '→' | '↑' | '↓' => 1,
        // Most other characters display as their char count
        _ => 1,
    }
}

// Helper function to calculate display width of a string, accounting for Unicode characters
pub fn display_width(s: &str) -> usize {
    s.chars().map(char_display_width).sum()
}

// Helper function to truncate a string to fit within a given display width.
//
// Returns `Cow::Borrowed` when the string already fits, avoiding allocation.
pub fn truncate_to_width(s: &str, max_width: usize) -> Cow<'_, str> {
    // Fast path: ASCII-only strings where byte length == display width
    if s.len() <= max_width {
        return Cow::Borrowed(s);
    }

    // The string is longer than max_width. For ASCII-only content we can
    // simply slice at the byte boundary.
    if s.is_ascii() {
        return Cow::Borrowed(&s[..max_width]);
    }

    // Slow path: walk char-by-char for non-ASCII content.
    let mut current_width = 0;
    let mut byte_end = 0;
    for c in s.chars() {
        let char_width = char_display_width(c);
        if current_width + char_width > max_width {
            break;
        }
        current_width += char_width;
        byte_end += c.len_utf8();
    }

    Cow::Borrowed(&s[..byte_end])
}

// Helper function to format RAM values with appropriate units
pub fn format_ram_value(gb_value: f64) -> String {
    if gb_value >= 1024.0 {
        format!("{:.2}TB", gb_value / 1024.0)
    } else if gb_value < 1.0 {
        // For sub-GB values (like 512MB = 0.5GB), show with 1 decimal place
        format!("{gb_value:.1}GB")
    } else {
        format!("{gb_value:.0}GB")
    }
}

/// Write colored text to a terminal buffer.
///
/// When `width` is `None` (the common hot-path case), the text is printed
/// directly without any intermediate `String` allocation. When `width` is
/// `Some(w)`, the text is padded or truncated to exactly `w` characters.
pub fn print_colored_text<W: Write>(
    stdout: &mut W,
    text: &str,
    fg_color: Color,
    bg_color: Option<Color>,
    width: Option<usize>,
) {
    match width {
        Some(w) => {
            // Width-adjusted path: only allocate when padding/truncation is needed
            let adjusted: Cow<'_, str> = if text.len() > w {
                truncate_to_width(text, w)
            } else if text.len() < w {
                Cow::Owned(format!("{text:<w$}"))
            } else {
                Cow::Borrowed(text)
            };

            if let Some(bg) = bg_color {
                queue!(
                    stdout,
                    SetForegroundColor(fg_color),
                    SetBackgroundColor(bg),
                    Print(adjusted.as_ref()),
                    ResetColor
                )
                .unwrap();
            } else {
                queue!(
                    stdout,
                    SetForegroundColor(fg_color),
                    Print(adjusted.as_ref()),
                    ResetColor
                )
                .unwrap();
            }
        }
        None => {
            // Hot path: no width adjustment, print text directly without allocation
            if let Some(bg) = bg_color {
                queue!(
                    stdout,
                    SetForegroundColor(fg_color),
                    SetBackgroundColor(bg),
                    Print(text),
                    ResetColor
                )
                .unwrap();
            } else {
                queue!(
                    stdout,
                    SetForegroundColor(fg_color),
                    Print(text),
                    ResetColor
                )
                .unwrap();
            }
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    // -----------------------------------------------------------------------
    // truncate_to_width: correctness and allocation behavior
    // -----------------------------------------------------------------------

    #[test]
    fn test_truncate_to_width_short_string_borrows() {
        let s = "hello";
        let result = truncate_to_width(s, 10);
        // Should borrow, not allocate
        assert!(matches!(result, Cow::Borrowed(_)));
        assert_eq!(&*result, "hello");
    }

    #[test]
    fn test_truncate_to_width_exact_fit_borrows() {
        let s = "hello";
        let result = truncate_to_width(s, 5);
        assert!(matches!(result, Cow::Borrowed(_)));
        assert_eq!(&*result, "hello");
    }

    #[test]
    fn test_truncate_to_width_truncates_ascii() {
        let s = "hello world";
        let result = truncate_to_width(s, 5);
        // ASCII fast path: should borrow a slice
        assert!(matches!(result, Cow::Borrowed(_)));
        assert_eq!(&*result, "hello");
    }

    #[test]
    fn test_truncate_to_width_empty_string() {
        let result = truncate_to_width("", 5);
        assert!(matches!(result, Cow::Borrowed(_)));
        assert_eq!(&*result, "");
    }

    #[test]
    fn test_truncate_to_width_zero_width() {
        let result = truncate_to_width("hello", 0);
        assert_eq!(&*result, "");
    }

    #[test]
    fn test_truncate_to_width_unicode_arrows() {
        // Arrows have display width 1 each
        let s = "↑↓←→abc";
        let result = truncate_to_width(s, 4);
        assert_eq!(&*result, "↑↓←→");
    }

    // -----------------------------------------------------------------------
    // display_width
    // -----------------------------------------------------------------------

    #[test]
    fn test_display_width_ascii() {
        assert_eq!(display_width("hello"), 5);
    }

    #[test]
    fn test_display_width_arrows() {
        assert_eq!(display_width("↑↓"), 2);
    }

    #[test]
    fn test_display_width_empty() {
        assert_eq!(display_width(""), 0);
    }

    // -----------------------------------------------------------------------
    // format_ram_value
    // -----------------------------------------------------------------------

    #[test]
    fn test_format_ram_value_gb() {
        assert_eq!(format_ram_value(16.0), "16GB");
    }

    #[test]
    fn test_format_ram_value_tb() {
        assert_eq!(format_ram_value(2048.0), "2.00TB");
    }

    #[test]
    fn test_format_ram_value_sub_gb() {
        assert_eq!(format_ram_value(0.5), "0.5GB");
    }

    // -----------------------------------------------------------------------
    // Throughput measurement
    // -----------------------------------------------------------------------

    #[test]
    fn test_truncate_to_width_throughput() {
        let long_string = "a".repeat(200);
        let start = std::time::Instant::now();
        for _ in 0..100_000 {
            let _ = truncate_to_width(&long_string, 80);
        }
        let elapsed = start.elapsed();
        // 100k truncations should complete well under 1 second
        assert!(
            elapsed.as_millis() < 1000,
            "truncate_to_width throughput too slow: {elapsed:?}"
        );
    }
}