Josa

Idiomatic josa selector.

Josa is a Rust library to select appropriate josas for korean language.

Overview

Method

Josa is an extension trait implemented for String type. Its API works just like push_str method on String.

use josa::JosaExt;
use josa::Josa::{EunNeun, IGa};

let mut user = "유진".to_owned();
let mut mackerel = "고등어".to_owned();

user.push_josa(EunNeun);
mackerel.push_josa(IGa);

let sentence = format!("{} {} 먹고싶다", user, mackerel);

assert_eq!(sentence, "유진은 고등어가 먹고싶다");

:warning: Like push_str does, push_josa expects String, not str, as its argument.

+, += Operator

You can use +, += operator to append josa.

use josa::Josa::{EunNeun, IGa};

let user = "유진".to_owned();
let mackerel = "고등어".to_owned();

let sentence = format!("{} {} 먹고싶다", user + EunNeun, mackerel + IGa);

assert_eq!(sentence, "유진은 고등어가 먹고싶다");

Usage

Add josa as a dependency in your Cargo.toml.

[dependencies]
josa = "0.1.0"

then import JosaExt trait in your code:

use josa::JosaExt;

Now you can use methods on String.

use josa::JosaExt;
// 🔥 here..

Documentation

See docs.rs

Roadmap

select method

Sometimes you don't want to mutate your String. For that case, we will provide pure function select which returns appropriate josa for given noun.

fn select(noun: &str, josa: Josa) -> &str

select macro

As soon as hygiene 2.0 (#54727) arrives stable, we will add support for following macro:

select!("{}{은} {}{가} 먹고싶다", user, mackerel);

which is more clear compared to current syntax:

Hangul enum variants

As soon as non-ASCII identifiers (#55467) arrives stable, we will change the names of josas to Hangul:

format!("{} {} 먹고싶다", user + 은는, mackerel + 이가);

License

Distributed under the MIT license.