to-kana

Converts English lettering to Kana. Please see the wiki to get supported inputs.

Basic Usage

As Library

use to_kana::ToKana;

let hello = "konnichiha,".hira().unwrap(); // Works on &str
let world = String::from("wa-rudo!").kata().unwrap(); // And String!

println!("{}{}", hello, world)); // こんにちは、ワールド！

let rust = "[rasuto".kata().unwrap();
let ga = "ga".hira().unwrap();
let number_1 = "nanba-1]".kata().unwrap();
let i_think = "toomoimasu.".hira().unwrap();

// 「ラストがナンバー１」とおもいます。
println!("{}{}{}{}", rust, ga, number_1, i_think);

Or, if you prefer the old way

use to_kana::{
    hira, // Hiragana
    kata, // Katakana
};

// は is pronounced "wa" in this context, but is usually pronounced "ha"
let hello = hira("konnichiha,").unwrap();
let world = kata("wa-rudo!").unwrap();

println!("{}{}", hello, world); // こんにちは、ワールド！

What if you don't want to just convert to Kana? What if you want to convert to small, half-width Katakana? You can!

use to_kana::{
    ToKana,
    SmallKana,
    HalfWidth,
};

// Not to be confused with "ヤ", "ャ" or "ﾔ"
assert_eq!("ｬ", "ya".kata().small().half_width().unwrap());

From Command Line

# Install
cargo install to-kana

# Get Help
to-kana -h
to-kana hira -h
to-kana kata -h

# Convert to Hiragana
to-kana hira <STRING>

# Convert to Katakana
to-kana kata <STRING>

# Convert to small, half-width Katakana
to-kana --small kata yo --half