antlr3 1.8.12 → 1.8.13

data/DEVELOPER-README.rdoc

@@ -0,0 +1,246 @@
+= Developing / Customizing The ANTLR for Ruby Project
+
+  by Kyle Yetter  <kcy5b@yahoo.com>
+  Originally Written on November 20, 2009
+  Updated on November 3, 2010
+
+== Just a Quick Note
+
+I'd love to keep this all intuitive and straight foward. However,
+this project differs from many typical ruby projects in that it
+dependens upon a number of entities outside the warm n' cozy ruby
+environment -- that is, java, the ANTLR tool, and ANTLR's
+StringTemplate-based code generation architecture. So there are
+a number of variables that add good helping of complexity to
+the project.
+
+So if you have any trouble getting everything to work properly,
+do yourself a favor and read through this guide. Feel free to
+drop any other specific questions to me via e-mail and
+I'll try to help you out as I can.
+
+== Getting Started
+
+1. pull the repository
+
+     git clone git://rubyforge.org/antlr3.git
+
+2. Modify your PATH environmental variable to add the following directories:
+  
+     $base/bin  $base/scripts  $base/vendor/gems/ruby-1.8/bin
+    
+where $base is the absolute path of the project's base directory.
+If you use a bash-flavored shell, you can do this by running:
+
+  . ./project-env.sh
+
+== External Programs Used By the Project
+
+general:
+
+* git
+* ruby 1.8.7
+* ruby 1.9.1 (optional)
+* java
+* graphviz (optional)
+  
+for documentation:
+
+* pygmentize (optional)
+  
+for building ANTLR:
+
+* javac
+* fastjar or jar
+* maven 2 (mvn) (optional)
+
+== Development Dependencies / Third-Party Gems
+
+* the ANTLR runtime library (everything under lib) has no external
+  dependencies (and ideally will stay that way)
+  
+* to allow contributors to take advantage of various useful third party
+  libraries for testing, benchmarking, utilities, yada yada yada, the
+  project uses a third-party library, ``isolate'', to manage a project-specific stash of gems
+
+* the file *config/isolate.rb* specifies the gems to fetch -- edit this
+  to add/remove development dependencies
+  
+* the project configuration object, $project, which is defined in
+  *config/project.rb*, handles setting up the load path and loading
+  Isolate to set up the rubygems environment
+  
+* more info on isolate can be found at the project's homepage:
+
+http://github.com/jbarnette/isolate
+
+== Project Layout
+
+=== Top Level
+
+  antlr3
+  |-- bin       : contains the antlr4ruby program
+  |-- config    : project development configuration scripts and data
+  |-- dev-lib   : home of all extra libraries used for development purposes
+  |-- doc       : custom documentation
+  |-- java      : the modified ANTLR3 jar and RubyTarget.java
+  |-- lib       : the ruby ANTLR runtime library
+  |-- log       : archived benchmarking data and other project logs
+  |-- notes     : random text notes I recorded throughout development
+  |-- samples   : ANTLR grammar samples customized for ruby output
+  |-- scripts   : development utilities
+  |-- templates : the string template files ANTLR uses to write ruby
+  |-- test      : a bunch of test code
+  `-- vendor    : third party libraries used by the development tools
+
+=== Templates
+
+  templates
+  |-- Ruby.stg           : all of the core templates for ruby output
+  |-- AST.stg            : additional base templates used by tree code
+  |-- ASTParser.stg      : more tree template code for AST-building parsers
+  |-- ASTTreeParser.stg  : more tree template code for tree parsers
+  |-- Dbg.stg            : debug-mode extensions to the core templates
+  `-- ASTDbg.stg         : debug-mode extensions to the AST templates
+
+* These are the String Template group files that ANTLR uses to
+  generate ruby code
+
+* If you are unfamilliar with the String Template language,
+  refer to http://www.stringtemplate.org for more information
+  and documentation
+
+* Modifications to these files will not be reflected in ANTLR
+  output until the ANTLR jar is updated with the changes. The
+  jar can be updated via:
+  
+    rake antlr
+
+=== Testing
+
+  test
+  |-- unit        : plain old unit tests for runtime library components
+  |-- functional  : tests of the functionality of ANTLR generated code
+  `-- performance : specs that are used for benchmarking/profiling
+
+* most unit tests and functional tests use a combined test/unit
+  and rspec environment; the tests are written as Test::Unit::TestCase
+  subclasses, but often use rspec-style example blocks and assertions
+
+* the tests can generally be run directly, but scripts/antlr-tests
+  is a command-line tool that can be used to run tests in an
+  `enhanced' fashion
+
+==== Functional Tests
+
+* functional tests are grouped into a number of categories, each of
+  which is represented as a subdirectory of test/functional. For
+  example tests concerning pure lexer functionality are all placed
+  in the directory test/functional/lexer
+
+* tests are further organized by specific subject, with one or more tests
+  focused on some single aspect grouped together in a single file under the category
+  directory. For example, test/functional/lexer/filter-mode.rb
+  contains several tests concerning filter mode lexer grammars.
+
+* the ANTLR grammars used to generate code are written 'inline' with all of
+  the tests. A number of utility classes contained in lib/antlr3/test
+  are used to compile the grammars into code, dynamically load the
+  code ANTLR generates, and test the output functionality.
+
+* running the ANTLR tool to generate code is fairly slow (that is, when you're
+  doing it 100 times in a row). When you first run all of the functional tests,
+  don't be surprised if it takes a good 10-15 minutes to do. However, grammars
+  are only recompiled when their source has changed or updates have been
+  made to the ANTLR jar, so subsequent runs are usually pretty quick.
+  
+== Programs / Utility Scripts
+
+=== antlr4ruby
+
+* a very simple script that wraps for the ANTLR3 tool
+
+* currently, it simply finds the absolute path of
+  java/antlr-full-3.x.x.jar in the project directory
+  and then essentially runs:
+  
+    java -jar path/to/antlr-full-3.x.x.jar ARGV
+
+* so to use ANTLR to generate ruby output using this project's
+  runtime library and code templates, run:
+  
+    antlr4ruby [antlr options] path/to/Grammar.g
+
+* run antlr4ruby without arguments to get a summary of
+  ANTLR's options and arguments, or read up on the
+  ANTLR tool's documentation at http://www.antlr.org
+
+=== antlr-tests
+
+* used to run various types of tests in the project, summarize
+  the results in tabular format, and dump enhanced information
+  about errors/test failures that arose during the test run
+  
+* uses the third party gem `main' to create a hierarchical
+  command structure, instead of plain old optparse
+  
+* examples:
+  
+    # run functional tests
+    antlr-tests functional
+    
+    # run unit, functional, benchmarking, and profiling tests:
+    antlr-tests run
+    
+    # trash all files generated by the tests
+    antlr-tests clean
+    
+    # run all parser-oriented tests
+    antlr-tests functional parser
+  
+=== grammar-tools
+
+* a growing number of utilities for viewing properties of ANTLR
+  grammar files, refactoring/porting ANTLR grammars for
+  ruby output, and formatting/highlighting grammar files
+  
+* a few notable commands:
+
+    # produce a fairly nice HTML-formatted grammar display
+    grammar-tools format html path/to/Grammar.g > grammar.html
+    
+    # list all rule names defined within a grammar
+    grammar-tools show rules path/to/Grammar.g
+    
+    # set up a grammar targetted for a language other than
+    # ruby to be retargetted for ruby output
+    grammar-tools modify stylize path/to/Grammar.g
+    
+    # print out a grammar without any language-specific elements
+    grammar-tools modify strip path/to/Grammar.g
+    
+    # print out help with a list of commands
+    grammar-tools help
+
+=== st-group
+
+* utility commands for working with StringTemplate template group files
+
+* uses the same command style as grammar-tools
+
+* current notable commands:
+
+    # break up a large STG file into a directory containing a single .st
+    # file for each template defined in a group
+    st-group unzip path/to/Group.stg
+    
+    # reconstitute a directory created by unzipping a group file
+    # back into a single .stg file
+    st-group zip path/to/Group/
+    
+    # print out names and other definition info contained in a .stg file
+    st-group info path/to/Group.stg
+    
+    # extract and display a single template definition
+    st-group show path/to/Group.stg templateName
+

data/Manifest.txt

@@ -1,169 +1,170 @@
 bin/antlr4ruby
-lib/antlr3.rb
-lib/antlr3/constants.rb
-lib/antlr3/test/core-extensions.rb
-lib/antlr3/test/grammar.rb
-lib/antlr3/test/functional.rb
-lib/antlr3/test/call-stack.rb
-lib/antlr3/debug/socket.rb
-lib/antlr3/debug/event-hub.rb
-lib/antlr3/debug/trace-event-listener.rb
-lib/antlr3/debug/rule-tracer.rb
-lib/antlr3/debug/record-event-listener.rb
-lib/antlr3/template/group-file-lexer.rb
-lib/antlr3/template/group-file.rb
-lib/antlr3/template/parameter.rb
-lib/antlr3/template/group-file-parser.rb
+lib/antlr3/tree.rb
 lib/antlr3/template.rb
+lib/antlr3/dfa.rb
 lib/antlr3/tree/wizard.rb
-lib/antlr3/tree/debug.rb
 lib/antlr3/tree/visitor.rb
-lib/antlr3/modes/ast-builder.rb
-lib/antlr3/modes/filter.rb
-lib/antlr3/debug.rb
-lib/antlr3/main.rb
-lib/antlr3/util.rb
-lib/antlr3/token.rb
-lib/antlr3/dfa.rb
-lib/antlr3/streams.rb
-lib/antlr3/error.rb
+lib/antlr3/tree/debug.rb
+lib/antlr3/constants.rb
 lib/antlr3/version.rb
-lib/antlr3/recognizers.rb
+lib/antlr3/streams.rb
 lib/antlr3/dot.rb
 lib/antlr3/profile.rb
-lib/antlr3/tree.rb
-lib/antlr3/streams/interactive.rb
+lib/antlr3/error.rb
+lib/antlr3/debug/rule-tracer.rb
+lib/antlr3/debug/record-event-listener.rb
+lib/antlr3/debug/trace-event-listener.rb
+lib/antlr3/debug/event-hub.rb
+lib/antlr3/debug/socket.rb
+lib/antlr3/main.rb
+lib/antlr3/debug.rb
+lib/antlr3/task.rb
+lib/antlr3/template/parameter.rb
+lib/antlr3/template/group-file-parser.rb
+lib/antlr3/template/group-file-lexer.rb
+lib/antlr3/template/group-file.rb
 lib/antlr3/streams/rewrite.rb
 lib/antlr3/streams/unicode.rb
-lib/antlr3/task.rb
-test/unit/test-streams.rb
-test/unit/test-template.rb
-test/unit/test-unicode-stream.rb
-test/unit/test-dfa.rb
-test/unit/test-exceptions.rb
-test/unit/test-scheme.rb
-test/unit/test-tree-wizard.rb
+lib/antlr3/streams/interactive.rb
+lib/antlr3/token.rb
+lib/antlr3/recognizers.rb
+lib/antlr3/modes/ast-builder.rb
+lib/antlr3/modes/filter.rb
+lib/antlr3/test/call-stack.rb
+lib/antlr3/test/grammar.rb
+lib/antlr3/test/functional.rb
+lib/antlr3/test/core-extensions.rb
+lib/antlr3/util.rb
+lib/antlr3.rb
+test/unit/test-scope.rb
 test/unit/sample-input/teststreams.input2
 test/unit/sample-input/file-stream-1
 test/unit/sample-input/template-group
+test/unit/test-template.rb
+test/unit/test-tree-wizard.rb
+test/unit/test-unicode-stream.rb
+test/unit/test-scheme.rb
 test/unit/test-trees.rb
+test/unit/test-streams.rb
+test/unit/test-dfa.rb
 test/unit/test-recognizers.rb
-test/unit/test-scope.rb
+test/unit/test-exceptions.rb
+test/functional/ast-output/auto-ast.rb
+test/functional/ast-output/hetero-nodes.rb
+test/functional/ast-output/construction.rb
+test/functional/ast-output/rewrites.rb
+test/functional/ast-output/tree-rewrite.rb
+test/functional/token-rewrite/via-parser.rb
+test/functional/token-rewrite/basic.rb
 test/functional/main/main-scripts.rb
-test/functional/template-output/template-output.rb
 test/functional/tree-parser/basic.rb
-test/functional/lexer/properties.rb
-test/functional/lexer/filter-mode.rb
-test/functional/lexer/syn-pred.rb
-test/functional/lexer/basic.rb
-test/functional/lexer/nuances.rb
-test/functional/lexer/xml.rb
-test/functional/delegation/import.rb
-test/functional/parser/scopes.rb
+test/functional/parser/nuances.rb
+test/functional/parser/backtracking.rb
 test/functional/parser/properties.rb
-test/functional/parser/basic.rb
+test/functional/parser/scopes.rb
+test/functional/parser/rule-methods.rb
 test/functional/parser/predicates.rb
-test/functional/parser/ll-star.rb
-test/functional/parser/backtracking.rb
 test/functional/parser/calc.rb
-test/functional/parser/nuances.rb
+test/functional/parser/basic.rb
+test/functional/parser/ll-star.rb
 test/functional/parser/actions.rb
-test/functional/parser/rule-methods.rb
-test/functional/debugging/debug-mode.rb
-test/functional/debugging/profile-mode.rb
+test/functional/lexer/filter-mode.rb
+test/functional/lexer/nuances.rb
+test/functional/lexer/properties.rb
+test/functional/lexer/basic.rb
+test/functional/lexer/syn-pred.rb
+test/functional/lexer/xml.rb
 test/functional/debugging/rule-tracing.rb
-test/functional/token-rewrite/basic.rb
-test/functional/token-rewrite/via-parser.rb
-test/functional/ast-output/tree-rewrite.rb
-test/functional/ast-output/construction.rb
-test/functional/ast-output/rewrites.rb
-test/functional/ast-output/hetero-nodes.rb
-test/functional/ast-output/auto-ast.rb
-templates/Ruby.stg
+test/functional/debugging/profile-mode.rb
+test/functional/debugging/debug-mode.rb
+test/functional/delegation/import.rb
+test/functional/template-output/template-output.rb
 templates/ASTDbg.stg
-templates/AST.stg
-templates/ST.stg
-templates/Dbg.stg
 templates/Support.stg
-templates/ASTTreeParser.stg
 templates/ASTParser.stg
+templates/AST.stg
+templates/ASTTreeParser.stg
+templates/Dbg.stg
+templates/ST.stg
+templates/Ruby.stg
 samples/CPP.g
 samples/ANTLRv3Grammar.g
 samples/JavaScript.g
-samples/standard/fuzzy/FuzzyJava.g
-samples/standard/fuzzy/output
-samples/standard/fuzzy/input
-samples/standard/fuzzy/fuzzy.rb
-samples/standard/fuzzy/fuzzy.py
-samples/standard/scopes/scopes.rb
-samples/standard/scopes/output
-samples/standard/scopes/input
-samples/standard/scopes/SymbolTable.g
-samples/standard/LL-star/LLStar.g
-samples/standard/LL-star/ll-star.rb
-samples/standard/LL-star/output
-samples/standard/LL-star/input
-samples/standard/dynamic-scope/DynamicScopes.g
-samples/standard/dynamic-scope/dynamic-scopes.rb
-samples/standard/dynamic-scope/output
-samples/standard/dynamic-scope/input
-samples/standard/java/java.rb
-samples/standard/java/Java.g
-samples/standard/java/output
-samples/standard/java/input
-samples/standard/C/C.g
-samples/standard/C/C__testrig.st
-samples/standard/C/c.rb
-samples/standard/C/C.tokens
-samples/standard/C/output
-samples/standard/C/input
-samples/standard/python/PythonTokenSource.rb
-samples/standard/python/Python.g
-samples/standard/python/output
-samples/standard/python/input
-samples/standard/python/python.rb
-samples/standard/treeparser/Lang.g
-samples/standard/treeparser/LangDumpDecl.g
 samples/standard/treeparser/treeparser.rb
-samples/standard/treeparser/output
+samples/standard/treeparser/Lang.g
 samples/standard/treeparser/input
-samples/standard/cminus/java.group
+samples/standard/treeparser/output
+samples/standard/treeparser/LangDumpDecl.g
 samples/standard/cminus/python.group
-samples/standard/cminus/output
-samples/standard/cminus/input
 samples/standard/cminus/CMinus.g
+samples/standard/cminus/input
+samples/standard/cminus/output
 samples/standard/cminus/bytecode.group
+samples/standard/cminus/java.group
 samples/standard/cminus/cminus.rb
 samples/standard/calc/Calculator.rb
 samples/standard/calc/Calculator.py
 samples/standard/calc/Calculator.g
-samples/standard/xml/README
-samples/standard/xml/output
-samples/standard/xml/input
-samples/standard/xml/XML.g
-samples/standard/xml/xml.rb
+samples/standard/dynamic-scope/input
+samples/standard/dynamic-scope/dynamic-scopes.rb
+samples/standard/dynamic-scope/output
+samples/standard/dynamic-scope/DynamicScopes.g
 samples/standard/rakefile
-samples/standard/simplecTreeParser/simplec.rb
-samples/standard/simplecTreeParser/SimpleCWalker.g
-samples/standard/simplecTreeParser/output
+samples/standard/java/Java.g
+samples/standard/java/input
+samples/standard/java/output
+samples/standard/java/java.rb
+samples/standard/tweak/tweak.rb
+samples/standard/tweak/input
+samples/standard/tweak/output
+samples/standard/tweak/Tweak.g
 samples/standard/simplecTreeParser/input
 samples/standard/simplecTreeParser/SimpleC.g
+samples/standard/simplecTreeParser/output
+samples/standard/simplecTreeParser/SimpleCWalker.g
+samples/standard/simplecTreeParser/simplec.rb
+samples/standard/island-grammar/island.rb
+samples/standard/island-grammar/input
 samples/standard/island-grammar/Simple.g
 samples/standard/island-grammar/output
-samples/standard/island-grammar/input
 samples/standard/island-grammar/Javadoc.g
-samples/standard/island-grammar/island.rb
-samples/standard/tweak/tweak.rb
-samples/standard/tweak/output
-samples/standard/tweak/input
-samples/standard/tweak/Tweak.g
-samples/standard/hoisted-predicates/HoistedPredicates.g
+samples/standard/C/C.g
+samples/standard/C/C.tokens
+samples/standard/C/input
+samples/standard/C/c.rb
+samples/standard/C/output
+samples/standard/C/C__testrig.st
+samples/standard/fuzzy/input
+samples/standard/fuzzy/output
+samples/standard/fuzzy/fuzzy.py
+samples/standard/fuzzy/fuzzy.rb
+samples/standard/fuzzy/FuzzyJava.g
+samples/standard/xml/input
+samples/standard/xml/output
+samples/standard/xml/README
+samples/standard/xml/xml.rb
+samples/standard/xml/XML.g
+samples/standard/LL-star/input
+samples/standard/LL-star/output
+samples/standard/LL-star/LLStar.g
+samples/standard/LL-star/ll-star.rb
 samples/standard/hoisted-predicates/hoisted-predicates.rb
-samples/standard/hoisted-predicates/output
 samples/standard/hoisted-predicates/input
+samples/standard/hoisted-predicates/output
+samples/standard/hoisted-predicates/HoistedPredicates.g
+samples/standard/scopes/SymbolTable.g
+samples/standard/scopes/input
+samples/standard/scopes/scopes.rb
+samples/standard/scopes/output
+samples/standard/python/Python.g
+samples/standard/python/input
+samples/standard/python/PythonTokenSource.rb
+samples/standard/python/output
+samples/standard/python/python.rb
 ANTLR-LICENSE.txt
 History.txt
-README.txt
+DEVELOPER-README.rdoc
+README.rdoc
 java/antlr-full-3.2.1.jar
 java/RubyTarget.java
 rakefile

data/{README.txt → README.rdoc}

@@ -1,7 +1,9 @@
-ANTLR 3 for Ruby
-    by Kyle Yetter (kcy5b@yahoo.com)
-    http://antlr.ohboyohboyohboy.org
-    http://github.com/ohboyohboyohboy/antlr3
+= ANTLR 3 for Ruby
+
+==== by Kyle Yetter (kcy5b@yahoo.com)
+
+* http://antlr.ohboyohboyohboy.org
+* http://github.com/ohboyohboyohboy/antlr3
 
 == DESCRIPTION:
 
@@ -59,37 +61,36 @@ ANTLR provides for other language targets, such as Java and Python. It contains:
 
 1. Write an ANTLR grammar specification for a language
 
-   grammar SomeLanguage;
-   
-   options {
-     language = Ruby;    // <- this option must be set to Ruby
-     output   = AST;
-   }
-   
-   top: expr ( ',' expr )*
-      ;
-    
-   and so on...
+     grammar SomeLanguage;
+     
+     options {
+       language = Ruby;    // <- this option must be set to Ruby
+       output   = AST;
+     }
+     
+     top: expr ( ',' expr )*
+        ;
+      
+     and so on...
    
 
 2. Run the ANTLR tool with the antlr4ruby command to generate output:
    
-   antlr4ruby SomeLanguage.g
-   # creates:
-   #   SomeLanguageParser.rb
-   #   SomeLanguageLexer.rb
-   #   SomeLanguage.g
+     antlr4ruby SomeLanguage.g
+     # creates:
+     #   SomeLanguageParser.rb
+     #   SomeLanguageLexer.rb
+     #   SomeLanguage.g
 
 3. Try out the results directly, if you like:
 
-  # see how the lexer tokenizes some input
-  ruby SomeLanguageLexer.rb < path/to/source-code.xyz
-  
-  # check whether the parser successfully matches some input
-  ruby SomeLanguageParser.rb --rule=top < path/to/source-code.xyz
+      # see how the lexer tokenizes some input
+      ruby SomeLanguageLexer.rb < path/to/source-code.xyz
+      
+      # check whether the parser successfully matches some input
+      ruby SomeLanguageParser.rb --rule=top < path/to/source-code.xyz
 
--> Read up on the package documentation for more specific details
-   about loading the recognizers and using their class definitions
+Read up on the package documentation for more specific details about loading the recognizers and using their class definitions
 
 == ISSUES
 

data/lib/antlr3/task.rb

@@ -111,6 +111,10 @@ class CompileTask < Rake::TaskLib
 
 #class CompileTask::GrammarSet
 class GrammarSet
+  if defined?( Rake::DSL )
+    include Rake::DSL
+  end
+  
   attr_accessor :antlr_jar, :debug,
                 :trace, :profile, :compile_options,
                 :java_options
@@ -227,6 +231,10 @@ class GrammarSet
 end
 
 class GrammarFile
+  if defined?( Rake::DSL )
+    include Rake::DSL
+  end
+  
   LANGUAGES = { 
     "ActionScript" => [ ".as" ],
     "CSharp2" => [ ".cs" ],

data/lib/antlr3/template.rb

@@ -1,5 +1,8 @@
 #!/usr/bin/ruby
-
+# encoding: utf-8
+#
+# author: Kyle Yetter
+#
 
 require 'erb'
 require 'antlr3'
@@ -209,9 +212,21 @@ private
 end
 
 class Context
-  VARIABLE_FORM = /^(@)?[a-z_\x80-\xff][\w\x80-\xff]*$/
-  SETTER_FORM = /^([a-z_\x80-\xff][\w\x80-\xff]*)=$/
-  ATTR_FORM = /^[a-z_\x80-\xff][\w\x80-\xff]*$/
+  VARIABLE_FORM = /^(@)?[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/
+  SETTER_FORM   = /^([a-z_\\x80-\\xff][\w\\x80-\\xff]*)=$/
+  ATTR_FORM     = /^[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/
+  #if RUBY_VERSION =~ /^1\.8(?=\.|$)/
+  #  class_eval( <<-'END' )
+  #    VARIABLE_FORM = /^(@)?[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/
+  #    SETTER_FORM   = /^([a-z_\\x80-\\xff][\w\\x80-\\xff]*)=$/
+  #    ATTR_FORM     = /^[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/
+  #  END
+  #else
+  #  VARIABLE_FORM = Regexp.new( "/^(@)?[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/", nil, 'n' )
+  #  SETTER_FORM   = Regexp.new( "/^([a-z_\\x80-\\xff][\w\\x80-\\xff]*)=$/", nil, 'n' )
+  #  ATTR_FORM     = Regexp.new( "/^[a-z_\\x80-\\xff][\w\\x80-\\xff]*$/", nil, 'n' )
+  #end
+  
   
   class << self
     attr_accessor :group, :name, :parameters

data/lib/antlr3/version.rb

@@ -20,7 +20,7 @@ module ANTLR3
   # 
   MAJOR_VERSION = 1
   MINOR_VERSION = 8
-  PATCH_VERSION = 12
+  PATCH_VERSION = 13
   VERSION = [ MAJOR_VERSION, MINOR_VERSION, PATCH_VERSION ]
   VERSION_STRING = VERSION.join( '.' ).freeze
   

data/rakefile

@@ -15,46 +15,46 @@ Hoe.spec "antlr3" do
   )
   
   self.test_globs = [
-    "test/unit/test-streams.rb",
+    "test/unit/test-scope.rb",
     "test/unit/test-template.rb",
+    "test/unit/test-tree-wizard.rb",
     "test/unit/test-unicode-stream.rb",
-    "test/unit/test-dfa.rb",
-    "test/unit/test-exceptions.rb",
     "test/unit/test-scheme.rb",
-    "test/unit/test-tree-wizard.rb",
     "test/unit/test-trees.rb",
+    "test/unit/test-streams.rb",
+    "test/unit/test-dfa.rb",
     "test/unit/test-recognizers.rb",
-    "test/unit/test-scope.rb",
+    "test/unit/test-exceptions.rb",
+    "test/functional/ast-output/auto-ast.rb",
+    "test/functional/ast-output/hetero-nodes.rb",
+    "test/functional/ast-output/construction.rb",
+    "test/functional/ast-output/rewrites.rb",
+    "test/functional/ast-output/tree-rewrite.rb",
+    "test/functional/token-rewrite/via-parser.rb",
+    "test/functional/token-rewrite/basic.rb",
     "test/functional/main/main-scripts.rb",
-    "test/functional/template-output/template-output.rb",
     "test/functional/tree-parser/basic.rb",
-    "test/functional/lexer/properties.rb",
-    "test/functional/lexer/filter-mode.rb",
-    "test/functional/lexer/syn-pred.rb",
-    "test/functional/lexer/basic.rb",
-    "test/functional/lexer/nuances.rb",
-    "test/functional/lexer/xml.rb",
-    "test/functional/delegation/import.rb",
-    "test/functional/parser/scopes.rb",
+    "test/functional/parser/nuances.rb",
+    "test/functional/parser/backtracking.rb",
     "test/functional/parser/properties.rb",
-    "test/functional/parser/basic.rb",
+    "test/functional/parser/scopes.rb",
+    "test/functional/parser/rule-methods.rb",
     "test/functional/parser/predicates.rb",
-    "test/functional/parser/ll-star.rb",
-    "test/functional/parser/backtracking.rb",
     "test/functional/parser/calc.rb",
-    "test/functional/parser/nuances.rb",
+    "test/functional/parser/basic.rb",
+    "test/functional/parser/ll-star.rb",
     "test/functional/parser/actions.rb",
-    "test/functional/parser/rule-methods.rb",
-    "test/functional/debugging/debug-mode.rb",
-    "test/functional/debugging/profile-mode.rb",
+    "test/functional/lexer/filter-mode.rb",
+    "test/functional/lexer/nuances.rb",
+    "test/functional/lexer/properties.rb",
+    "test/functional/lexer/basic.rb",
+    "test/functional/lexer/syn-pred.rb",
+    "test/functional/lexer/xml.rb",
     "test/functional/debugging/rule-tracing.rb",
-    "test/functional/token-rewrite/basic.rb",
-    "test/functional/token-rewrite/via-parser.rb",
-    "test/functional/ast-output/tree-rewrite.rb",
-    "test/functional/ast-output/construction.rb",
-    "test/functional/ast-output/rewrites.rb",
-    "test/functional/ast-output/hetero-nodes.rb",
-    "test/functional/ast-output/auto-ast.rb"
+    "test/functional/debugging/profile-mode.rb",
+    "test/functional/debugging/debug-mode.rb",
+    "test/functional/delegation/import.rb",
+    "test/functional/template-output/template-output.rb"
   ]
   
 end

data/templates/Ruby.stg

@@ -60,7 +60,7 @@ rescue LoadError
   
   # 3: try to activate the antlr3 gem
   begin
-    Gem.activate( 'antlr3', '~> <runtimeLibraryVersion()>' )
+    defined?( gem ) and gem( "antlr3", '~> <runtimeLibraryVersion()>' )
   rescue Gem::LoadError
     antlr_load_failed.call
   end
@@ -1459,4 +1459,4 @@ placeAction(scope, name) ::= <<
 <endif>
 >>
 
-runtimeLibraryVersion() ::= "1.8.12"
+runtimeLibraryVersion() ::= "1.8.13"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: antlr3
 version: !ruby/object:Gem::Version 
-  hash: 47
+  hash: 45
   prerelease: 
   segments: 
   - 1
   - 8
-  - 12
-  version: 1.8.12
+  - 13
+  version: 1.8.13
 platform: ruby
 authors: 
 - Kyle Yetter
@@ -15,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-29 00:00:00 -04:00
-default_executable: 
+date: 2013-07-17 00:00:00 Z
 dependencies: []
 
 description: |-
@@ -62,176 +61,176 @@ extra_rdoc_files: []
 
 files: 
 - bin/antlr4ruby
-- lib/antlr3.rb
-- lib/antlr3/constants.rb
-- lib/antlr3/test/core-extensions.rb
-- lib/antlr3/test/grammar.rb
-- lib/antlr3/test/functional.rb
-- lib/antlr3/test/call-stack.rb
-- lib/antlr3/debug/socket.rb
-- lib/antlr3/debug/event-hub.rb
-- lib/antlr3/debug/trace-event-listener.rb
-- lib/antlr3/debug/rule-tracer.rb
-- lib/antlr3/debug/record-event-listener.rb
-- lib/antlr3/template/group-file-lexer.rb
-- lib/antlr3/template/group-file.rb
-- lib/antlr3/template/parameter.rb
-- lib/antlr3/template/group-file-parser.rb
+- lib/antlr3/tree.rb
 - lib/antlr3/template.rb
+- lib/antlr3/dfa.rb
 - lib/antlr3/tree/wizard.rb
-- lib/antlr3/tree/debug.rb
 - lib/antlr3/tree/visitor.rb
-- lib/antlr3/modes/ast-builder.rb
-- lib/antlr3/modes/filter.rb
-- lib/antlr3/debug.rb
-- lib/antlr3/main.rb
-- lib/antlr3/util.rb
-- lib/antlr3/token.rb
-- lib/antlr3/dfa.rb
-- lib/antlr3/streams.rb
-- lib/antlr3/error.rb
+- lib/antlr3/tree/debug.rb
+- lib/antlr3/constants.rb
 - lib/antlr3/version.rb
-- lib/antlr3/recognizers.rb
+- lib/antlr3/streams.rb
 - lib/antlr3/dot.rb
 - lib/antlr3/profile.rb
-- lib/antlr3/tree.rb
-- lib/antlr3/streams/interactive.rb
+- lib/antlr3/error.rb
+- lib/antlr3/debug/rule-tracer.rb
+- lib/antlr3/debug/record-event-listener.rb
+- lib/antlr3/debug/trace-event-listener.rb
+- lib/antlr3/debug/event-hub.rb
+- lib/antlr3/debug/socket.rb
+- lib/antlr3/main.rb
+- lib/antlr3/debug.rb
+- lib/antlr3/task.rb
+- lib/antlr3/template/parameter.rb
+- lib/antlr3/template/group-file-parser.rb
+- lib/antlr3/template/group-file-lexer.rb
+- lib/antlr3/template/group-file.rb
 - lib/antlr3/streams/rewrite.rb
 - lib/antlr3/streams/unicode.rb
-- lib/antlr3/task.rb
-- test/unit/test-streams.rb
-- test/unit/test-template.rb
-- test/unit/test-unicode-stream.rb
-- test/unit/test-dfa.rb
-- test/unit/test-exceptions.rb
-- test/unit/test-scheme.rb
-- test/unit/test-tree-wizard.rb
+- lib/antlr3/streams/interactive.rb
+- lib/antlr3/token.rb
+- lib/antlr3/recognizers.rb
+- lib/antlr3/modes/ast-builder.rb
+- lib/antlr3/modes/filter.rb
+- lib/antlr3/test/call-stack.rb
+- lib/antlr3/test/grammar.rb
+- lib/antlr3/test/functional.rb
+- lib/antlr3/test/core-extensions.rb
+- lib/antlr3/util.rb
+- lib/antlr3.rb
+- test/unit/test-scope.rb
 - test/unit/sample-input/teststreams.input2
 - test/unit/sample-input/file-stream-1
 - test/unit/sample-input/template-group
+- test/unit/test-template.rb
+- test/unit/test-tree-wizard.rb
+- test/unit/test-unicode-stream.rb
+- test/unit/test-scheme.rb
 - test/unit/test-trees.rb
+- test/unit/test-streams.rb
+- test/unit/test-dfa.rb
 - test/unit/test-recognizers.rb
-- test/unit/test-scope.rb
+- test/unit/test-exceptions.rb
+- test/functional/ast-output/auto-ast.rb
+- test/functional/ast-output/hetero-nodes.rb
+- test/functional/ast-output/construction.rb
+- test/functional/ast-output/rewrites.rb
+- test/functional/ast-output/tree-rewrite.rb
+- test/functional/token-rewrite/via-parser.rb
+- test/functional/token-rewrite/basic.rb
 - test/functional/main/main-scripts.rb
-- test/functional/template-output/template-output.rb
 - test/functional/tree-parser/basic.rb
-- test/functional/lexer/properties.rb
-- test/functional/lexer/filter-mode.rb
-- test/functional/lexer/syn-pred.rb
-- test/functional/lexer/basic.rb
-- test/functional/lexer/nuances.rb
-- test/functional/lexer/xml.rb
-- test/functional/delegation/import.rb
-- test/functional/parser/scopes.rb
+- test/functional/parser/nuances.rb
+- test/functional/parser/backtracking.rb
 - test/functional/parser/properties.rb
-- test/functional/parser/basic.rb
+- test/functional/parser/scopes.rb
+- test/functional/parser/rule-methods.rb
 - test/functional/parser/predicates.rb
-- test/functional/parser/ll-star.rb
-- test/functional/parser/backtracking.rb
 - test/functional/parser/calc.rb
-- test/functional/parser/nuances.rb
+- test/functional/parser/basic.rb
+- test/functional/parser/ll-star.rb
 - test/functional/parser/actions.rb
-- test/functional/parser/rule-methods.rb
-- test/functional/debugging/debug-mode.rb
-- test/functional/debugging/profile-mode.rb
+- test/functional/lexer/filter-mode.rb
+- test/functional/lexer/nuances.rb
+- test/functional/lexer/properties.rb
+- test/functional/lexer/basic.rb
+- test/functional/lexer/syn-pred.rb
+- test/functional/lexer/xml.rb
 - test/functional/debugging/rule-tracing.rb
-- test/functional/token-rewrite/basic.rb
-- test/functional/token-rewrite/via-parser.rb
-- test/functional/ast-output/tree-rewrite.rb
-- test/functional/ast-output/construction.rb
-- test/functional/ast-output/rewrites.rb
-- test/functional/ast-output/hetero-nodes.rb
-- test/functional/ast-output/auto-ast.rb
-- templates/Ruby.stg
+- test/functional/debugging/profile-mode.rb
+- test/functional/debugging/debug-mode.rb
+- test/functional/delegation/import.rb
+- test/functional/template-output/template-output.rb
 - templates/ASTDbg.stg
-- templates/AST.stg
-- templates/ST.stg
-- templates/Dbg.stg
 - templates/Support.stg
-- templates/ASTTreeParser.stg
 - templates/ASTParser.stg
+- templates/AST.stg
+- templates/ASTTreeParser.stg
+- templates/Dbg.stg
+- templates/ST.stg
+- templates/Ruby.stg
 - samples/CPP.g
 - samples/ANTLRv3Grammar.g
 - samples/JavaScript.g
-- samples/standard/fuzzy/FuzzyJava.g
-- samples/standard/fuzzy/output
-- samples/standard/fuzzy/input
-- samples/standard/fuzzy/fuzzy.rb
-- samples/standard/fuzzy/fuzzy.py
-- samples/standard/scopes/scopes.rb
-- samples/standard/scopes/output
-- samples/standard/scopes/input
-- samples/standard/scopes/SymbolTable.g
-- samples/standard/LL-star/LLStar.g
-- samples/standard/LL-star/ll-star.rb
-- samples/standard/LL-star/output
-- samples/standard/LL-star/input
-- samples/standard/dynamic-scope/DynamicScopes.g
-- samples/standard/dynamic-scope/dynamic-scopes.rb
-- samples/standard/dynamic-scope/output
-- samples/standard/dynamic-scope/input
-- samples/standard/java/java.rb
-- samples/standard/java/Java.g
-- samples/standard/java/output
-- samples/standard/java/input
-- samples/standard/C/C.g
-- samples/standard/C/C__testrig.st
-- samples/standard/C/c.rb
-- samples/standard/C/C.tokens
-- samples/standard/C/output
-- samples/standard/C/input
-- samples/standard/python/PythonTokenSource.rb
-- samples/standard/python/Python.g
-- samples/standard/python/output
-- samples/standard/python/input
-- samples/standard/python/python.rb
-- samples/standard/treeparser/Lang.g
-- samples/standard/treeparser/LangDumpDecl.g
 - samples/standard/treeparser/treeparser.rb
-- samples/standard/treeparser/output
+- samples/standard/treeparser/Lang.g
 - samples/standard/treeparser/input
-- samples/standard/cminus/java.group
+- samples/standard/treeparser/output
+- samples/standard/treeparser/LangDumpDecl.g
 - samples/standard/cminus/python.group
-- samples/standard/cminus/output
-- samples/standard/cminus/input
 - samples/standard/cminus/CMinus.g
+- samples/standard/cminus/input
+- samples/standard/cminus/output
 - samples/standard/cminus/bytecode.group
+- samples/standard/cminus/java.group
 - samples/standard/cminus/cminus.rb
 - samples/standard/calc/Calculator.rb
 - samples/standard/calc/Calculator.py
 - samples/standard/calc/Calculator.g
-- samples/standard/xml/README
-- samples/standard/xml/output
-- samples/standard/xml/input
-- samples/standard/xml/XML.g
-- samples/standard/xml/xml.rb
+- samples/standard/dynamic-scope/input
+- samples/standard/dynamic-scope/dynamic-scopes.rb
+- samples/standard/dynamic-scope/output
+- samples/standard/dynamic-scope/DynamicScopes.g
 - samples/standard/rakefile
-- samples/standard/simplecTreeParser/simplec.rb
-- samples/standard/simplecTreeParser/SimpleCWalker.g
-- samples/standard/simplecTreeParser/output
+- samples/standard/java/Java.g
+- samples/standard/java/input
+- samples/standard/java/output
+- samples/standard/java/java.rb
+- samples/standard/tweak/tweak.rb
+- samples/standard/tweak/input
+- samples/standard/tweak/output
+- samples/standard/tweak/Tweak.g
 - samples/standard/simplecTreeParser/input
 - samples/standard/simplecTreeParser/SimpleC.g
+- samples/standard/simplecTreeParser/output
+- samples/standard/simplecTreeParser/SimpleCWalker.g
+- samples/standard/simplecTreeParser/simplec.rb
+- samples/standard/island-grammar/island.rb
+- samples/standard/island-grammar/input
 - samples/standard/island-grammar/Simple.g
 - samples/standard/island-grammar/output
-- samples/standard/island-grammar/input
 - samples/standard/island-grammar/Javadoc.g
-- samples/standard/island-grammar/island.rb
-- samples/standard/tweak/tweak.rb
-- samples/standard/tweak/output
-- samples/standard/tweak/input
-- samples/standard/tweak/Tweak.g
-- samples/standard/hoisted-predicates/HoistedPredicates.g
+- samples/standard/C/C.g
+- samples/standard/C/C.tokens
+- samples/standard/C/input
+- samples/standard/C/c.rb
+- samples/standard/C/output
+- samples/standard/C/C__testrig.st
+- samples/standard/fuzzy/input
+- samples/standard/fuzzy/output
+- samples/standard/fuzzy/fuzzy.py
+- samples/standard/fuzzy/fuzzy.rb
+- samples/standard/fuzzy/FuzzyJava.g
+- samples/standard/xml/input
+- samples/standard/xml/output
+- samples/standard/xml/README
+- samples/standard/xml/xml.rb
+- samples/standard/xml/XML.g
+- samples/standard/LL-star/input
+- samples/standard/LL-star/output
+- samples/standard/LL-star/LLStar.g
+- samples/standard/LL-star/ll-star.rb
 - samples/standard/hoisted-predicates/hoisted-predicates.rb
-- samples/standard/hoisted-predicates/output
 - samples/standard/hoisted-predicates/input
+- samples/standard/hoisted-predicates/output
+- samples/standard/hoisted-predicates/HoistedPredicates.g
+- samples/standard/scopes/SymbolTable.g
+- samples/standard/scopes/input
+- samples/standard/scopes/scopes.rb
+- samples/standard/scopes/output
+- samples/standard/python/Python.g
+- samples/standard/python/input
+- samples/standard/python/PythonTokenSource.rb
+- samples/standard/python/output
+- samples/standard/python/python.rb
 - ANTLR-LICENSE.txt
 - History.txt
-- README.txt
+- DEVELOPER-README.rdoc
+- README.rdoc
 - java/antlr-full-3.2.1.jar
 - java/RubyTarget.java
 - rakefile
 - Manifest.txt
-has_rdoc: true
 homepage: http://antlr.ohboyohboyohboy.org/
 licenses: []
 
@@ -263,48 +262,48 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: 
 - java
 rubyforge_project: antlr3
-rubygems_version: 1.5.0
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Fully-featured ruby parser generation for ANTLR version 3.
 test_files: 
-- test/unit/test-streams.rb
+- test/unit/test-scope.rb
 - test/unit/test-template.rb
+- test/unit/test-tree-wizard.rb
 - test/unit/test-unicode-stream.rb
-- test/unit/test-dfa.rb
-- test/unit/test-exceptions.rb
 - test/unit/test-scheme.rb
-- test/unit/test-tree-wizard.rb
 - test/unit/test-trees.rb
+- test/unit/test-streams.rb
+- test/unit/test-dfa.rb
 - test/unit/test-recognizers.rb
-- test/unit/test-scope.rb
+- test/unit/test-exceptions.rb
+- test/functional/ast-output/auto-ast.rb
+- test/functional/ast-output/hetero-nodes.rb
+- test/functional/ast-output/construction.rb
+- test/functional/ast-output/rewrites.rb
+- test/functional/ast-output/tree-rewrite.rb
+- test/functional/token-rewrite/via-parser.rb
+- test/functional/token-rewrite/basic.rb
 - test/functional/main/main-scripts.rb
-- test/functional/template-output/template-output.rb
 - test/functional/tree-parser/basic.rb
-- test/functional/lexer/properties.rb
-- test/functional/lexer/filter-mode.rb
-- test/functional/lexer/syn-pred.rb
-- test/functional/lexer/basic.rb
-- test/functional/lexer/nuances.rb
-- test/functional/lexer/xml.rb
-- test/functional/delegation/import.rb
-- test/functional/parser/scopes.rb
+- test/functional/parser/nuances.rb
+- test/functional/parser/backtracking.rb
 - test/functional/parser/properties.rb
-- test/functional/parser/basic.rb
+- test/functional/parser/scopes.rb
+- test/functional/parser/rule-methods.rb
 - test/functional/parser/predicates.rb
-- test/functional/parser/ll-star.rb
-- test/functional/parser/backtracking.rb
 - test/functional/parser/calc.rb
-- test/functional/parser/nuances.rb
+- test/functional/parser/basic.rb
+- test/functional/parser/ll-star.rb
 - test/functional/parser/actions.rb
-- test/functional/parser/rule-methods.rb
-- test/functional/debugging/debug-mode.rb
-- test/functional/debugging/profile-mode.rb
+- test/functional/lexer/filter-mode.rb
+- test/functional/lexer/nuances.rb
+- test/functional/lexer/properties.rb
+- test/functional/lexer/basic.rb
+- test/functional/lexer/syn-pred.rb
+- test/functional/lexer/xml.rb
 - test/functional/debugging/rule-tracing.rb
-- test/functional/token-rewrite/basic.rb
-- test/functional/token-rewrite/via-parser.rb
-- test/functional/ast-output/tree-rewrite.rb
-- test/functional/ast-output/construction.rb
-- test/functional/ast-output/rewrites.rb
-- test/functional/ast-output/hetero-nodes.rb
-- test/functional/ast-output/auto-ast.rb
+- test/functional/debugging/profile-mode.rb
+- test/functional/debugging/debug-mode.rb
+- test/functional/delegation/import.rb
+- test/functional/template-output/template-output.rb