wacl 0.1.1

Access Control List and authentication with SHA-256 password hashing
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
45
46
47
48
49
50
51
52
53
54
55

//! ACL 异常族（对标 libs/server/ACL/ACLException.cs）
//!
//! C# 以异常类层级表达（ACLException 基类 + 各子类），rust 侧统一收敛为
//! [`AclError`] 枚举，Display 文案与 C# 各子类异常消息逐字一致，供
//! `ERR {message}` 应答直接复用。

use thiserror::Error;

/// ACL 异常（C# 异常族的值化表达）
#[derive(Debug, Error)]
pub enum AclError {
  /// libs/server/ACL/ACLException.cs:ACLException（基类消息档）
  #[error("{0}")]
  Acl(String),
  /// libs/server/ACL/ACLException.cs:ACLParsingException（携带文件与行号上下文）
  #[error("{message}")]
  Parsing {
    /// 解析错误消息
    message: String,
    /// 出错文件名
    filename: String,
    /// 出错行号（-1 表示无行号上下文）
    line: i32,
  },
  /// libs/server/ACL/ACLException.cs:ACLPasswordException
  #[error("{0}")]
  Password(String),
  /// libs/server/ACL/ACLException.cs:ACLUnknownOperationException
  #[error("Unknown operation '{0}'")]
  UnknownOperation(String),
  /// libs/server/ACL/ACLException.cs:ACLCategoryDoesNotExistException
  #[error("ACL Category '{0}' does not exist")]
  CategoryDoesNotExist(String),
  /// libs/server/ACL/ACLException.cs:ACLUserDoesNotExistException
  #[error("A user with name '{0}' does not exist")]
  UserDoesNotExist(String),
  /// libs/server/ACL/ACLException.cs:ACLUserAlreadyExistsException
  #[error("A user with name '{0}' already exists.")]
  UserAlreadyExists(String),
  /// libs/server/ACL/ACLException.cs:AclCommandDoesNotExistException
  #[error("Command '{0}' does not exist")]
  CommandDoesNotExist(String),
}

impl AclError {
  /// 包装成 C# AccessControlList.cs:Load 的解析失败消息
  ///
  /// 对标 `Unable to parse ACL rule {Filename}:{Line}:  {Message}`（注意 C#
  /// 冒号后两个空格）
  pub fn parsing_wrap(message: &str, filename: &str, line: i32) -> Self {
    Self::Acl(format!(
      "Unable to parse ACL rule {filename}:{line}:  {message}"
    ))
  }
}