🛠️ Git Editor - Complete Technical Documentation

# Download the latest release for your platform
wget https://github.com/rohansen856/git-editor/releases/latest/download/git-editor-linux-x64.tar.gz
tar -xzf git-editor-linux-x64.tar.gz
sudo mv git-editor /usr/local/bin/

# Verify installation
git-editor --help

# Prerequisites: Rust 1.70+ and Git
rustup update stable

# Clone and build
git clone https://github.com/rohansen856/git-editor.git
cd git-editor

# Build release binary
cargo build --release

# Install globally
sudo cp target/release/git-editor /usr/local/bin/

# Or use cargo install
cargo install --path .

# Build Docker image
docker build -t git-editor .

# Run with repository mounted
docker run -v /path/to/repo:/workspace git-editor --repo-path /workspace --docs

git-editor/
├── src/
│   ├── main.rs              # Entry point and mode dispatch
│   ├── args.rs              # CLI argument parsing (clap)
│   ├── docs.rs              # Documentation generation
│   ├── rewrite/
│   │   ├── mod.rs           # Rewrite module exports
│   │   ├── rewrite_all.rs   # Full history rewriting
│   │   ├── rewrite_specific.rs # Interactive commit selection
│   │   └── rewrite_range.rs # Range-based editing
│   └── utils/
│       ├── mod.rs           # Utility module exports
│       ├── types.rs         # Common types and aliases
│       ├── validator.rs     # Input validation
│       ├── datetime.rs      # Timestamp generation
│       ├── commit_history.rs# Git operations
│       ├── prompt.rs        # User interaction
│       ├── git_clone.rs     # Repository cloning
│       ├── git_config.rs    # Git configuration
│       └── simulation.rs    # Dry-run functionality
├── docs/
│   └── template.html        # Documentation template
├── tests/
│   └── integration_tests.rs # Integration test suite
├── Cargo.toml              # Dependencies and metadata
├── Dockerfile              # Container configuration
└── Makefile                # Build automation

# Development build (fast compilation)
cargo build

# Release build (optimized)
cargo build --release

# Run with arguments
cargo run -- --help
cargo run -- --repo-path . -s

# Watch mode for development
cargo watch -x "run -- --docs"

# Run all tests (98 total)
cargo test

# Run unit tests only (78 tests)
cargo test --lib

# Run integration tests only (20 tests)
cargo test --test integration_tests

# Run specific test with output
cargo test --test integration_tests test_show_history_mode_integration -- --nocapture

# Run tests without browser opening (for development)
GIT_EDITOR_NO_BROWSER=1 cargo test --all

# Format code
cargo fmt

# Check formatting without changes
cargo fmt --check

# Run linter
cargo clippy

# Run linter with strict warnings (CI requirement)
cargo clippy -- -D warnings

# Security audit
cargo audit

# Check for outdated dependencies
cargo outdated

# Build release binary
make build

# Run all tests
make test

# Check code formatting
make fmt

# Run clippy linter
make lint

# Run with default parameters
make run

# Run with custom environment variables
make run-custom

# Clean build artifacts
make clean

# Build Docker image
make docker-build

# Run in Docker container
make docker-run

# Install binary to /usr/local/bin
make install

# Show all available commands
make help

// Get comprehensive commit history
pub fn get_commit_history(args: &Args, print: bool) -> Result<Vec<CommitInfo>>

// Analyze repository structure
pub fn analyze_repository(repo_path: &str) -> Result<RepositoryStats>

// Validate repository integrity
pub fn validate_repository(repo_path: &str) -> Result<()>

// Generate realistic timestamp distribution
pub fn generate_timestamps(
    start: &str,
    end: &str,
    count: usize
) -> Result<Vec<DateTime<Utc>>>

// Create business-hour weighted distribution
pub fn generate_business_hour_timestamps(
    start: DateTime<Utc>,
    end: DateTime<Utc>,
    commit_count: usize
) -> Vec<DateTime<Utc>>

// Full repository history rewrite
pub fn rewrite_all_commits(args: &Args) -> Result<()>

// Interactive commit selection and editing
pub fn rewrite_specific_commits(args: &Args) -> Result<()>

// Range-based commit editing
pub fn rewrite_range_commits(args: &Args) -> Result<()>

pub struct CommitInfo {
    pub hash: String,              // Full SHA-1 hash
    pub short_hash: String,        // Abbreviated hash (7 chars)
    pub timestamp: DateTime<Utc>,   // Commit timestamp
    pub author_name: String,       // Author display name
    pub author_email: String,      // Author email address
    pub message: String,           // Commit message
    pub parent_count: usize,       // Number of parent commits
}

pub struct EditOptions {
    pub edit_author_name: bool,    // Enable author name editing
    pub edit_author_email: bool,   // Enable author email editing
    pub edit_timestamp: bool,      // Enable timestamp editing
    pub edit_message: bool,        // Enable message editing
    pub new_author_name: Option<String>,
    pub new_author_email: Option<String>,
    pub new_message: Option<String>,
}