diff.rs

//! # Diff Module
//!
//! The diff module provides functionality for comparing files and parsing unified diff output.
//! It supports both Git diff and standard GNU diff formats, parsing them into a structured
//! representation for further processing.
//!
//! ## Overview
//!
//! This module is organized into three main components:
//!
//! - **models**: Data structures representing diff output, hunks, and individual lines
//! - **utils**: Utilities for executing diff commands (git diff or standard diff)
//! - **parser**: Functionality for parsing unified diff output into structured data
//!
//! ## Diff Types
//!
//! The module supports two diff formats:
//!
//! - **GitDiff**: Output from `git diff --no-index`, which includes `a/` and `b/` prefixes
//! - **GNUDiff**: Output from the standard `diff -u` command
//!
//! The module automatically attempts to use git diff first, falling back to standard diff
//! if git is not available.
//!
//! ## Data Flow
//!
//! ```text
//! File 1 & File 2
//!        ↓
//!   run_diff()  ← Executes diff command
//!        ↓
//!   DiffOutput  ← Raw diff output with metadata
//!        ↓
//! parse_unified_diff()  ← Parses diff text
//!        ↓
//!   DiffResult  ← Structured representation
//!        ↓
//!    Hunks & Lines  ← Individual changes
//! ```
//!
//! ## Usage Example
//!
//! ```ignore
//! use diff::utils;
//! use diff::parser;
//! use diff::models::LineType;
//!
//! // Run a diff on two files
//! let diff_output = utils::run_diff("file1.txt", "file2.txt")?;
//!
//! // Parse the diff output into a structured format
//! let diff_result = parser::parse_unified_diff(diff_output)?;
//!
//! // Check if there are any changes
//! if diff_result.has_changes() {
//!     println!("Files differ");
//! } else {
//!     println!("Files are identical");
//! }
//!
//! // Process hunks and lines
//! for hunk in diff_result.hunks {
//!     println!("Hunk at old line {}: {} changes", hunk.old_start, hunk.lines.len());
//!     for line in hunk.lines {
//!         match line.line_type {
//!             LineType::Added => println!("+ {}", line.content),
//!             LineType::Deleted => println!("- {}", line.content),
//!             LineType::Context => println!("  {}", line.content),
//!         }
//!     }
//! }
//! ```

pub mod models;
pub mod parser;
pub mod utils;