parsanol 3.0.0

data/example/modularity/basic.rb.md

@@ -0,0 +1,152 @@
+# Grammar Modularity - Ruby Implementation
+
+## How to Run
+
+```bash
+cd parsanol-ruby/example/modularity
+ruby basic.rb
+```
+
+## Code Walkthrough
+
+### Module Mixins
+
+Ruby modules can be mixed into parser classes:
+
+```ruby
+module ALanguage
+  include Parsanol::Parslet
+
+  rule(:a_language) { str('aaa') }
+end
+```
+
+`include Parsanol::Parslet` makes the module a grammar container.
+
+### Parser as Atom
+
+Parser instances are valid atoms:
+
+```ruby
+class BLanguage < Parsanol::Parser
+  root :blang
+
+  rule(:blang) { str('bbb') }
+end
+```
+
+Use `BLanguage.new` directly in other parsers' rules.
+
+### Passing Atoms
+
+Atoms are Ruby values that can be passed around:
+
+```ruby
+c_language = Parsanol.str('ccc')
+
+class Language < Parsanol::Parser
+  def initialize(c_language)
+    @c_language = c_language
+    super()
+  end
+
+  rule(:root) { str('c(') >> @c_language >> str(')') }
+end
+```
+
+Constructor injection enables dynamic grammar composition.
+
+### Combined Root Rule
+
+The root combines all module entry points:
+
+```ruby
+rule(:root) {
+  str('a(') >> a_language >> str(')') >> space |
+  str('b(') >> BLanguage.new >> str(')') >> space |
+  str('c(') >> @c_language >> str(')') >> space
+}
+```
+
+Each alternative invokes a different module.
+
+### Using the Composed Parser
+
+```ruby
+Language.new(c_language).parse('a(aaa)')  # => matches
+Language.new(c_language).parse('b(bbb)')  # => matches
+Language.new(c_language).parse('c(ccc)')  # => matches
+```
+
+Single parser instance handles all module syntaxes.
+
+## Design Patterns
+
+### Include Pattern
+
+```ruby
+module CommonExpressions
+  include Parsanol::Parslet
+
+  rule(:integer) { match('[0-9]').repeat(1) }
+  rule(:identifier) { match('[a-z]').repeat(1) }
+end
+
+class MyParser < Parsanol::Parser
+  include CommonExpressions
+  include WhitespaceRules
+
+  rule(:expr) { integer | identifier }
+end
+```
+
+Multiple modules combine via include.
+
+### Delegation Pattern
+
+```ruby
+class JsonParser < Parsanol::Parser
+  rule(:value) { StringParser.new | NumberParser.new | ObjectParser.new }
+end
+```
+
+Each sub-parser handles one JSON type.
+
+### Prefix Pattern
+
+```ruby
+module ExpressionParser
+  def expr_with_prefix(prefix)
+    prefix >> expr
+  end
+end
+```
+
+Modules can provide parameterized rules.
+
+## Output
+
+```ruby
+# All three module syntaxes parse
+Language.new(c_language).parse('a(aaa)')
+Language.new(c_language).parse('b(bbb)')
+Language.new(c_language).parse('c(ccc)')
+```
+
+## Design Decisions
+
+### Why Include for Modules?
+
+Ruby's include provides clean namespace integration. Rules become methods on the parser class.
+
+### Why Parser as Atom?
+
+Parsers being atoms enables composition without special syntax. Just instantiate and chain.
+
+### Why Constructor Injection?
+
+Dynamic composition allows runtime grammar modification. Same parser class with different sub-grammars.
+
+### Why Not Class Inheritance?
+
+Composition (include/instance) is more flexible than inheritance. Multiple modules can be combined in any order.

data/example/nested-errors/basic.rb

