rley 0.7.03 → 0.7.08

data/lib/rley/ptree/non_terminal_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'parse_tree_node' # Load superclass
 
 module Rley # This module is used as a namespace
@@ -16,20 +18,22 @@ module Rley # This module is used as a namespace
       def add_subnode(aSubnode)
         subnodes.unshift(aSubnode)
       end
-      
+
       # Emit a (formatted) string representation of the node.
       # Mainly used for diagnosis/debugging purposes.
+      # rubocop: disable Style/StringConcatenation
       def to_string(indentation)
         connector = '+- '
         selfie = super(indentation)
         prefix = "\n" + (' ' * connector.size * indentation) + connector
-        subnodes_repr = subnodes.reduce('') do |sub_result, subnode|
-          sub_result << prefix + subnode.to_string(indentation + 1) 
+        subnodes_repr = subnodes.reduce(+'') do |sub_result, subnode|
+          sub_result << prefix + subnode.to_string(indentation + 1)
         end
-        
-        return selfie + subnodes_repr        
+
+        selfie + subnodes_repr
       end
-      
+      # rubocop: enable Style/StringConcatenation
+
       # Part of the 'visitee' role in Visitor design pattern.
       # @param aVisitor[ParseTreeVisitor] the visitor
       def accept(aVisitor)

data/lib/rley/ptree/parse_tree.rb

@@ -1,15 +1,17 @@
+# frozen_string_literal: true
+
 require_relative 'terminal_node'
 require_relative 'non_terminal_node'
 
 module Rley # This module is used as a namespace
   module PTree # This module is used as a namespace
     # A parse tree (a.k.a. concrete syntax tree) is a tree-based representation
-    # for the parse that corresponds to the input text. In a parse tree, 
+    # for the parse that corresponds to the input text. In a parse tree,
     # a node corresponds to a grammar symbol used during the parsing:
     # - a leaf node maps to a terminal symbol occurring in
     # the input, and
     # - a intermediate node maps to a non-terminal node reduced
-    # during the parse. 
+    # during the parse.
     # The root node corresponds to the main/start symbol of the grammar.
     class ParseTree
       # @return [ParseTreeNode] The root node of the tree.
@@ -19,7 +21,7 @@ module Rley # This module is used as a namespace
       def initialize(theRootNode)
         @root = theRootNode
       end
-      
+
       # Notification from the builder telling that the parse tree construction
       # is over. This method can be overriden.
       def done!
@@ -33,7 +35,7 @@ module Rley # This module is used as a namespace
         aVisitor.start_visit_ptree(self)
 
         # Let's proceed with the visit of nodes
-        root.accept(aVisitor) if root
+        root&.accept(aVisitor)
 
         aVisitor.end_visit_ptree(self)
       end

data/lib/rley/ptree/parse_tree_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative '../lexical/token_range'
 
 module Rley # This module is used as a namespace
@@ -13,9 +15,9 @@ 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!()
+      def done!
         # Do nothing
       end
 
@@ -27,13 +29,13 @@ module Rley # This module is used as a namespace
       # Emit a (formatted) string representation of the node.
       # Mainly used for diagnosis/debugging purposes.
       def to_string(indentation)
-        return "#{symbol.name}#{range.to_string(indentation)}"
+        "#{symbol.name}#{range.to_string(indentation)}"
       end
 
       # Emit a short string representation of the node.
       # Mainly used for diagnosis/debugging purposes.
-      def to_s()
-        return "#{symbol.name}#{range.to_string(0)}"
+      def to_s
+        "#{symbol.name}#{range.to_string(0)}"
       end
     end # class
   end # module

data/lib/rley/ptree/terminal_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'parse_tree_node' # Load superclass
 
 module Rley # This module is used as a namespace
@@ -7,10 +9,10 @@ module Rley # This module is used as a namespace
       attr_reader(:token)
 
       # @param aToken [Lexical::Token] Input Token object
-      # @param aPos [Integer] position of the token in the input stream.      
+      # @param aPos [Integer] position of the token in the input stream.
       def initialize(aToken, aPos)
-        # (major, minor) =  
-        
+        # (major, minor) =
+
         # Use '1.class' trick to support both Integer and Fixnum classes
         range = aPos.kind_of?(1.class) ? { low: aPos, high: aPos + 1 } : aPos
         super(aToken.terminal, range)
@@ -22,18 +24,18 @@ module Rley # This module is used as a namespace
       def to_string(indentation)
         return super + ": '#{token.lexeme}'"
       end
-      
+
       # Emit a short string representation of the node.
       # Mainly used for diagnosis/debugging purposes.
