Rust状态栏插件库status-line使用指南

介绍

status-line是一个轻量级的Rust库，用于在终端应用程序中创建和管理状态栏。它允许开发者轻松显示实时信息，如进度、系统状态或其他动态数据，而无需复杂的UI框架。

主要特性：

• 轻量级且高效
• 支持实时更新状态信息
• 可自定义显示格式
• 线程安全
• 支持多行状态显示

安装

在Cargo.toml中添加依赖：

[dependencies]
status-line = "0.3"

基本使用方法

简单示例

use status_line::StatusLine;

fn main() {
    // 创建一个状态栏
    let status = StatusLine::new();
    
    // 设置状态信息
    status.update("Processing...");
    
    // 模拟工作
    for i in 0..=100 {
        status.update(&format!("Progress: {}%", i));
        std::thread::sleep(std::time::Duration::from_millis(50));
    }
    
    // 完成时清除状态栏
    status.clear();
    println!("Done!");
}

多部分状态显示

use status_line::{StatusLine, StatusPart};

fn main() {
    let status = StatusLine::new();
    
    // 创建多个状态部分
    let part1 = StatusPart::new("Downloading");
    let part2 = StatusPart::new("0%");
    let part3 = StatusPart::new("[====>      ]");
    
    // 组合显示
    status.update_parts(&[&part1, &part2, &part3]);
    
    // 更新部分状态
    for i in 0..=100 {
        part2.update(&format!("{}%", i));
        let progress = format!("[{}{}]", "=".repeat(i/10), " ".repeat(10 - i/10));
        part3.update(&progress);
        std::thread::sleep(std::time::Duration::from_millis(100));
    }
    
    status.clear();
}

高级用法

多行状态

use status_line::{StatusLine, StatusPart};

fn main() {
    let status = StatusLine::new().multiline(true);
    
    let line1_part1 = StatusPart::new("Task 1:");
    let line1_part2 = StatusPart::new("In progress");
    
    let line2_part1 = StatusPart::new("Task 2:");
    let line2_part2 = StatusPart::new("Waiting");
    
    status.update_parts(&[&line1_part1, &line1_part2]);
    status.add_line();
    status.update_parts(&[&line2_part1, &line2_part2]);
    
    // 更新不同行的状态
    line1_part2.update("Completed");
    line2_part2.update("In progress");
    
    std::thread::sleep(std::time::Duration::from_secs(2));
    status.clear();
}

自定义样式

use status_line::{StatusLine, StatusPart};
use colored::Colorize;

fn main() {
    let status = StatusLine::new();
    let part1 = StatusPart::new("Status:").bold();
    let part2 = StatusPart::new("OK").green();
    
    status.update_parts(&[&part1, &part2]);
    
    // 错误状态时改变颜色
    part2.update("ERROR").red();
    
    std::thread::sleep(std::time::Duration::from_secs(2));
    status.clear();
}

线程安全使用

use status_line::StatusLine;
use std::sync::Arc;
use std::thread;

fn main() {
    let status = Arc::new(StatusLine::new());
    
    let status_clone = status.clone();
    thread::spawn(move || {
        for i in 0..=50 {
            status_clone.update(&format!("Thread 1: {}", i));
            thread::sleep(std::time::Duration::from_millis(100));
        }
    });
    
    for i in 0..=50 {
        status.update(&format!("Main thread: {}", i));
        thread::sleep(std::time::Duration::from_millis(150));
    }
    
    status.clear();
}

完整示例

以下是一个结合了多种功能的完整示例：

use status_line::{StatusLine, StatusPart};
use colored::Colorize;
use std::sync::Arc;
use std::thread;
use std::time::Duration;

fn main() {
    // 创建多行状态栏
    let status = Arc::new(StatusLine::new().multiline(true));
    
    // 第一行：下载进度
    let download_label = StatusPart::new("Download:").bold();
    let download_progress = StatusPart::new("0%").blue();
    let download_bar = StatusPart::new("[          ]");
    
    // 第二行：系统状态
    let system_label = StatusPart::new("System:").bold();
    let system_status = StatusPart::new("OK").green();
    let cpu_usage = StatusPart::new("CPU: 0%");
    
    // 组合显示
    status.update_parts(&[&download_label, &download_progress, &download_bar]);
    status.add_line();
    status.update_parts(&[&system_label, &system_status, &cpu_usage]);
    
    // 模拟下载线程
    let status_clone = status.clone();
    thread::spawn(move || {
        for i in 0..=100 {
            download_progress.update(&format!("{}%", i));
            let bar = format!("[{}{}]", "=".repeat(i/10), " ".repeat(10 - i/10));
            download_bar.update(&bar);
            
            // 每10%更新一次CPU状态
            if i % 10 == 0 {
                let cpu = i % 70 + 10;
                cpu_usage.update(&format!("CPU: {}%", cpu));
                
                // 当CPU过高时显示警告
                if cpu > 60 {
                    system_status.update("WARNING").yellow();
                } else {
                    system_status.update("OK").green();
                }
            }
            
            thread::sleep(Duration::from_millis(100));
        }
    });
    
    // 主线程等待下载完成
    thread::sleep(Duration::from_secs(11));
    
    // 完成时显示最终状态
    system_status.update("IDLE").cyan();
    cpu_usage.update("CPU: 5%");
    
    thread::sleep(Duration::from_secs(2));
    status.clear();
    println!("所有任务已完成！");
}

注意事项

1. 在长时间运行的程序结束时调用clear()，以免状态信息残留
2. 频繁更新状态（>30次/秒）可能会导致显示闪烁
3. 在多线程环境中使用Arc包装StatusLine
4. 某些终端可能需要特殊处理才能正确显示状态栏

status-line库为Rust终端应用提供了简单而强大的状态显示功能，适合需要实时反馈的CLI工具和应用程序。