@@ -0,0 +1,132 @@
+$:.unshift File.dirname(__FILE__) + "/../lib"
+
+require 'parsanol/parslet'
+require 'parsanol/convenience'
+
+# This example demonstrates tree error reporting in a real life example.
+# Originally contributed to Parslet, ported to Parsanol as an example.
+
+def prettify(str)
+  puts " "*3 + " "*4 + "." + " "*4 + "10" + " "*3 + "." + " "*4 + "20"
+  str.lines.each_with_index do |line, index|
+    printf "%02d %s\n", 
+      index+1, 
+      line.chomp
+  end
+end
+
+class Parser < Parsanol::Parser
+
+  # commons
+
+  rule(:space) { match('[ \t]').repeat(1) }
+  rule(:space?) { space.maybe }
+
+  rule(:newline) { match('[\r\n]') }
+
+  rule(:comment) { str('#') >> match('[^\r\n]').repeat }
+
+  rule(:line_separator) {
+    (space? >> ((comment.maybe >> newline) | str(';')) >> space?).repeat(1)
+  }
+
+  rule(:blank) { line_separator | space }
+  rule(:blank?) { blank.maybe }
+
+  rule(:identifier) { match('[a-zA-Z0-9_]').repeat(1) }
+
+  # res_statement
+
+  rule(:reference) {
+    (str('@').repeat(1,2) >> identifier).as(:reference)
+  }
+
+  rule(:res_action_or_link) {
+    str('.').as(:dot) >> (identifier >> str('?').maybe ).as(:name) >> str('()')
+  }
+
+  rule(:res_actions) {
+    (
+      reference
+    ).as(:resources) >>
+    (
+      res_action_or_link.as(:res_action)
+    ).repeat(0).as(:res_actions)
+  }
+
+  rule(:res_statement) {
+    res_actions >>
+    (str(':') >> identifier.as(:name)).maybe.as(:res_field)
+  }
+
+  # expression
+
+  rule(:expression) {
+    res_statement
+  }
+
+  # body
+
+  rule(:body) {
+    (line_separator >> (block | expression)).repeat(1).as(:body) >>
+    line_separator
+  }
+
+  # blocks
+
+  rule(:begin_block) {
+    (str('concurrent').as(:type) >> space).maybe.as(:pre) >>
+    str('begin').as(:begin) >>
+    body >>
+    str('end')
+  }
+
+  rule(:define_block) {
+    str('define').as(:define) >> space >>
+    identifier.as(:name) >> str('()') >>
+    body >>
+    str('end')
+  }
+
+  rule(:block) {
+    define_block | begin_block
+  }
+
+  # root
+
+  rule(:radix) {
+    line_separator.maybe >> block >> line_separator.maybe
+  }
+
+  root(:radix)
+end
+
+
+ds = [
+  %{
+    define f()
+      @res.name
+    end
+  },
+  %{
+    define f()
+      begin
+        @res.name
+      end
+    end
+  }
+]
+
+ds.each do |d|
+
+  puts '-' * 80
+  prettify(d)
+
+  parser = Parser.new
+
+  begin
+    parser.parse_with_debug(d)
+  end
+end
+
+puts '-' * 80

data/example/nested-errors/basic.rb.md

