koi-reference-parser 0.0.1 → 0.0.2

data/.gitignore

@@ -1,3 +1,3 @@
-*.gem
-*.gemspec
-*.swp
+*.gem
+*.gemspec
+*.swp

data/MIT-LICENSE

@@ -1,20 +1,20 @@
-Copyright (c) 2010 Aaron Gough (http://thingsaaronmade.com/)
-
-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
+Copyright (c) 2010 Aaron Gough (http://thingsaaronmade.com/)
+
+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.

data/README.rdoc

@@ -1,44 +1,44 @@
-= koi-reference-parser
-
-This is the reference parser implementation for the programming language {Koi}[http://github.com/aarongough/koi]. The parser is implemented using a {Parsing Expression Grammar (PEG)}[http://en.wikipedia.org/wiki/Parsing_expression_grammar] that is run by a PEG engine called {Treetop}[http://treetop.rubyforge.org/].
-
-=== Example
-
-The parser takes a text string containing a program like:
-
-  test = 1 + 2
-  
-And turns it into an {Abstract Syntax Tree (AST)}[http://en.wikipedia.org/wiki/Abstract_syntax_tree] that unambiguously represents the program's structure and meaning. The AST is represented as a series of Ruby objects that subclass a generic SyntaxNode class. The code above transformed into AST would look like:
-
-  <Block "test = 1 + 2">
-    <Statement "test = 1 + 2">
-      <Assignment "test = 1 + 2">
-        <Identifier "test">
-        <AssignmentOperator "=">
-        <Expression "1 + 2">
-          <AdditiveExpression "1 + 2">
-            <IntegerLiteral "1">
-            <AdditionOperator "+">
-            <IntegerLiteral "2">
-            
-
-=== Installation
-
-This parser is normally installed as part of Koi's default toolchain. However if you would like to install it on it's own you can do so by installing the gem like so:
-
-  gem install koi-reference-parser
-
-=== Usage
-
-  require 'rubygems'
-  require 'koi-reference-parser'
-  
-  include KoiReferenceParser
-  
-  ast = Parser.parse( program_text )
-
-=== Author & Credits
-
-Author:: {Aaron Gough}[mailto:aaron@aarongough.com]
-
+= koi-reference-parser
+
+This is the reference parser implementation for the programming language {Koi}[http://github.com/aarongough/koi]. The parser is implemented using a {Parsing Expression Grammar (PEG)}[http://en.wikipedia.org/wiki/Parsing_expression_grammar] that is run by a PEG engine called {Treetop}[http://treetop.rubyforge.org/].
+
+=== Example
+
+The parser takes a text string containing a program like:
+
+  test = 1 + 2
+  
+And turns it into an {Abstract Syntax Tree (AST)}[http://en.wikipedia.org/wiki/Abstract_syntax_tree] that unambiguously represents the program's structure and meaning. The AST is represented as a series of Ruby objects that subclass a generic SyntaxNode class. The code above transformed into AST would look like:
+
+  <Block "test = 1 + 2">
+    <Statement "test = 1 + 2">
+      <Assignment "test = 1 + 2">
+        <Identifier "test">
+        <AssignmentOperator "=">
+        <Expression "1 + 2">
+          <AdditiveExpression "1 + 2">
+            <IntegerLiteral "1">
+            <AdditionOperator "+">
+            <IntegerLiteral "2">
+            
+
+=== Installation
+
+This parser is normally installed as part of Koi's default toolchain. However if you would like to install it on it's own you can do so by installing the gem like so:
+
+  gem install koi-reference-parser
+
+=== Usage
+
+  require 'rubygems'
+  require 'koi-reference-parser'
+  
+  include KoiReferenceParser
+  
+  ast = Parser.parse( program_text )
+
+=== Author & Credits
+
+Author:: {Aaron Gough}[mailto:aaron@aarongough.com]
+
 Copyright (c) 2010 {Aaron Gough}[http://thingsaaronmade.com/] ({thingsaaronmade.com}[http://thingsaaronmade.com/]), released under the MIT license

data/Rakefile

@@ -1,43 +1,43 @@
-require 'rake'
-require 'rake/testtask'
-require 'rake/rdoctask'
-
-desc 'Default: run unit tests.'
-task :default => :test
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gemspec|
-    gemspec.name = "koi-reference-parser"
-    gemspec.summary = "A reference parser for the Koi language."
-    gemspec.description = "A reference parser for the Koi language."
-    gemspec.email = "aaron@aarongough.com"
-    gemspec.homepage = "http://github.com/aarongough/koi-reference-parser"
-    gemspec.authors = ["Aaron Gough"]
-    gemspec.rdoc_options << '--line-numbers' << '--inline-source'
-    gemspec.extra_rdoc_files = ['README.rdoc', 'MIT-LICENSE']
-    gemspec.add_dependency('treetop')
-  end
-rescue LoadError
-  puts "Jeweler not available. Install it with: gem install jeweler"
-end
-
-
-desc 'Test koi-reference-parser.'
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib/*.rb'
-  t.libs << 'test'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = true
-end
-
-
-desc 'Generate documentation for koi-reference-parser.'
-Rake::RDocTask.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'koi-reference-parser'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-  rdoc.rdoc_files.include('app/**/*.rb')
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "koi-reference-parser"
+    gemspec.summary = "A reference parser for the Koi language."
+    gemspec.description = "A reference parser for the Koi language."
+    gemspec.email = "aaron@aarongough.com"
+    gemspec.homepage = "http://github.com/aarongough/koi-reference-parser"
+    gemspec.authors = ["Aaron Gough"]
+    gemspec.rdoc_options << '--line-numbers' << '--inline-source'
+    gemspec.extra_rdoc_files = ['README.rdoc', 'MIT-LICENSE']
+    gemspec.add_dependency('treetop')
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+
+desc 'Test koi-reference-parser.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib/*.rb'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+
+desc 'Generate documentation for koi-reference-parser.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'koi-reference-parser'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include('app/**/*.rb')
 end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/lib/koi-reference-parser.rb

@@ -1,8 +1,8 @@
-require 'rubygems'
-
-require_files = []
-require_files.concat Dir[File.join(File.dirname(__FILE__), 'parser', '**', '*.rb')]
-
-require_files.each do |file|
-  require File.expand_path(file)
-end
+require 'rubygems'
+
+require_files = []
+require_files.concat Dir[File.join(File.dirname(__FILE__), 'parser', '**', '*.rb')]
+
+require_files.each do |file|
+  require File.expand_path(file)
+end

data/lib/parser/exceptions.rb

@@ -1,2 +1,2 @@
-class ParseError < Exception
+class ParseError < Exception
 end

data/lib/parser/koi-reference-parser.treetop

@@ -1,197 +1,197 @@
-grammar KoiReferenceParser
-
-  rule block
-    statement+ <Block>
-  end
-
-  rule statement
-    space? ( hash_assignment / assignment / if / unless / function_call ) ';'? space? <Statement>
-  end
-  
-  rule nil
-    "nil" <NilLiteral>
-  end
-  
-  rule true
-    "true" <TrueLiteral>
-  end
-  
-  rule false
-    "false" <FalseLiteral>
-  end
-
-  rule integer
-    ('+' / '-')? [0-9]+ <IntegerLiteral>
-  end
-  
-  rule float
-    ('+' / '-')? [0-9]+ '.' [0-9]+ <FloatLiteral>
-  end
-  
-  rule string
-    '"' ([^"\\] / "\\" . )* '"' <StringLiteral>
-  end
-  
-  rule identifier
-    '$'? [a-zA-Z] [a-zA-Z0-9_]* <Identifier>
-  end
-  
-  rule hash_assignment
-    identifier hash_accessor_list space? assignment_operator space? ( hash / function_definition / expression ) <HashAssignment>
-  end
-  
-  rule assignment
-    identifier space? assignment_operator space? ( hash / function_definition / expression ) <Assignment>
-  end
-  
-  ##################
-  # Flow control
-  
-  rule if
-    'if(' space? expression space? ')' space
-      block
-    space? 'end' space? <If>
-  end
-  
-  rule unless
-    'unless(' space? expression space? ')' space
-      block
-    space? 'end' space? <Unless>
-  end
-  
-  ##################
-  # Functions
-  
-  rule function_call
-    identifier space? '(' space? expression? space? ','? expression? space? ')' <FunctionCall>
-  end
-  
-  rule function_definition
-    'function(' space? identifier space? ')' 
-      block
-    space? 'end' <FunctionDefinition>
-  end
-  
-  ##################
-  # Whitespace
-  
-  rule space
-    [\s]+ <Whitespace>
-  end
-  
-  ##################
-  # Hashes
-  
-  rule hash_accessor_list
-    hash_accessor+ <HashAccessorList>
-  end
-  
-  rule hash_accessor
-    '[' expression ']' <HashAccessor>
-  end
-  
-  rule hash
-    '{' key_value_list? '}' <HashLiteral>
-  end
-  
-  rule key_value_list
-    key_value+ <KeyValueList>
-  end
-  
-  rule key_value
-    space? expression space? '=>' space? expression space? ','? <KeyValue>
-  end
-  
-  rule key
-    space? expression space? <Key>
-  end
-  
-  rule value
-    space? expression space? <Value>
-  end
-
-  ##################
-  # Expressions
-  
-  rule expression
-    space? (hash_access / comparative / additive) <Expression>
-  end
-  
-  rule hash_access
-    identifier hash_accessor_list <HashAccess>
-  end
-  
-  rule comparative
-    additive space? (equality_operator / inequality_operator / greater_than_operator / less_than_operator) space? additive <ComparativeExpression>
-  end
-  
-  rule additive
-    multitive space? additive_operator space? additive <AdditiveExpression>
-    /
-    multitive 
-  end
-  
-  rule additive_operator
-    addition_operator 
-    /
-    subtraction_operator 
-  end
-
-  rule multitive
-    primary space? multitive_operator space? multitive <MultitiveExpression>
-    /
-    primary 
-  end
-  
-  rule multitive_operator
-    multiplication_operator 
-    /
-    division_operator  
-  end  
-  
-  rule primary
-    function_call / nil / false / true / identifier / float / integer / string 
-    /
-    '(' space? expression space? ')' <Expression>
-  end
-
-  ##################
-  # Operators
-
-  rule assignment_operator
-    '=' <AssignmentOperator>
-  end
-  
-  rule addition_operator
-    '+' <AdditionOperator>
-  end
-  
-  rule subtraction_operator
-    '-' <SubtractionOperator>
-  end
-  
-  rule multiplication_operator
-    '*' <MultiplicationOperator>
-  end
-  
-  rule division_operator
-    '/' <DivisionOperator>
-  end
-  
-  rule equality_operator
-    '==' <EqualityOperator>
-  end
-  
-  rule inequality_operator
-    '!=' <InequalityOperator>
-  end
-  
-  rule greater_than_operator
-    '>' <GreaterThanOperator>
-  end
-  
-  rule less_than_operator
-    '<' <LessThanOperator>
-  end
-
-end
+grammar KoiReferenceParser
+
+  rule block
+    statement+ <Block>
+  end
+
+  rule statement
+    space? ( hash_assignment / assignment / if / unless / function_call ) ';'? space? <Statement>
+  end
+  
+  rule nil
+    "nil" <NilLiteral>
+  end
+  
+  rule true
+    "true" <TrueLiteral>
+  end
+  
+  rule false
+    "false" <FalseLiteral>
+  end
+
+  rule integer
+    ('+' / '-')? [0-9]+ <IntegerLiteral>
+  end
+  
+  rule float
+    ('+' / '-')? [0-9]+ '.' [0-9]+ <FloatLiteral>
+  end
+  
+  rule string
+    '"' ([^"\\] / "\\" . )* '"' <StringLiteral>
+  end
+  
+  rule identifier
+    '$'? [a-zA-Z] [a-zA-Z0-9_]* <Identifier>
+  end
+  
+  rule hash_assignment
+    identifier hash_accessor_list space? assignment_operator space? ( hash / function_definition / expression ) <HashAssignment>
+  end
+  
+  rule assignment
+    identifier space? assignment_operator space? ( hash / function_definition / expression ) <Assignment>
+  end
+  
+  ##################
+  # Flow control
+  
+  rule if
+    'if(' space? expression space? ')' space
+      block
+    space? 'end' space? <If>
+  end
+  
+  rule unless
+    'unless(' space? expression space? ')' space
+      block
+    space? 'end' space? <Unless>
+  end
+  
+  ##################
+  # Functions
+  
+  rule function_call
+    identifier space? '(' space? expression? space? ','? expression? space? ')' <FunctionCall>
+  end
+  
+  rule function_definition
+    'function(' space? identifier space? ')' 
+      block
+    space? 'end' <FunctionDefinition>
+  end
+  
+  ##################
+  # Whitespace
+  
+  rule space
+    [\s]+ <Whitespace>
+  end
+  
+  ##################
+  # Hashes
+  
+  rule hash_accessor_list
+    hash_accessor+ <HashAccessorList>
+  end
+  
+  rule hash_accessor
+    '[' expression ']' <HashAccessor>
+  end
+  
+  rule hash
+    '{' key_value_list? '}' <HashLiteral>
+  end
+  
+  rule key_value_list
+    key_value+ <KeyValueList>
+  end
+  
+  rule key_value
+    space? expression space? '=>' space? expression space? ','? <KeyValue>
+  end
+  
+  rule key
+    space? expression space? <Key>
+  end
+  
+  rule value
+    space? expression space? <Value>
+  end
+
+  ##################
+  # Expressions
+  
+  rule expression
+    space? (hash_access / comparative / additive) <Expression>
+  end
+  
+  rule hash_access
+    identifier hash_accessor_list <HashAccess>
+  end
+  
+  rule comparative
+    additive space? (equality_operator / inequality_operator / greater_than_operator / less_than_operator) space? additive <ComparativeExpression>
+  end
+  
+  rule additive
+    multitive space? additive_operator space? additive <AdditiveExpression>
+    /
+    multitive 
+  end
+  
+  rule additive_operator
+    addition_operator 
+    /
+    subtraction_operator 
+  end
+
+  rule multitive
+    primary space? multitive_operator space? multitive <MultitiveExpression>
+    /
+    primary 
+  end
+  
+  rule multitive_operator
+    multiplication_operator 
+    /
+    division_operator  
+  end  
+  
+  rule primary
+    function_call / nil / false / true / identifier / float / integer / string 
+    /
+    '(' space? expression space? ')' <Expression>
+  end
+
+  ##################
+  # Operators
+
+  rule assignment_operator
+    '=' <AssignmentOperator>
+  end
+  
+  rule addition_operator
+    '+' <AdditionOperator>
+  end
+  
+  rule subtraction_operator
+    '-' <SubtractionOperator>
+  end
+  
+  rule multiplication_operator
+    '*' <MultiplicationOperator>
+  end
+  
+  rule division_operator
+    '/' <DivisionOperator>
+  end
+  
+  rule equality_operator
+    '==' <EqualityOperator>
+  end
+  
+  rule inequality_operator
+    '!=' <InequalityOperator>
+  end
+  
+  rule greater_than_operator
+    '>' <GreaterThanOperator>
+  end
+  
+  rule less_than_operator
+    '<' <LessThanOperator>
+  end
+
+end