rley 0.3.04 → 0.3.05

data/lib/rley/ptree/non_terminal_node.rb

@@ -1,4 +1,4 @@
-require_relative 'parse_tree_node'  # Load superclass
+require_relative 'parse_tree_node' # Load superclass
 
 module Rley # This module is used as a namespace
   module PTree # This module is used as a namespace

data/lib/rley/ptree/token_range.rb

@@ -6,8 +6,8 @@ module Rley # This module is used as a namespace
     # let's assume that the integer literal '3' is the fifth input token and
     # that the '+' and '11' tokens are respectively at position 6 and 7;
     # then the token range associated with E is [5, 7]
-    # While the parse tree/forest is being constructed the boundaries of the token range
-    # can be temporarily undefined (= set to nil)
+    # While the parse tree/forest is being constructed the boundaries of the 
+    # token range can be temporarily undefined (= set to nil)
     class TokenRange
       # The index of the lower bound of token range
       attr_reader(:low)

data/lib/rley/sppf/alternative_node.rb

@@ -1,34 +1,32 @@
-require_relative 'composite_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # A node in a parse forest that is a child
-    # of a parent node with :or refinement
-    class AlternativeNode < CompositeNode
-    
-      # GFG vertex label
-      attr_reader(:label)
-      
-      # Link to lhs symbol
-      attr_reader(:symbol)
-      
-      # @param aVertex [ItemVertex] An GFG vertex that corresponds 
-      # a dotted item (with the dot at the end)for the alternative under
-      # consideration.
-      # @param aRange [TokenRange]
-      def initialize(aVertex, aRange)
-        super(aRange)
-        @label = aVertex.label
-        @symbol = aVertex.dotted_item.lhs
-      end
-
-      # Emit a (formatted) string representation of the node.
-      # Mainly used for diagnosis/debugging purposes.
-      def to_string(indentation)
-        return "Alt(#{label})#{range.to_string(indentation)}"
-      end
-
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'composite_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # A node in a parse forest that is a child
+    # of a parent node with :or refinement
+    class AlternativeNode < CompositeNode
+      # GFG vertex label
+      attr_reader(:label)
+
+      # Link to lhs symbol
+      attr_reader(:symbol)
+
+      # @param aVertex [ItemVertex] An GFG vertex that corresponds
+      # a dotted item (with the dot at the end)for the alternative under
+      # consideration.
+      # @param aRange [TokenRange]
+      def initialize(aVertex, aRange)
+        super(aRange)
+        @label = aVertex.label
+        @symbol = aVertex.dotted_item.lhs
+      end
+
+      # Emit a (formatted) string representation of the node.
+      # Mainly used for diagnosis/debugging purposes.
+      def to_string(indentation)
+        return "Alt(#{label})#{range.to_string(indentation)}"
+      end
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/sppf/composite_node.rb

@@ -1,27 +1,27 @@
-require_relative 'sppf_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # Abstract class. The generalization for nodes that have
-    # children node(s).
-    class CompositeNode < SPPFNode
-      # Array of sub-nodes. 
-      attr_reader(:subnodes)
-      
-      def initialize(aRange)
-        super(aRange)
-        @subnodes = []
-      end
-      
-      
-      def add_subnode(aSubnode)
-        subnodes.unshift(aSubnode)
-      end
-      
-      def key()
-        @key ||= to_string(0)
-      end
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'sppf_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # Abstract class. The generalization for nodes that have
+    # children node(s).
+    class CompositeNode < SPPFNode
+      # Array of sub-nodes.
+      attr_reader(:subnodes)
+
+      def initialize(aRange)
+        super(aRange)
+        @subnodes = []
+      end
+
+
+      def add_subnode(aSubnode)
+        subnodes.unshift(aSubnode)
+      end
+
+      def key()
+        @key ||= to_string(0)
+      end
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/sppf/epsilon_node.rb

