loxxy 0.4.08 → 0.4.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7e447625d999f4b95129d7feff1586c6759cb929a8faaa82e3ecc94105d0268
-  data.tar.gz: 00a4801454ffd09b2d4e810fd15d0f9b40fea13f46e6d4eed7eba4cab8d35ebe
+  metadata.gz: 21a1cbd9499c50fc448238c4b46fabf32add037e813d073df2e88126682076cb
+  data.tar.gz: 54b00da85e3b48be9506ad9f5c52e4844c26491dcf3007a360af2c5a925296d7
 SHA512:
-  metadata.gz: 4a59f746cb7b8086ff3e1252c3fc0846229cb6927dcc4d62ad261c5e0c2fec4b1a75176cab6788cedb5c57a2fe9e7bec94d92d7dc63a2c455609a18761f78043
-  data.tar.gz: 66f72710a3f422e4431c88c44b56419f727711c1fbf339491f1fcb2f8f18edb0f4a21ce49a66ee4325ccf3b2576b0b94490d74f96c922a9d340d476e43660881
+  metadata.gz: a35a3aefa589ba7d2d5d0c3e2f9b21b837855ea46e93817e890649d5a0a8fc7f0d02b3fd2fdf0072c0f2b7ccdd4ad6c77e4c585f7dd08fe6394ee5f08dca23af
+  data.tar.gz: e5d91111f82398021791ef5e6c3f0625e3b16527aec81948dc730381b6da882a86ec7c6a11fd25273c2b8e06efb781421ee2de9b586833f0eb234cbbfcc67982

data/.rubocop.yml

@@ -2,8 +2,16 @@ AllCops:
   Exclude:
     - 'exp/**/*'
     - 'demo/**/*'
+  NewCops: enable
+  SuggestExtensions: false
 
-Gemspec/DateAssignment:
+Gemspec/DeprecatedAttributeAssignment:
+  Enabled: true
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+
+Gemspec/RequireMFA: # new in 1.23
   Enabled: true
 
 Layout/ArgumentAlignment:
@@ -60,117 +68,12 @@ Layout/MultilineMethodCallBraceLayout:
   Enabled: true
   EnforcedStyle: same_line
 
-Layout/SpaceAroundOperators:
-  Enabled: true
-
-Layout/SpaceBeforeBrackets:
-  Enabled: true
-
-Layout/SpaceInsideParens:
-  Enabled: true
-
-Layout/IndentationStyle:
-  Enabled: true
-
-Layout/SpaceAroundMethodCallOperator:
-  Enabled: true
-
-Layout/TrailingEmptyLines:
-  Enabled: true
-
-Layout/TrailingWhitespace:
-  Enabled: true
-
-Lint/AmbiguousAssignment:
-  Enabled: true
-
 Lint/AmbiguousOperatorPrecedence: # new in 1.21
   Enabled: true
 
-Lint/AmbiguousRange:
-  Enabled: true
-
-Lint/DeprecatedConstants:
-  Enabled: true
-
-Lint/DuplicateBranch:
-  Enabled: true
-
-Lint/DuplicateRegexpCharacterClassElement:
-  Enabled: true
-
-Lint/EmptyBlock:
-  Enabled: true
-
 Lint/EmptyClass:
   Enabled: false
 
-Lint/EmptyInPattern:
-  Enabled: true
-
-Lint/IncompatibleIoSelectWithFiberScheduler: # new in 1.21
-  Enabled: true
-
-Lint/LambdaWithoutLiteralBlock:
-  Enabled: true
-
-Lint/Loop:
-  Enabled: true
-
-Lint/NoReturnInBeginEndBlocks:
-  Enabled: true
-
-Lint/NumberedParameterAssignment:
-  Enabled: true
-
-Lint/OrAssignmentToConstant:
-  Enabled: true
-
-Lint/RaiseException:
-  Enabled: true
-
-Lint/RedundantDirGlobSort:
-  Enabled: true
-
-Lint/RequireRelativeSelfPath: # new in 1.22
-  Enabled: true
-
-Lint/RescueException:
-  Enabled: true
-
-Lint/StructNewOverride:
-  Enabled: true
-
-Lint/SymbolConversion:
-  Enabled: true
-
-Lint/ToEnumArguments:
-  Enabled: true
-
-Lint/TripleQuotes:
-  Enabled: true
-
-Lint/UnexpectedBlockArity:
-  Enabled: true
-
-Lint/UnmodifiedReduceAccumulator:
-  Enabled: true
-
-Lint/UnusedMethodArgument:
-  Enabled: true
-
-Lint/UselessAccessModifier:
-  Enabled: true
-
-Lint/UselessRuby2Keywords: # new in 1.23
-  Enabled: true
-
-Lint/Void:
-  Enabled: false
-
-Lint/UselessAssignment:
-  Enabled: true
-
 Metrics/AbcSize:
   Enabled: false
 
