loxxy 0.1.17 → 0.2.04

data/bin/loxxy

@@ -3,9 +3,57 @@
 
 require 'loxxy'
 
-if ARGV[0]
-lox = Loxxy::Interpreter.new
-File.open(ARGV[0], 'r') do |f|
-lox.evaluate(f.read)
-end
-end
+class LoxxyRunner
+  DefaultLoxExtension = 'lox'
+  attr_reader(:cli_options)
+
+  def initialize(prog_name, args)
+    my_version = Loxxy::VERSION
+    cli = Loxxy::CLIParser.new(prog_name, my_version)
+    @cli_options = cli.parse!(args)
+  end
+
+  def run!(file_names)
+    return if file_names.nil? || file_names.empty?
+
+    lox = Loxxy::Interpreter.new
+    begin
+      file_names.each do |lox_file|
+        fname = validate_filename(lox_file)
+        next unless file_exist?(fname)
+
+        File.open(fname, 'r') { |f| lox.evaluate(f.read) }
+      end
+    rescue Loxxy::ScanError => e
+      $stderr.puts e.message
+    end
+  end
+
+  private
+
+  def validate_filename(raw_fname)
+    # When necessary add extension to file name
+    fname = raw_fname.dup
+    basename = File.basename(fname)
+    has_extension = basename =~ /(?<=[^.])\.[^.]+$/
+    fname << '.' << DefaultLoxExtension unless has_extension
+
+    fname
+  end
+
+  def file_exist?(fname)
+    exists = File.exist?(fname)
+    $stderr.puts "No such file '#{fname}'" unless exists
+
+    exists
+  end
+end # class
+
+########################################
+# ENTRY POINT
+########################################
+program = LoxxyRunner.new(File.basename(__FILE__), ARGV)
+
+# All options from CLI gobbled from ARGV, remains only file name
+program.run!(ARGV)
+# End of file

data/lib/loxxy.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'loxxy/version'
+require_relative 'loxxy/cli_parser'
 require_relative 'loxxy/interpreter'
 require_relative 'loxxy/front_end/raw_parser'
 

data/lib/loxxy/ast/all_lox_nodes.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'lox_fun_stmt'
+require_relative 'lox_super_expr'
 require_relative 'lox_this_expr'
 require_relative 'lox_variable_expr'
 require_relative 'lox_literal_expr'

data/lib/loxxy/ast/ast_builder.rb

@@ -165,7 +165,14 @@ module Loxxy
 
       # rule('classDecl' => 'CLASS classNaming class_body')
       def reduce_class_decl(_production, _range, _tokens, theChildren)
-        Ast::LoxClassStmt.new(tokens[1].position, theChildren[1], theChildren[2])
+        if theChildren[1].kind_of?(Array)
+          name = theChildren[1].first
+          parent = theChildren[1].last
+        else
+          name = theChildren[1]
+          parent = nil
+        end
+        Ast::LoxClassStmt.new(tokens[1].position, name, parent, theChildren[2])
       end
 
       # rule('classNaming' => 'IDENTIFIER')
@@ -173,6 +180,13 @@ module Loxxy
         theChildren[0].token.lexeme
       end
 
+      # rule('classNaming' => 'IDENTIFIER LESS IDENTIFIER')
+      def reduce_class_subclassing(_production, _range, _tokens, theChildren)
+        super_token = theChildren[2].token
+        super_var = LoxVariableExpr.new(super_token.position, super_token.lexeme)
+        [theChildren[0].token.lexeme, super_var]
+      end
+
       # rule('class_body' => 'LEFT_BRACE methods_opt RIGHT_BRACE')
       def reduce_class_body(_production, _range, _tokens, theChildren)
         theChildren[1].nil? ? [] : theChildren[1]
@@ -368,6 +382,11 @@ module Loxxy
         LoxThisExpr.new(tokens[0].position)
       end
 
