pub enum KitError {
Show 20 variants
NotInstalled {
name: String,
},
AlreadyInstalled {
name: String,
path: PathBuf,
},
PluginInUse {
name: String,
},
ManifestRead {
path: PathBuf,
source: Error,
},
ManifestParse {
path: PathBuf,
source: Box<Error>,
},
ManifestMissingField {
field: String,
path: PathBuf,
},
LibraryNotFound {
name: String,
tried: String,
},
LibraryLoad {
path: PathBuf,
source: Box<Error>,
},
SymbolMissing {
symbol: String,
},
NullEntry,
LockTimeout {
path: PathBuf,
secs: u64,
},
LockIo {
path: PathBuf,
source: Error,
},
CargoNotFound,
BuildFailed {
code: Option<i32>,
},
BuildArtifactMissing {
stem: String,
dir: String,
},
Http(String),
Registry(String),
PluginPanicked {
what: String,
},
NoDataDir,
Io(Error),
}Expand description
kit 的错误。
变体分两类:
- 调用方能处理的:
KitError::NotInstalled/KitError::AlreadyInstalled/KitError::PluginInUse/KitError::CargoNotFound—— 调用方通常据此换一条路或提示用户; - 环境/数据坏了的:其余。基本只能上报。
Variants§
NotInstalled
要卸载/更新的插件没装。
AlreadyInstalled
要安装的插件已经在了。
这是刻意的:install 不覆盖已有的安装,替换请走 update。
PluginInUse
插件的动态库仍在本进程里加载着,删不掉。
Windows 上正在 dlopen 的 .dll 无法删除;Linux/macOS 上删得掉但空间不回收。
与其赌,不如让用户换一个干净的进程。
ManifestRead
读 manifest 文件失败。
ManifestParse
manifest 不是合法 TOML,或字段类型不对。
ManifestMissingField
manifest 里某个必填字段缺失或为空。
LibraryNotFound
安装目录里找不到符合命名规则的动态库。
LibraryLoad
dlopen 本身失败(文件损坏、架构不符、缺依赖库)。
SymbolMissing
动态库加载成功,但没有我们找的那个导出符号。
常见于“装错了东西“—— 比如把一个普通库放进了插件目录。
NullEntry
插件的入口函数返回了空指针。
LockTimeout
等安装锁超时。
LockIo
锁文件本身操作失败。
CargoNotFound
PATH 里没有 cargo,build-host 装不了。
调用方可以据此提示用户“装个 Rust 工具链“,或改走 prebuilt。
BuildFailed
cargo build 失败。stderr 已经透传给用户了(stdio 继承)。
BuildArtifactMissing
编译成功了,但产物里找不到 cdylib。
Http(String)
网络请求失败。字符串里带 URL 与状态码。
Registry(String)
registry 返回了能拿到、但不符合预期的内容。
PluginPanicked
跨边界调用时插件 panic 了(宿主侧 catch_unwind 捕获)。
NoDataDir
既没有 HOME 也没有等价的系统目录,数据目录定不下来。
Io(Error)
IO 错误。
Trait Implementations§
Source§impl Error for KitError
impl Error for KitError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
👎Deprecated since 1.42.0:
use the Display impl or to_string()
Auto Trait Implementations§
impl !RefUnwindSafe for KitError
impl !UnwindSafe for KitError
impl Freeze for KitError
impl Send for KitError
impl Sync for KitError
impl Unpin for KitError
impl UnsafeUnpin for KitError
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more