rley 0.8.08 → 0.8.09

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55b425fac78001960b95935a8dc8de88d1c0826bea5fba5fae72455f53cb084a
-  data.tar.gz: fdf0f9ed39985923134cd3ecc4bdd9325c9aab783437ab1d61a07e333ad3f2eb
+  metadata.gz: 9734bc9875c8931a5cd5c5497df1a77a3c938076c86d2748557b8ec901d09de6
+  data.tar.gz: 20a2a6a9b88752645cf731f6790b7f89729fb108f13701048a6cc8a2c65521f6
 SHA512:
-  metadata.gz: e63b7a5df081fa326b48f7f2e2cedbaf877ed377927e408278e3c8078a30fdcc69714ff234ba98dccc1eb3b05eaea53ebb39846a43e2cb794b883d91ce1c6953
-  data.tar.gz: e60bc7b045fe8d7203ddf26ecd603646137d43cbbbe79b533b2088c0f7d15bb46bc1dd58ae4d811ba8d78327fdcb0045cfddec4d708a76968d33c1602bf71cf4
+  metadata.gz: e203c3d6cf1b4f8b32a16af06ffe2a4548f8a53c37a2677fd13e8b3695a1e482f7d46177b3861d0b5c5b6139827133d09d1213821a7ec91b8dd805fcf3eac4dd
+  data.tar.gz: 43be3973376040fed3a9db55207d68171a0a6084ad9a102abcd26f47d60600c8aa9165a134c67b0f443e73e4e0cdd2d5a65e5271f63081a21f83aea0550b4474

data/.rubocop.yml

@@ -5,6 +5,9 @@ AllCops:
 Gemspec/DateAssignment:
   Enabled: true
 
+Gemspec/RequireMFA: # new in 1.23
+  Enabled: false
+
 Layout/ArgumentAlignment:
   Enabled: false
 
@@ -161,6 +164,9 @@ Lint/UnusedMethodArgument:
 Lint/UselessAccessModifier:
   Enabled: true
 
+Lint/UselessRuby2Keywords: # new in 1.23
+  Enabled: true
+
 Lint/Void:
   Enabled: false
 
@@ -200,6 +206,9 @@ Metrics/ModuleLength:
 Metrics/PerceivedComplexity:
   Enabled: false
 
+Naming/BlockForwarding: # new in 1.24
+  Enabled: true
+
 Naming/ConstantName:
   Enabled: false
 
@@ -278,6 +287,12 @@ Style/ExpandPathArguments:
 Style/ExponentialNotation:
   Enabled: true
 
+Style/FileRead: # new in 1.24
+  Enabled: true
+
+Style/FileWrite: # new in 1.24
+  Enabled: true
+
 Style/GuardClause:
   Enabled: false
 
@@ -302,6 +317,9 @@ Style/InPatternThen:
 Style/InverseMethods:
   Enabled: false
 
+Style/MapToHash: # new in 1.24
+  Enabled: true
+
 Style/MissingRespondToMissing:
   Enabled: false
 
@@ -326,6 +344,9 @@ Style/NumberedParametersLimit:
 Style/NumericLiterals:
   Enabled: false
 
+Style/OpenStructUse: # new in 1.23
+  Enabled: true
+
 Style/QuotedSymbols:
   Enabled: true
 
@@ -349,9 +370,9 @@ Style/RegexpLiteral:
 
 Style/PercentLiteralDelimiters:
   Enabled: false
-  
+
 Style/SelectByRegexp:
-  Enabled: true  
+  Enabled: true
 
 Style/StderrPuts:
   Enabled: false

data/CHANGELOG.md

@@ -1,7 +1,14 @@
+### 0.8.09 / 2022-01-28
+- Added code for coming tutorial
+
+* [NEW] Folder `tutorial` contains code used in tutorial (in wiki)
+* [NEW] Folders `TOML\iter_1` .. `TOML\iter_2` contains code for a TOML parser
+* [CHANGE] File `.rubocop.yml` updated to take into account new 1.25 cops.
+* [CHANGE] File `.rubocop.yml` updated to take into account new 1.25 cops.
+
 ### 0.8.08 / 2021-10-31
 - Fixes in example files, Refactored module `Notation` renamed `to `RGN´
 
