korean-glue 0.1.1

A modern Python library for Korean josa processing with dictionary support and framework integrations.

한국어

korean_glue

A modern Python library for Korean josa processing combining rule-based and dictionary-based approaches. Django template tags and Jinja2 filters are included for easy web framework integration.

Installation

pip install korean_glue

Framework integrations rely on Django and Jinja2.

Usage

Basic API

from korean_glue import attach, get_josa

print(get_josa("사과", "은/는"))  # "는"
print(attach("사과", "은/는"))    # "사과는"

Custom Exception Rules

from korean_glue import add_exception_rule, remove_exception_rule, attach

add_exception_rule("사과", "은/는", "당")
print(attach("사과", "은/는"))  # "사과당"
remove_exception_rule("사과", "은/는")

Command Line

Install the package and run the kglue command:

kglue '철수(은/는)'
kglue 'K(이/가)'
kglue '3(을/를)'

Framework Integrations

Django

{{ variable|josa:"을/를" }}

Jinja2

from korean_glue.integrations import jinja_filters
from jinja2 import Environment

env = Environment()
jinja_filters.register(env)
result = env.from_string("{{ word|josa('으로/로') }}").render(word="서울")

Running Tests

After setting up a development environment (see CONTRIBUTING.md), run:

pytest