yaml_smith 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03e70b6c6bd6522e6a35265fc2906e5fdc05e1e5a3bb497024e7805eb89cdc2e
-  data.tar.gz: a3b8572f3a9ead73fc96d1eb4795a995ac17a2ade613dc54334ee8c7b2e59843
+  metadata.gz: 1ae84128e5a9fd8e27052c2ae46fd0c824360a603a8e83bc939758c084ee9ca1
+  data.tar.gz: 1790ba5fa65a520ac3a55aa0ca0c718d65794c4abb007343b7e3a46cf5d740b2
 SHA512:
-  metadata.gz: 49168721a967966498b840fc55af20beaad3be787c756cfb28aa4d08c55011f1d8cfbef4f0af5216278aceee1efce14c2f89b9cb39ff24d6bc0379e57afe09cb
-  data.tar.gz: b7b6467e1f366f016ca038e5a7ecd2e54b55f72b9e6b071bd53ffaf2edf0726f46faa3b635d9dbb5e55d13b6e4e93ee943f52fec3bc95493c2404330b0bec03c
+  metadata.gz: 73c9db95bdbcbd3c7396e65387ef77d20dc64bef997db73700df90590b852db1f6c9461d1ef18f60a0c8e6d7c7d81eeeac6c0f88539556b39faccd946a62a395
+  data.tar.gz: 9746fcbffa82ccf28b8f8b1e21bba0286f7b5f3c5f157e46cf036368fa98b5f2de5d27098ad5064e26180de5c0fe2ff7b9881f967ee3e0ec2b16675528159212

data/AGENTS.md

@@ -12,7 +12,12 @@
 - `exe/yaml-smith` is only the executable wrapper; CLI dispatch and error handling belong in `lib/yaml_smith/cli.rb`.
 - Each command has its own class and file: `AddKey`, `SetKey`, and `DeleteKey`.
 - Shared file loading, validation, and atomic writing live in `YamlSmith::FileCommand`.
-- Commands currently operate on top-level mapping keys only; do not add nested-path behavior implicitly.
+- `AddKey` and `SetKey` accept a nested path in their `key` argument using dot
+  notation (e.g. `services.0.name`) or bracket notation (e.g. `services[0].name`).
+  Numeric segments index into arrays. `FileCommand#resolve_container` navigates
+  intermediate segments of the path, which must already exist; the final key may
+  be missing (for `set`, it is then added). `DeleteKey` searches matching keys
+  recursively and does not take a path.
 
 ## YAML Behavior
 

data/README.md

@@ -28,12 +28,24 @@ yaml-smith add config.yml timeout 30
 The value is parsed as YAML, so values such as `true`, `null`, arrays, and
 objects retain their YAML types. Existing keys are not overwritten.
 
-Set or replace a top-level key:
+Set or replace a key:
 
 ```bash
 yaml-smith set config.yml timeout 60
 ```
 
+Add and set also accept a nested path using dot notation, with numeric
+segments indexing into arrays. For example, this renames the web service in a
+Render configuration:
+
+```bash
+yaml-smith set render.yaml services.0.name rails_foo
+```
+
+Bracket notation is accepted as well: `services[0].name`. Intermediate
+segments of the path must already exist; the final key may be missing (for
+`set`, it is added).
+
 Delete matching keys recursively:
 
 ```bash

data/lib/yaml_smith/add_key.rb

@@ -1,16 +1,18 @@
 # frozen_string_literal: true
 
 module YamlSmith
-  # Adds a top-level key to a YAML file.
+  # Adds a key to a YAML file. The key may be a top-level key or a nested
+  # path such as `services.0.name`.
   class AddKey < FileCommand
     def call
       document = load_file(@path)
       value = load(@value)
 
       ensure_mapping(document)
-      raise Error, "key already exists: #{@key}" if document.key?(@key)
+      container, final_key = resolve_container(document)
+      raise Error, "key already exists: #{@key}" if container.key?(final_key)
 
-      document[@key] = value
+      container[final_key] = value
       write(Psych::Pure.dump(document))
     end
   end

data/lib/yaml_smith/file_command.rb

@@ -33,6 +33,49 @@ module YamlSmith
       raise Error, 'YAML document must contain a top-level mapping'
     end
 
+    def resolve_container(document)
+      container = document
+      segments[0..-2].each { |segment| container = navigate(container, segment) }
+      [container, segments.last]
+    end
+
+    def navigate(container, segment)
+      if integer?(segment)
+        raise Error, "expected an array at '#{segment}'" unless container.instance_of?(Psych::Pure::LoadedArray)
+
+        index = Integer(segment)
+        raise Error, "segment does not exist: #{segment}" if index >= container.length
+
+        container[index]
+      else
+        raise Error, "expected a mapping at '#{segment}'" unless container.instance_of?(Psych::Pure::LoadedHash)
+        raise Error, "segment does not exist: #{segment}" unless container.key?(segment)
+
+        container[segment]
+      end
+    end
+
+    def integer?(segment)
+      segment.match?(/\A\d+\z/)
+    end
+
+    def segments
+      @segments ||= parse_segments(@key)
+    end
+
+    def parse_segments(key)
+      return [key] unless key.include?('.') || key.include?('[')
+
+      key.scan(/[^.\s]+/).each_with_object([]) do |token, result|
+        segments = token.split('[')
+        result << segments[0] unless segments[0].empty?
+
+        segments[1..].each do |part|
+          result << part.delete_suffix(']')
+        end
+      end
+    end
+
     def write(contents)
       mode = File.stat(@path).mode & 0o7777
 

data/lib/yaml_smith/set_key.rb

@@ -1,14 +1,16 @@
 # frozen_string_literal: true
 
 module YamlSmith
-  # Sets a top-level key in a YAML file, adding or replacing it.
+  # Sets a key in a YAML file, adding or replacing it. The key may be a
+  # top-level key or a nested path such as `services.0.name`.
   class SetKey < FileCommand
     def call
       document = load_file(@path)
       value = load(@value)
 
       ensure_mapping(document)
-      document[@key] = value
+      container, final_key = resolve_container(document)
+      container[final_key] = value
       write(Psych::Pure.dump(document))
     end
   end

data/lib/yaml_smith/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module YamlSmith
-  VERSION = "0.2.0"
+  VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yaml_smith
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andy Waite