blame-rs - Biblioteca para rastrear autores por línea escrita en Rust
(github.com/levish0)Creé una biblioteca en Rust que permite rastrear en qué revisión fue escrita cada línea de un archivo de texto.
Funciones principales:
- API de metadatos genérica: permite adjuntar el tipo de metadatos que quieras, como hash del commit, autor, marca de tiempo, etc.
- Varios algoritmos de diff: compatibilidad con los algoritmos Myers (predeterminado) y Patience
- Diseño de alto rendimiento: rastreo de líneas con zero-copy, uso compartido de metadatos mediante Rc
- Rastreo hacia adelante: seguimiento eficiente del origen de las líneas desde la revisión más antigua hasta la más reciente
- Pruebas exhaustivas: validación de escenarios reales con pruebas basadas en fixtures
Enlaces:
- crates.io: https://crates.io/crates/blame-rs
- Código fuente: https://github.com/levish0/blame-rs
- Documentación: https://docs.rs/blame-rs
uso:
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"
Aún no hay comentarios.