@@ -204,21 +107,12 @@ Metrics/ModuleLength:
 Metrics/PerceivedComplexity:
   Enabled: false
 
-Naming/BlockForwarding: # new in 1.24
-  Enabled: true
-
 Naming/ConstantName:
   Enabled: false
 
 Naming/ClassAndModuleCamelCase:
   Enabled: false
 
-Naming/BlockParameterName:
-  Enabled: true
-
-Naming/InclusiveLanguage:
-  Enabled: true
-
 Naming/MethodParameterName:
   Enabled: false
 
@@ -228,15 +122,6 @@ Naming/MethodName:
 Naming/VariableName:
   Enabled: false
 
-Security/IoMethods: # new in 1.22
-  Enabled: true
-
-Style/Alias:
-  Enabled: true
-
-Style/ArgumentsForwarding:
-  Enabled: true
-
 Style/AsciiComments:
   Enabled: false
 
@@ -255,9 +140,6 @@ Style/ClassCheck:
 Style/ClassVars:
   Enabled: false
 
-Style/CollectionCompact:
-  Enabled: true
-
 Style/ColonMethodCall:
   Enabled: false
 
@@ -270,223 +152,69 @@ Style/CommentedKeyword:
 Style/ConditionalAssignment:
   Enabled: false
 
-Style/DefWithParentheses:
-  Enabled: true
-
 Style/Documentation:
   Enabled: false
 
-Style/DocumentDynamicEvalDefinition:
-  Enabled: true
-
 Style/ExpandPathArguments:
   Enabled: false
 
-Style/ExponentialNotation:
-  Enabled: true
-
 Style/GuardClause:
   Enabled: false
 
-Style/HashEachMethods:
-  Enabled: true
-
-Style/HashExcept:
-  Enabled: true
-
-Style/HashTransformKeys:
-  Enabled: true
-
-Style/HashTransformValues:
-  Enabled: true
-
 Style/IfUnlessModifier:
   Enabled: false
 
-Style/InPatternThen:
-  Enabled: true
-
 Style/InverseMethods:
   Enabled: false
 
 Style/MissingRespondToMissing:
   Enabled: false
 
-Style/MultilineInPatternThen:
-  Enabled: true
-
-Style/NegatedIfElseCondition:
-  Enabled: true
-
 Style/Next:
   Enabled: false
 
-Style/NilLambda:
-  Enabled: true
-
-Style/NumberedParameters: # new in 1.22
-  Enabled: true
-
-Style/NumberedParametersLimit: # new in 1.22
-  Enabled: true
-
 Style/NumericLiterals:
   Enabled: false
 
-Style/QuotedSymbols:
-  Enabled: true
-
-Style/RaiseArgs:
-  Enabled: true
-
-Style/RedundantArgument:
-  Enabled: true
-
 Style/RedundantReturn:
   Enabled: false
 
-Style/RedundantSelf:
-  Enabled: true
-
-Style/RedundantSelfAssignmentBranch:
-  Enabled: true
-
 Style/RegexpLiteral:
   Enabled: false
 
 Style/PercentLiteralDelimiters:
   Enabled: false
 
-Style/SelectByRegexp: # new in 1.22
-  Enabled: true
-
 Style/StderrPuts:
   Enabled: false
 
-Style/StringLiterals:
-  Enabled: true
-
-Style/SwapValues:
-  Enabled: true
-
 Style/TernaryParentheses:
   Enabled: false
 
 Style/UnlessElse:
   Enabled: false
 
