pegjs

History

David Majda 435bb8f2df Error handling: Structured expectations Before this commit, the \|expected\| property of an exception object thrown when a generated parser encountered an error contained expectations as strings. These strings were in a human-readable format suitable for displaying in the UI but not suitable for machine processing. For example, expected string literals included quotes and a string "any character" was used when any character was expected. This commit makes expectations structured objects. This makes the machine processing easier, while still allowing to generate a human-readable representation if needed. Implements part of #198. Speed impact ------------ Before: 1180.41 kB/s After: 1165.31 kB/s Difference: -1.28% Size impact ----------- Before: 863523 b After: 950817 b Difference: 10.10% (Measured by /tools/impact with Node.js v0.6.18 on x86_64 GNU/Linux.)		2013-12-01 16:08:29 +01:00
..
compiler/passes	Error handling: Structured expectations	2013-12-01 16:08:29 +01:00
vendor/jasmine	Upgrade jasmine and jasmine-node	2013-08-22 09:07:19 +02:00
generated-parser.spec.js	Error handling: Structured expectations	2013-12-01 16:08:29 +01:00
helpers.js	Fix too eager proxy rules removal	2013-01-06 10:17:10 +01:00
index.html	Code generator rewrite	2013-01-01 16:38:09 +01:00
parser.spec.js	Remove the \|startRule\| property from the AST	2013-01-06 10:21:48 +01:00
README	Git repo npmization: Make the repo a npm package	2012-11-10 14:21:14 +01:00

README

PEG.js Spec Suite
=================

This is the PEG.js spec suite. It ensures PEG.js works correctly. All specs
should always pass on all supported platforms.

Running in a browser
--------------------

  1. Make sure you have Node.js and all the development dependencies specified
     in package.json installed.

  2. Run the following command in the PEG.js root directory (one level up from
     this one):

       make browser

  3. Start a web server and make it serve the PEG.js root directory.

  4. Point your browser to an URL corresponding to the index.html file.

  5. Watch the specs pass (or fail).

If you have Python installed, you can fulfill steps 3 and 4 by running the
following command in the PEG.js root directory

  python -m SimpleHTTPServer

and loading http://localhost:8000/spec/index.html in your browser.

Running from a command-line
---------------------------

  1. Make sure you have Node.js and all the development dependencies specified
     in package.json installed.

  2. Run the following command in the PEG.js root directory (one level up from
     this one):

       make spec

  3. Watch the specs pass (or fail).