Hachi64 Rust 实现

哈吉米64编解码器的 Rust 实现，使用64个中文字符进行 Base64 风格的编码和解码。

特性

• 使用固定的哈吉米64字符集（64个中文字符）
• 支持带填充和不带填充两种模式
• 提供多种调用方式（实例方法、静态方法、便捷函数）
• 完全符合 Base64 编码标准
• 类型安全，性能优异

快速开始

添加依赖

[dependencies]
hachi64 = "0.1.0"

基本用法

use hachi64::{Hachi64, encode, decode};

fn main() {
    // 方式 1: 使用便捷函数（推荐）
    let encoded = encode(b"Hello");
    println!("编码结果: {}", encoded);  // 豆米啊拢嘎米多=
    
    let decoded = decode(&encoded).unwrap();
    println!("解码结果: {:?}", String::from_utf8(decoded).unwrap());  // Hello
    
    // 方式 2: 使用实例方法
    let encoder = Hachi64::new();
    let encoded = encoder.encode(b"Hello");
    let decoded = encoder.decode(&encoded).unwrap();
    
    // 方式 3: 使用静态方法
    let encoded = Hachi64::encode_static(b"Hello");
    let decoded = Hachi64::decode_static(&encoded).unwrap();
}

不使用填充

use hachi64::Hachi64;

let encoder = Hachi64::with_padding(false);
let encoded = encoder.encode(b"Hello");
println!("{}", encoded);  // 豆米啊拢嘎米多

编码示例

根据主 README 文档中的示例：

API 文档

结构体

Hachi64

哈吉米64编码器/解码器。

方法:

• new() -> Self - 创建新实例（默认带填充）
• with_padding(padding: bool) -> Self - 创建新实例并指定填充选项
• encode(&self, data: &[u8]) -> String - 编码字节数组
• decode(&self, encoded_str: &str) -> Result<Vec<u8>, HachiError> - 解码字符串
• encode_static(data: &[u8]) -> String - 静态编码方法
• decode_static(encoded_str: &str) -> Result<Vec<u8>, HachiError> - 静态解码方法

便捷函数

• encode(data: &[u8]) -> String - 使用默认设置编码
• decode(encoded_str: &str) -> Result<Vec<u8>, HachiError> - 使用默认设置解码

错误类型

HachiError

• InvalidInput - 输入字符串包含不在字符集中的字符

运行测试

cargo test

许可证

MIT