-# Rubocop complains when it doesn't find an explicit setting for the following cops:
-Layout/EmptyLinesAroundAttributeAccessor:
-  Enabled: true
-
-Lint/BinaryOperatorWithIdenticalOperands:
-  Enabled: true
-
-Lint/DeprecatedOpenSSLConstant:
-  Enabled: true
-
-Lint/DuplicateElsifCondition:
-  Enabled: true
-
-Lint/DuplicateRescueException:
-  Enabled: true
-
-Lint/EmptyConditionalBody:
-  Enabled: true
-
-Lint/FloatComparison:
-  Enabled: true
-
-Lint/MissingSuper:
-  Enabled: true
-
-Lint/MixedRegexpCaptureTypes:
-  Enabled: true
-
-Lint/OutOfRangeRegexpRef:
-  Enabled: true
-
-Lint/SelfAssignment:
-  Enabled: true
-
-Lint/TopLevelReturnWithArgument:
-  Enabled: true
-
-Lint/UnreachableLoop:
-  Enabled: true
-
-Style/AccessorGrouping:
-  Enabled: true
-
-Style/ArrayCoercion:
-  Enabled: true
-
-Style/BisectedAttrAccessor:
-  Enabled: true
-
-Style/CaseLikeIf:
-  Enabled: true
-
-Style/EndlessMethod:
-  Enabled: true
-
-Style/ExplicitBlockArgument:
-  Enabled: true
-
-Style/FileRead: # new in 1.24
-  Enabled: true
-
-Style/FileWrite: # new in 1.24
-  Enabled: true
-
-Style/GlobalStdStream:
-  Enabled: true
-
-Style/HashAsLastArrayItem:
-  Enabled: true
-
-Style/HashConversion:
-  Enabled: true
-
-Style/HashLikeCase:
-  Enabled: true
-  
-Style/IfWithBooleanLiteralBranches:
-  Enabled: true
-  
-Style/MapToHash: # new in 1.24
-  Enabled: true 
-
-Style/OpenStructUse: # new in 1.23
-  Enabled: true  
-
-Style/OptionalBooleanParameter:
-  Enabled: true
-  
-
-Style/RedundantAssignment:
-  Enabled: true
-
-Style/RedundantFetchBlock:
-  Enabled: true
-
-Style/RedundantFileExtensionInRequire:
-  Enabled: true
-
-Style/RedundantRegexpCharacterClass:
-  Enabled: true
-
-Style/RedundantRegexpEscape:
-  Enabled: true
-
-Style/SingleArgumentDig:
-  Enabled: true
-
-Style/SlicingWithRange:
-  Enabled: true
-
-Style/StringChars:
-  Enabled: true
-
-Style/StringConcatenation:
-  Enabled: true
+## Optional rubocop-rspec plugin rule checking
+#RSpec/ContextWording:
+#  Enabled: false
+#
+#RSpec/DescribeClass:
+#  Enabled: false
+#
+#RSpec/ExampleLength:
+#  Max: 40
+#
+#RSpec/MultipleExpectations:
+#  Max: 25
+#
+#RSpec/NoExpectationExample:
+#  Enabled: false
+#
+#RSpec/RepeatedDescription:
+#  Enabled: false
+#
+#RSpec/RepeatedExample:
+#  Enabled: false
+#
+#RSpec/RepeatedExampleGroupDescription:
+#  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.4.10] - 2025-0x-xx
+- Tested with Rley 0.9.02 and Rubocop 1.74
+
+## [0.4.09] - 2025-01-16
+- Tested with MRI Ruby 3.4.1.
+- Minor changes
+- [NEW] Added `demo` folder
+- [FIX] Some Rubocop 1.72.0 offences fixed.
+
 ## [0.4.08] - 2022-04-09
 - Refactoring of the `Scanner` class.
 
@@ -14,7 +23,6 @@
 - File `duplicate_local.lox` Fixed typo in error message.
 - File `duplicate_parameter.lox` Fixed typo in error message.
 
-
 ## [0.4.06] - 2021-11-01
 - Code update to cope with `Rley` v.0.8.08 changes
 

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020-2022 Dimitri Geshef
+Copyright (c) 2020-2025 Dimitri Geshef
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -19,8 +19,8 @@ Although __Lox__ is fairly simple, it is far from being a toy language:
 ### Loxxy gem features
 - Complete tree-walking interpreter including lexer, parser and resolver
 - 100% pure Ruby with clean design (not a port from some other language)
