petitparser 1.4.1 copy "petitparser: ^1.4.1" to clipboard
petitparser: ^1.4.1 copied to clipboard

outdatedDart 1 only

Dynamic parser combinator framework.

PetitParser for Dart #

Pub Package Build Status Coverage Status

Grammars for programming languages are traditionally specified statically. They are hard to compose and reuse due to ambiguities that inevitably arise. PetitParser combines ideas from scannnerless parsing, parser combinators, parsing expression grammars and packrat parsers to model grammars and parsers as objects that can be reconfigured dynamically.

This library is open source, stable and well tested. Development happens on GitHub. Feel free to report issues or create a pull-request there. General questions are best asked on StackOverflow.

An introductionary tutorial is part of the class documentation.

Basic Usage #

Installation #

Add the dependency to your package's pubspec.yaml file:

dependencies:
  petitparser: ">=1.0.0 <2.0.0"

Then on the command line run:

$ pub get

To PetitParser in your Dart code write:

import 'package:petitparser/petitparser.dart';

Examples #

The package comes with a large collections of grammars and language experiments ready to explore:

  • lib/dart.dart contains an experimental Dart grammar.
  • lib/json.dart contains a complete JSON grammar and parser.
  • lib/lisp.dart contains a complete Lisp grammar, parser and evaluator:
  • example/lisphell contains a command line lisp interpreter.
    • example/lispweb contains a web based lisp interpreter.
    • lib/smalltalk.dart contains a complete Smalltalk grammar.

Furthermore, there are various open source projects using PetitParser:

  • dart-xml is a lightweight library for parsing, traversing, and querying XML documents.
  • Haml.dart is an implementation of Haml in Dart.
  • RythmDart is a rich featured, high performance template engine.
  • SharkDart is a small template engine.

Misc #

History #

PetitParser was originally implemented in Smalltalk. Later on, as a mean to learn these languages, I reimplemented PetitParser in Java and Dart. The implementations are very similar in their API and the supported features. If possible, the implementations adopt best practises of the target language.

Ports #

License #

The MIT License, see LICENSE.