uguid

no_std 库提供 GUID（全局唯一标识符）类型，用于 GPT 磁盘、UEFI 和 Microsoft Windows。

功能

默认情况下未启用任何功能。

• bytemuck: 为 Guid 实现 bytemuck 的 Pod 和 Zeroable 特征。
• serde: 为 Guid 实现 serde 的 Serialize 和 Deserialize 特征。
• std: 目前没有效果。

最低支持的 Rust 版本 (MSRV)

当前 MSRV 是 1.81。

许可证

根据您的选择，可以按照 Apache License, Version 2.0 或 MIT license 进行许可。

免责声明

此项目不是官方的 Google 项目。它不受 Google 支持，并且 Google 明确否认对其质量、适销性或特定用途适用性的所有保证。

安装

在您的项目目录中运行以下 Cargo 命令：

cargo add uguid

或者将以下行添加到您的 Cargo.toml：

uguid = "2.2.1"

完整示例代码

// 引入 uguid 库
use uguid::Guid;

fn main() {
    // 创建一个新的 GUID
    let guid = Guid::new();
    println!("Generated GUID: {}", guid);
    
    // 从字符串解析 GUID
    let guid_str = "12345678-1234-5678-9abc-def012345678";
    let parsed_guid = Guid::parse(guid_str).expect("Invalid GUID format");
    println!("Parsed GUID: {}", parsed_guid);
    
    // 检查 GUID 是否为空
    let empty_guid = Guid::nil();
    println!("Is empty GUID nil? {}", empty_guid.is_nil());
    
    // 比较两个 GUID
    let guid1 = Guid::new();
    let guid2 = Guid::new();
    println!("Are GUIDs equal? {}", guid1 == guid2);
}

// 使用 serde 功能时的示例
#[cfg(feature = "serde")]
use serde::{Serialize, Deserialize};

#[cfg(feature = "serde")]
#[derive(Serialize, Deserialize)]
struct MyStruct {
    id: Guid,
    name: String,
}

#[cfg(feature = "serde")]
fn serde_example() {
    let my_data = MyStruct {
        id: Guid::new(),
        name: "Example".to_string(),
    };
    
    // 序列化为 JSON
    let json = serde_json::to_string(&my_data).unwrap();
    println!("Serialized: {}", json);
    
    // 从 JSON 反序列化
    let deserialized: MyStruct = serde_json::from_str(&json).unwrap();
    println!("Deserialized ID: {}", deserialized.id);
}

// 使用 bytemuck 功能时的示例
#[cfg(feature = "bytemuck")]
use bytemuck::{Pod, Zeroable};

#[cfg(feature = "bytemuck")]
fn bytemuck_example() {
    // 创建 GUID 的零值实例
    let zero_guid: Guid = Zeroable::zeroed();
    println!("Zero GUID: {}", zero_guid);
    
    // 将 GUID 转换为字节数组
    let guid = Guid::new();
    let bytes: &[u8] = bytemuck::bytes_of(&guid);
    println!("GUID bytes: {:?}", bytes);
    
    // 从字节数组创建 GUID
    let from_bytes: &Guid = bytemuck::from_bytes(bytes);
    println!("GUID from bytes: {}", from_bytes);
}

完整示例demo

// 完整示例：展示 uguid 库的基本使用和功能
use uguid::Guid;

fn main() {
    // 基本 GUID 操作示例
    println!("=== 基本 GUID 操作 ===");
    
    // 创建新的 GUID
    let guid1 = Guid::new();
    println!("新生成的 GUID: {}", guid1);
    
    // 从字符串解析 GUID
    let guid_str = "c9a646d3-9c61-4cb7-bfcd-ee2522c8f633";
    match Guid::parse(guid_str) {
        Ok(guid) => println!("解析的 GUID: {}", guid),
        Err(e) => println!("解析失败: {}", e),
    }
    
    // 创建空 GUID
    let nil_guid = Guid::nil();
    println!("空 GUID: {}", nil_guid);
    println!("是否为空: {}", nil_guid.is_nil());
    
    // GUID 比较
    let guid2 = Guid::new();
    println!("GUID 比较: {}", guid1 == guid2);
    
    // 启用不同功能时的示例
    #[cfg(feature = "serde")]
    serde_example();
    
    #[cfg(feature = "bytemuck")]
    bytemuck_example();
}

// Serde 功能示例
#[cfg(feature = "serde")]
fn serde_example() {
    use serde::{Serialize, Deserialize};
    
    println!("\n=== Serde 功能示例 ===");
    
    #[derive(Serialize, Deserialize)]
    struct User {
        id: Guid,
        username: String,
    }
    
    let user = User {
        id: Guid::new(),
        username: "john_doe".to_string(),
    };
    
    // 序列化到 JSON
    let json = serde_json::to_string(&user).unwrap();
    println!("序列化后的 JSON: {}", json);
    
    // 从 JSON 反序列化
    let deserialized: User = serde_json::from_str(&json).unwrap();
    println!("反序列化的用户 ID: {}", deserialized.id);
}

// Bytemuck 功能示例
#[cfg(feature = "bytemuck")]
fn bytemuck_example() {
    use bytemuck::{Zeroable, bytes_of};
    
    println!("\n=== Bytemuck 功能示例 ===");
    
    // 创建零值 GUID
    let zero_guid: Guid = Zeroable::zeroed();
    println!("零值 GUID: {}", zero_guid);
    
    // GUID 与字节数组转换
    let guid = Guid::new();
    let bytes = bytes_of(&guid);
    println!("GUID 字节表示: {:?}", bytes);
    
    // 注意：实际使用时需要确保字节数组格式正确
    println!("原始 GUID: {}", guid);
}