dictz 0.0.2__tar.gz

dictz-0.0.2/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to dictz are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.2] — 2026-11-13
+
+### Added
+- **DSL (ABBYY Lingvo) format support** via PyGlossary — reads `.dsl` and `.dsl.dz` files
+- **Babylon format support** via PyGlossary — reads `.bgl` binary dictionaries
+- `PyGlossaryDictionary` generic base parser (shared code between PyGlossary-backed formats)
+- Parser-registry dispatch handles `.dz`-compressed variants automatically
+- `supported_extensions()` helper for UI file-dialog filters
+- Test suite for the DSL parser and parser dispatcher
+- `CHANGELOG.md` and `LICENSE` added to the repo
+
+### Changed
+- `pyglossary` moved from optional to required dependency
+- File-open dialog filter now lists StarDict, DSL and Babylon separately
+- About-box version bumped to 0.0.2 and format list expanded
+- README rewritten for multi-platform publication (PyPI, GitHub) with badges and install instructions
+- PyPI classifiers expanded: Windows / Linux / macOS, Turkish and English natural languages
+
+## [0.0.1] — 2026-11-12
+
+### Added
+- Project bootstrap (4-layer architecture: UI, core, parsers, storage)
+- Native StarDict parser (no external dependency) — reads `.ifo`, `.idx`, `.dict` and `.dict.dz`
+- SQLite FTS5 central index with `unicode61 remove_diacritics 2` tokenizer
+- `QueryManager` orchestrates lookups across multiple loaded dictionaries
+- PySide6 three-pane UI: search box, suggestion list, definition view
+- Debounced incremental search (150 ms)
+- Cross-platform per-user data directory (Windows / macOS / Linux)
+- Test suite for the StarDict parser and index store (11 tests)

dictz-0.0.2/LICENSE

@@ -0,0 +1,55 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  The complete terms of the GNU General Public License version 3 are
+available at <https://www.gnu.org/licenses/gpl-3.0.html>.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  dictz — cross-platform multi-format offline dictionary application
+  Copyright (C) 2026  Bayram Kotan
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.

dictz-0.0.2/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include CHANGELOG.md
+include LICENSE
+include pyproject.toml
+recursive-include dictz *.py
+recursive-include dictz/resources *

