Re: [ANN] Citrus ~ Parsing Expressions for Ruby

Yes. I'm real. ;)

http://mjijackson.com/about

--
Michael Jackson
http://mjijackson.com
@mjijackson



On Thu, May 13, 2010 at 3:58 PM, Louis-Philippe <[e-mail]> wrot=
e:
> are you the real Michael Jackson?
>
> 2010/5/13 Michael Jackson <[e-mail]>
>
>> Hi all,
>>
>> Just released this gem today, and thought others might get some good
>> use out of it. It's like Treetop, but takes a completely different
>> approach.
>>
>> http://rubygems.org/gems/citrus
>> http://github.com/mjijackson/citrus
>>
>> The README is below. Enjoy.
>>
>> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>>
>> ~* Citrus *~
>>
>> Parsing Expressions for Ruby
>>
>>
>> Citrus is a compact and powerful parsing library for Ruby that combines =
the
>> elegance and expressiveness of the language with the simplicity and powe=
r
>> of
>> parsing expression grammars.
>>
>> Citrus grammars look very much like Treetop grammars but take a complete=
ly
>> different approach. Instead of generating parsers from your grammars,
>> Citrus
>> evaluates grammars and rules in memory as Ruby modules. In fact, you can
>> even
>> define your grammars as Ruby modules in the first place, entirely skippi=
ng
>> the
>> parsing/evaluation step.
>>
>> Terminals are represented as either strings or regular expressions. Supp=
ort
>> for
>> sequences, choices, labels, repetition, and lookahead (both positive and
>> negative) are all included, as well as character classes and the
>> dot-matches-
>> anything symbol.
>>
>> To try it out, fire up an IRB session from the root of the project and r=
un
>> one
>> of the examples.
>>
>> =A0 =A0$ irb -Ilib
>> =A0 =A0> require 'citrus'
>> =A0 =A0 =3D> true
>> =A0 =A0> Citrus.load 'examples/calc'
>> =A0 =A0 =3D> [Calc]
>> =A0 =A0> match =3D Calc.parse '1 + 5'
>> =A0 =A0 =3D> #<Citrus::Match ...
>> =A0 =A0> match.value
>> =A0 =A0 =3D> 6
>>
>> Be sure to try requiring `citrus/debug' (instead of just `citrus') if yo=
u'd
>> like
>> some better visualization of the match results.
>>
>> The code base is very small and it's well-documented and tested, so it
>> should be
>> fairly easy to understand for anyone who is familiar with parsing
>> expressions.
>>
>>
>> =A0** Links **
>>
>>
>> http://pdos.csail.mit.edu/~baford/packrat/
>> http://en.wikipedia.org/wiki/Parsing_expression_grammar
>> http://treetop.rubyforge.org/index.html
>>
>>
>> =A0** Installation **
>>
>>
>> Via RubyGems:
>>
>> =A0 =A0$ sudo gem install citrus
>>
>> From a local copy:
>>
>> =A0 =A0$ git clone git://github.com/mjijackson/citrus.git
>> =A0 =A0$ cd citrus
>> =A0 =A0$ rake package && sudo rake install
>>
>>
>> =A0** License **
>>
>>
>> Copyright 2010 Michael Jackson
>>
>> Permission is hereby granted, free of charge, to any person obtaining a
>> copy
>> of this software and associated documentation files (the "Software"), to
>> deal
>> in the Software without restriction, including without limitation the
>> rights
>> to use, copy, modify, merge, publish, distribute, sublicense, and/or sel=
l
>> copies of the Software, and to permit persons to whom the Software is
>> furnished to do so, subject to the following conditions:
>>
>> The above copyright notice and this permission notice shall be included =
in
>> all copies or substantial portions of the Software.
>>
>> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS =
OR
>> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
>> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL =
THE
>> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
>> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
>> FROM,
>> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS I=
N
>> THE SOFTWARE.
>>
>> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>>
>> --
>> Michael Jackson
>> http://mjijackson.com
>> @mjijackson
>>
>>
>