rley 0.6.05 → 0.6.06

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3083af262074f545ce6cdb9afed83c0d8a5cd255
-  data.tar.gz: d99c85423dde12c232681524dc9f8692bbd1d0ce
+  metadata.gz: e1e6215ec93e9404550f4ac55ac71cb294d5d3ef
+  data.tar.gz: 73b5089ae521c84ec6999096054dc1212e646d28
 SHA512:
-  metadata.gz: 27b474bb46b84aad4cfa74f72cdadc4d7da99bb0a80e5d6f8e4176716a6297a5be9495adac0202f2c5791ddbeb728ef7a35a5f0dd0e22504cb3d934c2d4446c9
-  data.tar.gz: 296215d53be774b54bff3b1b4ee316afab8ea86282d507cb72fac36f55b810c694e45554b2758a4b18c9008cb75030147129b20b730ce1b8cd1077ff582438df
+  metadata.gz: e954203459567724574ae05d976d5c836c21febdacc730971630a585ae73809bff5fa240238151c704ba51ccda44d9c2434f3202bdeddda75abb1b17cafa1a04
+  data.tar.gz: cc61845755b29425dfe538b7f7fd1605e21fb43be2d8e33956688bfca5f7626c257d31b6264ae44066875dadb4e9e4bb53a7e8a3adce16f76c14af2207ad9007

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+### 0.6.06 / 2018-04-12
+* [ADDED] Method `done!`: added to classes involved parse tree and parse forest creation. This method signals the end of parsing.
+* [CHANGE] Method `ParseTreeBuilder#process_item_entry`: added an explicit message in case of ambiguous parse.
+* [REMOVED] Deprecated method `GFGParsing#parse_tree`, to generate parse trees use the `Engine` class.
+
 ### 0.6.05 / 2018-04-02
 * [CHANGE] Method `ParseTreeBuilder#process_end_entry`: added an explicit message in case of ambiguous parse.
 * [CHANGE] Method `ParseTreeBuilder#process_item_entry`: added an explicit message in case of ambiguous parse.

data/examples/general/calc_iter1/calc_ast_nodes.rb

@@ -22,6 +22,10 @@ CalcTerminalNode = Struct.new(:token, :value, :position) do
     return value
   end
   
+  def done!()
+    # Do nothing
+  end
+  
   # Part of the 'visitee' role in Visitor design pattern.
   # @param aVisitor[ParseTreeVisitor] the visitor
   def accept(aVisitor)
@@ -49,6 +53,10 @@ class CalcCompositeNode
     @symbol = aSymbol
     @children = []    
   end
+  
+  def done!()
+    # Do nothing
+  end  
 
   # Part of the 'visitee' role in Visitor design pattern.
   # @param aVisitor[ParseTreeVisitor] the visitor

data/examples/general/calc_iter1/calc_demo.rb

