gukhanmun-opendict-cdb

This distribution contains Open Korean Dictionary (우리말샘) compiled into Gukhanmun CDB dictionary binaries (general.cdb.gz, north-korean.cdb.gz, dialect.cdb.gz, archaic.cdb.gz) for the gukhanmun Python package. It has no API of its own and does not depend on gukhanmun.

Installation

Install it through the matching extra of the core package:

pip install 'gukhanmun[opendict-cdb]'

Usage

Installing the data does not change any converter. Add it explicitly:

from gukhanmun import Converter, DictionaryFormat
from gukhanmun.dictionaries import opendict_general, opendict_north_korean, opendict_dialect, opendict_archaic

converter = Converter(dictionaries=[
    opendict_general(format=DictionaryFormat.CDB),
    opendict_north_korean(format=DictionaryFormat.CDB),
    opendict_dialect(format=DictionaryFormat.CDB),
    opendict_archaic(format=DictionaryFormat.CDB),
])

The four Open Korean Dictionary categories are separate resources: general words, North Korean words, dialect words and archaic words. Add only the categories you need.

Resources ending in .gz are gzip-compressed; the gukhanmun.dictionaries helpers decompress them, while direct resource access returns the compressed bytes.

To read a resource directly, use importlib.resources:

from importlib.resources import files

data = (files("gukhanmun_opendict_cdb") / "general.cdb.gz").read_bytes()

License

GPL-3.0-or-later AND LicenseRef-CC-BY-SA-2.0-KR. See LICENSE and ATTRIBUTION.md for the code license and the data attribution. provenance.json records the source snapshot and the hashes of the bundled files.