## WanaKana Rust
### ワナカナ <--> WanaKana <--> わなかな
toml,ignore
[dependencies]
wana_kana = "2.0"
Utility library for checking and converting between Japanese characters - Kanji, Hiragana, Katakana - and Romaji (Ported from https://github.com/WaniKani/WanaKana V4.0.2)
## Examples
use wana_kana::to_romaji::*;
use wana_kana::to_kana::*;
use wana_kana::to_hiragana::*;
use wana_kana::Options;
assert_eq!(to_romaji("ワナカナ"), "wanakana");
assert_eq!(to_hiragana("WanaKana"), "わなかな");
assert_eq!(to_kana("WANAKANA"), "ワナカナ");
On Migrating to 2.0 some performance improvements have been implemented by using more efficient lookup structures and avoiding allocations. According to these results around 1000 words can be converted per millisecond on a Core i7-6700.
bench_hiragana_to_romaji 3,519 1,070 -2,449 -69.59% x 3.29
bench_kana_1 3,066 567 -2,499 -81.51% x 5.41
bench_kana_2 8,006 1,831 -6,175 -77.13% x 4.37
bench_katakana_to_hiragana 2,512 622 -1,890 -75.24% x 4.04
bench_katakana_to_katakana 1,664 629 -1,035 -62.20% x 2.65
bench_katakana_to_romaji 6,922 1,067 -5,855 -84.59% x 6.49
bench_romaji_to_hiragana 3,802 1,300 -2,502 -65.81% x 2.92
bench_romaji_to_katakana 4,361 1,929 -2,432 -55.77% x 2.26
A short comparison suggests around 25x performance
```javascript import toKana from './src/toKana'; import toHiragana from './src/toHiragana'; import toKatakana from './src/toKatakana'; import toRomaji from './src/toRomaji';
console.time("yo") for (var i = 0; i < 1000; i++) { toKana('aiueosashisusesonaninunenokakikukeko') toKana('AIUEOSASHISUSESONANINUNENOKAKIKUKEKO') toHiragana('aiueosashisusesonaninunenokakikukeko') toHiragana('アイウエオサシスセソナニヌネノカキクケコ') toKatakana('aiueosashisusesonaninunenokakikukeko') toKatakana('あいうえおさしすせそなにぬねのかきくけこ') toRomaji('あいうえおさしすせそなにぬねのかきくけこ') toRomaji('アイウエオサシスセソナニヌネノカキクケコ') }
console.timeEnd("yo")
``
node -r esm run.js`
```rust extern crate wanakana; use wanakana::tohiragana::tohiragana; use wanakana::tokatakana::tokatakana; use wanakana::toromaji::toromaji; use wanakana::tokana::*;
fn main() { let start = std::time::Instant::now(); for _ in 0..1000 { tokana("aiueosashisusesonaninunenokakikukeko"); tokana("AIUEOSASHISUSESONANINUNENOKAKIKUKEKO"); tohiragana("aiueosashisusesonaninunenokakikukeko"); tohiragana("アイウエオサシスセソナニヌネノカキクケコ"); tokatakana("aiueosashisusesonaninunenokakikukeko"); tokatakana("あいうえおさしすせそなにぬねのかきくけこ"); toromaji("あいうえおさしすせそなにぬねのかきくけこ"); toromaji("アイウエオサシスセソナニヌネノカキクケコ"); }
println!("{:?}", start.elapsed().as_millis());
}
```
node -r esm run.js 253.231ms
cargo run --release --bin bench 9ms
cargo install wana_kana will install 2 CLI tools: to_kana and to_romaji.
Both commands support piping ls | to_kana and parameters to_romaji へろ をるど.