esmorph 0.1.0

Fast Spanish morphological analyzer: lemmas, Universal Dependencies features and inflection
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

# esmorph

Fast Spanish morphological analyzer written in Rust, the core of the
[esMorph](https://github.com/SergeyShk/esMorph) library for Python.

- The analyses of a word form by a dictionary built from Wiktionary and treebanks, the most probable first: the lemma,
  the part of speech and the [Universal Dependencies](https://universaldependencies.org/) features.
- Case does not matter. A word absent as written is looked for without its accents and with a lost diaeresis.
- A verb with enclitic pronouns is analyzed as its verb, with the words of the token: `dámelo` is `da` + `me` + `lo`.
- The forms of a lexeme in the order of its paradigm and the form with given features: conjugation, gender and number.
- Tokens out of the dictionary by rules: punctuation, symbols, numbers, Roman numerals, names and acronyms.
- Unknown lowercase words guessed by their last part after a hyphen, a known prefix or their ending, with their forms.
- The dictionary is mapped into memory or read from the data of the program without copies.

## Installation

```toml
[dependencies]
esmorph = "0.1"
```

The dictionary is in the crate [`esmorph-dict-es`](https://crates.io/crates/esmorph-dict-es), used through the feature `bundled` (on by default). Without it the dictionary is read from a file:

```rust,ignore
let dictionary = esmorph::Dictionary::open("es.dict")?;
```

## Example

```rust
use esmorph::Dictionary;

fn main() -> Result<(), esmorph::Error> {
    let dictionary = Dictionary::bundled()?;
    for analysis in dictionary.analyze("camiones") {
        let tag = dictionary.ud_tag(analysis.ud).unwrap();
        println!("{} {} {}", analysis.lemma, tag.pos(), tag.feats_string());
    }
    let hablar = &dictionary.analyze("hablar")[0];
    let past = [("Tense", "Past"), ("Person", "3"), ("Number", "Plur")];
    assert_eq!(dictionary.inflect(hablar, &past).unwrap().word, "hablaron");
    Ok(())
}
```

## License

The code is distributed under the [MIT](https://github.com/SergeyShk/esMorph/blob/master/LICENSE.txt) license. The dictionary is under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).