@@ -0,0 +1,157 @@
+# Nested Error Reporting - Ruby Implementation
+
+## How to Run
+
+```bash
+cd parsanol-ruby/example/nested-errors
+ruby basic.rb
+```
+
+## Code Walkthrough
+
+### parse_with_debug Output
+
+The debug method shows full error information:
+
+```ruby
+parser.parse_with_debug(input)
+```
+
+This automatically formats and displays the error tree.
+
+### Error Tree Structure
+
+Parslet errors form a tree:
+
+```
+- Failed to parse sequence
+  - Expected "end" at line 3
+  - In block body
+    - Expected expression
+    - Expected "begin"
+```
+
+Each indentation represents a nested failure context.
+
+### Helper Formatting
+
+The example provides line-numbered output:
+
+```ruby
+def prettify(str)
+  puts " "*3 + " "*4 + "." + " "*4 + "10" + " "*3 + "." + " "*4 + "20"
+  str.lines.each_with_index do |line, index|
+    printf "%02d %s\n", index+1, line.chomp
+  end
+end
+```
+
+Column ruler helps locate errors visually.
+
+### Complex Grammar for Testing
+
+The example uses a realistic grammar:
+
+```ruby
+rule(:reference) {
+  (str('@').repeat(1,2) >> identifier).as(:reference)
+}
+
+rule(:res_action_or_link) {
+  str('.').as(:dot) >>
+  (identifier >> str('?').maybe).as(:name) >>
+  str('()')
+}
+```
+
+Multiple rules create multiple failure points.
+
+### Block Structure
+
+Nested blocks create deep error trees:
+
+```ruby
+rule(:begin_block) {
+  (str('concurrent').as(:type) >> space).maybe.as(:pre) >>
+  str('begin').as(:begin) >>
+  body >>
+  str('end')
+}
+
+rule(:define_block) {
+  str('define').as(:define) >> space >>
+  identifier.as(:name) >> str('()') >>
+  body >>
+  str('end')
+}
+```
+
+Each block type has its own error context.
+
+### Test Cases
+
+```ruby
+ds = [
+  %{
+    define f()
+      @res.name
+    end
+  },
+  %{
+    define f()
+      begin
+        @res.name
+      end
+    end
+  }
+]
+
+ds.each do |d|
+  puts '-' * 80
+  prettify(d)
+  parser.parse_with_debug(d)
+end
+```
+
+Each case demonstrates different error scenarios.
+
+## Output Types
+
+Successful parse:
+```
+01
+02 define f()
+03   @res.name
+04 end
+
+{:define=>"define"@..., :name=>"f"@..., :body=>[...]}
+```
+
+Failed parse with tree:
+```
+01
+02 define f()
+03   @res.name(
+04 end
+
+Failed to match sequence
+`- Expected ")" at line 3, column 12
+```
+
+## Design Decisions
+
+### Why parse_with_debug?
+
+It handles error formatting automatically. For production use, catch `Parsanol::ParseFailed` and format custom messages.
+
+### Why Multiple Test Cases?
+
+Different constructs fail differently. Multiple cases show the full error reporting capability.
+
+### Why Prettify Helper?
+
+Line numbers help users find errors in their input. The column ruler aids visual scanning.
+
+### Why Block-Structured Grammar?
+
+Simple grammars have shallow error trees. Block-structured grammars demonstrate nested error contexts.

data/example/output/boolean_algebra.out

@@ -0,0 +1,4 @@
+{:and=>
+  {:left=>{:var=>"1"@3},
+   :right=>{:or=>{:left=>{:var=>"2"@13}, :right=>{:var=>"3"@21}}}}}
+[["1", "2"], ["1", "3"]]

data/example/output/calc.out

@@ -0,0 +1 @@
+123*2 (command line): -> 246

data/example/output/capture.out

@@ -0,0 +1,3 @@
+[{:line=>"Text1\n"@9},
+ {:doc=>[{:line=>"Text3\n"@23}, {:line=>"Text4\n"@29}]},
+ {:line=>"\nText2\n"@41}]

data/example/output/comments.out

@@ -0,0 +1,8 @@
+[{:exp=>{:a=>"a"@3}},
+ {:line=>"// line comment"@7},
+ {:exp=>{:a=>"a"@25}},
+ {:exp=>{:a=>"a"@27}},
+ {:exp=>[{:a=>"a"@29}, {:line=>"// line comment"@31}]},
+ {:exp=>[{:a=>"a"@49}, {:multi=>"/* inline comment */"@51}]},
+ {:exp=>{:a=>"a"@72}},
+ {:multi=>"/* multiline\n  comment */"@77}]

data/example/output/deepest_errors.out

@@ -0,0 +1,54 @@
+--------------------------------------------------------------------------------
+       .    10   .    20
+01 
+02     define f()
+03       @res.name
+04     end
+05   
+Failed to match sequence (LINE_SEPARATOR? BLOCK LINE_SEPARATOR?) at line 2 char 5.
+`- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 2 char 5.
+   |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 2 char 15.
+   |  `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 3 char 11.
+   |     `- Expected at least 1 of SPACE? (COMMENT? NEWLINE / ';') SPACE? at line 3 char 11.
+   |        `- Failed to match sequence (SPACE? (COMMENT? NEWLINE / ';') SPACE?) at line 3 char 11.
+   |           `- Expected one of [COMMENT? NEWLINE, ';'] at line 3 char 11.
+   |              |- Failed to match sequence (COMMENT? NEWLINE) at line 3 char 11.
+   |              |  `- Expected "()", but got "\n " at line 3 char 16.
+   |              `- Expected "()", but got "\n " at line 3 char 16.
+   `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 2 char 5.
+      `- Expected "()", but got "\n " at line 3 char 16.
+--------------------------------------------------------------------------------
+       .    10   .    20
+01 
+02     define f()
+03       begin
+04         @res.name
+05       end
+06     end
+07   
+Failed to match sequence (LINE_SEPARATOR? BLOCK LINE_SEPARATOR?) at line 2 char 5.
+`- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 2 char 5.
+   |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 2 char 15.
+   |  `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 2 char 15.
+   |     `- Expected at least 1 of LINE_SEPARATOR (BLOCK / EXPRESSION) at line 2 char 15.
+   |        `- Failed to match sequence (LINE_SEPARATOR (BLOCK / EXPRESSION)) at line 3 char 7.
+   |           `- Expected one of [BLOCK, EXPRESSION] at line 3 char 7.
+   |              |- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 3 char 7.
+   |              |  |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 3 char 7.
+   |              |  |  `- Expected "define", but got "begin\n" at line 3 char 7.
+   |              |  `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 3 char 12.
+   |              |     `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 4 char 13.
+   |              |        `- Expected at least 1 of SPACE? (COMMENT? NEWLINE / ';') SPACE? at line 4 char 13.
+   |              |           `- Failed to match sequence (SPACE? (COMMENT? NEWLINE / ';') SPACE?) at line 4 char 13.
+   |              |              `- Expected one of [COMMENT? NEWLINE, ';'] at line 4 char 13.
+   |              |                 |- Failed to match sequence (COMMENT? NEWLINE) at line 4 char 13.
+   |              |                 |  `- Expected "()", but got "\n " at line 4 char 18.
+   |              |                 `- Expected "()", but got "\n " at line 4 char 18.
+   |              `- Failed to match sequence (RES_ACTIONS res_field:((':' name:IDENTIFIER)?)) at line 3 char 7.
+   |                 `- Failed to match sequence (resources:REFERENCE res_actions:(res_action:RES_ACTION_OR_LINK{0, })) at line 3 char 7.
+   |                    `- Failed to match sequence ('@'{1, 2} IDENTIFIER) at line 3 char 7.
+   |                       `- Expected at least 1 of '@' at line 3 char 7.
+   |                          `- Expected "()", but got "\n " at line 4 char 18.
+   `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 2 char 5.
+      `- Expected "()", but got "\n " at line 4 char 18.
+--------------------------------------------------------------------------------

