patchloom 0.11.0

Structured file editing library and CLI for AI agents: parser-backed JSON/YAML/TOML edits, AST-aware code operations, multi-file batching, markdown operations, and MCP server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Whitespace / newline / EOL tidy CLI (`patchloom tidy check|fix`).
//!
//! - [`check`]: report issues (parallel scan)
//! - [`fix`]: dirty-file scan then engine stage + finalize_report

mod check;
mod fix;

pub use check::TidyIssue;

use crate::cli::global::GlobalFlags;
use clap::Args;

#[derive(Debug, Args)]
#[command(after_help = "\
EXAMPLES:
  patchloom tidy fix . --apply
  patchloom tidy fix src/ --ensure-final-newline --apply
  patchloom tidy fix . --trim-trailing-whitespace --apply
  patchloom tidy check . --normalize-eol lf

With no write-policy flags, `tidy fix` enables final-newline and trailing-
whitespace fixes (the same issues `tidy check` always reports). Pass explicit
flags to narrow the fix set.")]
pub struct TidyArgs {
    #[command(subcommand)]
    pub action: TidyAction,
    #[command(flatten)]
    pub write: crate::cli::global::WriteFlags,
}

#[derive(Debug, clap::Subcommand)]
pub enum TidyAction {
    /// Report newline, EOL, and whitespace issues in text files.
    Check { paths: Vec<String> },
    /// Apply normalization fixes to text files.
    Fix {
        paths: Vec<String>,
        /// Dedent: remove leading whitespace. Values: "auto", "tab", or a number (e.g. "4").
        #[arg(long)]
        dedent: Option<String>,
        /// Indent: add leading whitespace. Values: "tab" or a number (e.g. "4").
        #[arg(long)]
        indent: Option<String>,
        /// Restrict dedent/indent to a line range (1-based inclusive, e.g. "10:50" or "10-50").
        #[arg(long)]
        lines: Option<String>,
    },
}

pub fn run(args: TidyArgs, global: &GlobalFlags) -> anyhow::Result<u8> {
    crate::verbose!("tidy: action={:?}", std::mem::discriminant(&args.action));
    match args.action {
        TidyAction::Check { paths } => check::run_check(&paths, global),
        TidyAction::Fix {
            paths,
            dedent,
            indent,
            lines,
        } => fix::run_fix(paths, dedent, indent, lines, global),
    }
}

#[cfg(test)]
mod tests;