Miscellanea
This commit is contained in:
parent
bd77a5742d
commit
18326425fd
|
@ -0,0 +1,14 @@
|
||||||
|
{exec} = require 'child_process'
|
||||||
|
|
||||||
|
task 'lib', 'compile to javascript', ->
|
||||||
|
exec ['mkdir -p lib',
|
||||||
|
'coffee -o lib -c src/reparse.coffee'].join(' && '), (err) ->
|
||||||
|
throw err if err
|
||||||
|
|
||||||
|
task 'doc', 'build the ReParse documentation', ->
|
||||||
|
exec 'node_modules/.bin/docco src/reparse.coffee', (err) ->
|
||||||
|
throw err if err
|
||||||
|
|
||||||
|
task 'clean', 'Delete the compiled code and generated documentation', ->
|
||||||
|
exec 'rm -fr lib docs', (err) ->
|
||||||
|
throw err if err
|
|
@ -0,0 +1,19 @@
|
||||||
|
Copyright (c) 2012 Elf M. Sternberg
|
||||||
|
|
||||||
|
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 sell
|
||||||
|
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 IN
|
||||||
|
THE SOFTWARE.
|
|
@ -0,0 +1,69 @@
|
||||||
|
# ReParse - Coffeescript Edition
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
|
||||||
|
This is a hand-written re-implementation of Ben Weaver's ReParse
|
||||||
|
(https://github.com/weaver/ReParse). It is a (mostly) faithful
|
||||||
|
reimplementation, although a few things were re-arranged to be more in
|
||||||
|
line with Haskell's parsec library, with a side-line look at JSParsec.
|
||||||
|
This version uses the Coffeescript class management toolkit, so it
|
||||||
|
*looks* much more like a classic duck-typed OO implementation, the
|
||||||
|
kind of thing you're familiar with from Ruby or Python. Take a peek
|
||||||
|
at the examples and you'll see what I mean-- I think they're 20%
|
||||||
|
cooler that Ben's, just 'cuz of how they look.
|
||||||
|
|
||||||
|
I made the parser re-usable with a new input; it's slightly faster
|
||||||
|
than the javascript implementation.
|
||||||
|
|
||||||
|
I wrote this because I needed a parser for a coffeescript project, and
|
||||||
|
while I liked Ben's code, I needed to disassemble it, figure out what
|
||||||
|
it did, and re-write it in my own language and with my own brain.
|
||||||
|
It's been nearly 14 years since I last had to write a parser; I
|
||||||
|
usually work at a much higher level, but my current project required
|
||||||
|
one, and this was the exercise I chose.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
Coffeescript to build/run.
|
||||||
|
|
||||||
|
Docco to produce documentation.
|
||||||
|
|
||||||
|
Both of these are specified in the package.json file.
|
||||||
|
|
||||||
|
## Acknowledgements
|
||||||
|
|
||||||
|
Ben Weaver (of course)
|
||||||
|
|
||||||
|
Balazs Endresz (for JSParsec, which at least explained some functions
|
||||||
|
of Parsec to me better than the Parsec source code)
|
||||||
|
|
||||||
|
John MacFarlane (for Pandoc, which led me down this rabbit hole in the
|
||||||
|
first place)
|
||||||
|
|
||||||
|
## LICENSE AND COPYRIGHT NOTICE: NO WARRANTY GRANTED OR IMPLIED
|
||||||
|
|
||||||
|
Copyright (c) 2012 Elf M. Sternberg
|
||||||
|
|
||||||
|
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 sell
|
||||||
|
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 IN
|
||||||
|
THE SOFTWARE.
|
||||||
|
|
||||||
|
- Elf M. Sternberg <elf@pendorwright.com>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -226,7 +226,7 @@ exports.ReParse = class ReParse
|
||||||
|
|
||||||
endBy: (method, end, min = 0) =>
|
endBy: (method, end, min = 0) =>
|
||||||
val = @many method, min
|
val = @many method, min
|
||||||
@option end
|
@produce end
|
||||||
val
|
val
|
||||||
|
|
||||||
# Parses 1 or more productions of method, which must be terminated
|
# Parses 1 or more productions of method, which must be terminated
|
||||||
|
|
Loading…
Reference in New Issue