-- Passes the `jox` (THE reference `Lox` implementation) test suite
-- Can run a Lox imterpreter implemented in ... `Lox` [LoxLox](https://github.com/benhoyt/loxlox),
+- Passes the `jlox` (THE reference `Lox` implementation) test suite
+- Can run a Lox interpreter implemented in ... `Lox` [LoxLox](https://github.com/benhoyt/loxlox),
 - Minimal runtime dependency (Rley gem). Won't drag a bunch of gems...  
 - Ruby API for integrating a Lox interpreter with your code.
 - A command-line interpreter `loxxy`
@@ -55,7 +55,7 @@ And then execute:
 Create a text file and enter the following lines:
 ```javascript
 // hello.lox
-// Your firs Lox program
+// Your first Lox program
 print "Hello, world.";
 ```
 
@@ -326,7 +326,9 @@ lox_input = <<-LOX_END
   print "Hello, world!";
 LOX_END
 
-
+lox = Loxxy::Interpreter.new
+lox.evaluate(lox_program) # => Hello, world!
+```
 
 ## Suppported Lox language features
 

data/lib/loxxy/ast/ast_builder.rb

@@ -47,7 +47,7 @@ module Loxxy
       # Create a new AST builder instance.
       # @param theTokens [Array<Rley::Lexical::Token>] The sequence of input tokens.
       def initialize(theTokens)
-        super(theTokens)
+        super
         @strict = false
       end
 
@@ -188,7 +188,7 @@ module Loxxy
       # rule('varDecl' => 'VAR IDENTIFIER (EQUAL expression)? SEMICOLON')
       def reduce_var_declaration(_production, _range, tokens, theChildren)
         var_name = theChildren[1].token.lexeme.dup
-        init_val = theChildren[2] ? theChildren[2].last : nil
+        init_val = theChildren[2]&.last
         Ast::LoxVarStmt.new(tokens[1].position, var_name, init_val)
       end
 
@@ -260,7 +260,7 @@ module Loxxy
 
       # rule('returnStmt' => 'RETURN expression? SEMICOLON')
       def reduce_return_stmt(_production, _range, tokens, theChildren)
-        ret_expr = theChildren[1].nil? ? nil : theChildren[1].first
+        ret_expr = theChildren[1]&.first
         Ast::LoxReturnStmt.new(tokens[1].position, ret_expr)
       end
 

data/lib/loxxy/back_end/engine.rb

@@ -446,6 +446,7 @@ module Loxxy
         add_native_fun('print_error', native_print_error)
       end
 
+      # rubocop: disable Lint/UselessConstantScoping
       NativeFunction = Struct.new(:callable, :interp) do
         def accept(_visitor)
           interp.expr_stack.push self
@@ -459,6 +460,7 @@ module Loxxy
           '<native fn>'
         end
       end
+      # rubocop: enable Lint/UselessConstantScoping
 
       def add_native_fun(aName, aProc)
         native_fun = Variable.new(aName, NativeFunction.new(aProc, self))

data/lib/loxxy/back_end/environment.rb

@@ -49,7 +49,7 @@ module Loxxy
       # Returns a string with a human-readable representation of the object.
       # @return [String]
       def inspect
-        +"#<#{self.class}:#{object_id.to_s(16)}>"
+        "#<#{self.class}:#{object_id.to_s(16)}>"
       end
 
       private

data/lib/loxxy/back_end/resolver.rb

@@ -178,7 +178,6 @@ module Loxxy
         resolve_local(aThisExpr, aVisitor)
       end
 
-      # rubocop: disable Style/CaseLikeIf
       # rubocop: disable Style/StringConcatenation
       def after_super_expr(aSuperExpr, aVisitor)
         msg_prefix = "Error at 'super': Can't use 'super' "
@@ -195,7 +194,6 @@ module Loxxy
         resolve_local(aSuperExpr, aVisitor)
       end
       # rubocop: enable Style/StringConcatenation
-      # rubocop: enable Style/CaseLikeIf
 
       # function declaration creates a new scope for its body & binds its parameters for that scope
       def before_fun_stmt(aFunStmt, aVisitor)

data/lib/loxxy/datatype/number.rb

@@ -63,7 +63,6 @@ module Loxxy
       # one Lox number and a Ruby Numeric
       # @param other [Loxxy::Datatype::Number, Numeric]
       # @return [Loxxy::Datatype::Number]
-      # rubocop: disable Lint/BinaryOperatorWithIdenticalOperands
       def /(other)
         case other
         when Number, Numeric
@@ -84,7 +83,6 @@ module Loxxy
           raise TypeError, err_msg
         end
       end
-      # rubocop: enable Lint/BinaryOperatorWithIdenticalOperands
 
       # Unary minus (return value with changed sign)
       # @return [Loxxy::Datatype::Number]

data/lib/loxxy/front_end/scanner.rb

@@ -20,14 +20,14 @@ module Loxxy
     # Delimiters: e.g. parentheses '(',  ')'
     # Separators: e.g. comma
     class Scanner
-      PATT_BLOCK_COMMENT_BEGIN = /\/\*/.freeze
-      PATT_BLOCK_COMMENT_END = /\*\//.freeze
-      PATT_COMPARISON = /[!=><]=?/.freeze
-      PATT_IDENTIFIER = /[a-zA-Z_][a-zA-Z_0-9]*/.freeze
-      PATT_LINE_COMMENT = /\/\/[^\r\n]*/.freeze
-      PATT_NEWLINE = /(?:\r\n)|\r|\n/.freeze
-      PATT_NUMBER = /\d+(?:\.\d+)?/.freeze
-      PATT_WHITESPACE = /[ \t\f]+/.freeze
+      PATT_BLOCK_COMMENT_BEGIN = /\/\*/
+      PATT_BLOCK_COMMENT_END = /\*\//
+      PATT_COMPARISON = /[!=><]=?/
+      PATT_IDENTIFIER = /[a-zA-Z_][a-zA-Z_0-9]*/
+      PATT_LINE_COMMENT = /\/\/[^\r\n]*/
+      PATT_NEWLINE = /(?:\r\n)|\r|\n/
+      PATT_NUMBER = /\d+(?:\.\d+)?/
+      PATT_WHITESPACE = /[ \t\f]+/
 
       # @return [StringScanner] Low-level input scanner
       attr_reader(:scanner)
@@ -67,7 +67,7 @@ module Loxxy
       @@keywords = %w[
         and class else false fun for if nil or
         print return super this true var while
-      ].map { |x| [x, x] }.to_h
+      ].to_h { |x| [x, x] }
 
       # Single character that have a special meaning when escaped
       # @return [{Char => String}]
@@ -148,7 +148,7 @@ module Loxxy
               elsif (lexeme = scanner.scan(PATT_COMPARISON))
                 # One or two special character tokens
                 build_token(Lexeme2name[lexeme], lexeme)
-              elsif scanner.scan(/"/) # Start of string detected...
+              elsif scanner.scan('"') # Start of string detected...
                 build_string_token
               elsif (lexeme = scanner.scan(PATT_NUMBER))
                 build_token('NUMBER', lexeme)

data/lib/loxxy/interpreter.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative './front_end/parser'
-require_relative './ast/ast_visitor'
-require_relative './back_end/engine'
+require_relative 'front_end/parser'
+require_relative 'ast/ast_visitor'
+require_relative 'back_end/engine'
 
 module Loxxy
   # A Lox tree-walking interpreter.

data/lib/loxxy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Loxxy
-  VERSION = '0.4.08'
+  VERSION = '0.4.10'
 end

data/loxxy.gemspec

@@ -10,12 +10,10 @@ module PkgExtending
     file_list = Dir[
       '.rubocop.yml',
       '.rspec',
-      '.travis.yml',
       '.yardopts',
       'Gemfile',
       'Rakefile',
       'CHANGELOG.md',
-      'CODE_OF_CONDUCT.md',
       'LICENSE.txt',
       'README.md',
       'loxxy.gemspec',
@@ -44,11 +42,13 @@ Gem::Specification.new do |spec|
   spec.description   = <<-DESCR_END
   A Ruby implementation of the Lox programming language. Lox is a dynamically typed,
   object-oriented programming language that features first-class functions, closures,
-  classes, and inheritance.
+  classes, and inheritance. The interpreter passes all unit tests from the original Java implementation.
+  It is also able to run `LoxLox` a Lox interpreter written in Lox itself.
   DESCR_END
   spec.homepage      = 'https://github.com/famished-tiger/loxxy'
   spec.license       = 'MIT'
-  spec.required_ruby_version = '>= 2.5'
+  spec.required_ruby_version = '>= 3.1'
+  spec.metadata = { 'rubygems_mfa_required' => 'true' }
 
   spec.bindir        = 'bin'
   spec.executables   = ['loxxy']
@@ -58,10 +58,10 @@ Gem::Specification.new do |spec|
   PkgExtending.pkg_documentation(spec)
 
   # Runtime dependencies
-  spec.add_dependency 'rley', '~> 0.8.08'
+  spec.add_dependency 'rley', '~> 0.9', '>= 0.9.02'
 
   # Development dependencies
-  spec.add_development_dependency 'bundler', '~> 2.0'
-  spec.add_development_dependency 'rake', '~> 12.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'bundler', '~> 2.4', '>= 2.4.1'
+  spec.add_development_dependency 'rake', '~> 13'
+  spec.add_development_dependency 'rspec', '~> 3', '>= 3.10.0'
 end