ostring_base 2.1.0

ostring base crate include some basic function
Documentation

OS System Tools

一个用 Rust 编写的系统工具集合，提供系统信息获取、文件路径管理、串口管理和自动启动配置等功能。

功能特性

  • 📊 系统信息监控

    • 内存使用情况
    • 系统名称和版本
    • 主机名
    • 网络接口信息

  • 📁 路径管理

    • 链式API设计
    • 目录/文件自动创建
    • 类型安全的路径操作

  • 🔌 串口管理

    • 列出可用串口
    • 获取串口详细信息（ID、名称、制造商）

  • 🚀 自动启动配置

    • 支持 Windows/macOS/Linux
    • 配置应用程序自启动
    • 支持启用/禁用自启动

系统要求

  • Rust 1.70 或更高版本
  • 支持的操作系统：
    • Windows 10/11
    • macOS 10.15+
    • Linux (主流发行版)

安装

  1. 克隆仓库：

    git clone https://github.com/Weakcat/ostring_base.git

  2. 构建项目：

    cargo build --release

使用示例

系统信息获取

use ostring_base::os_sysinfo::OsSysInfo;

let info = OsSysInfo::get_info();
println!("{:?}", info);

路径管理 (链式API)

use ostring_base::os_path::{PathManager, app_file_path};

// 获取并确保应用配置文件存在
let config_path = app_file_path("myapp", "config.json")?;

// 自定义路径操作
let mut log_manager = PathManager::get_data_dir()?;
log_manager.join_dir("myapp")?
           .join_dir("logs")?
           .ensure()?;
let log_dir = log_manager.path();
    
// 文件路径（注意：文件路径后不能再join）
let mut file_manager = PathManager::get_data_dir()?;
file_manager.join_dir("myapp")?
            .join_file("data.log")?;  // 此时path_type为File
    
// 以下操作会返回错误
// file_manager.join_dir("logs")?; // 错误：无法在文件路径上进行join操作

// 创建并获取文件路径
file_manager.ensure()?;
let file_path = file_manager.string()?;

串口列表

use ostring_base::os_serialport::serial_port_list;

let ports = serial_port_list();
println!("{:?}", ports);

自动启动配置

use ostring_base::os_autolaunch::AutoLaunchManager;

// 检查是否启用了自动启动
let is_enabled = AutoLaunchManager::is_enabled()?;
println!("自动启动状态: {}", is_enabled);

// 启用自动启动
AutoLaunchManager::update_launch(true)?;

// 禁用自动启动
AutoLaunchManager::update_launch(false)?;

依赖项

  • serde: 序列化/反序列化支持
  • sysinfo: 系统信息获取
  • serialport: 串口通信
  • auto-launch: 自动启动配置
  • dirs: 系统目录路径获取
  • anyhow: 错误处理

开发

运行测试

cargo test