-      def to_s()
+      def to_s
         return super + ": '#{token.lexeme}'"
-      end      
+      end
 
       # Part of the 'visitee' role in Visitor design pattern.
       # @param aVisitor[ParseTreeVisitor] the visitor
       def accept(aVisitor)
         aVisitor.visit_terminal(self)
-      end      
+      end
     end # class
   end # module
 end # module

data/lib/rley/rley_error.rb

@@ -1,10 +1,12 @@
-# File: rley_error.rb
-
-module Rley # Module used as a namespace
-  # @abstract
-  # Base class for any exception explicitly raised by Rley code.
-  class RleyError < StandardError
-  end # class
-end # module
-
-# End of file
+# frozen_string_literal: true
+
+# File: rley_error.rb
+
+module Rley # Module used as a namespace
+  # @abstract
+  # Base class for any exception explicitly raised by Rley code.
+  class RleyError < StandardError
+  end # class
+end # module
+
+# End of file

data/lib/rley/sppf/alternative_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'composite_node'
 
 module Rley # This module is used as a namespace
@@ -11,10 +13,10 @@ module Rley # This module is used as a namespace
       # @return [Syntax::NonTerminal] Link to lhs symbol
       attr_reader(:symbol)
 
-      # @param aVertex [GFG::ItemVertex] 
-      #   A GFG vertex that corresponds to a dotted item 
+      # @param aVertex [GFG::ItemVertex]
+      #   A GFG vertex that corresponds to a dotted item
       #   with the dot at the end) for the alternative under consideration.
-      # @param aRange [Lexical::TokenRange] 
+      # @param aRange [Lexical::TokenRange]
       #   A range of token indices corresponding to this node.
       def initialize(aVertex, aRange)
         super(aRange)
@@ -26,14 +28,14 @@ module Rley # This module is used as a namespace
       # Mainly used for diagnosis/debugging purposes.
       # @return [String]
       def to_string(indentation)
-        return "Alt(#{label})#{range.to_string(indentation)}"
+        "Alt(#{label})#{range.to_string(indentation)}"
       end
-      
+
       # Part of the 'visitee' role in Visitor design pattern.
       # @param aVisitor[ParseTreeVisitor] the visitor
       def accept(aVisitor)
         aVisitor.visit_alternative(self)
-      end      
+      end
     end # class
   end # module
 end # module

data/lib/rley/sppf/composite_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'sppf_node'
 
 module Rley # This module is used as a namespace
@@ -7,11 +9,11 @@ module Rley # This module is used as a namespace
     class CompositeNode < SPPFNode
       # @return [Array<SPFFNode>] Sub-nodes (children).
       attr_reader(:subnodes)
-      
-      alias children subnodes      
+
+      alias children subnodes
 
       # Constructor
-      # @param aRange [Lexical::TokenRange]      
+      # @param aRange [Lexical::TokenRange]
       def initialize(aRange)
         super(aRange)
         @subnodes = []
@@ -22,14 +24,14 @@ module Rley # This module is used as a namespace
       def add_subnode(aSubnode)
         subnodes.unshift(aSubnode)
       end
-      
+
       # @return [String] a text representation of the node.
-      def inspect()
+      def inspect
         key
-      end      
+      end
 
       # @return [String]
-      def key()
+      def key
         @key ||= to_string(0)
       end
     end # class

data/lib/rley/sppf/epsilon_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'leaf_node'
 
 module Rley # This module is used as a namespace
@@ -15,14 +17,14 @@ module Rley # This module is used as a namespace
       # Mainly used for diagnosis/debugging purposes.
       # @return [String]
       def to_string(indentation)
-        return "_#{range.to_string(indentation)}"
+        "_#{range.to_string(indentation)}"
       end
-      
+
       # Part of the 'visitee' role in Visitor design pattern.
       # @param aVisitor[ParseTreeVisitor] the visitor
       def accept(aVisitor)
         aVisitor.visit_epsilon(self)
-      end      
+      end
     end # class
   end # module
 end # module

data/lib/rley/sppf/leaf_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'sppf_node'
 
 module Rley # This module is used as a namespace
@@ -6,14 +8,14 @@ module Rley # This module is used as a namespace
     # child node.
     class LeafNode < SPPFNode
       # @return [String] a text representation of the node.
-      def inspect()
+      def inspect
         key
       end
 
       # @return [String]
-      def key()
+      def key
         @key ||= to_string(0)
-      end    
+      end
     end # class
   end # module
 end # module

