Star me on GitHub

Current implementations of parsers include:

Implementing a parser for a new serialization format or any other parsable text or bytes can be done by implementing the following interface.

type Interface interface {
    Next() error
    IsLeaf() bool

type Value interface {
    Double() (float64, error)
    Int() (int64, error)
    Uint() (uint64, error)
    Bool() (bool, error)
    String() (string, error)
    Bytes() ([]byte, error)

This interface allows for the implementation of a streaming parser. A parser that lazily parses the input as the methods are called and only parses the input once, without backtracking. Exercising the parser can be done with the debug.Walk function. The Walk function also returns some debugging output which should be useful in the development of your parser.

Your parser should also be able to handle skipping of some of the input. This happens when the Walk function returns before encountering an io.EOF. The debug.RandomWalk function is useful for testing this type of robustness in your parser.