Skip to main content

yang_base/definition/
error.rs

1//! 定义构建错误。
2
3use thiserror::Error;
4
5/// App 定义在冻结前发现的结构化错误。
6#[derive(Debug, Clone, PartialEq, Eq, Error)]
7#[non_exhaustive]
8pub enum BuildError {
9    /// 名称不符合对应命名规则。
10    #[error("{kind} 名称非法: {name}")]
11    InvalidName {
12        /// 名称种类。
13        kind: &'static str,
14        /// 非法名称。
15        name: String,
16    },
17    /// 同一命名空间出现重复名称。
18    #[error("{kind} 名称重复: {name}")]
19    DuplicateName {
20        /// 名称种类。
21        kind: &'static str,
22        /// 重复名称。
23        name: String,
24    },
25    /// 定义引用的目标不存在。
26    #[error("{kind} 引用无效: {reference}")]
27    InvalidReference {
28        /// 引用种类。
29        kind: &'static str,
30        /// 无法解析的引用。
31        reference: String,
32    },
33    /// HTTP method 与 path 的匹配集合发生冲突。
34    #[error("route 冲突: {method} {path}{detail}")]
35    RouteConflict {
36        /// HTTP method。
37        method: String,
38        /// 路由模板。
39        path: String,
40        /// 底层模板匹配器提供的可选细节。
41        detail: String,
42    },
43    /// 路由声明本身非法。
44    #[error("route 非法: {method} {path}: {reason}")]
45    InvalidRoute {
46        /// HTTP method。
47        method: String,
48        /// 路由模板。
49        path: String,
50        /// 失败原因。
51        reason: String,
52    },
53    /// 字段定义内部存在矛盾或无效配置。
54    #[error("字段定义非法 [{table}.{field}]: {reason}")]
55    InvalidFieldDefinition {
56        /// 表名。
57        table: String,
58        /// 字段名。
59        field: String,
60        /// 失败原因。
61        reason: String,
62    },
63    /// Addon 声明的依赖没有注册。
64    #[error("Addon 依赖缺失 [{addon}]: {dependency}")]
65    DependencyMissing {
66        /// 声明依赖的 Addon。
67        addon: String,
68        /// 缺失的 Addon。
69        dependency: String,
70    },
71}