Romkan

0.2.1 verified Mon Apr 27 auth: no python maintenance

A library for converting between Romaji and Kana (Hiragana and Katakana) in Japanese. Version 0.2.1 is the latest release. Maintenance status is unclear; the last update was in 2013.

pip install romkan

Common errors

error ModuleNotFoundError: No module named 'romkan' ↓

cause The package is not installed, or the name is misspelled.

fix

Run 'pip install romkan' and ensure correct spelling: 'romkan' not 'romaji' etc.

error AttributeError: module 'romkan' has no attribute 'to_hiragana' ↓

cause Incorrect import: importing the module instead of the function.

fix

Use 'from romkan import to_hiragana' directly.

Warnings

gotcha Some Romaji inputs may not round-trip correctly due to ambiguous mappings (e.g., 'おお' vs 'おう'). ↓

fix Be aware that conversion is phonetic; verify expected output for edge cases.

deprecated The library is not actively maintained (last update 2013). It may have bugs or miss modern Python features. ↓

fix Consider alternatives like pykakasi or jaconv for actively maintained libraries.

Imports

to_hiragana
wrong
```
import romkan; romkan.to_hiragana('roma')
```
correct
```
from romkan import to_hiragana
```
Importing the module and calling function works fine, but the common mistake is forgetting to import the specific function.

Quickstart

Basic usage of romkan for conversion between Romaji and Kana.

from romkan import to_hiragana, to_katakana, to_hepburn, to_kunrei

hira = to_hiragana('nihon')
print(hira)  # にほん

kata = to_katakana('nihon')
print(kata)  # ニホン

hepburn = to_hepburn('にほん')
print(hepburn)  # nihon

kunrei = to_kunrei('にほん')
print(kunrei)  # nihon (same for this example)