@@ -11,7 +11,7 @@ Command-line syntax:
     the arithmetic expression is enclosed between double quotes (")
 
   Example:
-  ruby #{my_name} "2 * 3 + (1 + 3 ** 2)"
+  ruby #{my_name} "2 * 3 + (1 + 3 * 2)"
 END_MSG
   puts msg
   exit(1)

data/examples/general/calc_iter2/calc_ast_nodes.rb

@@ -21,6 +21,10 @@ CalcTerminalNode = Struct.new(:token, :value, :position) do
   def interpret()
     return value
   end
+  
+  def done!()
+    # Do nothing
+  end
 
   # Part of the 'visitee' role in Visitor design pattern.
   # @param aVisitor[ParseTreeVisitor] the visitor
@@ -77,6 +81,10 @@ class CalcCompositeNode
   def accept(aVisitor)
     aVisitor.visit_nonterminal(self)
   end
+  
+  def done!()
+    # Do nothing
+  end
 
   alias subnodes children
 end # class

data/lib/rley/constants.rb

@@ -3,7 +3,7 @@
 
 module Rley # Module used as a namespace
   # The version number of the gem.
-  Version = '0.6.05'.freeze
+  Version = '0.6.06'.freeze
 
   # Brief description of the gem.
   Description = "Ruby implementation of the Earley's parsing algorithm".freeze

data/lib/rley/parse_rep/parse_forest_builder.rb

@@ -40,6 +40,11 @@ module Rley # This module is used as a namespace
         @entry2node = {}
         @entry2path_to_alt = {}
       end
+      
+      # Notify the builder that the construction is over
+      def done!()
+        result.done!
+      end
 
       def receive_event(anEvent, anEntry, anIndex)
         # puts "Event: #{anEvent} #{anEntry} #{anIndex}"

data/lib/rley/parse_rep/parse_rep_creator.rb

@@ -29,6 +29,8 @@ module Rley # This module is used as a namespace
         rescue StopIteration => exc
           # Do nothing
         end
+        
+        a_builder.done!
 
         return a_builder.result
       end

data/lib/rley/parse_rep/parse_tree_builder.rb

@@ -24,8 +24,8 @@ module Rley # This module is used as a namespace
     end # Struct
 
 
-    # The purpose of a ParseTreeBuilder is to build piece by piece a CST
-    # (Concrete Syntax Tree) from a sequence of input tokens and
+    # The purpose of a ParseTreeBuilder is to build piece by piece 
+    # a parse tree from a sequence of input tokens and
     # visit events produced by walking over a GFGParsing object.
     # Uses the Builder GoF pattern.
     # The Builder pattern creates a complex object
@@ -35,7 +35,7 @@ module Rley # This module is used as a namespace
       # @return [Array<Token>] The sequence of input tokens
       attr_reader(:tokens)
 
-      # Link to CST object (being) built.
+      # Link to Parse tree object (being) built.
       attr_reader(:result)
 
 
@@ -46,6 +46,11 @@ module Rley # This module is used as a namespace
         @stack = []
         @dummy_node = Object.new.freeze
       end
+      
+      # Notify the builder that the construction is over
+      def done!()
+        result.done!
+      end      
 
       # Receive events resulting from a visit of GFGParsing object.
       # These events are produced by a specialized Enumerator created

data/lib/rley/parser/gfg_parsing.rb

@@ -199,20 +199,6 @@ END_MSG
         return factory.create
       end
 
-      # Factory method. Builds a ParseTree from the parse result.
-      # @return [ParseTree]
-      def parse_tree(aBuilder = nil)
-        msg = <<-END_MSG
-Method Rley::Parser::GFGParsing.parse_tree is deprecated, call
-Rley::Engine::to_ptree. It will be removed April 1st
-or version 0.6.1 (whichever is first)
-END_MSG
-        warn(msg)
-        factory = ParseRep::ParseTreeFactory.new(self)
-
-        return factory.create(aBuilder)
-      end
-
       # Retrieve the very first parse entry added to the chart.
       # This entry corresponds to the start vertex of the GF graph
       # with origin equal to zero.

data/lib/rley/ptree/parse_tree.rb

@@ -19,6 +19,12 @@ module Rley # This module is used as a namespace
       def initialize(theRootNode)
         @root = theRootNode
       end
+      
+      # Notify the builder that the construction is over.
+      # This method can be overriden
+      def done!()
+        @root.done!
+      end
 
       # Part of the 'visitee' role in the Visitor design pattern.
       #   A visitee is expected to accept the visit from a visitor object

data/lib/rley/ptree/parse_tree_node.rb

@@ -13,6 +13,10 @@ module Rley # This module is used as a namespace
         @symbol = aSymbol
         @range = Lexical::TokenRange.new(aRange)
       end
+      
+      # Notify the builder that the construction is over
+      def done!()
+      end
 
       # Assign a value from given range to each  undefined range bound
       def range=(aRange)

data/lib/rley/sppf/parse_forest.rb

@@ -29,6 +29,10 @@ module Rley # This module is used as a namespace
         @is_ambiguous = false
       end
       
+      # Notification that the SPPF construction is over
+      def done!()
+      end
+      
       # Returns true if the given node is present in the forest.
       def include?(aNode)
         return key2node.include?(aNode)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rley
 version: !ruby/object:Gem::Version
-  version: 0.6.05
+  version: 0.6.06
 platform: ruby
 authors:
 - Dimitri Geshef
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-02 00:00:00.000000000 Z
+date: 2018-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coveralls