hanjadict 0.4.1

A lightweight Python library for looking up Korean Hanja characters with their 훈음 (Hun-eum) meanings and pronunciations

HanjaDict (한자사전)

A lightweight Python package for looking up Hanja (Chinese characters used in Korea) information, specifically focusing on 훈음 (hun-eum).

Installation

pip install hanjadict

Usage

import hanjadict

# Look up a Hanja character
result = hanjadict.lookup("雪")
print(result)
# Output: '눈 설'

# Check if a character is Hanja
is_hanja = hanjadict.is_hanja("雪")
print(is_hanja)
# Output: True

# Get only the pronunciation (음/音) part
pron = hanjadict.pronunciation("雪")
print(pron)
# Output: '설'

# Access the raw dictionary data
raw_data = hanjadict.table_data
print(len(raw_data))
# Output: 53458

# If the character is not found, returns None
result = hanjadict.lookup("xyz")
print(result)  # Output: None

Features

• Fast lookups using a pre-compiled dictionary
• Simple API with intuitive functions
• Comprehensive dictionary of 53,458 characters
• Lightweight with no external dependencies
• Access to raw dictionary data for advanced usage

Available Functions

• lookup(c): Get the full 훈음 information for a character
• is_hanja(c): Check if a character is a valid Hanja in the dictionary
• pronunciation(c): Extract only the Sino-Korean pronunciation (음/音) part
• table_data: Access the raw dictionary data (as a Python dictionary)

What is 훈음 (Hun-eum)?

훈음 (訓音) refers to the combined Korean native word meaning (훈/訓) and Sino-Korean pronunciation (음/音) of a Hanja character. For example:

• 雪 (눈 설): "눈" is the 훈 (native Korean word for "snow") and "설" is the 음 (Sino-Korean pronunciation)
• 山 (메 산): "메" is the 훈 (native Korean word for "mountain") and "산" is the 음

This concept is unique to Korean language and helps learners understand both the meaning and pronunciation of Hanja characters.

Special Formats Handled

The pronunciation() function can handle various dictionary formats:

• Normal format: "눈 설" → returns "설"
• Comma-separated: "샘솟을 집, 샘솟을 설" → returns "집"
• Slash-separated: "제비 연/잔치 연" → returns "연"
• Parentheses: "영양 령(영)" → returns "령"