15个版本 (4个重大更新)

0.6.7	2023年4月24日
0.6.6	2023年3月2日
0.6.4	2023年2月21日
0.4.0	2023年2月12日
0.1.0	2023年2月10日

#390 in 编码

每月51次下载

MIT/Apache

57KB
339 行

Serde2File

通过serde_json将一些数据序列化存储到文件中或从文件反序列化数据

支持

存储文件时支持加密存储
支持用户自定义加密方法和参数传递
提供默认的aes256gsm加密实现
灵活的文件存储位置和名称设置

派生宏Serde2File属性（可选）

使用方法

#[derive(Serialize, Deserialize, Serde2File)]
#[serde2file(
    encrypt = "TestEncryptTool::encrypt",
    decrypt = "TestEncryptTool::decrypt",
    crypt_arg_type = "&'static str",
    file_name_getter_arg_type = "(&str,&str)",
    file_name_getter = "(&str,&str)",
    dump_file_name = "test_data.json",   
    file_name_getter = "some_get_file_name_function",
    file_name_getter_arg_type = "String"
)]

属性

#[serde2file(参数1=值1,...)]
- encrypt 数据加密方法
- decrypt 数据解密方法
- 以上加密和解密方法必须同时设置，否则不进行加解密。
- 例如：#[serde2file(encrypt="TestEncryptTool::encrypt",decrypt="TestEncryptTool::decrypt")]
- dump_file_name
  - 自定义转储文件名称
  - 如果没有设置，则默认转储文件名称为当前Struct的完整名称。
  - 例如，serde2file::test::TestData对应的默认转储文件名称为serde2file-test-TestData.json
  - 例如：#[serde2file(dump_file_name = "test_data.json")]
- crypt_arg_type
  - 定义额外的加密和解密参数类型
  - 用于传递自定义参数到加密或解密函数
  - 例如：#[serde2file(crypt_arg_type = "&'static str")]
- 动态确定文件名称和保存路径
  - file_name_getter 文件名称获取函数
  - file_name_getter_arg_type 文件名称获取函数参数类型，用于根据参数动态获取文件名称

特性

默认：core + encrypt_tool
core 无加密工具
encrypt_tool Aes256Gcm 加密工具

将struct序列化为文件存储，或从文件反序列化为struct

支持：

存储文件时支持加密存储
支持自定义加密方法和参数传递
提供默认的aes256gsm加密实现
灵活的文件存储路径和名称设置

派生宏Serde2File属性（可选）

用法

#[derive(Serialize, Deserialize, Serde2File)]
#[serde2file(
    encrypt = "TestEncryptTool::encrypt",
    decrypt = "TestEncryptTool::decrypt",
    crypt_arg_type = "&'static str",
    file_name_getter_arg_type = "(&str,&str)",
    file_name_getter = "(&str,&str)",
    dump_file_name = "test_data.json",   
    file_name_getter = "some_get_file_name_function",
    file_name_getter_arg_type = "String"
)]

属性

#[serde2file(参数1=值1,...)]
- encrypt 数据加密方法
- decrypt 数据解密方法
- 以上加密和解密方法必须同时设置，否则不进行加解密。
- 例如：#[file_encrypt(encrypt="TestEncryptTool::encrypt",decrypt="TestEncryptTool::decrypt")]
- dump_file_name
  - 设置自定义的转储文件名称
  - 自定义转储文件名称
  - 默认为当前Struct的完整名称，
  - 如serde2file::test::TestData对应的默认转储文件名称为serde2file-test-TestData.json
  - 例如：#[serde2file(dump_file_name = "test_data.json")]
- crypt_arg_type
  - 定义额外的加解密参数类型
  - 用于向加密或解密函数传递自定义参数使用
  - 例如：#[serde2file(crypt_arg_type = "&'static str")]
- 动态确定文件名称和保存路径
  - file_name_getter 文件名称获取函数
  - file_name_getter_arg_type 文件名称获取函数传参类型，用于根据参数动态获取文件名称
  - 例如：#[serde2file(file_name_getter = "some_get_file_name_function",file_name_getter_arg_type = "String")]

特性

默认：core + encrypt_tool
core 无加密工具
encrypt_tool : Aes256Gcm 加密工具

示例1 / 示例1

(1) 最简单用法 / 最简单用法

无需加密，直接将struct转储到json文件。转储文件名称为默认名称

无需加密，直接将struct转储到json文件，转储文件名称为默认名称

use serde::{Deserialize, Serialize};
use serde2file::prelude::*;

#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Eq, Serde2File)]
struct TestData {
    id: String,
    name: String,
}
#cfg(test)
mod test {
    use super::*;
    /// Test serialization and encrypted storage to file
    /// 测试序列化并加密存储到文件
    #[test]
    fn test_serialize_to_file() {
        let data = TestData {
            id: "01".into(),
            name: "hy".into(),
        };
        assert_eq!("/tmp/[package-name]-Test-Data.json",
            data.dump2file("/tmp").unwrap());
    }
    /// Test deserialization from encrypted file
    /// 测试从加密文件反序列化
    #[test]
    fn test_deserialize_from_file() {
        let data = TestData {
            id: "01".into(),
            name: "hy".into(),
        };
        let s_data = TestData::load_from_file("/tmp").unwrap();
        assert_eq!(data, s_data)
    }
}

(2) 加密转储为自定义文件 / 加密转储为自定义文件

加密转储文件，使用默认的aes256gsm加密实现
无需额外加密参数
将转储文件名称设置为test_data.json。

加密转储文件，加密时使用默认的aes256gsm加密实现，无需额外加密参数，设置转储文件名称为test_data.json。

