Crate pacosso

Pacosso is a framework for rapid parser development. It does not aim at building high-performance parsers - other frameworks are much more suitable for that - but rather at easy development for rapid prototyping and projects with moderate performance requirements.

Different from other streaming parser libraries, pacosso manages the incoming stream internally. The feature is intended to make writing parsers as easy as possible. Pacosso is able to handle any reader including in-memory buffers and strings, files, sockets and IO-chains combining such readers.

To see pacosso in action, have a look at Jsosso, a JSON parser that demonstrates the framework. It contains demo programs, benchmarks and more documentation.

Example:

use std::io;
use pacosso::{Stream, ParseResult};
use pacosso::options::Opts;

let parse = |p: &mut Stream<io::Cursor<Vec<u8>>>| -> ParseResult<()> {
    p.string("hello")?;
    p.whitespace()?;
    p.string("world")
};

let mut input = io::Cursor::new("hello world".as_bytes().to_vec());
let mut s = Stream::new(Opts::default().set_buf_size(8), &mut input);

assert!(match s.apply(parse) {
    Ok(()) => true,
    Err(e) => {
       eprintln!("error: {:?}", e);
       false
    },
});

Re-exports

• pub use self::options::Opts;
• pub use self::error::*;

Modules

• error
• options

Structs

• Cursor
  Cursor keeps track of the position in the overall stream, in terms of lines in the stream and within the current line. Note that, for stream, the start position is 0, while, for line and lpos, the start position is 1.
• Stream
  Stream manages the reader from which to parse. Streams can be built from any reader including in-memory buffers and strings, files, sockets and io::Chains.

Functions

• parse_buffer
  Convenience interface for parsing a byte buffer.
• parse_file
  Convenience interface for parsing from a file.
• parse_string
  Convenience interface for parsing a string.

Type Definitions

• ParseResult
  Parser methods return a Result of a generic type and a ParseError