use std::path::PathBuf;
#[derive(Debug, thiserror::Error)]
pub enum KitError {
#[error("插件 {name} 未安装")]
NotInstalled {
name: String,
},
#[error("插件 {name} 的目录已存在:{path}")]
AlreadyInstalled {
name: String,
path: PathBuf,
},
#[error(
"插件 {name} 的动态库仍在本进程中加载,无法删除。\
请在一个新终端里重试(新进程不会加载它),或退出当前会话后再执行"
)]
PluginInUse {
name: String,
},
#[error("读 manifest 失败({path}):{source}")]
ManifestRead {
path: PathBuf,
#[source]
source: std::io::Error,
},
#[error("解析 manifest 失败({path}):{source}")]
ManifestParse {
path: PathBuf,
#[source]
source: Box<toml::de::Error>,
},
#[error("manifest 缺少字段 `{field}`({path})")]
ManifestMissingField {
field: String,
path: PathBuf,
},
#[error("找不到插件 {name} 的动态库。试过:{tried}")]
LibraryNotFound {
name: String,
tried: String,
},
#[error("加载动态库失败({path}):{source}")]
LibraryLoad {
path: PathBuf,
#[source]
source: Box<libloading::Error>,
},
#[error("动态库里没有导出符号 `{symbol}`")]
SymbolMissing {
symbol: String,
},
#[error("插件的入口函数返回了空指针")]
NullEntry,
#[error("等待文件锁超时({path},等了 {secs} 秒)")]
LockTimeout {
path: PathBuf,
secs: u64,
},
#[error("文件锁操作失败({path}):{source}")]
LockIo {
path: PathBuf,
#[source]
source: std::io::Error,
},
#[error("PATH 里找不到 `cargo`;build-host 安装需要 Rust 工具链")]
CargoNotFound,
#[error("build-host 编译失败(退出码 {code:?})")]
BuildFailed {
code: Option<i32>,
},
#[error("编译产物里找不到 cdylib(找的是 {stem},目录 {dir})")]
BuildArtifactMissing {
stem: String,
dir: String,
},
#[error("网络请求失败:{0}")]
Http(String),
#[error("registry 返回了意外的响应:{0}")]
Registry(String),
#[error("插件在 {what} 时 panic(已由 catch_unwind 捕获)")]
PluginPanicked {
what: String,
},
#[error("宿主应用的数据目录无法确定(既没有 HOME 也没有系统等价物)")]
NoDataDir,
#[error(transparent)]
Io(#[from] std::io::Error),
}
pub type KitResult<T> = std::result::Result<T, KitError>;