farseer 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2700438309a0da4774a6b4c33aa2f8dc01a61e4ae6eae9db5b5d4bc917f45263
-  data.tar.gz: da6f37d9b9582cfb731a39d6de9a7afbe4678b5e67df717008b8fdfa39281409
+  metadata.gz: 22cbc0c49fc2a306b2e0e7291dd58e09047bd2eef4b679d2be9f9e307c6db2e1
+  data.tar.gz: a3a1a49b2748d129931af363e3a4bcbb9fdbd174956de07a4de0daceb0cc07cb
 SHA512:
-  metadata.gz: 9fdc000cff13a63b7ecd370d2a9f454736bc43a5b41ff4b001fdbc07a46ff5b6f2c17101eb27be07499c73b39faace6e00ca61ec04cfebac408054a16ba4cab2
-  data.tar.gz: a147d2daafaa1205e316fdcb811ddd8ae78150d060cf890081bd7ad46f2566398fad6b6941711355f13e2f897e37ac290b877e9e418a138a78759beb2fa0eeb3
+  metadata.gz: 8b3bc436e67fcd46f61964cb6e3e70c7f3a8c374a1712680f4a91901daaf9ae071c79428ac40da19038619e8a05556cbbfd0167d43b5841020b082d730f909a6
+  data.tar.gz: 2303e7849b72c10e9353ff9faf362c3d8e0113f24247dbd95104ea45d2c5877e96bcf2444d402853909f14590f4a3c8295f813f99ebc23e1c4bbccbb33c11ae8

data/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2024-06-04
+### Added
+- `Farseer::And` to run a sequence of parsers that must all succeed.
+- `Farseer::Or` to try multiple parsers until one works.
+- `Farseer::Word` to parse a keyword at the beginning of a string.
+- `Farseer::Regexp` to parse a token using `regexp`.
+- `mutant` development dependency for mutation testing.
+- Achieve `100%` mutation test coverage.
+- `byebug` development dependency for debugging.
+
+### Removed
+- All helper methods of `Farseer`.
+
+### Changed
+- Update development dependencies.
+
 ## [0.6.0] - 2024-06-03
 ### Added
 - `Farseer::Opt`  to parse `0` to `1` times the wrapped parser. (`?`)

data/lib/farseer/and.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Farseer
+  class And
+    def initialize(*parsers)
+      @parsers = parsers.flatten
+      freeze
+    end
+
+    def parse(input)
+      return Maybe.none if @parsers.empty?
+
+      initial = Maybe.return(Result.new('', input))
+
+      @parsers.reduce(initial) do |maybe_acc, parser|
+        bind_accumulator(maybe_acc, parser)
+      end
+    end
+
+    def bind_accumulator(maybe_acc, parser)
+      maybe_acc.bind do |acc_result|
+        parse_with_rest(parser, acc_result)
+      end
+    end
+
+    def parse_with_rest(parser, acc_result)
+      parser.parse(acc_result.rest).bind do |result|
+        combine_results(acc_result, result)
+      end
+    end
+
+    def combine_results(acc_result, result)
+      combined_tokens = acc_result.token + result.token
+      Maybe.return(Result.new(combined_tokens, result.rest))
+    end
+  end
+end

data/lib/farseer/any.rb

@@ -8,13 +8,13 @@ module Farseer
     end
 
     def parse(input)
-      helper(input)
+      helper(input, '')
     end
 
-    def helper(input, tokens = [])
+    def helper(input, tokens)
       @parser.parse(input)
-             .bind { |r| helper(r.rest, [*tokens, r.token]) }
-             .map_none { Result.new(tokens.join, input) }
+             .bind { |r| helper(r.rest, tokens + r.token) }
+             .map_none { Result.new(tokens, input) }
     end
   end
 end

data/lib/farseer/chars.rb

@@ -2,8 +2,8 @@
 
 module Farseer
   class Chars
-    def initialize(chars)
-      @chars = chars
+    def initialize(*chars)
+      @chars = chars.flatten
       freeze
     end
 

data/lib/farseer/many.rb

@@ -9,13 +9,13 @@ module Farseer
 
     def parse(input)
       @parser.parse(input)
