perigord-kleisli / combi

Combi

Combi is a parsec-inspired Rust parser combinator library. It can parse any type implementing Stream trait, and has built-in implementations for &str and &[u8].

Features

• Built in error-handling

Example programs

JSON Parser

Usage:

cargo run --example json <FILE> [..keys]

The file can also be received from piping:

cargo run --example json [..keys] < <FILE> or <program> | cargo run --example json [..keys]

Example:

$ echo '{"a": {"c": 2}, "b": [2,3] }' | cargo run --example json a
{
  "c": 2
}

$ echo '{"a": {"c": 2}, "b": [2,3] }' | cargo run --example json a c
2

$ echo '{"a": {"c": 2}, "b": [2,3] }' | cargo run --example json b 1
3

RegEx Engine

Usage:

cargo run --example regex <FILE> <PATTERN>

The file can also be received from piping:

cargo run --example regex <PATTERN> < <FILE> or <program> | cargo run --example regex <PATTERN>

Example:

""

$ echo "foobar\nbaz\nfoo" | cargo run --example regex 'foo'
foobar
foo

$ cargo run --example regex '[a-zA-Z0-9._%-]+@[a-zA-Z0-9-]+\.[a-zA-Z]{2,4}' <<EOF
[email protected]
invalidEmail.com
[email protected]
invalidmail_2&@a.com
invalidmail_3@com
VAL%[email protected]
EOF
[email protected]
[email protected]
VAL%[email protected]

TODO

• Add a difference between Errors that consume input vs those that don't
• Error message prettifier
• Indentation parsers
• Add more example programs
• Add ability to add custom errors
• Add unit tests
• Documentation
• Optimization