korean-glue 0.1.4

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

Single-form patterns like 은, 이, or 을 are also recognized and automatically expanded to their counterparts.

from korean_glue import attach, get_josa

print(get_josa("사과", "은/는"))  # "는"
print(attach("사과", "은/는"))    # "사과는"
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 '철수(은)'
kglue 'K(이/가)'
kglue '3(을/를)'

Framework Integrations

Django

To use the filter, load the template tag library first:

{% load korean_glue.integrations.django_tags %}
{{ variable|josa:"을/를" }}

Alternatively add "korean_glue.integrations.django_tags" to OPTIONS['builtins'] in the TEMPLATES setting.

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