blame-rs – In Rust geschriebene Bibliothek zur zeilenweisen Autorenverfolgung

Ich habe eine Rust-Bibliothek erstellt, mit der sich nachverfolgen lässt, in welcher Revision jede Zeile einer Textdatei geschrieben wurde.

Hauptfunktionen:

• Generische Metadaten-API: Beliebige Metadatentypen wie Commit-Hash, Autor und Zeitstempel können angehängt werden
• Verschiedene Diff-Algorithmen: Unterstützung für Myers (Standard) und Patience
• Auf hohe Leistung ausgelegt: Zero-Copy-Zeilenverfolgung, gemeinsames Nutzen von Metadaten über Rc
• Forward Tracking: Effiziente Nachverfolgung der Zeilenherkunft von der ältesten bis zur neuesten Revision
• Umfassende Tests: Fixture-basierte Tests zur Überprüfung realer Szenarien

Links:

• crates.io: https://crates.io/crates/blame-rs
• Quellcode: https://github.com/levish0/blame-rs
• Dokumentation: https://docs.rs/blame-rs

usage:

use blame_rs::DiffAlgorithm::{Myers, Patience};  
use blame_rs::{BlameOptions, BlameRevision, blame_with_options};  
use std::fs;  
use std::rc::Rc;  
  
#[derive(Debug)]  
struct CommitInfo {  
    hash: String,  
    author: String,  
    message: String,  
}  
  
fn main() {  
    // Read revision files  
    let rev0 = fs::read_to_string("examples/rev0.txt").expect("Failed to read rev0.txt");  
    let rev1 = fs::read_to_string("examples/rev1.txt").expect("Failed to read rev1.txt");  
    let rev2 = fs::read_to_string("examples/rev2.txt").expect("Failed to read rev2.txt");  
  
    // Create revisions with metadata  
    let revisions = vec![  
        BlameRevision {  
            content: &rev0,  
            metadata: Rc::new(CommitInfo {  
                hash: "abc123".to_string(),  
                author: "Alice".to_string(),  
                message: "Initial commit".to_string(),  
            }),  
        },  
        BlameRevision {  
            content: &rev1,  
            metadata: Rc::new(CommitInfo {  
                hash: "def456".to_string(),  
                author: "Bob".to_string(),  
                message: "Add greeting message".to_string(),  
            }),  
        },  
        BlameRevision {  
            content: &rev2,  
            metadata: Rc::new(CommitInfo {  
                hash: "789abc".to_string(),  
                author: "Charlie".to_string(),  
                message: "Update greeting and add footer".to_string(),  
            }),  
        },  
    ];  
  
    // Run blame  
    let result = blame_with_options(  
        &revisions,  
        BlameOptions {  
            algorithm: Patience,  
        },  
    )  
    .expect("Blame operation failed");  
}  

Blame Results:  
================================================================================  
Line   Commit     Author          Content  
================================================================================  
1      abc123     Alice           fn main() {  
2      abc123     Alice               println!("Hello, world!");  
3      def456     Bob                 println!("Bob did this");  
4      def456     Bob             }  
5      789abc     Charlie         fn main() {  
6      789abc     Charlie             println!("Hello, world!");  
7      789abc     Charlie         }  
  
================================================================================  
Revision Details:  
================================================================================  
Revision 0: abc123 - Alice - "Initial commit"  
Revision 1: def456 - Bob - "Add greeting message"  
Revision 2: 789abc - Charlie - "Update greeting and add footer"