philiprehberger-differ 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 501adf50f677014ce90da4bc0222ca212f6a36d091e6612e1a93a3feab001867
-  data.tar.gz: 28e1bf4f0c0f662f7c8f7d19cb22c24271c709f45a22d7646f86857e586764ff
+  metadata.gz: f6f6c2e127be0912f009924625aa0ef3babcc21855bb9a6f0af744f6c6dff179
+  data.tar.gz: c2c99a65ed6ad72b399f52c99a3ac5866ca0c7705917c395124281c570869d31
 SHA512:
-  metadata.gz: 6aaaf8bb2c8717bcba57ee14cad6386113c20c815d270fc135da8991dbfc3fa3796389e4bee2ccf1c79b63b443dc926218f4a55a7eca8748a4005a501a3be0ad
-  data.tar.gz: 7a70fb5815b3a8eb3a6150a521a130ea2c795298d97e522a14bba4bc58c18845199ea3c06cc3797914cad6d476357c2fd86ef89627763805226eac9add84e4cf
+  metadata.gz: 9e3c7e4dcfabefe06c2348f4e13a1fa3023234ac3e57c2e8c3ac51437027944c906bfe3bc721e57d259087381bba09ee734181b80a83ce69872e6be814d1e041
+  data.tar.gz: 6796e028cb9a84341db6fc7952e79c692bbcd8d87dbb1af116da04fdd883785db8c63a0e80909940355aae65f993b31437eb69aaa2ab27805f372ed69841ea4c

data/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- `Changeset` now includes `Enumerable` for direct iteration over changes
+- `Changeset#count` returning the number of changes
+- `Changeset#paths` returning all changed paths
+- `Changeset#include?(path)` to check if a specific path was changed
+- `Changeset#summary` returning `{ added:, removed:, changed: }` counts
+
 ## [0.3.0] - 2026-04-01
 
 ### Added

data/README.md

@@ -139,6 +139,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)`
@@ -154,6 +168,11 @@ Returns a Float between 0.0 (completely different) and 1.0 (identical).
 | Method | Description |
 |---|---|
 | `changed?` | Returns `true` if any differences exist |
+| `count` | Number of changes |
+| `paths` | Array of all changed paths |
+| `include?(path)` | Check if a specific path was changed |
+| `summary` | `{ added:, removed:, changed: }` counts |
+| `each` | Iterate over changes (includes `Enumerable`) |
 | `changes` | All `Change` objects |
 | `added` | Changes where `type == :added` |
 | `removed` | Changes where `type == :removed` |
@@ -169,6 +188,7 @@ Returns a Float between 0.0 (completely different) and 1.0 (identical).
 | `Differ.subset(changeset, path)` | Filter changes to a specific path prefix |
 | `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/changeset.rb

@@ -3,12 +3,52 @@
 module Philiprehberger
   module Differ
     class Changeset
+      include Enumerable
+
       attr_reader :changes
 
       def initialize(changes = [])
         @changes = changes
       end
 
+      # Iterate over each Change.
+      #
+      # @yield [Change] each change
+      # @return [Enumerator] if no block given
+      def each(&)
+        @changes.each(&)
+      end
+
+      # Number of changes.
+      #
+      # @return [Integer]
+      def count
+        @changes.length
+      end
+
+      # Array of all changed paths.
+      #
+      # @return [Array<String>]
+      def paths
+        @changes.map(&:path)
+      end
+
+      # Check if a specific path was changed.
+      #
+      # @param path [String, Symbol] the path to check
+      # @return [Boolean]
+      def include?(path)
+        path_s = path.to_s
+        @changes.any? { |c| c.path.to_s == path_s }
+      end
+
+      # Summary counts by change type.
+      #
+      # @return [Hash{Symbol => Integer}] { added:, removed:, changed: }
+      def summary
+        { added: added.length, removed: removed.length, changed: changed.length }
+      end
+
       def changed?
         !@changes.empty?
       end

data/lib/philiprehberger/differ/version.rb

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

data/lib/philiprehberger/differ.rb

@@ -56,6 +56,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.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-04-21 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