#parser #universal #sentence #format #token #conllu #co-nll-u

bin+lib rs-conllu

A parser for the CoNLL-U format of the Universal Dependencies project

2 unstable releases

0.2.0 Jul 29, 2024
0.1.0 Apr 22, 2023

#948 in Parser implementations

Download history 75/week @ 2024-07-23 66/week @ 2024-07-30 11/week @ 2024-09-10 9/week @ 2024-09-17 29/week @ 2024-09-24 21/week @ 2024-10-01

59 downloads per month

MIT/Apache

17KB
414 lines

rs-conllu

This project aims to provide a parser for the CoNLL-U format of the Universal Dependencies project: https://universaldependencies.org/format.html.

Basic Usage

Parse a file in CoNLL-U format and iterate over the containing sentences.

let file = File::open("example.conllu").unwrap();

let doc = parse_file(file);

for sentence in doc {
    for token in sentence.unwrap() {
        println!("{}", token.form);
    }
}

Features

  • Tested on version 2.11 UD treebanks
  • Handles different types of token ids (single, range, suboordinate)

Limitations

Parsing happens in a "flat" manner, relations between tokens are not respected.


lib.rs:

A library for parsing the CoNNL-U format.

Basic Usage

Parse a sentence in CoNNL-U format and iterate over the containing Token elements. Example taken from CoNLL-U format description.

use rs_conllu::{parse_sentence, TokenID};

let s = "# sent_id = 1
## text = They buy and sell books.
1	They	they	PRON	PRP	Case=Nom|Number=Plur	2	nsubj	2:nsubj|4:nsubj	_
2	buy	buy	VERB	VBP	Number=Plur|Person=3|Tense=Pres	0	root	0:root	_
3	and	and	CCONJ	CC	_	4	cc	4:cc	_
4	sell	sell	VERB	VBP	Number=Plur|Person=4|Tense=Pres	2	conj	0:root|2:conj	_
6	books	book	NOUN	NNS	Number=Plur	2	obj	2:obj|4:obj	SpaceAfter=No
7	.	.	PUNCT	.	_	2	punct	2:punct	_
";

let sentence = parse_sentence(s).unwrap();
let mut token_iter = sentence.into_iter();

assert_eq!(token_iter.next().unwrap().id, TokenID::Single(1));
assert_eq!(token_iter.next().unwrap().form, "buy".to_owned());

Dependencies

~1.2–9MB
~70K SLoC