+      # rule('primary' => 'SUPER DOT IDENTIFIER')
+      def reduce_super_expr(_production, _range, _tokens, theChildren)
+        LoxSuperExpr.new(theChildren[0].token.position, theChildren[2].token.lexeme)
+      end
+
       # rule('function' => 'IDENTIFIER LEFT_PAREN params_opt RIGHT_PAREN block').as 'function'
       def reduce_function(_production, _range, _tokens, theChildren)
         first_child = theChildren.first

data/lib/loxxy/ast/ast_visitee.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Loxxy
+  module Ast
+    # Mix-in module that relies on meta-programming to add a method
+    # called `accept` to the host class (an AST node).
+    # That method fulfills the expected behavior of the `visitee` in
+    # the Visitor design pattern.
+    module ASTVisitee
+      # Convert the input string into a snake case string.
+      # Example: ClassExpr => class_expr
+      # @param aName [String] input name to convert
+      # @return [String] the name converted into snake case
+      def snake_case(aName)
+        converted = +''
+        down = false
+        aName.each_char do |ch|
+          lower = ch.downcase
+          if lower == ch
+            converted << ch
+            down = true
+          else
+            converted << '_' if down && converted[-1] != '_'
+            converted << lower
+            down = false
+          end
+        end
+
+        converted
+      end
+
+      # This method adds a method named `accept` that takes a visitor
+      # The visitor is expected to implement a method named:
+      # visit + class name (without the Lox prefix) in snake case
+      # Example: class name = LoxClassStmt => visit method = visit_class_stmt
+      def define_accept
+        return if instance_methods(false).include?(:accept)
+
+        base_name = name.split('::').last
+        name_suffix = snake_case(base_name).sub(/^lox/, '')
+        accept_body = <<-MTH_END
+          # Part of the 'visitee' role in Visitor design pattern.
+          # @param visitor [Ast::ASTVisitor] the visitor
+          def accept(aVisitor)
+            aVisitor.visit#{name_suffix}(self)
+          end
+        MTH_END
+
+        class_eval(accept_body)
+      end
+    end # module
+  end # module
+end # module

data/lib/loxxy/ast/ast_visitor.rb

@@ -133,7 +133,7 @@ module Loxxy
 
       # @param aSetExpr [AST::LOXGetExpr] the get expression node to visit
       def visit_set_expr(aSetExpr)
-        broadcast(:before_set_expr, aSetExpr)
+        broadcast(:before_set_expr, aSetExpr, self)
         traverse_subnodes(aSetExpr)
         broadcast(:after_set_expr, aSetExpr, self)
       end
@@ -212,6 +212,13 @@ module Loxxy
         broadcast(:after_this_expr, aThisExpr, self)
       end
 
+      # Visit event. The visitor is about to visit the super keyword.
+      # @param aSuperExpr [Ast::LoxSuperExpr] super expression
+      def visit_super_expr(aSuperExpr)
+        broadcast(:before_super_expr, aSuperExpr)
+        broadcast(:after_super_expr, aSuperExpr, self)
+      end
+
       # Visit event. The visitor is about to visit the given terminal datatype value.
       # @param aValue [Ast::BuiltinDattype] the built-in datatype value
       def visit_builtin(aValue)

data/lib/loxxy/ast/lox_assign_expr.rb