-
 * [CHANGE] Module `Notation` changed to `RGN`.
 
 * [FIX] `examples/general/calc_iter1/CalcLexer#initialize` now strips whitespaces at end of expression to parse.
@@ -21,7 +28,7 @@
 
 * [NEW] Folder `example\tokenizer` contains an example with a scanner that was generated.
 * [NEW] Class `Rley::Lexical::Literal` a specialization of Token class for literal tokens.
-* [CHANGE] File `.rubocp.yml` updated to take into account new 1.21 and 1.22 cops.
+* [CHANGE] File `.rubocop.yml` updated to take into account new 1.21 and 1.22 cops.
 * [DELETED] Class `Rley::Parser::ParserTracer` this class was no more in use.
 * [DELETED] Class `Rley::Syntax::Literal` this class was unused.
 * [DELETED] Class `Rley::Syntax::VerbatimSymbol` this class was unused.

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2021 Dimitri Geshef
+Copyright (c) 2014-2022 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

@@ -458,5 +458,5 @@ standard parser textbooks. Here are a few references (and links) of papers on GF
 
 Copyright
 ---------
-Copyright (c) 2014-2020, Dimitri Geshef.  
+Copyright (c) 2014-2022, Dimitri Geshef.  
 __Rley__ is released under the MIT License see [LICENSE.txt](https://github.com/famished-tiger/Rley/blob/master/LICENSE.txt) for details.

data/lib/rley/constants.rb

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

data/lib/rley/rgn/ast_node.rb

@@ -36,7 +36,7 @@ module Rley
 
       # Abstract method (must be overriden in subclasses).
       # Part of the 'visitee' role in Visitor design pattern.
-      # @param _visitor [LoxxyTreeVisitor] the visitor
+      # @param _visitor [ASTVisitor] the visitor
       def accept(_visitor)
         raise NotImplementedError
       end

data/lib/rley/rgn/parser.rb

@@ -35,9 +35,9 @@ module Rley
         @engine.use_grammar(Rley::RGN::RGNGrammar)
       end
 
-      # Parse the given Lox program into a parse tree.
-      # @param source [String] Lox program to parse
-      # @return [Rley::ParseTree] A parse tree equivalent to the Lox input.
+      # Parse the given RGN snippet into a parse tree.
+      # @param source [String] Snippet to parse
+      # @return [Rley::ParseTree] A parse tree equivalent to the RGN input.
       def parse(source)
         lexer = Tokenizer.new(source)
         result = engine.parse(lexer.tokens)

data/lib/rley/rgn/symbol_node.rb

@@ -28,7 +28,7 @@ module Rley
 
       # Abstract method (must be overriden in subclasses).
       # Part of the 'visitee' role in Visitor design pattern.
-      # @param visitor [LoxxyTreeVisitor] the visitor
+      # @param visitor [RGN::ASTVisitor] the visitor
       def accept(visitor)
         visitor.visit_symbol_node(self)
       end

data/lib/rley/rgn/tokenizer.rb

@@ -41,15 +41,15 @@ module Rley
         match_closest repeat
       ].map { |x| [x, x] }.to_h
 
-      # Constructor. Initialize a tokenizer for Lox input.
-      # @param source [String] Lox text to tokenize.
+      # Constructor. Initialize a tokenizer for RGN input.
+      # @param source [String] RGN text to tokenize.
       def initialize(source = nil)
         @scanner = StringScanner.new('')
         start_with(source) if source
       end
 
       # Reset the tokenizer and make the given text, the current input.
-      # @param source [String] Lox text to tokenize.
+      # @param source [String] RGN text to tokenize.
       def start_with(source)
         @scanner.string = source
         @lineno = 1

data/lib/rley/syntax/grm_symbol.rb

@@ -8,10 +8,6 @@ module Rley # This module is used as a namespace
       # @return [String] The name of the grammar symbol
       attr_reader(:name)
 
-      # An indicator that tells whether the grammar symbol can generate a
-      # non-empty string of terminals.
-      attr_writer(:generative)
-
       # Constructor.
       # aName [String] The name of the grammar symbol.
       def initialize(aName)

data/lib/rley/syntax/non_terminal.rb