use serde::{Deserialize, Serialize};
use serde2file::encrypt::Aes256GcmEncryptUtil;
use serde2file::prelude::*;

#[allow(dead_code)]
#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Eq, Serde2File)]
#[serde2file(
    dump_file_name = "test_data.json",
    encrypt = "TestEncryptTool::encrypt",
    decrypt = "TestEncryptTool::decrypt"
)]
struct TestData {
    id: String,
    name: String,
}
/// a encryption and decryption tools
#[allow(dead_code)]
struct TestEncryptTool;
impl Aes256GcmEncryptUtil for TestEncryptTool{
    type CryptArgType = ();
    fn get_aes_key_nonce(extra:Option<Self::CryptArgType>) -> (String, String) {
        (
            format!("*)_#@{}!$=_^20230208)leb*$xz",extra.unwrap_or("140600")),
            "abc$hy%95599".into(),
        )
    }
}

/// Test serialization and encrypted storage to file
/// 测试序列化并加密存储到文件
#[test]
fn test_serde_file() {
    let data = TestData {
        id: "01".into(),
        name: "hy".into(),
    };
    assert_eq!("/tmp/test_data.json",data.dump2file("/tmp").unwrap());
    let s_data = TestData::load_from_file("/tmp").unwrap();
    assert_eq!(data, s_data)
}

(3) 使用自定义加密参数加密转储文件 / 使用自定义加密参数加密转储文件

使用默认的aes256gsm加密实现，并需要额外加解密参数。设置转储文件名称为test_data.json。

加密时使用默认的aes256gsm加密实现，并需要额外加解密参数，设置转储文件名称为test_data.json。

use serde::{Deserialize, Serialize};
use super::encrypt::Aes256GcmEncryptUtil;
use crate::prelude::*;

#[allow(dead_code)]
#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Eq, Serde2File)]
#[serde2file(
    dump_file_name = "test_data2.json",
    encrypt = "TestEncryptTool::encrypt",
    decrypt = "TestEncryptTool::decrypt",
    crypt_arg_type = "&'static str"
)]
struct TestData2 {
    id: String,
    name: String,
}

/// a encryption and decryption tools
#[allow(dead_code)]
struct TestEncryptTool;
impl Aes256GcmEncryptUtil for TestEncryptTool{
    type CryptArgType = &'static str;
    fn get_aes_key_nonce(extra:Option<Self::CryptArgType>) -> (String, String) {
        (
            format!("*)_#@{}!$=_^20230208)leb*$xz",extra.unwrap_or("140600")),
            "abc$hy%95599".into(),
        )
    }
}

/// Test serialization and encrypted storage to file with extra param
/// 测试序列化并加密存储到文件
#[test]
fn test_serde_file() {
    let data = TestData2 {
        id: "01".into(),
        name: "hy".into(),
    };
    let file_name_arg = String::from("14H701");
    assert_eq!("/tmp/test_data2.json",data.dump2file_with_encrypt_arg("/tmp",Some("14H701"),Some(file_name_arg)).unwrap());
    let s_data = TestData2::load_from_file_with_decrypt_arg("/tmp",Some("14H701"),Some(file_name_arg)).unwrap();
    assert_eq!(data, s_data)
}

(4) 使用自定义加密参数加密转储文件，并动态确定文件存储名称 / 使用自定义加密参数加密转储文件，并动态确定文件存储名称

使用默认的aes256gsm加密实现，并需要额外加解密参数。通过get_file_name函数获取文件名称。

加密时使用默认的aes256gsm加密实现，并需要额外加解密参数，通过get_file_name函数获取文件名称。

use serde::{Deserialize, Serialize};
use super::encrypt::Aes256GcmEncryptUtil;
use crate::prelude::*;

fn get_file_name(sys_root:&str,extra:Option<String>) -> DumpResult<String>{
    Ok(format!("{sys_root}/{}",extra.unwrap()))
}

#[allow(dead_code)]
#[derive(Debug, Serialize, Deserialize, Default, PartialEq, Eq, Serde2File)]
#[serde2file(
    encrypt = "TestEncryptTool::encrypt",
    decrypt = "TestEncryptTool::decrypt",
    crypt_arg_type = "&'static str"，
    file_name_getter = "get_file_name",
    file_name_getter_arg_type = "String"
)]
struct TestData2 {
    id: String,
    name: String,
}

/// a encryption and decryption tools
#[allow(dead_code)]
struct TestEncryptTool;
impl Aes256GcmEncryptUtil for TestEncryptTool{
    type CryptArgType = &'static str;
    fn get_aes_key_nonce(extra:Option<Self::CryptArgType>) -> (String, String) {
        (
            format!("*)_#@{}!$=_^20230208)leb*$xz",extra.unwrap_or("140600")),
            "abc$hy%95599".into(),
        )
    }
}

/// Test serialization and encrypted storage to file with extra param
/// 测试序列化并加密存储到文件
#[test]
fn test_serde_file_extra2() {
    let data = TestData2 {
        id: "01".into(),
        name: "hy".into(),
    };

    let file_name_arg = String::from("14H701");
    assert_eq!(
        format!("/tmp/{fiel_name_arg}"),
        data.dump2file_with_encrypt_arg_and_path(
            "/tmp",
            Some("14H701"),
            Some(file_name_arg)
        ).unwrap());
    let s_data = TestData2::load_from_file_with_decrypt_arg_and_path("/tmp",Some("14H701"),Some(file_name_arg)).unwrap();
    assert_eq!(data, s_data)
}

依赖项

~1.4–2.7MB
~52K SLoC