45 lines
1.5 KiB
Rust
45 lines
1.5 KiB
Rust
//! focus-tools：内置的文件与 shell 工具集。
|
||
//! focus-tools: built-in file and shell tools.
|
||
//!
|
||
//! 每个工具都实现 [`focus_core::Tool`]：`read`、`write`、`edit`、`shell`。
|
||
//! 全部使用同步 `std` I/O（与 core 的同步 `Tool` trait 一致），并原生支持
|
||
//! Windows 与 Linux（路径用 `std::path`，shell 按平台选择）。
|
||
//! Each tool implements [`focus_core::Tool`]: `read`, `write`, `edit`, `shell`.
|
||
//! All use synchronous `std` I/O (consistent with the core's sync `Tool`
|
||
//! trait) and natively support both Windows and Linux (paths via `std::path`,
|
||
//! the shell chosen per platform).
|
||
|
||
#![forbid(unsafe_code)]
|
||
|
||
/// pi 风格的精确替换编辑工具。
|
||
/// The pi-style exact-replacement edit tool.
|
||
pub mod edit;
|
||
/// 读取文件（支持行范围）。
|
||
/// File reading (with optional line ranges).
|
||
pub mod read;
|
||
/// 平台感知的 shell 执行工具。
|
||
/// Platform-aware shell execution tool.
|
||
pub mod shell;
|
||
/// 整文件覆盖写入。
|
||
/// Whole-file overwrite writing.
|
||
pub mod write;
|
||
|
||
pub use edit::EditTool;
|
||
pub use read::ReadTool;
|
||
pub use shell::ShellTool;
|
||
pub use write::WriteTool;
|
||
|
||
use std::path::{Path, PathBuf};
|
||
|
||
/// 把用户提供的路径解析为绝对路径：相对路径基于 `root`，绝对路径原样保留。
|
||
/// Resolve a user-supplied path: relative paths are based on `root`,
|
||
/// absolute paths are kept as-is.
|
||
pub(crate) fn resolve_path(root: &Path, input: &str) -> PathBuf {
|
||
let p = Path::new(input);
|
||
if p.is_absolute() {
|
||
p.to_path_buf()
|
||
} else {
|
||
root.join(p)
|
||
}
|
||
}
|