libkuraji 1.0.0__tar.gz

libkuraji-1.0.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2019,2023 Takuya Nishimoto
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

libkuraji-1.0.0/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.4
+Name: libkuraji
+Version: 1.0.0
+Summary: Japanese Braille translator originally developed for NVDAJP
+Author: Takuya Nishimoto
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/nishimotz/libkuraji
+Project-URL: Repository, https://github.com/nishimotz/libkuraji
+Project-URL: Issues, https://github.com/nishimotz/libkuraji/issues
+Keywords: braille,japanese,accessibility,nvda,mecab
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Adaptive Technologies
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Provides-Extra: integration
+Requires-Dist: fugashi; extra == "integration"
+Dynamic: license-file
+
+# libkuraji
+
+[日本語](README-ja.md)
+
+Japanese Braille translator originally developed for NVDAJP.
+
+Translates mixed Kanji/Kana Japanese text into Japanese 6-dot braille (Unicode braille patterns), with morphological word segmentation (masuake / spacing). Returns a position map from each braille cell back to the source text.
+
+## Requirements
+
+- Python 3.10 or later
+- `pip install libkuraji[integration]` (`fugashi`)
+- Environment variable `LIBKURAJI_INTEGRATION=1` (enables the JTalk extended dictionary)
+
+## Installation
+
+```console
+pip install 'libkuraji[integration]'
+export LIBKURAJI_INTEGRATION=1   # Windows PowerShell: $env:LIBKURAJI_INTEGRATION=1
+```
+
+On macOS and Homebrew Python, system-wide installs may be restricted. Use a virtual environment in that case.
+
+```console
+python3 -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install 'libkuraji[integration]'
+export LIBKURAJI_INTEGRATION=1
+```
+
+### For development (from the repository)
+
+```console
+git clone https://github.com/nishimotz/libkuraji.git
+cd libkuraji
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e '.[dev,integration]'
+export LIBKURAJI_INTEGRATION=1
+```
+
+In zsh, quote the extras: `'.[dev,integration]'`.
+
+## Quick start
+
+On first run, dictionary binaries from [libkuraji-jtalk-dic](https://github.com/nishimotz/libkuraji-jtalk-dic) are downloaded automatically from GitHub Releases.
+
+```console
+kuraji "私は点字を読みます。"
+# => ⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲
+```
+
+```python
+import libkuraji
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+# => '⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲'
+```
+
+Pass `unicodeIO=True` to get Unicode braille (the same format as the CLI).
+
+Input is limited to 65,536 characters by default (`InputTooLongError` when exceeded). Override with `LIBKURAJI_MAX_INPUT_CHARS`; set `0` to disable the limit.
+
+## Usage
+
+### Python API
+
+```python
+import libkuraji
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+# inpos[i] is the input index for cells[i]
+# outpos[j] is the braille index for input position j
+```
+
+To use a custom morphological analyzer, inject it with `initialize`. The analyzer must implement `analyze(text, logwrite)` and `is_ready()`.
+
+```python
+libkuraji.initialize(analyzer=my_analyzer)
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+```
+
+For NABCC (computer braille) mode: `translate_kanji(text, nabcc=True, unicodeIO=True)`.
+
+#### Foreign quotation marks and information processing braille
+
+libkuraji automatically detects words containing Latin letters and symbols, wrapping them in one of two braille indicators.
+
+| Mode | Indicator | Target | Grade 2 English |
+|------|-----------|--------|-----------------|
+| Foreign quotation marks | `⠦...⠴` | Natural language foreign text (with spaces/apostrophes) | Only when liblouis is injected |
+| Information processing braille | `⠠⠦...⠠⠴` | URLs, email addresses, file paths, etc. | Not applicable |
+
+#### Grade 2 English braille inside foreign quotation marks
+
+Pass a `louisTranslate` function and `louisTableList` (e.g. `["en-ueb-g2.ctb"]`) to `translate_kanji` to apply Grade 2 English braille translation to the inner text of foreign quotation marks `⠦...⠴`. libkuraji does not provide a `louis` translate function — the caller must inject it.
+
+```python
+import louis
+
+def my_louis_translate(table_list, text, cursorPos=0, mode=0):
+    return louis.translate(
+        table_list, text,
+        cursorPos=cursorPos, mode=mode,
+    )
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "これは ⠦English text⠴ です。",
+    unicodeIO=True,
+    louisTranslate=my_louis_translate,
+    louisTableList=["en-ueb-g2.ctb"],
+)
+```
+
+See [docs/encoding.md](docs/encoding.md) for output encoding details (Unicode braille vs liblouis dotsIO, and what `unicodeIO` means).
+
+#### MeCab setup
+
+| Platform | Notes |
+|----------|-------|
+| Windows | The `fugashi` wheel bundles `libmecab.dll`, so `pip` alone is sufficient |
+| macOS / Linux | Verified in this repository with `fugashi` only. Some environments may require a system [MeCab](https://taku910.github.io/mecab/) install |
+
+Override the dictionary release tag with `LIBKURAJI_JTALK_DIC_TAG` (default: `DEFAULT_DIC_TAG` in `src/libkuraji/jtalk_dic.py`). To skip download, point `LIBKURAJI_JTALK_DIC_DIR` at an already extracted dictionary directory.
+
+### CLI
+
+```console
+kuraji "私は点字を読みます。"
+⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲
+
+kuraji "私は点字を読みます。" --positions
+{"text": "私は点字を読みます。", "braille": "⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲", ...}
+```
+
+Main options:
+
+| Option | Description |
+|--------|-------------|
+| `-p` / `--positions` | Output position map as JSON |
+| `--nabcc` | NABCC (computer braille) mode |
+| `-j` / `--kanji` | Force mixed Kanji/Kana mode |
+| `-k` / `--kana` | Kana-only mode (see below) |
+
+### Kana input only (supplement)
+
+If the input is already in katakana, use `translate` without MeCab.
+
+```python
+from libkuraji import translate
+
+translate("ワタシワ テンジヲ ヨミマス。")
+```
+
+```console
+kuraji -k "ワタシワ テンジヲ ヨミマス。"
+```
+
+## Testing
+
+### Default tests (same as CI)
+
+Runs without MeCab. Replays recorded MeCab output from `tests/mecabFixture.json` to verify translator2.
+
+```console
+pip install -e '.[dev]'
+pytest
+```
+
+Test data in `tests/harness.json` and related files follow rules from the Japanese braille guide (*Ten'yaku no Tebiki*). To re-record `tests/mecabFixture.json`, use `miscDepsJp/jptools/recordMecabFixture.py` in the nvdajp repository.
+
+### Integration tests with the real dictionary (optional)
+
+Opt-in tests that verify translation against the live JTalk extended dictionary and MeCab.
+
+Prerequisites:
+
+- `pip install -e '.[dev,integration]'`
+- `gh` CLI (falls back to the GitHub REST API if unavailable)
+
+Run:
+
+```console
+export LIBKURAJI_INTEGRATION=1
+pytest tests/test_integration.py -q
+
+# Also run exact MeCab output parity checks
+export LIBKURAJI_PARITY_CHECK=1
+pytest tests/test_integration.py -q
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:LIBKURAJI_INTEGRATION=1
+pytest tests/test_integration.py -q
+```
+
+Some integration tests also run in CI (GitHub Actions) on Windows and Linux. `test_mecab_fixture_parity` (internal MeCab output comparison across versions) is skipped by default and intended for dictionary update verification.
+
+Integration tests also reproduce MeCab output correction via `mecab_correct.py` (ported from nvdajp's `Mecab_correctFeatures` under BSD relicensing). The `libmecab.dll` bundled with `fugashi` and the nvdajp MeCab used when recording fixtures may differ on a few symbol-only inputs (about 98% match overall). Final braille output consistency is preserved and CI passes.
+
+## Relationship to NVDA Japanese
+
+- This library separates and standalone-izes the braille engine (translator1/translator2) from [nvdajp](https://github.com/nvdajp/nvdajp). The translator1 equivalent (`kana` module) is a clean-room rewrite driven by tests; translator2 was ported under BSD relicensing by the copyright holder.
+- Decoupling plan: `projectDocs/jp/braille-engine-decoupling-plan.md` in the nvdajp repository.
+
+## License
+
+BSD 3-Clause License. See [LICENSE](LICENSE).

libkuraji-1.0.0/README.md

@@ -0,0 +1,219 @@
+# libkuraji
+
+[日本語](README-ja.md)
+
+Japanese Braille translator originally developed for NVDAJP.
+
+Translates mixed Kanji/Kana Japanese text into Japanese 6-dot braille (Unicode braille patterns), with morphological word segmentation (masuake / spacing). Returns a position map from each braille cell back to the source text.
+
+## Requirements
+
+- Python 3.10 or later
+- `pip install libkuraji[integration]` (`fugashi`)
+- Environment variable `LIBKURAJI_INTEGRATION=1` (enables the JTalk extended dictionary)
+
+## Installation
+
+```console
+pip install 'libkuraji[integration]'
+export LIBKURAJI_INTEGRATION=1   # Windows PowerShell: $env:LIBKURAJI_INTEGRATION=1
+```
+
+On macOS and Homebrew Python, system-wide installs may be restricted. Use a virtual environment in that case.
+
+```console
+python3 -m venv .venv
+source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install 'libkuraji[integration]'
+export LIBKURAJI_INTEGRATION=1
+```
+
+### For development (from the repository)
+
+```console
+git clone https://github.com/nishimotz/libkuraji.git
+cd libkuraji
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e '.[dev,integration]'
+export LIBKURAJI_INTEGRATION=1
+```
+
+In zsh, quote the extras: `'.[dev,integration]'`.
+
+## Quick start
+
+On first run, dictionary binaries from [libkuraji-jtalk-dic](https://github.com/nishimotz/libkuraji-jtalk-dic) are downloaded automatically from GitHub Releases.
+
+```console
+kuraji "私は点字を読みます。"
+# => ⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲
+```
+
+```python
+import libkuraji
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+# => '⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲'
+```
+
+Pass `unicodeIO=True` to get Unicode braille (the same format as the CLI).
+
+Input is limited to 65,536 characters by default (`InputTooLongError` when exceeded). Override with `LIBKURAJI_MAX_INPUT_CHARS`; set `0` to disable the limit.
+
+## Usage
+
+### Python API
+
+```python
+import libkuraji
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+# inpos[i] is the input index for cells[i]
+# outpos[j] is the braille index for input position j
+```
+
+To use a custom morphological analyzer, inject it with `initialize`. The analyzer must implement `analyze(text, logwrite)` and `is_ready()`.
+
+```python
+libkuraji.initialize(analyzer=my_analyzer)
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "私は点字を読みます。",
+    unicodeIO=True,
+)
+```
+
+For NABCC (computer braille) mode: `translate_kanji(text, nabcc=True, unicodeIO=True)`.
+
+#### Foreign quotation marks and information processing braille
+
+libkuraji automatically detects words containing Latin letters and symbols, wrapping them in one of two braille indicators.
+
+| Mode | Indicator | Target | Grade 2 English |
+|------|-----------|--------|-----------------|
+| Foreign quotation marks | `⠦...⠴` | Natural language foreign text (with spaces/apostrophes) | Only when liblouis is injected |
+| Information processing braille | `⠠⠦...⠠⠴` | URLs, email addresses, file paths, etc. | Not applicable |
+
+#### Grade 2 English braille inside foreign quotation marks
+
+Pass a `louisTranslate` function and `louisTableList` (e.g. `["en-ueb-g2.ctb"]`) to `translate_kanji` to apply Grade 2 English braille translation to the inner text of foreign quotation marks `⠦...⠴`. libkuraji does not provide a `louis` translate function — the caller must inject it.
+
+```python
+import louis
+
+def my_louis_translate(table_list, text, cursorPos=0, mode=0):
+    return louis.translate(
+        table_list, text,
+        cursorPos=cursorPos, mode=mode,
+    )
+
+cells, inpos, outpos, cursor = libkuraji.translate_kanji(
+    "これは ⠦English text⠴ です。",
+    unicodeIO=True,
+    louisTranslate=my_louis_translate,
+    louisTableList=["en-ueb-g2.ctb"],
+)
+```
+
+See [docs/encoding.md](docs/encoding.md) for output encoding details (Unicode braille vs liblouis dotsIO, and what `unicodeIO` means).
+
+#### MeCab setup
+
+| Platform | Notes |
+|----------|-------|
+| Windows | The `fugashi` wheel bundles `libmecab.dll`, so `pip` alone is sufficient |
+| macOS / Linux | Verified in this repository with `fugashi` only. Some environments may require a system [MeCab](https://taku910.github.io/mecab/) install |
+
+Override the dictionary release tag with `LIBKURAJI_JTALK_DIC_TAG` (default: `DEFAULT_DIC_TAG` in `src/libkuraji/jtalk_dic.py`). To skip download, point `LIBKURAJI_JTALK_DIC_DIR` at an already extracted dictionary directory.
+
+### CLI
+
+```console
+kuraji "私は点字を読みます。"
+⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲
+
+kuraji "私は点字を読みます。" --positions
+{"text": "私は点字を読みます。", "braille": "⠄⠕⠳⠄ ⠟⠴⠐⠳⠔ ⠜⠷⠵⠹⠲", ...}
+```
+
+Main options:
+
+| Option | Description |
+|--------|-------------|
+| `-p` / `--positions` | Output position map as JSON |
+| `--nabcc` | NABCC (computer braille) mode |
+| `-j` / `--kanji` | Force mixed Kanji/Kana mode |
+| `-k` / `--kana` | Kana-only mode (see below) |
+
+### Kana input only (supplement)
+
+If the input is already in katakana, use `translate` without MeCab.
+
+```python
+from libkuraji import translate
+
+translate("ワタシワ テンジヲ ヨミマス。")
+```
+
+```console
+kuraji -k "ワタシワ テンジヲ ヨミマス。"
+```
+
+## Testing
+
+### Default tests (same as CI)
+
+Runs without MeCab. Replays recorded MeCab output from `tests/mecabFixture.json` to verify translator2.
+
+```console
+pip install -e '.[dev]'
+pytest
+```
+
+Test data in `tests/harness.json` and related files follow rules from the Japanese braille guide (*Ten'yaku no Tebiki*). To re-record `tests/mecabFixture.json`, use `miscDepsJp/jptools/recordMecabFixture.py` in the nvdajp repository.
+
+### Integration tests with the real dictionary (optional)
+
+Opt-in tests that verify translation against the live JTalk extended dictionary and MeCab.
+
+Prerequisites:
+
+- `pip install -e '.[dev,integration]'`
+- `gh` CLI (falls back to the GitHub REST API if unavailable)
+
+Run:
+
+```console
+export LIBKURAJI_INTEGRATION=1
+pytest tests/test_integration.py -q
+
+# Also run exact MeCab output parity checks
+export LIBKURAJI_PARITY_CHECK=1
+pytest tests/test_integration.py -q
+```
+
+On Windows PowerShell:
+
+```powershell
+$env:LIBKURAJI_INTEGRATION=1
+pytest tests/test_integration.py -q
+```
+
+Some integration tests also run in CI (GitHub Actions) on Windows and Linux. `test_mecab_fixture_parity` (internal MeCab output comparison across versions) is skipped by default and intended for dictionary update verification.
+
+Integration tests also reproduce MeCab output correction via `mecab_correct.py` (ported from nvdajp's `Mecab_correctFeatures` under BSD relicensing). The `libmecab.dll` bundled with `fugashi` and the nvdajp MeCab used when recording fixtures may differ on a few symbol-only inputs (about 98% match overall). Final braille output consistency is preserved and CI passes.
+
+## Relationship to NVDA Japanese
+
+- This library separates and standalone-izes the braille engine (translator1/translator2) from [nvdajp](https://github.com/nvdajp/nvdajp). The translator1 equivalent (`kana` module) is a clean-room rewrite driven by tests; translator2 was ported under BSD relicensing by the copyright holder.
+- Decoupling plan: `projectDocs/jp/braille-engine-decoupling-plan.md` in the nvdajp repository.
+
+## License
+
+BSD 3-Clause License. See [LICENSE](LICENSE).

libkuraji-1.0.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "libkuraji"
+version = "1.0.0"
+description = "Japanese Braille translator originally developed for NVDAJP"
+readme = "README.md"
+license = "BSD-3-Clause"
+authors = [{ name = "Takuya Nishimoto" }]
+requires-python = ">=3.10"
+keywords = ["braille", "japanese", "accessibility", "nvda", "mecab"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Adaptive Technologies",
+    "Topic :: Text Processing :: Linguistic",
+]
+
+[project.urls]
+Homepage = "https://github.com/nishimotz/libkuraji"
+Repository = "https://github.com/nishimotz/libkuraji"
+Issues = "https://github.com/nishimotz/libkuraji/issues"
+
+[project.scripts]
+kuraji = "libkuraji.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest"]
+integration = ["fugashi"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

libkuraji-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

libkuraji-1.0.0/src/libkuraji/__init__.py

@@ -0,0 +1,69 @@
+# libkuraji
+# Copyright (C) 2019-2026 Takuya Nishimoto
+# License: BSD 3-Clause. See LICENSE.
+
+from .kana import translate_with_pos
+from .limits import InputTooLongError
+
+
+def translate(text: str, nabcc: bool = False) -> str:
+    """Translate kana text (translator2 output) into braille cells."""
+    return translate_with_pos(text, nabcc=nabcc)[0]
+
+
+def initialize(analyzer=None, logwrite=None):
+    """Initialize the morphological analyzer for mixed-text (Kanji/Kana) translation.
+
+    If analyzer is None, a default JTalkDicAnalyzer (which uses fugashi and
+    automatically downloads the JTalk dictionary if needed) will be used.
+    """
+    if analyzer is None:
+        try:
+            from .jtalk_dic import make_analyzer
+            analyzer = make_analyzer()
+        except ImportError as e:
+            raise ImportError(
+                "The default analyzer requires 'fugashi' and dictionary dependencies. "
+                "Please run 'pip install libkuraji[integration]' to install them, "
+                "or pass a custom analyzer instance."
+            ) from e
+    from . import translator2
+    translator2.initialize(analyzer=analyzer, logwrite=logwrite)
+
+
+def translate_kanji(
+    text: str, cursorPos: int = 0, nabcc: bool = False, **kwargs
+) -> tuple[str, list[int], list[int], int]:
+    """Translate mixed Kanji/Kana Japanese text, returning braille and position maps.
+
+    If the analyzer has not been initialized, it will be automatically initialized
+    with the default JTalkDicAnalyzer.
+
+    Keyword arguments are forwarded to ``translator2.translate``. Notable options:
+
+    * ``unicodeIO`` (bool, default ``False``): If ``True``, return Unicode braille
+      (U+2800..U+28FF, blanks as U+0020), matching the CLI and liblouis
+      ``dotsIO | ucBrl``. If ``False``, return liblouis ``dotsIO`` cells
+      (U+8000..U+80FF, blanks as U+2800), the inherited nvdajp translator2
+      default. See ``docs/encoding.md``.
+    """
+    from . import translator2
+    if not translator2.mecab_initialized:
+        initialize()
+    return translator2.translate(text, cursorPos=cursorPos, nabcc=nabcc, **kwargs)
+
+
+def terminate():
+    """Terminate the morphological analyzer and clean up resources."""
+    from . import translator2
+    translator2.terminate()
+
+
+__all__ = [
+    "translate",
+    "translate_with_pos",
+    "initialize",
+    "translate_kanji",
+    "terminate",
+    "InputTooLongError",
+]