dictz-0.0.2/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: dictz
+Version: 0.0.2
+Summary: dictz — a cross-platform multi-format offline dictionary application (GoldenDict-style)
+Author-email: Bayram Kotan <bayramkotan@gmail.com>
+Maintainer-email: Bayram Kotan <bayramkotan@gmail.com>
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/bayramkotan/dictz
+Project-URL: Repository, https://github.com/bayramkotan/dictz
+Project-URL: Issues, https://github.com/bayramkotan/dictz/issues
+Project-URL: Documentation, https://github.com/bayramkotan/dictz#readme
+Project-URL: Changelog, https://github.com/bayramkotan/dictz/blob/main/CHANGELOG.md
+Keywords: dictionary,stardict,dsl,babylon,goldendict,offline,lexicography,translation,pyside6,qt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Turkish
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.6.0
+Requires-Dist: rapidfuzz>=3.6.0
+Requires-Dist: pyglossary>=4.7.0
+Provides-Extra: tts
+Requires-Dist: edge-tts>=6.1.0; extra == "tts"
+Requires-Dist: pyttsx3>=2.90; extra == "tts"
+Provides-Extra: ocr
+Requires-Dist: mss>=9.0.0; extra == "ocr"
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr"
+Provides-Extra: anki
+Requires-Dist: requests>=2.31.0; extra == "anki"
+Provides-Extra: all
+Requires-Dist: dictz[anki,ocr,tts]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.3.0; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Requires-Dist: pyinstaller>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# dictz
+
+[![PyPI version](https://img.shields.io/pypi/v/dictz.svg)](https://pypi.org/project/dictz/)
+[![Python versions](https://img.shields.io/pypi/pyversions/dictz.svg)](https://pypi.org/project/dictz/)
+[![License: GPL v3+](https://img.shields.io/badge/License-GPLv3+-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/bayramkotan/dictz)
+[![Downloads](https://img.shields.io/pypi/dm/dictz.svg)](https://pypi.org/project/dictz/)
+
+Cross-platform, multi-format, offline dictionary application — a GoldenDict-style desktop tool built with Python and Qt.
+
+> [Türkçe açıklama aşağıda](#türkçe)
+
+![Platforms: Windows, Linux, macOS](https://img.shields.io/badge/runs_on-Windows_·_Linux_·_macOS-success)
+
+## Highlights
+
+- **Multi-format** — StarDict (`.ifo`), ABBYY Lingvo DSL (`.dsl`, `.dsl.dz`), Babylon (`.bgl`)
+- **Multi-dictionary** — load any number of dictionaries at once; a single query hits them all
+- **Fast** — SQLite FTS5 index with Unicode + diacritic-insensitive search
+- **Offline** — no network calls, no telemetry
+- **Cross-platform** — one codebase runs on Windows 11, Linux (CachyOS/Arch/Debian/Ubuntu/Fedora), and macOS
+
+## Install
+
+### From PyPI
+
+```bash
+pip install dictz
+```
+
+### From source
+
+```bash
+git clone https://github.com/bayramkotan/dictz.git
+cd dictz
+pip install -e .
+```
+
+### Run
+
+```bash
+dictz
+# or equivalently
+python -m dictz
+```
+
+## Supported formats
+
+| Format | Extension | Parser |
+|--------|-----------|--------|
+| StarDict | `.ifo` / `.idx` / `.dict(.dz)` | native |
+| ABBYY Lingvo DSL | `.dsl` / `.dsl.dz` | [PyGlossary](https://github.com/ilius/pyglossary) |
+| Babylon | `.bgl` | [PyGlossary](https://github.com/ilius/pyglossary) |
+
+More formats (XDXF, Slob, DictD, MDict, …) are planned — see the [roadmap](#roadmap).
+
+## Where to find dictionaries
+
+- [FreeDict](https://freedict.org/) — StarDict dictionaries, many language pairs
+- [StarDict.org](http://download.huzheng.org/) — large StarDict collection
+- [Lingvo DSL packs](http://lingvo.helpmax.net/) — ABBYY Lingvo community dictionaries
+
+## Roadmap
+
+- [x] **v0.0.1** — StarDict, multi-dictionary search, SQLite FTS5 index
+- [x] **v0.0.2** — DSL + Babylon format support via PyGlossary
+- [ ] Fuzzy / approximate matching (RapidFuzz)
+- [ ] Rich HTML rendering (QWebEngineView) with images and audio
+- [ ] Text-to-speech (edge-tts neural voices)
+- [ ] Clipboard monitoring + global hotkey
+- [ ] Screen-area OCR (Tesseract)
+- [ ] Anki integration (one-click flashcards)
+- [ ] Dictionary manager UI + preferences
+- [ ] Dark mode
+- [ ] Standalone binaries for Windows / Linux / macOS (PyInstaller)
+
+## Development
+
+```bash
+# Install with dev extras
+pip install -e ".[dev]"
+
+# Run the test suite
+pytest -v
+```
+
+Project layout:
+
+```
+dictz/
+├── dictz/
+│   ├── core/           # query orchestration, parser dispatch
+│   ├── parsers/        # one module per dictionary format
+│   ├── storage/        # SQLite FTS5 indexer
+│   ├── services/       # (planned) TTS, OCR, clipboard, Anki
+│   ├── ui/             # PySide6 widgets
+│   └── app.py          # entry point
+├── tests/
+└── pyproject.toml
+```
+
+## Contributing
+
+Issues and pull requests are welcome at [github.com/bayramkotan/dictz](https://github.com/bayramkotan/dictz).
+
+## License
+
+Licensed under the [GNU General Public License v3.0 or later](LICENSE).
+
+## Author
+
+[Bayram Kotan](https://bayramkotan.com) — [github.com/bayramkotan](https://github.com/bayramkotan)
+
+---
+
+## Türkçe
+
+dictz, çoklu format destekli, çevrimdışı çalışan, çapraz platform bir sözlük uygulamasıdır. GoldenDict tarzı bir masaüstü aracıdır ve Python + Qt ile geliştirilmektedir.
+
+### Öne çıkanlar
+
+- **Çoklu format** — StarDict (`.ifo`), ABBYY Lingvo DSL (`.dsl`, `.dsl.dz`), Babylon (`.bgl`)
+- **Çoklu sözlük** — istediğin kadar sözlük yükle; tek bir arama hepsinde çalışır
+- **Hızlı** — SQLite FTS5 indeksi + Unicode + diakritik duyarsız arama
+- **Çevrimdışı** — hiçbir ağ çağrısı yok, telemetri yok
+- **Çapraz platform** — Windows 11, Linux (CachyOS/Arch/Debian/Ubuntu/Fedora) ve macOS üzerinde aynı kod
+
+### Kurulum
+
+```bash
+pip install dictz
+```
+
+### Çalıştırma
+
+```bash
+dictz
+```
+
+### Yol haritası
+
+- [x] **v0.0.1** — StarDict format desteği, çoklu sözlükte arama, SQLite FTS5 indeksi
+- [x] **v0.0.2** — DSL + Babylon format desteği (PyGlossary ile)
+- [ ] Fuzzy arama (RapidFuzz)
+- [ ] Tanımlar için zengin HTML görüntüleme
+- [ ] Metin okuma (TTS, neural sesler)
+- [ ] Pano izleme + global kısayol
+- [ ] Ekran OCR (Tesseract)
+- [ ] Anki entegrasyonu
+- [ ] Sözlük yöneticisi UI + tercihler
+- [ ] Koyu tema
+- [ ] Windows / Linux / macOS tek dosya binary (PyInstaller)
+
+### Lisans
+
+[GNU General Public License v3.0 veya sonrası](LICENSE).

dictz-0.0.2/README.md

@@ -0,0 +1,156 @@
+# dictz
+
+[![PyPI version](https://img.shields.io/pypi/v/dictz.svg)](https://pypi.org/project/dictz/)
+[![Python versions](https://img.shields.io/pypi/pyversions/dictz.svg)](https://pypi.org/project/dictz/)
+[![License: GPL v3+](https://img.shields.io/badge/License-GPLv3+-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/bayramkotan/dictz)
+[![Downloads](https://img.shields.io/pypi/dm/dictz.svg)](https://pypi.org/project/dictz/)
+
+Cross-platform, multi-format, offline dictionary application — a GoldenDict-style desktop tool built with Python and Qt.
+
+> [Türkçe açıklama aşağıda](#türkçe)
+
+![Platforms: Windows, Linux, macOS](https://img.shields.io/badge/runs_on-Windows_·_Linux_·_macOS-success)
+
+## Highlights
+
+- **Multi-format** — StarDict (`.ifo`), ABBYY Lingvo DSL (`.dsl`, `.dsl.dz`), Babylon (`.bgl`)
+- **Multi-dictionary** — load any number of dictionaries at once; a single query hits them all
+- **Fast** — SQLite FTS5 index with Unicode + diacritic-insensitive search
+- **Offline** — no network calls, no telemetry
+- **Cross-platform** — one codebase runs on Windows 11, Linux (CachyOS/Arch/Debian/Ubuntu/Fedora), and macOS
+
+## Install
+
+### From PyPI
+
+```bash
+pip install dictz
+```
+
+### From source
+
+```bash
+git clone https://github.com/bayramkotan/dictz.git
+cd dictz
+pip install -e .
+```
+
+### Run
+
+```bash
+dictz
+# or equivalently
+python -m dictz
+```
+
+## Supported formats
+
+| Format | Extension | Parser |
+|--------|-----------|--------|
+| StarDict | `.ifo` / `.idx` / `.dict(.dz)` | native |
+| ABBYY Lingvo DSL | `.dsl` / `.dsl.dz` | [PyGlossary](https://github.com/ilius/pyglossary) |
+| Babylon | `.bgl` | [PyGlossary](https://github.com/ilius/pyglossary) |
+
+More formats (XDXF, Slob, DictD, MDict, …) are planned — see the [roadmap](#roadmap).
+
+## Where to find dictionaries
+
+- [FreeDict](https://freedict.org/) — StarDict dictionaries, many language pairs
+- [StarDict.org](http://download.huzheng.org/) — large StarDict collection
+- [Lingvo DSL packs](http://lingvo.helpmax.net/) — ABBYY Lingvo community dictionaries
+
+## Roadmap
+
+- [x] **v0.0.1** — StarDict, multi-dictionary search, SQLite FTS5 index
+- [x] **v0.0.2** — DSL + Babylon format support via PyGlossary
+- [ ] Fuzzy / approximate matching (RapidFuzz)
+- [ ] Rich HTML rendering (QWebEngineView) with images and audio
+- [ ] Text-to-speech (edge-tts neural voices)
+- [ ] Clipboard monitoring + global hotkey
+- [ ] Screen-area OCR (Tesseract)
+- [ ] Anki integration (one-click flashcards)
+- [ ] Dictionary manager UI + preferences
+- [ ] Dark mode
+- [ ] Standalone binaries for Windows / Linux / macOS (PyInstaller)
+
+## Development
+
+```bash
+# Install with dev extras
+pip install -e ".[dev]"
+
+# Run the test suite
+pytest -v
+```
+
+Project layout:
+
+```
+dictz/
+├── dictz/
+│   ├── core/           # query orchestration, parser dispatch
+│   ├── parsers/        # one module per dictionary format
+│   ├── storage/        # SQLite FTS5 indexer
+│   ├── services/       # (planned) TTS, OCR, clipboard, Anki
+│   ├── ui/             # PySide6 widgets
+│   └── app.py          # entry point
+├── tests/
+└── pyproject.toml
+```
+
+## Contributing
+
+Issues and pull requests are welcome at [github.com/bayramkotan/dictz](https://github.com/bayramkotan/dictz).
+
+## License
+
+Licensed under the [GNU General Public License v3.0 or later](LICENSE).
+
+## Author
+
+[Bayram Kotan](https://bayramkotan.com) — [github.com/bayramkotan](https://github.com/bayramkotan)
+
+---
+
+## Türkçe
+
+dictz, çoklu format destekli, çevrimdışı çalışan, çapraz platform bir sözlük uygulamasıdır. GoldenDict tarzı bir masaüstü aracıdır ve Python + Qt ile geliştirilmektedir.
+
+### Öne çıkanlar
+
+- **Çoklu format** — StarDict (`.ifo`), ABBYY Lingvo DSL (`.dsl`, `.dsl.dz`), Babylon (`.bgl`)
+- **Çoklu sözlük** — istediğin kadar sözlük yükle; tek bir arama hepsinde çalışır
+- **Hızlı** — SQLite FTS5 indeksi + Unicode + diakritik duyarsız arama
+- **Çevrimdışı** — hiçbir ağ çağrısı yok, telemetri yok
+- **Çapraz platform** — Windows 11, Linux (CachyOS/Arch/Debian/Ubuntu/Fedora) ve macOS üzerinde aynı kod
+
+### Kurulum
+
+```bash
+pip install dictz
+```
+
+### Çalıştırma
+
+```bash
+dictz
+```
+
+### Yol haritası
+
+- [x] **v0.0.1** — StarDict format desteği, çoklu sözlükte arama, SQLite FTS5 indeksi
+- [x] **v0.0.2** — DSL + Babylon format desteği (PyGlossary ile)
+- [ ] Fuzzy arama (RapidFuzz)
+- [ ] Tanımlar için zengin HTML görüntüleme
+- [ ] Metin okuma (TTS, neural sesler)
+- [ ] Pano izleme + global kısayol
+- [ ] Ekran OCR (Tesseract)
+- [ ] Anki entegrasyonu
+- [ ] Sözlük yöneticisi UI + tercihler
+- [ ] Koyu tema
+- [ ] Windows / Linux / macOS tek dosya binary (PyInstaller)
+
+### Lisans
+
+[GNU General Public License v3.0 veya sonrası](LICENSE).

dictz-0.0.2/dictz/__init__.py

@@ -0,0 +1,2 @@
+"""dictz — a cross-platform multi-format offline dictionary application."""
+__version__ = "0.0.2"

dictz-0.0.2/dictz/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m dictz` to launch the app."""
+from .app import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

dictz-0.0.2/dictz/app.py

@@ -0,0 +1,65 @@
+"""dictz application entry point.
+
+Run with:
+    python -m dictz
+    # or after `pip install -e .`:
+    dictz
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+from PySide6.QtWidgets import QApplication
+
+from .core.query_manager import QueryManager
+from .storage.indexer import IndexStore
+from .ui.main_window import MainWindow
+
+__version__ = "0.0.2"
+APP_NAME = "dictz"
+
+
+def user_data_dir() -> Path:
+    """Cross-platform per-user data directory.
+
+    - Windows:  %APPDATA%\\dictz
+    - macOS:    ~/Library/Application Support/dictz
+    - Linux:    $XDG_DATA_HOME/dictz  (fallback ~/.local/share/dictz)
+    """
+    if sys.platform == "win32":
+        base = Path(os.environ.get("APPDATA", Path.home() / "AppData" / "Roaming"))
+        return base / APP_NAME
+    elif sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / APP_NAME
+    else:
+        xdg = os.environ.get("XDG_DATA_HOME")
+        base = Path(xdg) if xdg else Path.home() / ".local" / "share"
+        return base / APP_NAME.lower()
+
+
+def main() -> int:
+    app = QApplication(sys.argv)
+    app.setApplicationName(APP_NAME)
+    app.setApplicationVersion(__version__)
+    app.setOrganizationName("Bayram Kotan")
+    app.setOrganizationDomain("bayramkotan.com")
+
+    data_dir = user_data_dir()
+    data_dir.mkdir(parents=True, exist_ok=True)
+    index_path = data_dir / "dictz_index.db"
+
+    index_store = IndexStore(index_path)
+    index_store.open()
+
+    query_manager = QueryManager(index_store=index_store)
+
+    window = MainWindow(query_manager)
+    window.show()
+
+    return app.exec()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

dictz-0.0.2/dictz/core/query_manager.py

@@ -0,0 +1,126 @@
+"""Query manager: orchestrates lookups across all loaded dictionaries.
+
+The query manager keeps a list of loaded `Dictionary` instances and dispatches
+a single user query to all of them, collecting and ranking the results.
+
+For v0.0.2 we run lookups sequentially. Parallelization with QThreadPool comes
+in a later version when big glossary loading becomes a bottleneck.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+from ..parsers.babylon import BabylonDictionary
+from ..parsers.base import Dictionary, DictionaryEntry
+from ..parsers.dsl import DSLDictionary
+from ..parsers.stardict import StarDictDictionary
+from ..storage.indexer import IndexStore
+
+
+# File-extension -> parser class. `.dsl.dz` is handled by peeling the .dz
+# compression suffix before the lookup.
+_PARSER_REGISTRY: dict[str, type[Dictionary]] = {
+    ".ifo": StarDictDictionary,
+    ".dsl": DSLDictionary,
+    ".bgl": BabylonDictionary,
+}
+
+
+def parser_for(path: Path | str) -> type[Dictionary]:
+    """Pick a parser class based on file extension.
+
+    Handles compressed forms (.dsl.dz, .gls.dz) by peeling the .dz suffix.
+    """
+    p = Path(path)
+    suffix = p.suffix.lower()
+
+    # Strip dictzip compression layer
+    if suffix == ".dz":
+        inner_suffix = p.with_suffix("").suffix.lower()
+        if inner_suffix in _PARSER_REGISTRY:
+            return _PARSER_REGISTRY[inner_suffix]
+
+    if suffix in _PARSER_REGISTRY:
+        return _PARSER_REGISTRY[suffix]
+
+    raise ValueError(f"No parser registered for file: {p}")
+
+
+def supported_extensions() -> list[str]:
+    """List of extensions the current build can open."""
+    return sorted(_PARSER_REGISTRY.keys())
+
+
+class QueryManager:
+    """Orchestrates dictionary loading and multi-dictionary lookups."""
+
+    def __init__(self, index_store: IndexStore | None = None):
+        self.dictionaries: dict[str, Dictionary] = {}
+        self.index_store = index_store
+
+    def add_dictionary(self, path: Path | str, reindex: bool = False) -> Dictionary:
+        parser_cls = parser_for(path)
+        dictionary = parser_cls(path)
+        dictionary.load()
+        self.dictionaries[dictionary.metadata.name] = dictionary
+
+        if self.index_store is not None:
+            already_indexed = self.index_store.is_indexed(dictionary.metadata.name)
+            if reindex or not already_indexed:
+                self.index_store.index_dictionary(dictionary)
+
+        return dictionary
+
+    def remove_dictionary(self, name: str) -> None:
+        if name in self.dictionaries:
+            self.dictionaries[name].close()
+            del self.dictionaries[name]
+        if self.index_store is not None:
+            self.index_store.remove_dictionary(name)
+
+    def loaded_names(self) -> list[str]:
+        return sorted(self.dictionaries.keys())
+
+    def search(self, word: str, exact: bool = True) -> list[DictionaryEntry]:
+        if not word.strip():
+            return []
+
+        results: list[DictionaryEntry] = []
+        for name, dictionary in self.dictionaries.items():
+            try:
+                entries = dictionary.lookup(word, exact=exact)
+            except Exception as e:
+                print(f"[dictz] lookup failed in {name}: {e}")
+                continue
+            results.extend(entries)
+        return results
+
+    def suggest(self, prefix: str, limit: int = 30) -> list[str]:
+        if not prefix.strip():
+            return []
+
+        if self.index_store is not None:
+            rows = self.index_store.search_headword(prefix, limit=limit)
+            seen: set[str] = set()
+            out: list[str] = []
+            for headword, _ in rows:
+                if headword not in seen:
+                    seen.add(headword)
+                    out.append(headword)
+            return out
+
+        seen = set()
+        out = []
+        for dictionary in self.dictionaries.values():
+            for entry in dictionary.lookup(prefix, exact=False):
+                if entry.headword not in seen:
+                    seen.add(entry.headword)
+                    out.append(entry.headword)
+                    if len(out) >= limit:
+                        return out
+        return out
+
+    def close_all(self) -> None:
+        for dictionary in self.dictionaries.values():
+            dictionary.close()
+        self.dictionaries.clear()

dictz-0.0.2/dictz/parsers/babylon.py

@@ -0,0 +1,16 @@
+"""Babylon (.bgl) dictionary parser.
+
+Babylon is a proprietary binary format from the Babylon translator. The format
+was reverse-engineered years ago; PyGlossary includes a mature parser that
+handles the binary encoding, embedded images, and multi-byte character sets.
+"""
+from __future__ import annotations
+
+from .pyglossary_base import PyGlossaryDictionary
+
+
+class BabylonDictionary(PyGlossaryDictionary):
+    """Babylon binary dictionary (.bgl)."""
+
+    _format = "BabylonBgl"
+    format_label = "babylon"