lindera-dictionary 5.0.1

A morphological dictionary library.
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

use std::path::Path;

use crate::LinderaResult;
use crate::dictionary::prefix_dictionary::{DaTrust, PrefixDictionary};
#[cfg(feature = "mmap")]
use crate::util::mmap_file;
use crate::util::read_file;

/// Loader for prefix dictionary data from disk files.
pub struct PrefixDictionaryLoader {}

impl PrefixDictionaryLoader {
    /// Load prefix dictionary from files in the specified directory.
    ///
    /// Reads dict.da, dict.vals, dict.wordsidx, and dict.words files
    /// and constructs a PrefixDictionary.
    ///
    /// # Arguments
    ///
    /// * `input_dir` - Path to the directory containing dictionary files.
    ///
    /// # Returns
    ///
    /// A `PrefixDictionary` loaded from the files.
    pub fn load(input_dir: &Path) -> LinderaResult<PrefixDictionary> {
        let da_data = read_file(input_dir.join("dict.da").as_path())?;
        let vals_data = read_file(input_dir.join("dict.vals").as_path())?;
        let words_idx_data = read_file(input_dir.join("dict.wordsidx").as_path())?;
        let words_data = read_file(input_dir.join("dict.words").as_path())?;

        PrefixDictionary::load(
            da_data,
            vals_data,
            words_idx_data,
            words_data,
            true,
            DaTrust::Untrusted,
        )
    }

    /// Load prefix dictionary using memory-mapped files.
    ///
    /// Note: only `vals_data`/`words_idx_data`/`words_data` end up genuinely
    /// mmap-backed (read lazily at lookup time via `Data::Map`). `da_data` is
    /// still eagerly copied into an owned `DoubleArrayAhoCorasick` by
    /// [`PrefixDictionary::load`] — daachorse has no zero-copy deserialization
    /// API — so mmap only avoids the initial file-read syscall/allocation for
    /// that component, not runtime lazy paging. mmap'd bytes are passed with
    /// [`DaTrust::Untrusted`], the same as a plain read: they can be
    /// corrupted or tampered with just as easily as a regular file.
    ///
    /// # Arguments
    ///
    /// * `input_dir` - Path to the directory containing dictionary files.
    ///
    /// # Returns
    ///
    /// A `PrefixDictionary` loaded via memory mapping.
    #[cfg(feature = "mmap")]
    pub fn load_mmap(input_dir: &Path) -> LinderaResult<PrefixDictionary> {
        let da_data = mmap_file(input_dir.join("dict.da").as_path())?;
        let vals_data = mmap_file(input_dir.join("dict.vals").as_path())?;
        let words_idx_data = mmap_file(input_dir.join("dict.wordsidx").as_path())?;
        let words_data = mmap_file(input_dir.join("dict.words").as_path())?;

        PrefixDictionary::load(
            da_data,
            vals_data,
            words_idx_data,
            words_data,
            true,
            DaTrust::Untrusted,
        )
    }
}