opencorpora 0.3.0

Reading and parsing opencorpora.org XML-dictionary.
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

use std::rc::Rc;

/// Структура описывающая граммему.
///
/// Список всех граммем можно [посмотреть](http://opencorpora.org/dict.php?act=gram)
/// на сайте [opencorpora.org](http://opencorpora.org).
#[derive(Clone, Default, Debug)]
pub struct Grammeme {
    /// Имя родительской граммемы (значение `None` индицирует, что это граммема верхнего уровня)
    pub parent: Option<String>,

    /// Имя граммемы на латинице
    pub name: String,

    /// Имя граммемы на кириллице
    pub alias: String,

    /// Подробное описание граммемы
    pub description: String,
}

/// Тип ограничения на использование граммемы.
#[derive(Clone, Copy, Debug)]
pub enum RestrictionKind {
    /// Необязательный
    Maybe,

    /// Обязательный
    Obligatory,

    /// Запрещающий
    Forbidden,
}

/// Область ограничения на использование граммемы.
#[derive(Clone, Copy, Debug)]
pub enum RestrictionScope {
    /// Лексема
    Lemma,

    /// Словоформа лексемы
    Form,
}

/// Правило ограничивающие применение граммемы.
///
/// Более подробное описание [приведено](http://opencorpora.org/dict.php?act=gram_restr)
/// на сайте [opencorpora.org](http://opencorpora.org).
#[derive(Clone, Debug)]
pub struct Restriction {
    /// Тип ограничения (см. [документацию](enum.RestrictionKind.html) типа `RestrictionKind`)
    pub kind: RestrictionKind,

    /// Приоритет (?)
    pub auto: usize,

    /// Область применения слева
    pub left_scope: RestrictionScope,

    /// Граммема слева.
    /// Для некоторых правил значение справа может отсутствовать.
    pub left_grammeme: Option<Rc<Grammeme>>,

    /// Область применения справа
    pub right_scope: RestrictionScope,

    /// Граммема справа.
    /// Для некоторых правил значение справа может отсутствовать.
    pub right_grammeme: Option<Rc<Grammeme>>,
}

impl Default for Restriction {
    fn default() -> Self {
        Restriction{
            kind: RestrictionKind::Maybe,
            auto: 0,
            left_scope: RestrictionScope::Lemma,
            left_grammeme: None,
            right_scope: RestrictionScope::Lemma,
            right_grammeme: None,
        }
    }
}

/// Структура словоформы лексемы.
#[derive(Clone, Default, Debug)]
pub struct Form {
    /// Текстовое представление словоформы
    pub word: String,

    /// Множество граммем описывающих словоформу
    pub grammemes: Vec<Rc<Grammeme>>,
}

/// Структура описывающая лексему.
#[derive(Clone, Default, Debug)]
pub struct Lemma {
    /// Числовой идентификатор лексемы
    pub id: usize,

    /// Номер ревизии
    pub revision: usize,

    /// Текстовое представление исходный словоформы лексемы
    pub word: String,

    /// Множество граммем описывающих лексему
    pub grammemes: Vec<Rc<Grammeme>>,

    /// Множество словоформ входящих в данную лексему
    pub forms: Vec<Form>,
}

/// Тип связи между лексемами.
#[derive(Clone, Default, Debug)]
pub struct LinkKind {
    /// Числовой идентификатор типа связи.
    /// Используется в типе `Link`.
    pub id: usize,

    /// Имя типа связи
    pub name: String,
}

/// Структура хранящая связь между двумя лексемами.
#[derive(Clone, Default, Debug)]
pub struct Link {
    /// Числовой идентификатор связи
    pub id: usize,

    /// Лексема с исходной стороны связи
    pub from: Rc<Lemma>,

    /// Лексема с конечной стороны связи
    pub to: Rc<Lemma>,

    /// Типа связи
    pub kind: Rc<LinkKind>,
}

/// Структура содержащая данные словаря.
#[derive(Default, Debug)]
pub struct Dict {
    /// Версия словаря
    pub version: String,

    /// Номер ревизии
    pub revision: usize,

    /// Множество граммем
    pub grammemes: Vec<Rc<Grammeme>>,

    /// Множество правил-ограничений на использование граммем
    pub restrictions: Vec<Restriction>,

    /// Массив лексем
    pub lemmata: Vec<Rc<Lemma>>,

    /// Множество типов связей между лексемами
    pub link_kinds: Vec<Rc<LinkKind>>,

    /// Множество связей между лексемами
    pub links: Vec<Link>,
}