-             .bind { |r| helper(r.rest, [r.token]) }
+             .bind { |r| helper(r.rest, r.token) }
     end
 
-    def helper(input, tokens = [])
-      @parser.parse(input)
-             .bind { |r| helper(r.rest, [*tokens, r.token]) }
-             .map_none { Result.new(tokens.join, input) }
+    def helper(input, tokens)
+      parse(input)
+        .bind { |r| helper(r.rest, tokens + r.token) }
+        .map_none { Result.new(tokens, input) }
     end
   end
 end

data/lib/farseer/opt.rb

@@ -8,8 +8,9 @@ module Farseer
     end
 
     def parse(input)
-      @parser.parse(input)
-             .map_none { Result.new('', input) }
+      @parser
+        .parse(input)
+        .map_none { Result.new('', input) }
     end
   end
 end

data/lib/farseer/or.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Farseer
+  class Or
+    def initialize(*parsers)
+      @parsers = parsers.flatten
+      freeze
+    end
+
+    def parse(input)
+      case @parsers.length
+      when 0 then Maybe.none
+      when 1 then @parsers.first.parse(input)
+      else parse_helper(input)
+      end
+    end
+
+    def parse_helper(input)
+      @parsers.reduce do |acc, parser|
+        acc.parse(input).bind_none { parser.parse(input) }
+      end
+    end
+  end
+end

data/lib/farseer/regexp.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Farseer
+  class Regexp
+    WS_REGEXP = /^(?'token'\s*)(?'rest'.*)$/
+    RegexpError = Class.new(ArgumentError)
+
+    def initialize(regexp)
+      raise RegexpError unless regexp.names == ['token', 'rest']
+
+      @regexp = regexp
+      freeze
+    end
+
+    WS = new(WS_REGEXP)
+
+    def parse(input)
+      match = input.match(@regexp)
+
+      Maybe.return(Result.new(match[:token], match[:rest]))
+    end
+  end
+end

data/lib/farseer/result.rb

@@ -11,8 +11,8 @@ module Farseer
 
     def eql?(other)
       self.class.eql?(other.class) and
-        self.token.eql?(other.token) and
-        self.rest.eql?(other.rest)
+        token.eql?(other.token) and
+        rest.eql?(other.rest)
     end
     alias == eql?
   end

data/lib/farseer/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Farseer
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
   public_constant :VERSION
 end

data/lib/farseer/word.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Farseer
+  class Word
+    def initialize(word)
+      @word = word
+      freeze
+    end
+
+    def parse(input)
+      case
+      when input.start_with?(@word) then Maybe.return(Result.new(@word, input[@word.length..]))
+      else Maybe.none
+      end
+    end
+  end
+end

data/lib/farseer.rb

@@ -6,26 +6,7 @@ loader = Zeitwerk::Loader::for_gem
 loader.setup
 
 module Farseer
-  WS_REGEX = /^(\s*)(.*)$/
   Maybe = Muina::Maybe
-
-  def self.any_char_parser
-    ->(chars, input) { Chars.new(chars).parse(input) }
-      .curry
-  end
-
-  def self.char_parser
-    ->(char, input) { Char.new(char).parse(input) }
-      .curry
-  end
-
-  def self.ws_parser
-    ->(input) {
-      match = input.match(WS_REGEX)
-
-      Maybe.return(Result.new(match[1], match[2]))
-    }
-  end
 end
 
 loader.eager_load

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: farseer
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - vaporyhumo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-03 00:00:00.000000000 Z
+date: 2024-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: muina
@@ -50,13 +50,17 @@ files:
 - README.md
 - SECURITY.md
 - lib/farseer.rb
+- lib/farseer/and.rb
 - lib/farseer/any.rb
 - lib/farseer/char.rb
 - lib/farseer/chars.rb
 - lib/farseer/many.rb
 - lib/farseer/opt.rb
+- lib/farseer/or.rb
+- lib/farseer/regexp.rb
 - lib/farseer/result.rb
 - lib/farseer/version.rb
+- lib/farseer/word.rb
 homepage: https://github.com/vaporyhumo/farseer
 licenses:
 - Unlicense