english 0.2.0

English inflector decliner conjugator from wiktionary data
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
89
90
91
92

use english::*;

fn main() {
    println!("{}", English::noun("thyridium", &Number::Plural));
    benchmark_verb();
    benchmark_noun();
    benchmark_adj();
}
use std::hint::black_box;
use std::time::Instant;

pub fn benchmark_verb() {
    let words = [
        "zzzzzzzzzzzzzzzzz",
        //   "xxxxxxxxxxxx",
        //  "yyyyyyyyyyyy",
        //   "aaaaaaaaaaaaaaaaaaaaa",
        //  "wwwwwwwwwww",
        //   "lllllllllll",
    ];
    let person = Person::Third;
    let number = Number::Singular;
    let tense = Tense::Present;
    let form = Form::Finite;

    run_benchmark("verb", &words, |w| {
        English::verb(w, &person, &number, &tense, &form)
    });
}

pub fn benchmark_noun() {
    //tests for genereally worst case scenario, long word that is outside the array
    let words = [
        "zzzzzzzzzzzzzzzzz",
        //   "xxxxxxxxxxxx",
        //  "yyyyyyyyyyyy",
        //   "aaaaaaaaaaaaaaaaaaaaa",
        //  "wwwwwwwwwww",
        //   "lllllllllll",
    ];

    run_benchmark("noun", &words, |w| English::noun(w, &Number::Plural));
}

pub fn benchmark_adj() {
    let words = [
        "zzzzzzzzzzzzzzzzz",
        //   "xxxxxxxxxxxx",
        //  "yyyyyyyyyyyy",
        //   "aaaaaaaaaaaaaaaaaaaaa",
        //  "wwwwwwwwwww",
        //   "lllllllllll",
    ];

    run_benchmark("adjective", &words, |w| {
        English::adj(w, &Degree::Comparative)
    });
}

fn run_benchmark<F>(label: &str, words: &[&str], mut f: F)
where
    F: FnMut(&str) -> String,
{
    let iterations = 1_000_000;
    let total_calls = iterations * words.len();

    let start = Instant::now();
    let mut last_result = String::new();

    for _ in 0..iterations {
        for &word in words {
            // black_box prevents the optimizer from removing the call
            last_result = black_box(f(black_box(word)));
        }
    }

    let duration = start.elapsed();
    let nanos = duration.as_nanos() as f64;
    let calls_per_sec = (total_calls as f64) / (nanos / 1e9);

    let nanos_per_call = nanos / total_calls as f64;

    println!("[{label}] Last result: {last_result}");
    println!(
        "[{label}] Completed in {:?} → {} calls",
        duration, total_calls
    );
    println!(
        "[{label}] Throughput: {:.2} calls/sec | Time per call: {:.2} ns",
        calls_per_sec, nanos_per_call
    );
}