data/example/output/documentation.err

@@ -0,0 +1,4 @@
+/Users/kaspar/git_work/own/parslet/lib/parslet/atoms/base.rb:326:in `parse_failed': Don't know what to do with bbbb at line 1 char 1. (Parslet::ParseFailed)
+	from /Users/kaspar/git_work/own/parslet/lib/parslet/atoms/base.rb:55:in `parse'
+	from example/documentation.rb:13:in `parse'
+	from example/documentation.rb:18:in `<main>'

data/example/output/documentation.out

@@ -0,0 +1 @@
+"aaaa"@0

data/example/output/email_parser.out

@@ -0,0 +1,2 @@
+since you haven't specified any EMAIL_ADDR, for testing purposes we're using a.b.c.d@gmail.com
+"a.b.c.d@gmail.com"

data/example/output/empty.err

@@ -0,0 +1 @@
+example/empty.rb:13:in `<main>': rule(:empty) { ... }  returns nil. Still not implemented, but already used? (NotImplementedError)

data/example/output/erb.out

@@ -0,0 +1,7 @@
+{:text=>[{:text=>"The value of x is "@0}, {:expression=>{:ruby=>" x "@21}}, {:text=>"."@26}]}
+{:text=>[{:code=>{:ruby=>" 1 + 2 "@2}}]}
+{:text=>[{:comment=>{:ruby=>" commented "@3}}]}
+The not printed result of "a = 2".
+The not printed non-evaluated comment "a = 1", see the value of a below.
+The nicely printed result.
+The value of a is 2, and b is 3.

data/example/output/ignore.out

@@ -0,0 +1 @@
+"ac"@0

data/example/output/ignore_whitespace.out

@@ -0,0 +1 @@
+[{:a=>"a"@0}, {:a=>"a"@1}, {:a=>"a"@5}, {:a=>"a"@7}]

data/example/output/ip_address.out

@@ -0,0 +1,9 @@
+                       0.0.0.0 -> {:ipv4=>"0.0.0.0"@0}
+               255.255.255.255 -> {:ipv4=>"255.255.255.255"@0}
+                   255.255.255 -> Failed: Expected one of [IPV4, IPV6] at line 1 char 1.
+               1:2:3:4:5:6:7:8 -> {:ipv6=>"1:2:3:4:5:6:7:8"@0}
+         12AD:34FC:A453:1922:: -> {:ipv6=>"12AD:34FC:A453:1922::"@0}
+                    12AD::34FC -> {:ipv6=>"12AD::34FC"@0}
+                        12AD:: -> {:ipv6=>"12AD::"@0}
+                            :: -> {:ipv6=>"::"@0}
+                           1:2 -> Failed: Expected one of [IPV4, IPV6] at line 1 char 1.

data/example/output/json.out

@@ -0,0 +1,5 @@
+
+{:array=>[{:number=>"1"@5}, {:number=>"2"@8}, {:number=>"3"@11}, {:null=>"null"@14}, {:string=>"asdfasdf asdfds"@25}, {:object=>{:entry=>{:key=>{:string=>"a"@46}, :val=>{:number=>"-1.2"@50}}}}, {:object=>[{:entry=>{:key=>{:string=>"b"@61}, :val=>{:true=>"true"@65}}}, {:entry=>{:key=>{:string=>"c"@72}, :val=>{:false=>"false"@76}}}]}, {:number=>"0.1e24"@89}, {:true=>"true"@97}, {:false=>"false"@103}, {:array=>{:number=>"1"@112}}]}
+
+[1, 2, 3, nil, "asdfasdf asdfds", {"a"=>-1.2}, {"b"=>true, "c"=>false}, 1.0e+23, true, false, [1]]
+

data/example/output/local.out

@@ -0,0 +1,3 @@
+{:e=>"a"@0, :rec=>{:e=>"a"@1, :rec=>{:e=>"a"@2, :rec=>{:e=>"a"@3, :rec=>nil}}}}
+e2:'aa' !. / e1:'a' rec:B
+{:e1=>"a"@0, :rec=>{:e1=>"a"@1, :rec=>{:e2=>"aa"@2}}}

data/example/output/mathn.out

@@ -0,0 +1,4 @@
+it terminates before we require mathn
+requiring mathn now
+and trying again (will hang without the fix)
+okay!

data/example/output/minilisp.out

@@ -0,0 +1,5 @@
+[:define,
+ :test,
+ [:lambda,
+  [],
+  [:begin, [:display, "something"@54], [:display, 1], [:display, 3.08]]]]

data/example/output/nested_errors.out

@@ -0,0 +1,54 @@
+--------------------------------------------------------------------------------
+       .    10   .    20
+01 
+02     define f()
+03       @res.name
+04     end
+05   
+Failed to match sequence (LINE_SEPARATOR? BLOCK LINE_SEPARATOR?) at line 2 char 5.
+`- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 2 char 5.
+   |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 2 char 15.
+   |  `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 3 char 11.
+   |     `- Expected at least 1 of SPACE? (COMMENT? NEWLINE / ';') SPACE? at line 3 char 11.
+   |        `- Failed to match sequence (SPACE? (COMMENT? NEWLINE / ';') SPACE?) at line 3 char 11.
+   |           `- Expected one of [COMMENT? NEWLINE, ';'] at line 3 char 11.
+   |              |- Failed to match sequence (COMMENT? NEWLINE) at line 3 char 11.
+   |              |  `- Failed to match [\\r\\n] at line 3 char 11.
+   |              `- Expected ";", but got "." at line 3 char 11.
+   `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 2 char 5.
+      `- Expected "begin", but got "defin" at line 2 char 5.
+--------------------------------------------------------------------------------
+       .    10   .    20
+01 
+02     define f()
+03       begin
+04         @res.name
+05       end
+06     end
+07   
+Failed to match sequence (LINE_SEPARATOR? BLOCK LINE_SEPARATOR?) at line 2 char 5.
+`- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 2 char 5.
+   |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 2 char 15.
+   |  `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 2 char 15.
+   |     `- Expected at least 1 of LINE_SEPARATOR (BLOCK / EXPRESSION) at line 2 char 15.
+   |        `- Failed to match sequence (LINE_SEPARATOR (BLOCK / EXPRESSION)) at line 3 char 7.
+   |           `- Expected one of [BLOCK, EXPRESSION] at line 3 char 7.
+   |              |- Expected one of [DEFINE_BLOCK, BEGIN_BLOCK] at line 3 char 7.
+   |              |  |- Failed to match sequence (define:'define' SPACE name:IDENTIFIER '()' BODY 'end') at line 3 char 7.
+   |              |  |  `- Expected "define", but got "begin\n" at line 3 char 7.
+   |              |  `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 3 char 12.
+   |              |     `- Failed to match sequence (body:((LINE_SEPARATOR (BLOCK / EXPRESSION)){1, }) LINE_SEPARATOR) at line 4 char 13.
+   |              |        `- Expected at least 1 of SPACE? (COMMENT? NEWLINE / ';') SPACE? at line 4 char 13.
+   |              |           `- Failed to match sequence (SPACE? (COMMENT? NEWLINE / ';') SPACE?) at line 4 char 13.
+   |              |              `- Expected one of [COMMENT? NEWLINE, ';'] at line 4 char 13.
+   |              |                 |- Failed to match sequence (COMMENT? NEWLINE) at line 4 char 13.
+   |              |                 |  `- Failed to match [\\r\\n] at line 4 char 13.
+   |              |                 `- Expected ";", but got "." at line 4 char 13.
+   |              `- Failed to match sequence (RES_ACTIONS res_field:((':' name:IDENTIFIER)?)) at line 3 char 7.
+   |                 `- Failed to match sequence (resources:REFERENCE res_actions:(res_action:RES_ACTION_OR_LINK{0, })) at line 3 char 7.
+   |                    `- Failed to match sequence ('@'{1, 2} IDENTIFIER) at line 3 char 7.
+   |                       `- Expected at least 1 of '@' at line 3 char 7.
+   |                          `- Expected "@", but got "b" at line 3 char 7.
+   `- Failed to match sequence (pre:((type:'concurrent' SPACE)?) begin:'begin' BODY 'end') at line 2 char 5.
+      `- Expected "begin", but got "defin" at line 2 char 5.
+--------------------------------------------------------------------------------