@@ -1,27 +1,26 @@
-require_relative 'leaf_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # A leaf node in a parse forest that matches an empty
-    # string from the input
-    class EpsilonNode < LeafNode
-      
-      # aPosition is the position of the token in the input stream.
-      def initialize(aPosition)
-        range = {low: aPosition, high: aPosition}
-        super(range)
-      end
-      
-      # Emit a (formatted) string representation of the node.
-      # Mainly used for diagnosis/debugging purposes.
-      def to_string(indentation)
-        return "_#{range.to_string(indentation)}"
-      end
-      
-      def key()
-        @key ||= to_string(0)
-      end
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'leaf_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # A leaf node in a parse forest that matches an empty
+    # string from the input
+    class EpsilonNode < LeafNode
+      # aPosition is the position of the token in the input stream.
+      def initialize(aPosition)
+        range = { low: aPosition, high: aPosition }
+        super(range)
+      end
+
+      # Emit a (formatted) string representation of the node.
+      # Mainly used for diagnosis/debugging purposes.
+      def to_string(indentation)
+        return "_#{range.to_string(indentation)}"
+      end
+
+      def key()
+        @key ||= to_string(0)
+      end
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/sppf/leaf_node.rb

@@ -1,12 +1,11 @@
-require_relative 'sppf_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # Abstract class. The generalization for nodes that don't have
-    # child node.
-    class LeafNode < SPPFNode
-      
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'sppf_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # Abstract class. The generalization for nodes that don't have
+    # child node.
+    class LeafNode < SPPFNode
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/sppf/non_terminal_node.rb

@@ -1,38 +1,37 @@
-require_relative 'composite_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # A node in a parse forest that matches exactly one
-    # non-terminal symbol
-    class NonTerminalNode < CompositeNode
-      # Link to the non-terminal symbol
-      attr_reader(:symbol)
-
-      # Indication on how the sub-nodes contribute to the 'success'
-      # of parent node. Possible values: :and, :or
-      attr_accessor :refinement
-
-      def initialize(aNonTerminal, aRange)
-        super(aRange)
-        @symbol = aNonTerminal
-        @refinement = :and
-      end
-      
-      def add_subnode(aSubnode)
-        if refinement == :or
-          subnodes << aSubnode        
-        else
-          super(aSubnode)
-        end
-      end      
-
-      # 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)}"
-      end
-
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'composite_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # A node in a parse forest that matches exactly one
+    # non-terminal symbol
+    class NonTerminalNode < CompositeNode
+      # Link to the non-terminal symbol
+      attr_reader(:symbol)
+
+      # Indication on how the sub-nodes contribute to the 'success'
+      # of parent node. Possible values: :and, :or
+      attr_accessor :refinement
+
+      def initialize(aNonTerminal, aRange)
+        super(aRange)
+        @symbol = aNonTerminal
+        @refinement = :and
+      end
+
+      def add_subnode(aSubnode)
+        if refinement == :or
+          subnodes << aSubnode
+        else
+          super(aSubnode)
+        end
+      end
+
+      # 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)}"
+      end
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/sppf/sppf_node.rb

@@ -21,4 +21,4 @@ module Rley # This module is used as a namespace
     end # class
   end # module
 end # module
-# End of file
+# End of file

data/lib/rley/sppf/token_node.rb

@@ -1,29 +1,29 @@
-require_relative 'leaf_node'
-
-module Rley # This module is used as a namespace
-  module SPPF # This module is used as a namespace
-    # A node in a parse forest that matches exactly one
-    # token from the input
-    class TokenNode < LeafNode
-      attr_reader(:token)
-      
-      # aPosition is the position of the token in the input stream.
-      def initialize(aToken, aPosition)
-        range = {low: aPosition, high: aPosition + 1}
-        super(range)
-        @token = aToken
-      end
-      
-      # Emit a (formatted) string representation of the node.
-      # Mainly used for diagnosis/debugging purposes.
-      def to_string(indentation)
-        return "#{token.terminal.name}#{range.to_string(indentation)}"
-      end
-      
-      def key()
-        @key ||= to_string(0)
-      end
-    end # class
-  end # module
-end # module
-# End of file
+require_relative 'leaf_node'
+
+module Rley # This module is used as a namespace
+  module SPPF # This module is used as a namespace
+    # A node in a parse forest that matches exactly one
+    # token from the input
+    class TokenNode < LeafNode
+      attr_reader(:token)
+
+      # aPosition is the position of the token in the input stream.
+      def initialize(aToken, aPosition)
+        range = { low: aPosition, high: aPosition + 1 }
+        super(range)
+        @token = aToken
+      end
+
+      # Emit a (formatted) string representation of the node.
+      # Mainly used for diagnosis/debugging purposes.
+      def to_string(indentation)
+        return "#{token.terminal.name}#{range.to_string(indentation)}"
+      end
+
+      def key()
+        @key ||= to_string(0)
+      end
+    end # class
+  end # module
+end # module
+# End of file

