philiprehberger-differ 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e8573d84ddf309e3d702cb9b90d1b407c8963cd84cf62235e6620d586949437
-  data.tar.gz: 79ddab362109ba0b8b7958ba77fe9242426a403904082e81b2c8db2f6246a2c2
+  metadata.gz: 43183caae823c98d43466bf7d1e6a2a5c993dc9f573d3d07352f3802fbc1b6d0
+  data.tar.gz: a7633ce9d9a19b69229548221475b8890198c272edf0bbb4e9d3fd3aae9eb912
 SHA512:
-  metadata.gz: 585f857fb63da7b81aad2ded9a2948e4cf27b5d996c6afa76480a0ff41397d3181ab02cad53ab285a8d629f15df669c6372d2d7d220b68d27168dac72f8993be
-  data.tar.gz: 20e291749bdbec14d58031833b02c9de65dc5f40bd3675407b478ce8dce20efeeb613ca9e28062b97628fd8a32cf44eb98df5e781964b5f70ac85fe1a09a6618
+  metadata.gz: 97bea10cc3793229177af29091a41a7af415ef1c383150604bffc8492a4f4dc4c0f57d78d7cbc9241c86ba3f2fa0c41c5170aafc1098f9fbe8b2e47129799b25
+  data.tar.gz: 8d728725be558d50bc31124070f43e47a7980971c75d78bc9150877bcc6dde91c52b1191514134492bae5948eff763ca70f92c4e755bb2c18d5bfb854b959bca

data/CHANGELOG.md

@@ -7,6 +7,19 @@ 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
+- `Philiprehberger::Differ.stats` — structured counts of added/removed/changed paths in a changeset
+
+### Fixed
+- `bug_report.yml` — require Ruby version; add Gem version input per guide
+
 ## [0.4.0] - 2026-04-10
 
 ### 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
@@ -139,6 +150,20 @@ result[:conflicts]  # => [{ path:, theirs:, ours: }]
 Philiprehberger::Differ.breaking_changes?(changeset)  # => true/false
 ```
 
+### Change Statistics
+
+Get a structured count summary of a changeset:
+
+```ruby
+changeset = Philiprehberger::Differ.diff(
+  { name: 'Alice', age: 30, id: 1 },
+  { name: 'Bob', email: 'bob@example.com' }
+)
+
+Philiprehberger::Differ.stats(changeset)
+# => { added: 1, removed: 2, changed: 1, total: 4, paths: 4 }
+```
+
 ## API
 
 ### `Philiprehberger::Differ.diff(old_val, new_val, ignore: [], array_key: nil)`
@@ -172,8 +197,10 @@ 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 |
 
 ### `Change`
 

data/lib/philiprehberger/differ/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Differ
-    VERSION = '0.4.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
@@ -56,6 +90,31 @@ module Philiprehberger
       { merged: merged, conflicts: conflicts }
     end
 
+    # Structured count summary of a changeset.
+    #
+    # Returns a hash of integer counts for the added, removed, and changed
+    # entries in the changeset, along with a running total and the number of
+    # unique paths. This method is read-only and never mutates the changeset.
+    #
+    # @param changeset [Changeset] the changeset to summarize
+    # @return [Hash{Symbol => Integer}] counts by kind — `{ added:, removed:, changed:, total:, paths: }`
+    # @raise [ArgumentError] if `changeset` is not a {Changeset}
+    def self.stats(changeset)
+      raise ArgumentError, 'changeset must be a Philiprehberger::Differ::Changeset' unless changeset.is_a?(Changeset)
+
+      added   = changeset.added.length
+      removed = changeset.removed.length
+      changed = changeset.changed.length
+
+      {
+        added: added,
+        removed: removed,
+        changed: changed,
+        total: added + removed + changed,
+        paths: changeset.paths.length
+      }
+    end
+
     # Detect if a changeset contains breaking changes (removals or type changes)
     #
     # @param changeset [Changeset] the changeset to check

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-differ
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-10 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