AnyRepair

A Rust crate for repairing malformed structured data across 10 formats (JSON, YAML, Markdown, XML, TOML, CSV, INI, Diff, Java properties, and .env).

Quick Start

Installation

[dependencies]
anyrepair = "0.2.7"

Basic Usage

use anyrepair::repair;

// Auto-detect format and repair
let malformed = r#"{"name": "John", age: 30,}"#;
let repaired = repair(malformed)?;
println!("{}", repaired); // {"name": "John", "age": 30}

CLI

# Install
cargo install anyrepair

# Auto-detect and repair
anyrepair repair input.json

# Format-specific repair
anyrepair repair input.json --format json
anyrepair repair input.yaml --format yaml
anyrepair repair config.ini --format ini
anyrepair repair app.properties --format properties
anyrepair repair .env --format env

# Show confidence score
anyrepair repair input.json --format json --confidence

# Batch process multiple files
anyrepair batch --input ./data --output ./repaired --recursive

# Stream large files
anyrepair stream --input large_file.json --output repaired.json --format json

# Validation without repair
anyrepair validate --input input.json --format json

What's New

v0.2.7 — Current

• Auto-detect properties & env — detect_format() now recognizes .properties and .env files
• Heuristic validator fixes — XML content = false positive fixed, entity corruption fixed, CSV destructive space→comma fixed
• Zero compiler warnings — Dead code removed, mut qualifiers cleaned
• Criterion benchmarks — All 10 formats + format detection + large-document throughput
• 353 tests, all passing, zero warnings

v0.2.6

• Minimal dependencies — Runtime: regex, thiserror, clap only (no serde, serde_json, serde_yaml, quick-xml, toml, csv, or ini crates)
• json_util module — Built-in JSON validation, escaping, and MCP payloads without external JSON libraries
• Heuristic validators for XML, TOML, CSV, and YAML (structural checks instead of full parser crates)
• 316 tests, all passing

v0.2.5

• Properties & .env formats — PropertiesRepairer and EnvRepairer in key_value.rs
• 10 formats in SUPPORTED_FORMATS; MCP exposes 12 tools
• Removed ini crate; INI/properties/env share native key-value repair

v0.2.0–0.2.4 (highlights)

• Centralized format registry and unified repair --format CLI
• Python-compatible jsonrepair() / JsonRepair API
• Diff support and streaming for large files
• Earlier dependency cleanup (pulldown-cmark, anyhow, and others)

See CHANGELOG.md for full version history.

Why AnyRepair?

Structured data from LLMs, APIs, or manual editing is often malformed. AnyRepair fixes common issues:

• JSON: Missing quotes, trailing commas, syntax errors
• YAML: Indentation, missing colons
• Markdown: Headers, links, fences
• XML / TOML / CSV / INI / Diff: Format-specific repairs
• Properties / .env: Key=value lines, sections, escaping

Key features:

• Auto-detects format for all 10 formats
• Deterministic heuristic repairs (no network, no ML)
• Small dependency footprint (three runtime crates)
• MCP server for Claude and other MCP clients
• Streaming for large files
• Python-compatible JSON API
• 353 tests (cargo test)

Dependencies

Parsing and validation for JSON, XML, TOML, CSV, and YAML use in-crate heuristics and json_util rather than heavyweight parser dependencies.

Usage Examples

Multi-Format Auto-Detection

use anyrepair::repair;

let json = repair(r#"{"key": value,}"#)?;
let yaml = repair("name: John\nage: 30")?;
let markdown = repair("# Header\n[link](url")?;

Explicit key-value formats

use anyrepair::repair_with_format;

let props = repair_with_format("db.url jdbc:postgresql://localhost", "properties")?;
let env = repair_with_format("API_KEY = secret", "env")?;

Python-Compatible JSON API

use anyrepair::{jsonrepair, JsonRepair};

let repaired = jsonrepair(r#"{"name": "John", age: 30,}"#)?;

let mut jr = JsonRepair::new();
let repaired = jr.jsonrepair(r#"{name: "John"}"#)?;

Format-Specific Repairers

use anyrepair::{create_repairer, repair_with_format, traits::Repair};

let mut repairer = create_repairer("json")?;
let repaired = repairer.repair(malformed_json)?;
let confidence = repairer.confidence(&repaired);

let repaired = repair_with_format(malformed_yaml, "yaml")?;

Streaming Large Files

use anyrepair::StreamingRepair;
use std::fs::File;
use std::io::BufReader;

let input = BufReader::new(File::open("large_file.json")?);
let mut output = File::create("repaired.json")?;

let processor = StreamingRepair::with_buffer_size(65536);
processor.process(input, &mut output, Some("json"))?;

MCP Server Integration

cargo install anyrepair
anyrepair-mcp

claude_desktop_config.json:

{
  "mcpServers": {
    "anyrepair": {
      "command": "anyrepair-mcp"
    }
  }
}

Tools: repair, repair_json, repair_yaml, repair_markdown, repair_xml, repair_toml, repair_csv, repair_ini, repair_diff, repair_properties, repair_env, validate.

See MCP_SERVER.md for setup details.

Supported Formats

Performance

• Strategy pipeline with priority ordering
• Release profile optimized for size (opt-level = "z", LTO, strip)
• Streaming for files larger than RAM
• Fewer transitive dependencies for faster builds and smaller binaries

cargo build --release
cargo build --profile dist   # distribution profile in Cargo.toml

Testing

cargo test

See TEST_SUMMARY.md for more detail.

Comparison

Documentation

Links: GitHub Issues · crates.io · docs.rs

Examples

cargo run --example mcp_repair_json
cargo run --example mcp_multi_format

See examples/ and examples/README.md.

Roadmap

See TODO.md for planned work (Protobuf, CLI polish, web/API, format-preserving repairs, and more).

License

Apache-2.0

Repository

If AnyRepair helps you, consider starring the repo on GitHub — it helps others find the project.

https://github.com/yingkitw/anyrepair