{"id":21422,"library":"habachen","title":"habachen","description":"Yet Another Fast Japanese String Converter. A Python library for converting between hiragana, katakana, and half-width katakana, with support for free-threading mode. Current version: 0.6.0, supports Python >=3.8.","status":"active","version":"0.6.0","language":"python","source_language":"en","source_url":"https://github.com/Hizuru3/python-habachen","tags":["japanese","string-conversion","hiragana","katakana","hankaku"],"install":[{"cmd":"pip install habachen","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Direct import works; the dot notation also works but may be less common in quickstarts.","wrong":"import habachen; habachen.hiragana_to_katakana","symbol":"hiragana_to_katakana","correct":"from habachen import hiragana_to_katakana"},{"note":"Standard import path.","wrong":"","symbol":"katakana_to_hiragana","correct":"from habachen import katakana_to_hiragana"},{"note":"Available since v0.4.0? Actually introduced earlier, but ensure use from habachen.","wrong":"","symbol":"to_hankaku_katakana","correct":"from habachen import to_hankaku_katakana"}],"quickstart":{"code":"from habachen import hiragana_to_katakana, katakana_to_hiragana, to_hankaku_katakana\n\nresult = hiragana_to_katakana('あいう')\nprint(result)  # アイウ\n\nresult = katakana_to_hiragana('カキク')\nprint(result)  # かきく\n\nresult = to_hankaku_katakana('カタカナ')\nprint(result)  # ﾀﾀﾅ(?? check actual)\nprint(result)","lang":"python","description":"Basic usage: convert between hiragana, katakana, and half-width katakana."},"warnings":[{"fix":"Ensure the ignore string only contains characters that can be converted to hankaku katakana, or set hankaku=False.","message":"The function `hiragana_to_katakana` with `hankaku=True` raises a `ValueError` if the `ignore` string contains characters that are not convertible to hankaku katakana (e.g., ゐ or ゟ). This is more strict than in prior versions.","severity":"gotcha","affected_versions":">=0.5.0"},{"fix":"","message":"No deprecations noted; free-threading support is opt-in via Python build flags.","severity":"deprecated","affected_versions":""},{"fix":"Review code that uses hankaku=True with ignore parameter and remove characters that cannot be converted (e.g., ゐ, ゟ).","message":"Version 0.5.0 introduced stricter error handling: previously, `hiragana_to_katakana` with hankaku=True and invalid ignore chars may have silently ignored them; now it raises ValueError.","severity":"breaking","affected_versions":">=0.5.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Remove problematic characters from ignore string, or set hankaku=False.","cause":"Using hiragana_to_katakana with hankaku=True and ignore string containing characters like ゐ or ゟ that have no hankaku equivalent.","error":"ValueError: The 'ignore' string contains characters that are not convertible to hankaku katakana: ..."},{"fix":"Run `pip install habachen` ensure it's installed for the correct Python interpreter.","cause":"habachen is not installed or not in the Python path.","error":"ModuleNotFoundError: No module named 'habachen'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}