crate_plugin_kit/install/mod.rs
1//! 安装:把 crates.io 上的一个插件 crate 变成磁盘上可 `dlopen` 的 cdylib + manifest。
2//!
3//! 两条路,由 [`crate::CratePluginKit::install`] 按 [`crate::KitConfig::prefer_prebuilt`] 选:
4//!
5//! ```text
6//! prefer_prebuilt = true
7//! └─ prebuilt::try_install ──(没发 prebuilt / 下不到)──> build_host::install
8//! prefer_prebuilt = false
9//! └─ build_host::install
10//! ```
11//!
12//! **build-host 是默认与兜底**:它走 `cargo build`,因此天然使用用户已经配好的
13//! registry / 镜像。prebuilt 从 GitHub 下载会绕开这些配置,所以只当加速项。
14
15pub mod build_host;
16pub mod prebuilt;
17
18use std::path::PathBuf;
19
20use crate::cache::InstallSource;
21
22/// 一次成功安装的产物。
23#[derive(Debug, Clone)]
24pub struct Installed {
25 /// 完整 crate 名,如 `bmux-plugin-cargo`。
26 pub crate_name: String,
27 /// 实际安装的版本。
28 pub version: String,
29 /// 安装目录。
30 pub dir: PathBuf,
31 /// 落地的 cdylib 路径。
32 pub library: PathBuf,
33 /// 怎么来的。
34 pub source: InstallSource,
35}
36
37/// 清理一个目录(不存在也算成功)。
38pub(crate) fn remove_dir_if_exists(dir: &std::path::Path) -> std::io::Result<()> {
39 match std::fs::remove_dir_all(dir) {
40 Ok(()) => Ok(()),
41 Err(e) if e.kind() == std::io::ErrorKind::NotFound => Ok(()),
42 Err(e) => Err(e),
43 }
44}