shlesha 0.5.7

High-performance extensible transliteration library with hub-and-spoke architecture
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

#!/usr/bin/env python3
"""
Quick Performance Test: Shlesha vs Vidyut
Shows the impact of Aho-Corasick optimization
"""

import time
import statistics

def test_conversion(name, shlesha_func, vidyut_func, iterations=3000):
    """Test and compare a specific conversion."""
    print(f"\n🧪 Testing: {name}")
    print("-" * 50)
    
    # Test Shlesha
    times = []
    for _ in range(iterations):
        start = time.perf_counter()
        shlesha_func()
        times.append(time.perf_counter() - start)
    
    shlesha_avg = statistics.mean(times)
    shlesha_throughput = 1 / shlesha_avg
    
    # Test Vidyut
    times = []
    for _ in range(iterations):
        start = time.perf_counter()
        vidyut_func()
        times.append(time.perf_counter() - start)
    
    vidyut_avg = statistics.mean(times)
    vidyut_throughput = 1 / vidyut_avg
    
    # Compare
    if shlesha_avg < vidyut_avg:
        faster = "Shlesha"
        speedup = vidyut_avg / shlesha_avg
    else:
        faster = "Vidyut"
        speedup = shlesha_avg / vidyut_avg
    
    print(f"Shlesha: {shlesha_throughput:,.0f} conversions/second")
    print(f"Vidyut:  {vidyut_throughput:,.0f} conversions/second")
    print(f"🏆 {faster} is {speedup:.2f}x faster!")
    
    return {
        'name': name,
        'faster': faster,
        'speedup': speedup,
        'shlesha_throughput': shlesha_throughput,
        'vidyut_throughput': vidyut_throughput
    }

def main():
    """Run the performance comparison."""
    import shlesha
    from vidyut.lipi import transliterate, Scheme
    
    print("⚡ Shlesha vs Vidyut Performance Comparison")
    print("=" * 60)
    print("Testing the impact of Aho-Corasick optimization")
    
    results = []
    
    # Test 1: Indic → Indic (where Shlesha should win)
    def shlesha_indic(): 
        return shlesha.transliterate("నమస్కారం", "telugu", "devanagari")
    def vidyut_indic(): 
        return transliterate("నమస్కారం", Scheme.Telugu, Scheme.Devanagari)
    
    results.append(test_conversion(
        "Indic → Indic (Telugu → Devanagari)",
        shlesha_indic, vidyut_indic
    ))
    
    # Test 2: Roman → Roman (Aho-Corasick optimization)
    def shlesha_roman(): 
        return shlesha.transliterate("namaskāram", "iast", "slp1")
    def vidyut_roman(): 
        return transliterate("namaskāram", Scheme.Iast, Scheme.Slp1)
    
    results.append(test_conversion(
        "Roman → Roman (IAST → SLP1)",
        shlesha_roman, vidyut_roman
    ))
    
    # Test 3: Roman → Indic (complex pipeline)
    def shlesha_roman_indic(): 
        return shlesha.transliterate("saṃskṛtam", "iast", "telugu")
    def vidyut_roman_indic(): 
        return transliterate("saṃskṛtam", Scheme.Iast, Scheme.Telugu)
    
    results.append(test_conversion(
        "Roman → Indic (IAST → Telugu)",
        shlesha_roman_indic, vidyut_roman_indic
    ))
    
    # Test 4: Indic → Roman
    def shlesha_indic_roman(): 
        return shlesha.transliterate("సంస్కృతం", "telugu", "slp1")
    def vidyut_indic_roman(): 
        return transliterate("సంస్కృతం", Scheme.Telugu, Scheme.Slp1)
    
    results.append(test_conversion(
        "Indic → Roman (Telugu → SLP1)",
        shlesha_indic_roman, vidyut_indic_roman
    ))
    
    # Summary
    print(f"\n🏆 FINAL RESULTS")
    print("=" * 70)
    print(f"{'Test':<35} {'Winner':<8} {'Speedup':<8} {'Shlesha/s':<12} {'Vidyut/s':<12}")
    print("-" * 70)
    
    shlesha_wins = 0
    for result in results:
        if result['faster'] == 'Shlesha':
            shlesha_wins += 1
        
        print(f"{result['name']:<35} {result['faster']:<8} {result['speedup']:<8.1f} "
              f"{result['shlesha_throughput']:<12.0f} {result['vidyut_throughput']:<12.0f}")
    
    print(f"\n🎯 Shlesha wins {shlesha_wins}/{len(results)} categories!")
    
    if shlesha_wins >= 2:
        print("🚀 Excellent! Aho-Corasick optimization is working!")
    else:
        print("🤔 Hmm, performance could be better. Check your build.")
    
    # Show sample outputs
    print(f"\n📝 Sample Conversions:")
    print(f"Telugu → Devanagari: నమస్కారం → {shlesha.transliterate('నమస్కారం', 'telugu', 'devanagari')}")
    print(f"IAST → SLP1: namaskāram → {shlesha.transliterate('namaskāram', 'iast', 'slp1')}")
    print(f"IAST → Telugu: saṃskṛtam → {shlesha.transliterate('saṃskṛtam', 'iast', 'telugu')}")

if __name__ == "__main__":
    main()