rustfst 1.3.0

Library for constructing, combining, optimizing, and searching weighted finite-state transducers (FSTs).
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

use anyhow::Result;
use std::fmt::Debug;
use std::ops::Deref;
use std::path::Path;

use crate::fst_properties::FstProperties;
use crate::semirings::Semiring;
use crate::{StateId, TrsVec};

pub trait FstOp<W: Semiring>: Debug {
    // was FstImpl
    fn compute_start(&self) -> Result<Option<StateId>>;
    fn compute_trs(&self, id: StateId) -> Result<TrsVec<W>>;
    fn compute_final_weight(&self, id: StateId) -> Result<Option<W>>;

    // Computed at construction time
    fn properties(&self) -> FstProperties;
}

impl<W: Semiring, F: FstOp<W>, FP: Deref<Target = F> + Debug> FstOp<W> for FP {
    fn compute_start(&self) -> Result<Option<StateId>> {
        self.deref().compute_start()
    }

    fn compute_trs(&self, id: StateId) -> Result<TrsVec<W>> {
        self.deref().compute_trs(id)
    }

    fn compute_final_weight(&self, id: StateId) -> Result<Option<W>> {
        self.deref().compute_final_weight(id)
    }

    // Computed at construction time
    fn properties(&self) -> FstProperties {
        self.deref().properties()
    }
}

pub trait AccessibleOpState {
    type FstOpState;

    // Return a reference to an FstOp internal state.
    fn get_op_state(&self) -> &Self::FstOpState;
}

pub trait SerializableOpState: Sized {
    /// Loads a FstOpState from a file in binary format.
    fn read<P: AsRef<Path>>(path: P) -> Result<Self>;

    /// Writes a FstOpState to a file in binary format.
    fn write<P: AsRef<Path>>(&self, path: P) -> Result<()>;
}