data/lib/rley/syntax/grammar.rb

@@ -53,7 +53,7 @@ module Rley # This module is used as a namespace
       # Validation method. Return the validated list of productions
       def validate_productions(theProductions)
         msg = 'A grammar must have at least one production'
-        fail StandardError, msg if theProductions.nil? || theProductions.empty?
+        raise StandardError, msg if theProductions.nil? || theProductions.empty?
         return theProductions
       end
 
@@ -112,8 +112,6 @@ module Rley # This module is used as a namespace
         return nullable
       end
 
-      private
-
       def add_symbol(aSymbol)
         its_name = aSymbol.name
         return if name2symbol.include? its_name

data/lib/rley/syntax/grammar_builder.rb

@@ -70,16 +70,16 @@ module Rley # This module is used as a namespace
       # build the resulting grammar (if not yet done).
       def grammar()
         unless @grammar
-          fail StandardError, 'No symbol found for grammar' if symbols.empty?
+          raise StandardError, 'No symbol found for grammar' if symbols.empty?
           if productions.empty?
-            fail StandardError, 'No production found for grammar'
+            raise StandardError, 'No production found for grammar'
           end
           
           # Check that each non-terminal appears at least once in lhs.
           all_non_terminals = symbols.values.select { |s| s.is_a?(NonTerminal) }
           all_non_terminals.each do |n_term|
             next if productions.any? { |prod| n_term == prod.lhs }
-            fail StandardError, "Nonterminal #{n_term.name} not rewritten"
+            raise StandardError, "Nonterminal #{n_term.name} not rewritten"
           end
 
           @grammar = Grammar.new(productions.dup)
@@ -114,11 +114,11 @@ module Rley # This module is used as a namespace
       # @param aSymbolArg [GrmSymbol-like or String]
       # @return [Array] list of grammar symbols
       def build_symbol(aClass, aSymbolArg)
-        if aSymbolArg.kind_of?(GrmSymbol)
-          a_symbol = aSymbolArg
-        else
-          a_symbol = aClass.new(aSymbolArg)
-        end
+        a_symbol = if aSymbolArg.kind_of?(GrmSymbol)
+                      aSymbolArg
+                   else
+                      aClass.new(aSymbolArg)
+                   end
 
         return a_symbol
       end

data/lib/rley/syntax/non_terminal.rb

@@ -6,15 +6,13 @@ module Rley # This module is used as a namespace
     # a composition of terminal or non-terminal symbols
     class NonTerminal < GrmSymbol
       attr_writer(:nullable)
-    
+
       # Constructor.
       # @param aName [String] The name of the grammar symbol.
       def initialize(aName)
         super(aName)
       end
-      
-      public
-      
+
       # @return [false/true] Return true if the symbol derives
       # the empty string. As non-terminal symbol is nullable when it can
       # can match to zero input token.

data/lib/rley/syntax/production.rb

@@ -18,8 +18,8 @@ module Rley # This module is used as a namespace
 
       # Provide common alternate names to lhs and rhs accessors
 
-      alias_method :body, :rhs
-      alias_method :head, :lhs
+      alias body rhs
+      alias head lhs
 
       def initialize(aNonTerminal, theSymbols)
         @lhs = valid_lhs(aNonTerminal)
@@ -40,7 +40,7 @@ module Rley # This module is used as a namespace
         unless aNonTerminal.kind_of?(NonTerminal)
           msg_prefix = 'Left side of production must be a non-terminal symbol'
           msg_suffix = ", found a #{aNonTerminal.class} instead."
-          fail StandardError, msg_prefix + msg_suffix
+          raise StandardError, msg_prefix + msg_suffix
         end
 
         return aNonTerminal