@@ -17,11 +17,7 @@ module Loxxy
         @name = aName
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_assign_expr(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_binary_expr.rb

@@ -16,12 +16,7 @@ module Loxxy
         @operator = anOperator
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_binary_expr(self)
-      end
-
+      define_accept # Add `accept` method as found in Visitor design pattern
       alias operands subnodes
     end # class
   end # module

data/lib/loxxy/ast/lox_block_stmt.rb

@@ -15,11 +15,7 @@ module Loxxy
         subnodes.size == 1 && subnodes[0].nil?
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_block_stmt(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_call_expr.rb

@@ -15,11 +15,7 @@ module Loxxy
         @arguments = argList
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_call_expr(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_class_stmt.rb

@@ -8,23 +8,23 @@ module Loxxy
       # @return [String] the class name
       attr_reader :name
 
+      # @return [Ast::LoxVariableExpr] variable referencing the superclass (if any)
+      attr_reader :superclass
+
       # @return [Array<Ast::LoxFunStmt>] the methods
       attr_reader :body
 
       # @param aPosition [Rley::Lexical::Position] Position of the entry in the input stream.
       # @param condExpr [Loxxy::Ast::LoxNode] iteration condition
       # @param theBody [Array<Loxxy::Ast::LoxNode>]
-      def initialize(aPosition, aName, theMethods)
+      def initialize(aPosition, aName, aSuperclassName, theMethods)
         super(aPosition, [])
         @name = aName.dup
+        @superclass = aSuperclassName
         @body = theMethods
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_class_stmt(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_for_stmt.rb

@@ -25,17 +25,13 @@ module Loxxy
         @update_expr = updateExpr
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_for_stmt(self)
-      end
-
       # Accessor to the condition expression
       # @return [LoxNode]
       def condition
         subnodes[0]
       end
+
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_fun_stmt.rb

@@ -23,11 +23,7 @@ module Loxxy
         @is_method = false
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_fun_stmt(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
     # rubocop: enable Style/AccessorGrouping
   end # module

data/lib/loxxy/ast/lox_get_expr.rb

@@ -18,12 +18,7 @@ module Loxxy
         @property = aPropertyName
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_get_expr(self)
-      end
-
+      define_accept # Add `accept` method as found in Visitor design pattern
       alias callee= object=
     end # class
   end # module

data/lib/loxxy/ast/lox_grouping_expr.rb

@@ -11,11 +11,7 @@ module Loxxy
         super(aPosition, [subExpr])
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_grouping_expr(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_if_stmt.rb

@@ -21,17 +21,13 @@ module Loxxy
         @else_stmt = elseStmt
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_if_stmt(self)
-      end
-
       # Accessor to the condition expression
       # @return [LoxNode]
       def condition
         subnodes[0]
       end
+
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_literal_expr.rb

@@ -15,11 +15,7 @@ module Loxxy
         @literal = aLiteral
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_literal_expr(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module

data/lib/loxxy/ast/lox_logical_expr.rb

@@ -16,12 +16,7 @@ module Loxxy
         @operator = anOperator
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_logical_expr(self)
-      end
-
+      define_accept # Add `accept` method as found in Visitor design pattern
       alias operands subnodes
     end # class
   end # module

data/lib/loxxy/ast/lox_node.rb

@@ -1,8 +1,16 @@
 # frozen_string_literal: true
 
+require_relative 'ast_visitee'
+
 module Loxxy
   module Ast
+    # Abstract class.
+    # Instances of its subclasses represent nodes of an abstract syntax tree
+    # that is the product of the parse of an input text.
     class LoxNode
+      # Let nodes take `visitee` role as defined in the Visitor design pattern
+      extend ASTVisitee
+
       # return [Rley::Lexical::Position] Position of the entry in the input stream.
       attr_reader :position
 
@@ -16,7 +24,7 @@ module Loxxy
         # Default: do nothing ...
       end
 
-      # Abstract method.
+      # Abstract method (must be overriden in subclasses).
       # Part of the 'visitee' role in Visitor design pattern.
       # @param _visitor [LoxxyTreeVisitor] the visitor
       def accept(_visitor)

data/lib/loxxy/ast/lox_print_stmt.rb

@@ -11,11 +11,7 @@ module Loxxy
         super(aPosition, [anExpression])
       end
 
-      # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [Ast::ASTVisitor] the visitor
-      def accept(visitor)
-        visitor.visit_print_stmt(self)
-      end
+      define_accept # Add `accept` method as found in Visitor design pattern
     end # class
   end # module
 end # module