rematch 1.2.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 586bcff5cd631385dd5dd60787cd47220d4367e42a9c34a74f6c2c1617940278
-  data.tar.gz: c5afbca2c06ea0e7c78500c9a2a172e1114251b021e2a257edf278bc031223c6
+  metadata.gz: 2b3e156f501309072c0c57f782f4954d878d6fca881df21be60294d048e8499d
+  data.tar.gz: '09b2e677934c63c345dcd5df0aaa1d045136b2089f93abbc9e88c19109bfaddc'
 SHA512:
-  metadata.gz: 7c4a5aa9c5247e0789c54736a1b09a69ffe5aed69f0035c2fe8a79c98b52b20e21a2ce727d331520df969dbb593298cca1efc8ac0d6f4e153aa94422e964e04b
-  data.tar.gz: abfdbf717e06179fd84e3a37348a4272e5fa207a859761a50f0b3b3debab6806a95c3595165c522b87e01226cc13859b1ce9d0e01040bc2e6f86e648f83e960f
+  metadata.gz: ae7b319799b53c0c459217113ca1bb2e4811cadcacf26f2bb5be127414d8e1064fe70a3dfd15ce691a3013016fb8b772168568e450913f6b09045fe5d4e469e4
+  data.tar.gz: 8124b42a3eaa69c37c10b8991f1d3a3eb13c4c70fc2ecde3908580eae388da11e18848a89848c9a2f4682c8f2903afd77f336e70753c33c0ae665c02213c3105

data/lib/minitest/rematch_plugin.rb

@@ -4,29 +4,44 @@ require 'rematch'
 
 # Implement the minitest plugin
 module Minitest
+  # Set Rematch.rebuild with the --rematch-rebuild
   def self.plugin_rematch_options(opts, _options)
     opts.on '--rematch-rebuild', 'Rebuild the stores with the current entries/values' do
       Rematch.rebuild = true
     end
   end
 
-  # reopen the minitest class
+  # Reopen the minitest class
   class Test
+    # Create the rematch object for each test
     def before_setup
       super
       @rematch = Rematch.new(path: method(name).source_location.first, id: location)
     end
   end
 
-  # reopen the minitest module
+  # Reopen the minitest module
   module Assertions
-    def assert_rematch(actual, assert_method = :assert_equal)
-      send assert_method, @rematch.rematch(actual), actual
+    # Main assertion
+    def assert_rematch(actual, *args)
+      assertion = :assert_equal
+      message   = nil
+      args.each { |arg| arg.is_a?(Symbol) ? assertion = arg : message = arg }
+      send assertion, @rematch.rematch(actual), actual, message  # assert that the stored value is the same actual value
+    end
+
+    # Temporarily used to store the actual value, useful for reconciliation of expected changed values
+    def store_assert_rematch(actual, *_args)
+      @rematch.store(actual)
+      # Always fail after storing, forcing the restore of the original assertion/expectation
+      raise Minitest::Assertion, '[rematch] the value has been stored: remove the "store_" prefix to pass the test'
     end
   end
 
-  # reopen the minitest module
+  # Reopen the minitest module
   module Expectations
+    # Add the expectations pointing to the assertions
     infect_an_assertion :assert_rematch, :must_rematch, true # dont_flip
+    infect_an_assertion :store_assert_rematch, :store_must_rematch, true # dont_flip
   end
 end

data/lib/rematch.rb

@@ -3,15 +3,17 @@
 require 'yaml/store'
 require 'fileutils'
 
-# Implement the key/value store
+# Handles the key/value store for each test
 class Rematch
-  VERSION = '1.2.0'
+  VERSION = '1.4.1'
   EXT     = '.rematch'
 
-  @rebuilt = []
+  @rebuild = false  # rebuild the store?
+  @rebuilt = []     # paths already rebuilt
   class << self
     attr_accessor :rebuild
 
+    # Check whether path requires rebuild and do it if required
     def check_rebuild(path)
       return unless @rebuild && !@rebuilt.include?(path)
 
@@ -21,7 +23,7 @@ class Rematch
     end
   end
 
-  # path and unique id of the test being run
+  # Instantiated at each test, stores the path and the unique id of the test being run
   def initialize(path:, id:)
     path = "#{path}#{EXT}"
     self.class.check_rebuild(path)
@@ -30,9 +32,21 @@ class Rematch
     @count = 0
   end
 
-  # store if unknown; retrieve otherwise
+  # Retrieve the stored value for the current assertion if its key is known; store the value otherwise
   def rematch(value)
-    key = "[#{@count += 1}] #{@id}"
+    key = assertion_key
     @store.transaction { |s| s.root?(key) ? s[key] : s[key] = value }
   end
+
+  # Store the value
+  def store(value)
+    @store.transaction { |s| s[assertion_key] = value }
+  end
+
+  private
+
+  # Return the key for the current assertion
+  def assertion_key
+    "[#{@count += 1}] #{@id}"
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rematch
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Domizio Demichelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-21 00:00:00.000000000 Z
+date: 2021-12-10 00:00:00.000000000 Z
 dependencies: []
 description: Instead of copying and pasting large outputs or big ruby structures into
   all the affected test files every time your code change, you can do it the easy
@@ -25,7 +25,11 @@ files:
 homepage: https://github.com/ddnexus/rematch
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/ddneus/rematch
+  bug_tracker_uri: https://github.com/ddnexus/rematch/issues
+  changelog_uri: https://github.com/ddnexus/rematch/blob/master/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -34,14 +38,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
-      version: '2.1'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.2.32
 signing_key: 
 specification_version: 4
 summary: Declutter your test files from large hardcoded data and update them automatically