philiprehberger-differ 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6f6c2e127be0912f009924625aa0ef3babcc21855bb9a6f0af744f6c6dff179
-  data.tar.gz: c2c99a65ed6ad72b399f52c99a3ac5866ca0c7705917c395124281c570869d31
+  metadata.gz: 43183caae823c98d43466bf7d1e6a2a5c993dc9f573d3d07352f3802fbc1b6d0
+  data.tar.gz: a7633ce9d9a19b69229548221475b8890198c272edf0bbb4e9d3fd3aae9eb912
 SHA512:
-  metadata.gz: 9e3c7e4dcfabefe06c2348f4e13a1fa3023234ac3e57c2e8c3ac51437027944c906bfe3bc721e57d259087381bba09ee734181b80a83ce69872e6be814d1e041
-  data.tar.gz: 6796e028cb9a84341db6fc7952e79c692bbcd8d87dbb1af116da04fdd883785db8c63a0e80909940355aae65f993b31437eb69aaa2ab27805f372ed69841ea4c
+  metadata.gz: 97bea10cc3793229177af29091a41a7af415ef1c383150604bffc8492a4f4dc4c0f57d78d7cbc9241c86ba3f2fa0c41c5170aafc1098f9fbe8b2e47129799b25
+  data.tar.gz: 8d728725be558d50bc31124070f43e47a7980971c75d78bc9150877bcc6dde91c52b1191514134492bae5948eff763ca70f92c4e755bb2c18d5bfb854b959bca

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-01
+
+### Added
+- `Philiprehberger::Differ.invert(changeset)` — return a changeset with additions/removals swapped and changed values reversed; lets callers compute the inverse diff without rerunning the comparator
+
 ## [0.5.0] - 2026-04-21
 
 ### Added

data/README.md

@@ -125,6 +125,17 @@ changeset = Philiprehberger::Differ.diff(old_data, new_data)
 user_changes = Philiprehberger::Differ.subset(changeset, 'user')
 ```
 
+### Inverting a Diff
+
+Return the inverse of a changeset — additions and removals swap, and
+changed values are reversed. Applying the inverse undoes the original:
+
+```ruby
+forward = Philiprehberger::Differ.diff(old_data, new_data)
+reverse = Philiprehberger::Differ.invert(forward)
+reverse.apply(forward.apply(old_data)) # => old_data
+```
+
 ### Three-Way Merge
 
 ```ruby
@@ -186,6 +197,7 @@ Returns a Float between 0.0 (completely different) and 1.0 (identical).
 | Method | Description |
 |---|---|
 | `Differ.subset(changeset, path)` | Filter changes to a specific path prefix |
+| `Differ.invert(changeset)` | Return a new changeset that reverses the original |
 | `Differ.merge(base, theirs, ours)` | Three-way merge with conflict detection |
 | `Differ.breaking_changes?(changeset)` | Detect removals and type changes |
 | `.stats(changeset)` | Count summary of a changeset |

data/lib/philiprehberger/differ/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Differ
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/philiprehberger/differ.rb

@@ -33,6 +33,40 @@ module Philiprehberger
       Changeset.new(filtered)
     end
 
+    # Return the inverse of a changeset.
+    #
+    # Additions become removals (and vice versa), and changed entries swap
+    # their old and new values. Applying the inverted changeset to a hash
+    # that has already had the original changeset applied will undo it
+    # without keeping the prior state around.
+    #
+    # @param changeset [Changeset] the changeset to invert
+    # @return [Changeset] a new changeset with each change reversed
+    # @raise [ArgumentError] if `changeset` is not a {Changeset}
+    def self.invert(changeset)
+      raise ArgumentError, 'changeset must be a Philiprehberger::Differ::Changeset' unless changeset.is_a?(Changeset)
+
+      reversed = changeset.changes.map do |change|
+        case change.type
+        when :added
+          Change.new(path: change.path, type: :removed, old_value: change.new_value)
+        when :removed
+          Change.new(path: change.path, type: :added, new_value: change.old_value)
+        when :changed
+          Change.new(
+            path: change.path,
+            type: :changed,
+            old_value: change.new_value,
+            new_value: change.old_value
+          )
+        else
+          change
+        end
+      end
+
+      Changeset.new(reversed)
+    end
+
     # Perform a three-way merge with conflict detection
     #
     # @param base [Hash] the common ancestor

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-differ
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-21 00:00:00.000000000 Z
+date: 2026-05-02 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby library for deep structural diffing of hashes, arrays, and nested
   objects with apply/revert, JSON Patch output, similarity scoring, and configurable