data/example/output/optimized_erb.out

@@ -0,0 +1 @@
+{:text=>[{:text=>"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\n"@0}, {:expression=>{:ruby=>" erb tag "@2685}}, {:text=>"\n\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\nLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,\nquis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo\nconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse\ncillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non\nproident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n"@2696}]}

data/example/output/parens.out

@@ -0,0 +1,8 @@
+                  (): {:l=>"("@0, :m=>nil, :r=>")"@1} (1 parens)
+
+                (()): {:l=>"("@0, :m=>{:l=>"("@1, :m=>nil, :r=>")"@2}, :r=>")"@3} (2 parens)
+
+          ((((())))): {:l=>"("@0, :m=>{:l=>"("@1, :m=>{:l=>"("@2, :m=>{:l=>"("@3, :m=>{:l=>"("@4, :m=>nil, :r=>")"@5}, :r=>")"@6}, :r=>")"@7}, :r=>")"@8}, :r=>")"@9} (5 parens)
+
+               ((()): Failed to match sequence (l:'(' m:(BALANCED?) r:')') at line 1 char 6.
+

data/example/output/prec_calc.out

@@ -0,0 +1,5 @@
+a = 1
+b = 2
+c = 3 * 25
+d = 100 + 3*4
+{:a=>1, :b=>2, :c=>75, :d=>112}

data/example/output/readme.out

@@ -0,0 +1 @@
+String contents: This is a \"String\" in which you can escape stuff