rwer 0.2.2

A fast Rust crate for WER, CER, and related ASR evaluation metrics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! # rwer
//!
//! A modern Rust crate for Word Error Rate (WER), Character Error Rate (CER),
//! and related ASR (Automatic Speech Recognition) evaluation metrics.
//!
//! ## Quick Start
//!
//! ```
//! use rwer::{cer, wer};
//!
//! let reference = "the cat sat on the mat";
//! let hypothesis = "the cat sat on a mat";
//!
//! println!("WER: {:.2}%", wer(reference, hypothesis) * 100.0);
//! println!("CER: {:.2}%", cer(reference, hypothesis) * 100.0);
//! ```
//!
//! ## Metrics
//!
//! - **WER** (Word Error Rate): `(S + D + I) / N`
//! - **CER** (Character Error Rate): Same formula at Unicode grapheme cluster level, with NFC normalization for consistent results
//! - **MER** (Match Error Rate): `(S + D + I) / (H + S + D + I)`
//! - **WIP** (Word Information Preserved): `(H/N) * (H/(H+S+D+I))`
//! - **WIL** (Word Information Lost): `1 - WIP`
//!
//! ## Transforms
//!
//! ```
//! use rwer::{wer, Compose, ToLower, RemovePunctuation, Transform};
//!
//! let pipeline = Compose::new(vec![
//!     Box::new(ToLower),
//!     Box::new(RemovePunctuation),
//! ]);
//!
//! let ref_text = pipeline.transform("Hello, World!");
//! let hyp_text = pipeline.transform("hello world");
//! assert!(wer(&ref_text, &hyp_text) < 1e-10);
//! ```
//!
//! ## Feature Flags
//!
//! - `chinese-variant` — Enable Traditional/Simplified Chinese conversion using zhconv
//! - `cli` — Enable the CLI binary

#![forbid(unsafe_code)]
#![warn(missing_docs)]
#![deny(clippy::all)]
#![deny(clippy::pedantic)]

/// Levenshtein alignment and edit operations.
pub mod alignment;

/// WER, CER, MER, WIP, WIL metric computation.
pub mod metrics;

/// Alignment output, visualization, and error analysis.
pub mod output;

/// Text transform pipeline for preprocessing.
pub mod transform;

/// Prelude module with commonly used items.
pub mod prelude {
    pub use crate::metrics::{cer, mer, wer, wil, wip};
    pub use crate::output::{AlignmentOutput, ErrorCounts, visualize_alignment};
    pub use crate::transform::{Compose, ToLower, Transform};

    #[cfg(feature = "chinese-variant")]
    pub use crate::transform::{ToSimplified, ToTraditional};
}

// Re-export main API items
pub use crate::alignment::{EditOp, OperationCounts, align, count_operations};
pub use crate::metrics::{cer, mer, process_chars, process_words, wer, wer_sentences, wil, wip};
pub use crate::output::{
    AlignmentChunk, AlignmentOutput, ErrorCounts, collect_error_counts, visualize_alignment,
};
pub use crate::transform::{
    Compose, ExpandCommonEnglishContractions, NormalizeSpaces, RemovePunctuation,
    RemoveSpecificWords, RemoveWhitespace, Strip, SubstituteWords, ToLower, ToUpper, Transform,
};

#[cfg(feature = "chinese-variant")]
pub use crate::transform::{ToSimplified, ToTraditional};

#[cfg(feature = "cli")]
pub mod cli;