rcli-loader 0.1.0

RCLI-loader: The Rust client line interface loader crate, a utility built for versatile monitoring of the progress for running tasks
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

use crate::{loading_element::LoadingElement, terminal_helper::V2Usz};
pub enum Position {
    TOP,BOTTOM
}

pub trait LoadingColorScheme {
    fn get_char_block_color(&self, l_elem: &LoadingElement) -> Box<str>; // WARNING: Return of string as color with ANSI codes is unreliable, this should be made to some kind of struct?
}

pub struct RedGreenScheme {}
impl LoadingColorScheme for RedGreenScheme {
    fn get_char_block_color(&self, l_elem: &LoadingElement) -> Box<str> {
        let ratio = if l_elem.get_max() > 0 {255 * l_elem.get_progress() / l_elem.get_max()} else {0}; // Note: This ratio calculation might break if 56 bits of precision is used on a 64 bit machine, or 24 bits on a 32 bit machine
        return Box::from(format!("\x1b[38;2;{r};{g};{b}m", r=255-ratio, g=ratio, b=0)) // Returns 24 bit color
    }
}

pub struct BlueScheme {}
impl LoadingColorScheme for BlueScheme {
    fn get_char_block_color(&self, _l_elem: &LoadingElement) -> Box<str> {
        Box::from(format!("\x1b[38;2;{r};{g};{b}m", r=0, g=0, b=255)) // Returns 24 bit color
    }
}

// TODO: This might work more effectively as a macro
pub fn set_terminal_pos(pos: V2Usz) {
    print!("\x1B[{line};{column}H", column = pos.x as usize, line = pos.y as usize);
}

// Note: Does not flush stdout
// Prints Unicode U+2500 '─'
pub fn print_splitter_line(terminal_size: &V2Usz, offset_height: usize) {
    set_terminal_pos(V2Usz { x: 0, y: offset_height }); // Set proper positioning
    print!("{end:\u{2500}>times$}", end="", times=terminal_size.x as usize); // Print 
}