philiprehberger-json_path 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d1f6e3df479eeb12b69af816742069bd38c31953c3b1611add83bc3aac4434a
-  data.tar.gz: 69b8a9a12b7a95fcf12ac173c6559d9e002a9d8d085c05b28716eb9948262fe5
+  metadata.gz: f593dd25616efcfc78e8efbda2f1909d8ba63d19e1b144c9d9708c7a9e736fde
+  data.tar.gz: 83c8f2bc4b1dfdc7da601cb21739ae2b2ff5c22964d0cefeae04cb6bcae4d09a
 SHA512:
-  metadata.gz: c603bf6cd3c2a58f248b1ca535ebcd63d28f3d1cdc269ff73f7e2889f161316c0a1c3a710c7e250c5529d090458fc42ffeac1cb2a43020fb81d037b500548a04
-  data.tar.gz: 12a21c296a86fe78d87ffd71ad9bba9b81200d60c8ffb1f3959e77f56f7312d31fda4d04fc00e3baa37103dee548237d0827810d8abe672b148b696d86f9c9e4
+  metadata.gz: 63eaa887ffe7f5a8e440b06e78217c9f19391dafd3705ac0fb29a68fbd6362599532626f2c47f9848d76e83370bc3a38503942a8e48d3fbf4cd332adef9813e4
+  data.tar.gz: 86c79db3e059ae57cd8192fa63168aa58b34a6a187041a3ce7905a58276a30fd0c10b7289da3724ec122d49283011c555f9b557b3e916bee3f91a168f05217fe

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-01
+
+### Added
+- `JsonPath.update(data, path, &block)` — apply a block to every JSONPath match, replacing each with the block's return value. Mutates `data` in place; returns it for chaining. Raises when the path resolves to the root document.
+
 ## [0.4.0] - 2026-04-19
 
 ### Added

data/README.md

@@ -130,6 +130,20 @@ Philiprehberger::JsonPath.query(data, '$.groups[?(@.members.length > 0)].name')
 # => ["team1"]
 ```
 
+### In-place Updates
+
+Apply a transformation to every match. Mutates the data and returns it for chaining.
+
+```ruby
+data = { 'users' => [{ 'name' => 'alice' }, { 'name' => 'bob' }] }
+
+Philiprehberger::JsonPath.update(data, '$.users[*].name', &:upcase)
+# data["users"].map { |u| u["name"] } => ["ALICE", "BOB"]
+
+# Increment every numeric price in a nested store
+Philiprehberger::JsonPath.update(catalog, '$..price') { |p| p * 1.10 }
+```
+
 ### Supported Syntax
 
 | Syntax | Description |
@@ -157,6 +171,7 @@ Philiprehberger::JsonPath.query(data, '$.groups[?(@.members.length > 0)].name')
 | `JsonPath.count(data, path)` | Return the number of matches |
 | `JsonPath.exists?(data, path)` | Check if any match exists |
 | `JsonPath.paths(data, path)` | Return canonical JSONPath strings for each match |
+| `JsonPath.update(data, path, &block)` | Replace every matched value with the block's return; mutates `data` in place |
 
 ## Development
 

data/lib/philiprehberger/json_path/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module JsonPath
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/json_path.rb

@@ -75,6 +75,79 @@ module Philiprehberger
       evaluate_with_paths(data, tokens).map { |_node, p| p }
     end
 
+    # Apply a transformation to every JSONPath match in `data`.
+    #
+    # Mutates `data` in place and returns it for chaining. Each match is
+    # replaced with the block's return value. Skips matches that resolve
+    # to the document root (`"$"`). Use `Marshal.load(Marshal.dump(data))`
+    # first if you need to preserve the original.
+    #
+    # @param data [Hash, Array] the data to transform
+    # @param path [String] JSONPath expression
+    # @yield [value] each matched value
+    # @yieldreturn [Object] the replacement value
+    # @return [Hash, Array] the mutated data
+    # @raise [Error] when the path resolves to the root document
+    def self.update(data, path, &block)
+      raise Error, 'block required for update' unless block
+
+      paths(data, path).each do |canonical|
+        raise Error, 'Cannot update root document' if canonical == '$'
+
+        mutate_at(data, canonical, &block)
+      end
+      data
+    end
+
+    # @api private
+    def self.mutate_at(data, canonical, &block)
+      segments = canonical_segments(canonical)
+      *parent_path, last = segments
+      parent = parent_path.reduce(data) { |node, seg| descend(node, seg) }
+
+      if parent.is_a?(Hash)
+        key = parent.key?(last) ? last : last.to_sym
+        parent[key] = block.call(parent[key])
+      elsif parent.is_a?(Array)
+        idx = Integer(last)
+        parent[idx] = block.call(parent[idx])
+      end
+    end
+
+    # @api private
+    def self.canonical_segments(canonical)
+      remaining = canonical[1..]
+      segments = []
+
+      until remaining.empty?
+        case remaining
+        when /\A\.([A-Za-z_][A-Za-z0-9_]*)/
+          segments << ::Regexp.last_match(1)
+          remaining = remaining[::Regexp.last_match(0).length..]
+        when /\A\['((?:\\'|[^'])*)'\]/
+          segments << ::Regexp.last_match(1).gsub("\\'", "'")
+          remaining = remaining[::Regexp.last_match(0).length..]
+        when /\A\[(\d+)\]/
+          segments << ::Regexp.last_match(1)
+          remaining = remaining[::Regexp.last_match(0).length..]
+        else
+          raise Error, "Unparseable canonical path segment: #{remaining}"
+        end
+      end
+
+      segments
+    end
+
+    # @api private
+    def self.descend(node, segment)
+      if node.is_a?(Hash)
+        node.key?(segment) ? node[segment] : node[segment.to_sym]
+      elsif node.is_a?(Array)
+        node[Integer(segment)]
+      end
+    end
+    private_class_method :mutate_at, :canonical_segments, :descend
+
     class << self
       private
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-json_path
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - philiprehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-05-01 00:00:00.000000000 Z
 dependencies: []
 description: Evaluate JSONPath expressions against Ruby hashes and arrays. Supports
   dot notation, array indexing, wildcards, slices, filter expressions, recursive descent,