pi_block_device 0.1.0

Asynchronous copy-on-write block storage abstractions
Documentation
//! 文件存储的固定目录和文件命名布局。

use std::path::{Path, PathBuf};

/// 返回存储根下固定的 data 子目录路径。
pub(crate) fn data_dir(root: &Path) -> PathBuf {
    root.join("data")
}

/// 返回存储根下固定的 log 子目录路径。
pub(crate) fn log_dir(root: &Path) -> PathBuf {
    root.join("log")
}

/// 返回指定普通级别初始 Active 段文件路径;调用方必须传入 `0..=14`,初始版本固定为 `level + 1`。
/// 本函数只格式化路径,不自行校验范围。
pub(crate) fn active_file(root: &Path, level: u8) -> PathBuf {
    data_dir(root).join(format!("{level:x}.{:07x}", u32::from(level) + 1))
}

/// 返回初始化时首个 active 追加日志文件路径。
pub(crate) fn initial_log_file(root: &Path) -> PathBuf {
    log_dir(root).join("00000001.active")
}