### ----------------------------------------------------
### -- Grammar-Common
### -- Licenses: Artistic-2.0
### -- Authors: Jeffrey Goff <drforr@pobox.com>
### -- File: README.md
### ----------------------------------------------------
# Grammar-Common [![Build Status](https://secure.travis-ci.org/drforr/perl6-Grammar-Common.svg?branch=master)](http://travis-ci.org/drforr/perl6-Grammar-Common)
Grammar-Common
=======

Common bits for grammars, such as math expressions.

All files here will be roles, rather than standalone grammars and actions.
Yes, simple actions are included that return simple hashes containing the parse
tree. You can override these as well, or simply include your own actions.

The test suite shows you how to return more complex objects - I elected not
to do this even though it does make quite a bit more sense because I didn't
want to arbitrary clutter the grammar namespace.

Read the individual Grammar::Common files for more documentation, but these
are generally meant to be dropped in with
'also does Grammar::Common::Expression::Infix;' and using the resulting
<expression> rule as you like.

In most cases default values will be provided, although I'm probably going to
go with C-style variables and values, just because adding a full Perl-style
expression encourages people to think it's reparsing Perl 6, but that's another
module.

Installation
============

* Using zef (a module management tool bundled with Rakudo Star):

```
    zef update && zef install Grammar::Common
```

## Testing

To run tests:

```
    prove -e perl6
```

## Author

Jeffrey Goff, DrForr on #perl6, https://github.com/drforr/

## License

Artistic License 2.0


