romann

日本語テキストを自然なローマ字や英語表記に変換するPythonライブラリです。 曲名・人名・外来語などを、視認性の高いローマ字や本来のスペルで出力します。 液晶ディスプレイや海外向け表示などにご活用いただけます。

主な特徴

• SudachiPyによる高精度な形態素解析
• 外来語は辞書に基づき英語表記に自動変換（カスタマイズ可）
• 4x8ドット液晶でも読みやすいローマ字表記
• Python 3.12対応・TDDによる品質管理

変換例

動作環境

• Python 3.12
• 主要依存: SudachiPy, pykakasi, jaconv

インストール

pip install romann

使い方

from romann import RomanConverter
converter = RomanConverter()
print(converter.to_roman("薔薇の花"))  # BaraNoHana
print(converter.to_roman("アース・ウィンド＆ファイアー"))  # EarthWindAndFire

# スペースありの変換（オプション）
print(converter.to_roman("薔薇の花", remove_spaces=False))  # Bara No Hana
print(converter.to_roman("アース・ウィンド＆ファイアー", remove_spaces=False))  # Earth Wind & Fire

変換ルール

• 単語の先頭は大文字
• デフォルトではスペースなしで出力（オプションでスペース区切りに変更可能）
• 外来語は辞書にあれば英語表記、なければローマ字
• 記号類はそのまま（「、」「。」は「,」「.」に変換）
• 前後・連続する空白は整理

外来語辞書を引く条件

外来語辞書は**読み（ひらがな）**をキーにするため、読みが偶然一致するだけの語まで 巻き込んでしまう。カタカナ表記そのものが外来語のしるしなので、そこを軸に絞っている。

外来語辞書のカスタマイズ

外来語の変換は hiragana_english.json に基づきます。これを編集することで、 特定単語の変換方法を調整できます。キーは読みのひらがな、値は小文字の英語表記。

{
  "あーす": "earth",
  "どあ": "door",
  "どろっぷす": "drops"
}

値を空文字にすると語ごと消えてしまうので、必ず何か入れること。

漢字語は kanji_english.json に表記そのものをキーにして入れます。 読みで引かないので衝突しません。英語のつづりが定まっている固有名詞だけを入れること。

{
  "東京": "tokyo"
}

katakana_english.json は現在の変換では使っていません（キーがローマ字のため）。

関連

• Kanjiconv

ご利用・フィードバック・Issue歓迎します。

• 連続する空白は1つの空白に変換

インストール

pip install romann

依存ライブラリ

• pykakasi: 日本語のローマ字変換
• SudachiPy: 形態素解析
• jaconv: 文字コード変換

使用方法

from romann import RomanConverter

converter = RomanConverter()

# 日本語テキストをローマ字に変換
text = "薔薇の花"
romaji = converter.to_roman(text)
print(romaji)  # 出力: "Bara No Hana"

# 外来語を含むテキストの変換
text = "アースウィンド"
romaji = converter.to_roman(text)
print(romaji)  # 出力: "Earth Wind"

外来語辞書のカスタマイズ

外来語の変換は hiragana_english.json ファイルに基づいて行われます。このファイルをカスタマイズすることで、特定の単語の変換方法を調整できます。

{
  "あーす": "earth",
  "どあ": "door",
  "らぶ": "love"
}

使用例

from romann import RomanConverter

converter = RomanConverter()

# 通常の変換（スペースなし）
result = converter.to_roman("こんにちは")
print(result)  # 出力: Konnichiha

# 複数単語の変換（デフォルトでスペースなし）
result = converter.to_roman("こんにちは 世界")
print(result)  # 出力: KonnichihaSekai

# スペースありの変換
result = converter.to_roman("こんにちは 世界", remove_spaces=False)
print(result)  # 出力: Konnichiha Sekai

関連

• Kanjiconv