dotstate 0.3.3

A modern, secure, and user-friendly dotfile manager built with Rust
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

/// Calculate the X coordinate for a cursor position in text
///
/// # Arguments
/// * `text` - The text string
/// * `cursor_pos` - Cursor position in characters
/// * `area_width` - Width of the area
///
/// # Returns
/// X coordinate for the cursor
#[allow(dead_code)]
#[must_use]
pub fn calculate_cursor_x(text: &str, cursor_pos: usize, area_width: u16) -> u16 {
    let clamped_pos = cursor_pos.min(text.chars().count());
    clamped_pos.min(area_width as usize) as u16
}

/// Clamp cursor position to valid range for text
///
/// # Arguments
/// * `text` - The text string
/// * `pos` - Desired cursor position
///
/// # Returns
/// Clamped cursor position
#[allow(dead_code)]
#[must_use]
pub fn clamp_cursor_position(text: &str, pos: usize) -> usize {
    pos.min(text.chars().count())
}

/// Truncate text with ellipsis if it exceeds max width
///
/// # Arguments
/// * `text` - Text to truncate
/// * `max_width` - Maximum width in characters
///
/// # Returns
/// Truncated string with ellipsis if needed
#[allow(dead_code)]
#[must_use]
pub fn truncate_with_ellipsis(text: &str, max_width: usize) -> String {
    if text.chars().count() <= max_width {
        text.to_string()
    } else {
        let truncated: String = text.chars().take(max_width.saturating_sub(3)).collect();
        format!("{truncated}...")
    }
}