@@ -7,6 +7,10 @@ module Rley # This module is used as a namespace
     # A non-terminal symbol (sometimes called a syntactic variable) represents
     # a composition of terminal or non-terminal symbols
     class NonTerminal < GrmSymbol
+      # An indicator that tells whether the grammar symbol can generate a
+      # non-empty string of terminals.
+      attr_writer(:generative)
+
       # A non-terminal symbol is nullable if it can match an empty string.
       attr_writer(:nullable)
 

data/lib/rley/syntax/terminal.rb

@@ -7,25 +7,29 @@ module Rley # This module is used as a namespace
     # A terminal symbol represents a class of words in the language
     # defined the grammar.
     class Terminal < GrmSymbol
-      # Constructor.
-      # @param aName [String] The name of the grammar symbol.
-      def initialize(aName)
-        super(aName)
-        self.generative = true
+      # An indicator that tells whether the grammar symbol can generate a
+      # non-empty string of terminals.
+      # @return [TrueClass]
+      def generative?
+        true
       end
 
       # Return true iff the symbol is a terminal
+      # @return [TrueClass]
       def terminal?
-        return true
+        true
       end
 
       # @return [false] Return true if the symbol derives
       # the empty string. As terminal symbol corresponds to a input token
       # it is by definition non-nullable.
+      # @return [FalseClass]
       def nullable?
         false
       end
 
+      # Return a readable text representation of the instance
+      # @return [String] The symbol name
       def to_s
         name
       end

data/spec/rley/parser/gfg_earley_parser_spec.rb

@@ -22,7 +22,6 @@ require_relative '../support/expectation_helper'
 require_relative '../../../lib/rley/parser/gfg_earley_parser'
 
 module Rley # Open this namespace to avoid module qualifier prefixes
-  # rubocop: disable Metrics/BlockLength
   module Parser # Open this namespace to avoid module qualifier prefixes
     describe GFGEarleyParser do
       include GrammarABCHelper # Mix-in module with builder for grammar abc
@@ -1038,6 +1037,5 @@ MSG
       end # context
     end # describe
   end # module
-  # rubocop: enable Metrics/BlockLength
 end # module
 # End of file

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rley
 version: !ruby/object:Gem::Version
-  version: 0.8.08
+  version: 0.8.09
 platform: ruby
 authors:
 - Dimitri Geshef
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-31 00:00:00.000000000 Z
+date: 2022-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -303,7 +303,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: Ruby implementation of the Earley's parsing algorithm
@@ -330,14 +330,6 @@ test_files:
 - spec/rley/lexical/literal_spec.rb
 - spec/rley/lexical/token_range_spec.rb
 - spec/rley/lexical/token_spec.rb
-- spec/rley/parser/dangling_else_spec.rb
-- spec/rley/parser/error_reason_spec.rb
-- spec/rley/parser/gfg_chart_spec.rb
-- spec/rley/parser/gfg_earley_parser_spec.rb
-- spec/rley/parser/gfg_parsing_spec.rb
-- spec/rley/parser/parse_entry_set_spec.rb
-- spec/rley/parser/parse_entry_spec.rb
-- spec/rley/parser/parse_walker_factory_spec.rb
 - spec/rley/parse_forest_visitor_spec.rb
 - spec/rley/parse_rep/ambiguous_parse_spec.rb
 - spec/rley/parse_rep/ast_builder_spec.rb
@@ -347,6 +339,14 @@ test_files:
 - spec/rley/parse_rep/parse_forest_factory_spec.rb
 - spec/rley/parse_rep/parse_tree_factory_spec.rb
 - spec/rley/parse_tree_visitor_spec.rb
+- spec/rley/parser/dangling_else_spec.rb
+- spec/rley/parser/error_reason_spec.rb
+- spec/rley/parser/gfg_chart_spec.rb
+- spec/rley/parser/gfg_earley_parser_spec.rb
+- spec/rley/parser/gfg_parsing_spec.rb
+- spec/rley/parser/parse_entry_set_spec.rb
+- spec/rley/parser/parse_entry_spec.rb
+- spec/rley/parser/parse_walker_factory_spec.rb
 - spec/rley/ptree/non_terminal_node_spec.rb
 - spec/rley/ptree/parse_tree_node_spec.rb
 - spec/rley/ptree/parse_tree_spec.rb