zhconv 0.4.1

Traditional, Simplified and regional Chinese variants converter powered by MediaWiki & OpenCC rulesets and the Aho-Corasick algorithm 中文简繁及地區詞轉換
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use std::str::FromStr;

use itertools::Itertools;

use console_error_panic_hook;
use wasm_bindgen::prelude::*;

use crate::{get_builtin_converter, Variant, ZhConverterBuilder, ENABLED_TARGET_VARIANTS};

// #[wasm_bindgen(typescript_custom_section)]
// const COMMIT_HASH: &str = concat!("COMMIT_HASH", env!("VERGEN_GIT_SHA"));
// #[wasm_bindgen(typescript_custom_section)]
// const BUILD_TIMESTAMP: &str = env!("VERGEN_BUILD_TIMESTAMP");
// #[wasm_bindgen(typescript_custom_section)]
// const MEDIAWIKI_COMMIT_HASH: &str = env!("MEDIAWIKI_COMMIT_HASH");

// #[allow(dead_code)]
// #[wasm_bindgen]
// pub struct BuildInfo {
//     timestamp: &'static str,
//     commit_hash: &'static str,
//     mediawiki_commit_hash: &'static str,
// }

#[wasm_bindgen]
pub fn get_build_timestamp() -> Option<String> {
    option_env!("VERGEN_BUILD_TIMESTAMP").map(|s| s.into())
}

#[wasm_bindgen]
pub fn get_commit() -> Option<String> {
    option_env!("VERGEN_GIT_SHA").map(|s| s.into())
}

#[wasm_bindgen]
pub fn get_mediawiki_commit() -> Option<String> {
    option_env!("MEDIAWIKI_COMMIT_HASH").map(|s| s.into())
}

#[wasm_bindgen]
pub fn get_opencc_commit() -> Option<String> {
    option_env!("OPENCC_COMMIT_HASH").map(|s| s.into())
}

#[wasm_bindgen]
pub fn get_enabled_target_variants() -> Option<String> {
    use itertools::Itertools;
    Some(format!(
        "[{}]",
        ENABLED_TARGET_VARIANTS
            .iter()
            .format_with(",", |v, f| f(&format_args!("\"{v}\"")))
    ))
}

/// Convert text to a target Chinese variant.
///
/// Supported target variants: zh, zh-Hant, zh-Hans, zh-TW, zh-HK, zh-MO, zh-CN, zh-SG, zh-MY.
/// If `wikitext` is `True`, inline conversion rules such as `-{foo...bar}-` are parsed.
/// `rules` should be line-seperated in MediaWiki syntax without -{ or }- tags, like
/// `zh-hans:鹿; zh-hant:馬`.
/// Rules removing entries from built-in tables are not supported and are silently ignored.
#[wasm_bindgen]
pub fn zhconv(text: &str, target: &str, wikitext: Option<bool>, rules: Option<String>) -> String {
    console_error_panic_hook::set_once();

    let wikitext = wikitext.unwrap_or(false);
    let target = Variant::from_str(target).expect("Unsupported target variant");
    let converter = get_builtin_converter(target);
    let mut builder = rules.map(|rs| ZhConverterBuilder::new().conv_lines(rs.lines()));
    if wikitext {
        converter.convert_as_wikitext(text, &mut builder, true, true)
    } else {
        match builder {
            Some(builder) => converter.convert_with_secondary_converter(text, &builder.build()),
            None => converter.convert(text),
        }
    }
}

#[wasm_bindgen]
pub fn is_hans(text: &str) -> bool {
    console_error_panic_hook::set_once();

    crate::is_hans(text)
}

#[wasm_bindgen]
pub fn is_hans_confidence(text: &str) -> f32 {
    console_error_panic_hook::set_once();

    crate::is_hans_confidence(text)
}

#[wasm_bindgen]
pub fn infer_variant(text: &str) -> String {
    console_error_panic_hook::set_once();

    crate::infer_variant(text).to_string()
}

#[wasm_bindgen]
pub fn infer_variant_confidence(text: &str) -> String {
    console_error_panic_hook::set_once();

    crate::infer_variant_confidence(text)
        .into_iter()
        .map(|(v, c)| format!("{};q={:.3}", v, c))
        .join(", ")
}