halococo/eunneun

> 한국어 조사, 이제 걱정 끝!

EunNeun은 어떤 라이브러리인가요?

문자열에 .kParticle(...) 메서드를 호출하면, 받침 유무와 특수 규칙(예: ㄹ 받침, 괄호 등)을 자동 판별하여 알맞은 한국어 조사를 붙여줍니다.

"학교)".kParticle(.으로로) → "학교로)" "물".kParticle(.으로로) → "물로" (ㄹ 받침 예외 적용)

이런 경험 있으시죠?

// 헷갈리는 조사들...
let message = userName + "이/가" + " " + itemName + "을/를" + " 획득했습니다!"

// 조건문으로 직접 처리...
let particle = hasJongseong(word) ? "을" : "를"
let result = word + particle

// ㄹ 받침 예외도 처리해야...
if word.last == "ㄹ" && particleType == "으로/로" {
    // ...
}

이제 이렇게 간단하게!

// 👇 잊지 말고!
import EunNeun

"사과".kParticle(.을를)   // "사과를"
"책".kParticle(.을를)     // "책을"

let message = "\(userName.kParticle(.이가)) \(itemName.kParticle(.을를)) 획득했습니다!"
// 예: "철수가 검을 획득했습니다!"

왜 EunNeun인가요?

정확성

- 유니코드 기반 받침 분석 - ㄹ(리을) 받침 예외 자동 처리 - 종성 계산 로직 → 빠르고 정확함

편의성

- .kParticle(.을를)처럼 직관적인 API - 공백, 개행, 괄호, 따옴표도 자동 정리 - 메서드 체이닝 친화적

실용성

- 게임, 채팅, 알림 등에 즉시 사용 가능 - Swift 스타일 가이드에 맞춘 구현 - SPM으로 간편 설치

설치

Swift Package Manager

// Package.swift
// swift-tools-version:5.7
dependencies: [
    .package(url: "https://github.com/halococo/EunNeun", from: "1.0.2")
]

Xcode

File → Add Package Dependencies →

https://github.com/halococo/EunNeun

Swift 5.7+, Xcode 14.0+ 환경 권장

1분만에 배우기

import EunNeun

"사과".kParticle(.을를)     // "사과를"
"책".kParticle(.이가)       // "책이"
"철수".kParticle(.아야)     // "철수야"
"학교".kParticle(.으로로)   // "학교로"

let user = "지영"
let item = "포도"
print("\(user.kParticle(.이가)) \(item.kParticle(.을를)) 맛있어요")
// → "지영이 포도를 맛있어요"

실전 활용 예제

게임 메시지

func showReward(item: String, count: Int) -> String {
    "\(item.kParticle(.을를)) \(count)개 획득하셨습니다!"
}

채팅 봇

func createGreeting(name: String) -> String {
    let isMorning = Calendar.current.component(.hour, from: Date()) < 12
    return "\(name.kParticle(.이가)) \(isMorning ? "좋은 아침" : "안녕하세요")!"
}

알림 메시지

func createNotification(friend: String, action: String) -> String {
    "\(friend.kParticle(.이가)) 회원님의 게시물에 \(action)습니다."
}

지원하는 조사 종류

| 조사 | 예시 | |------|------| | .을를 | "책".kParticle(.을를) → "책을" | | .이가 | "사과".kParticle(.이가) → "사과가" | | .은는 | "고양이".kParticle(.은는) → "고양이는" | | .과와 | "친구".kParticle(.과와) → "친구와" | | .아야 | "민수".kParticle(.아야) → "민수야" | | .으로로 | "물".kParticle(.으로로) → "물로" / "집".kParticle(.으로로) → "집으로" |

고급 기능

ㄹ 받침 자동 처리

"물".kParticle(.으로로)   // "물로"
"길".kParticle(.으로로)   // "길로"
"집".kParticle(.으로로)   // "집으로"

스마트 tail 정리

"\"사과\"".kParticle(.을를)         // "\"사과\"를"
"(책)".kParticle(.이가)             // "(책)이"
"학교)".kParticle(.으로로)          // "학교로)"
"카페.... )".kParticle(.을를)       // "카페를.... )"
"사과   \n".kParticle(.을를)        // "사과를   \n"

동작 원리

유니코드 한글 범위: U+AC00 ~ U+D7A3
종성(받침) 판별 공식:

let offset = unicodeScalar - 0xAC00
let hasFinalConsonant = (offset % 28) != 0
let isRieul = (offset % 28) == 8

시스템 요구사항

Swift 5.7+
iOS 13.0+, macOS 10.15+, watchOS 6.0+, tvOS 13.0+
Xcode 14.0+ (권장)

참고 사항

“마지막 단어” 기준으로 조사 판별
한글 외 문자열은 받침 없는 것으로 간주

- "Apple".kParticle(.이가) → "Apple가"

괄호, 따옴표 등은 적절히 밖/안 구분하여 조사 붙임

기여하기

기능 제안: GitHub Discussions
버그 제보: GitHub Issues

라이선스

Package Metadata

Repository: halococo/eunneun

Default branch: main

README: README.md