wcompact 0.1.3

HybridLog read-only segment compaction and garbage collection
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

use std::result;

use thiserror::Error;

/// wedb_compact 模块错误类型
///
/// 错误面 = 紧缩器自身校验错误 + 底层引擎类型化故障的透明转发（对照宿主 wkv
/// error.rs 的 `Compact(#[from] wcompact::Error)` 透明组合关系）：宿主经穷尽映射
/// 注入底层错误，全程无字符串化降级。
#[derive(Error, Debug)]
pub enum Error {
  /// 紧缩目标地址超出只读区边界
  #[error("紧缩目标地址 {until_address:#x} 超出只读区边界 {read_only_address:#x}")]
  UntilAddressOutOfRange {
    until_address: u64,
    read_only_address: u64,
  },

  /// 紧缩会话纪元参与者注册失败（宿主纪元参与者表耗尽）
  #[error(transparent)]
  Epoch(#[from] wepoch::Error),

  /// 混合日志故障（尾部追加、起始地址推进补刷、磁盘记录回读）
  #[error(transparent)]
  Hlog(#[from] whlog::Error),

  /// 记录编解码故障
  #[error(transparent)]
  Record(#[from] wrecord::Error),

  /// 索引故障
  #[error(transparent)]
  Index(#[from] windex::Error),

  /// 块设备故障
  #[error(transparent)]
  Device(#[from] wdev::Error),

  /// 宿主引擎紧缩契约外故障
  #[error("紧缩路径不可达的宿主引擎错误: {0}")]
  Host(String),
}

pub type Result<T> = result::Result<T, Error>;