haqumei 0.2.0

Haqumei is a Japanese Grapheme-to-Phoneme (G2P) library implemented in Rust.
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

use std::{
    ffi::NulError,
    io,
    path::{PathBuf, StripPrefixError},
};

use thiserror::Error;

#[derive(Error, Debug)]
pub enum HaqumeiError {
    #[error("Failed to allocate internal structures: {0}")]
    AllocationError(&'static str),

    #[error("The provided dictionary path is invalid: {0}")]
    InvalidDictionaryPath(String),

    #[error("Failed to load MeCab dictionary.")]
    MecabLoadError,

    #[error(
        "Input data for FFI contains an interior NUL byte at position {pos}: `{}`",
        String::from_utf8_lossy(bytes)
    )]
    InteriorNulError { bytes: Vec<u8>, pos: usize },

    #[error("Cache directory I/O error at path '{path}'")]
    CacheIo {
        path: PathBuf,
        #[source]
        source: io::Error,
    },

    #[error("MeCab analysis failed (parsing error or invalid state): {0}")]
    MecabError(String),

    #[error("text2mecab conversion failed: {0}")]
    Text2MecabError(String),

    #[error("Dictionary path not found: {path}")]
    DictionaryNotFound { path: PathBuf },

    #[error(
        "Embedded dictionary verification failed at '{path}': checksum mismatch.\n  Expected: {expected}\n  Actual:   {actual}"
    )]
    DictionaryVerification {
        path: PathBuf,
        expected: String,
        actual: String,
    },

    #[error("Could not determine a valid cache directory for this system")]
    CacheDirectoryNotFound,

    #[error("Global dictionary is not initialized yet")]
    GlobalDictionaryNotInitialized,

    #[error(transparent)]
    StripPrefixError(#[from] StripPrefixError),

    #[error(transparent)]
    IoError(#[from] io::Error),

    #[error(transparent)]
    DirError(#[from] walkdir::Error),

    #[error(transparent)]
    VibratoError(#[from] vibrato_rkyv::errors::VibratoError),

    #[error(transparent)]
    OrtError(#[from] ort::Error),
}

impl From<NulError> for HaqumeiError {
    fn from(value: NulError) -> Self {
        let pos = value.nul_position();
        HaqumeiError::InteriorNulError {
            bytes: value.into_vec(),
            pos,
        }
    }
}