tjosa 0.1.0

t-string을 지원하는 Python 한국어 조사 처리 라이브러리

tjosa

한국어 조사를 어간에 맞게 자동으로 맞춰주는 라이브러리입니다. t-string을 통해 삽입한 값의 조사를 자동으로 인식해 변환하는 기능을 지원합니다.

요구 사항 (Requirements)

• Python 3.14+

설치 방법 (Installation)

pip install tjosa

지원 조사

• 은/는
• 이/가
• 을/를
• 과/와
• 으로/로
• 아/야
• 이/
  • 이랑/랑
  • 이며/며
  • 이다/다
  • 이가/가

이랑/랑, 이며/며, 이다/다, 이가/가는 이/를 통해 지원합니다.

사용법 (Usage)

josa

josa(template: Template, *, custom_josas: Sequence[tuple[str, str]], unused_josas: Sequence[str]) -> str

t-string 템플릿의 삽입값에 맞춰 뒤따르는 조사를 자동 변환합니다.

custom_josas 변수에 (받침 있음, 받침 없음)을 매핑한 사용자 지정 조사 튜플의 목록을 넣으면 해당 조사도 변환합니다.

unused_josas 변수에 변환하기를 원치 않는 조사의 목록을 입력할 수 있습니다.

예시:

from tjosa import josa

food = "사과"
print(josa(t"{food}는 맛있다"))   # 사과는 맛있다

food = "파인애플"
print(josa(t"{food}는 맛있다"))   # 파인애플은 맛있다

josa_only

josa_only(eogan: str, josa: str | tuple[str, str]) -> str

어간과 조사를 입력하면, 어간에 맞는 적절한 조사를 반환합니다.

josa에 입력할 수 있는 조사는 지원 조사 문단을 참고해 주세요. 예를 들어, 은/는을 사용할 경우 은 또는 는 중 하나를 선택해서 josa 인자이 입력하면 됩니다.

단, 이/가와 이/와 중복되는 조사 이의 경우, 이/가 우선되므로 이/가를 구분하려는 경우에는 가를 사용해 주세요.

josa에 (받침 있음, 받침 없음)을 매핑한 사용자 지정 조사 튜플을 대신 사용할 수 있습니다.

예시:

• josa_only("사과", "은") -> 는
• josa_only("집", "은") -> 은
• josa_only("학교", "으로") -> 로

성능 비교 (Performance)

tjosa는 한 단어 조사 선택(josa_only)과 문장 전체 문자열 변환(josa) 사용 방식 모두에서 유사 라이브러리 대비 빠른 성능을 보입니다.

동일 환경에서 유사 라이브러리와 함께 벤치마크를 측정한 결과는 다음과 같습니다.

• 한 단어 조사 선택

  • hsl0/tjosa.josa_only: 평균 8.9497μs
  • kimsehwan96/pyjosa.get_josa: 평균 26.0833μs
  • hsl0/tjosa.josa_only가 약 65.69% 더 빠름

• 문장 전체 조사 변환

  • hsl0/tjosa.josa: 평균 32.1564μs
  • myevan/pyjosa.replace_josa: 평균 37.2463μs
  • hsl0/josa가 약 13.67% 더 빠름

자세한 사항은 docs/benchmark.md 문서를 참고해 주세요.

라이선스 (License)

본 패키지는 MIT 라이선스로 배포됩니다.