data/lib/rley/sppf/non_terminal_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'composite_node'
 
 module Rley # This module is used as a namespace

data/lib/rley/sppf/parse_forest.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'token_node'
 require_relative 'non_terminal_node'
 require_relative 'alternative_node'
@@ -5,19 +7,19 @@ require_relative 'alternative_node'
 module Rley # This module is used as a namespace
   module SPPF # This module is used as a namespace
     # In an ambiguous grammar there are valid inputs that can result in multiple
-    # parse trees. A set of parse trees is commonly referred to as a parse 
-    # forest. More specifically a parse forest is a graph data 
+    # parse trees. A set of parse trees is commonly referred to as a parse
+    # forest. More specifically a parse forest is a graph data
     # structure designed to represent a set of equally syntactically correct
     # parse trees. Parse forests generated by Rley are so-called Shared Packed
-    # Parse Forests (SPPF). SPPFs allow very compact representation of parse 
+    # Parse Forests (SPPF). SPPFs allow very compact representation of parse
     # trees by sharing common sub-tree amongst the parse trees.
     class ParseForest
       # The root node of the forest
       attr_reader(:root)
-      
+
       # A Hash with pairs of the kind node key => node
       attr_reader(:key2node)
-      
+
       # A setter that tells that the parse is ambiguous.
       attr_writer(:is_ambiguous)
 
@@ -28,34 +30,34 @@ module Rley # This module is used as a namespace
         @key2node = {}
         @is_ambiguous = false
       end
-      
+
       # Notification that the SPPF construction is over
       def done!
         # Do nothing
       end
-      
+
       # Returns true if the given node is present in the forest.
       def include?(aNode)
-        return key2node.include?(aNode)
+        key2node.include?(aNode)
       end
-      
+
       # Returns true if the parse encountered a structural ambiguity
       # (i.e. more than one parse tree for the given input)
-      def ambiguous?()
-        return @is_ambiguous
+      def ambiguous?
+        @is_ambiguous
       end
-      
-      # Create an Enumerator that helps to iterate over the possible 
-      # parse trees. That enumerator will generate a parse tree when 
+
+      # Create an Enumerator that helps to iterate over the possible
+      # parse trees. That enumerator will generate a parse tree when
       # called with `next` method.
       # @return [Enumerator]
-      def to_ptree_enum()
+      def to_ptree_enum
         # How to implement?
         # One visits the forest => beware of dependency
         # At each visited item create a corresponding  tree node.
         # At end of visit & stack not empty
         # Re-generate another ptree
-      end      
+      end
 
       # Part of the 'visitee' role in the Visitor design pattern.
       #   A visitee is expected to accept the visit from a visitor object
@@ -64,7 +66,7 @@ module Rley # This module is used as a namespace
         aVisitor.start_visit_pforest(self)
 
         # Let's proceed with the visit of nodes
-        root.accept(aVisitor) if root
+        root&.accept(aVisitor)
 
         aVisitor.end_visit_pforest(self)
       end

data/lib/rley/sppf/sppf_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative '../lexical/token_range'
 
 module Rley # This module is used as a namespace
@@ -5,23 +7,22 @@ module Rley # This module is used as a namespace
     # Abstract class. The generalization for all kinds of nodes
     # occurring in a shared packed parse forest (SPPF).
     class SPPFNode
-    
-      # @return [Lexical::TokenRange] 
+      # @return [Lexical::TokenRange]
       # A range of token indices corresponding to this node.
       attr_reader(:range)
-      
+
       # Constructor
       # @param aRange [Lexical::TokenRange]
       def initialize(aRange)
         @range = Lexical::TokenRange.new(aRange)
       end
-      
-      # Return the origin, that is, the index of the 
+
+      # Return the origin, that is, the index of the
       # first token matched by this node.
       # @return [Integer]
-      def origin()
-        return range.low
-      end  
+      def origin
+        range.low
+      end
     end # class
   end # module
 end # module

data/lib/rley/sppf/token_node.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'leaf_node'
 
 module Rley # This module is used as a namespace
@@ -23,14 +25,14 @@ module Rley # This module is used as a namespace
       # @param indentation [Integer]
       # @return [String]
       def to_string(indentation)
-        return "#{token.terminal.name}#{range.to_string(indentation)}"
+        "#{token.terminal.name}#{range.to_string(indentation)}"
       end
-      
+
       # Part of the 'visitee' role in Visitor design pattern.
       # @param aVisitor[ParseTreeVisitor] the visitor
       def accept(aVisitor)
         aVisitor.visit_terminal(self)
-      end      
+      end
     end # class
   end # module
 end # module