philiprehberger-toml_kit 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 174ea153b4049cb9bfa03861fcfd17b0a1d6ca732c77bee833596261d8c3ac73
-  data.tar.gz: 9bcc85d52e0186652cee5b9304c4673da3f66d0eec8a4ff70ecd2bdfc856635b
+  metadata.gz: 8cdca57335aa874bbc1ed3f637df91a738bddc6316b82df101925c0ed383fc37
+  data.tar.gz: 6edfe631dd620f5def0c1477db9a14a2bed6eba13810a9ce03d3548abba062eb
 SHA512:
-  metadata.gz: e45be50d82be1e07d068a2932aa9c5889f5f2ae3a9fde62ec76850d9df3e9b3297ce3fa2fd46999af8f8fbc2e47e49ca1f5c89f3f5c0d8bd00e11fb7ea05d687
-  data.tar.gz: d65fe1af77f1fb87a56a4270e5bc2a7624fec1f75cab35bf56a24bc6f69369c9b5464991870475abe166b785626d64e23788141dfc68d8e3f6ea4a9baf6e0ccb
+  metadata.gz: 56b547d9009966fc988cc954fca8a3a40b35057306b936db0a487f275a3b97bae6e959f08134c08f40198896a335bfde902484e9c026e09c7a5116cf39d5a8a4
+  data.tar.gz: 745fdff008a2c06306ccc64567119401b12578369783fe6afcf39003ef0d4604a89ff3dc2279d765eb82e68a720cdf3d888ca502379bcab94cd8682508a5f5f6

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-30
+
+### Added
+- `TomlKit.set(data, path, value)` — set a nested value at a dot-path, creating intermediate hashes as needed (mirrors `TomlKit.query`)
+- `TomlKit.delete(data, path)` — delete a nested key by dot-path; returns the removed value or `nil`
+- `TomlKit.exists?(data, path)` — check whether a dot-path resolves to a value
+
 ## [0.3.0] - 2026-04-15
 
 ### Added

data/README.md

@@ -203,10 +203,10 @@ Philiprehberger::TomlKit.query(data, "servers[0].name")
 Philiprehberger::TomlKit.query(data, "missing.path", default: "N/A")
 # => "N/A"
 
-# Additional Query methods
-Philiprehberger::TomlKit::Query.set(data, "database.timeout", 30)
-Philiprehberger::TomlKit::Query.exists?(data, "database.host")  # => true
-Philiprehberger::TomlKit::Query.delete(data, "database.timeout") # => 30
+# Top-level mutators (mirror TomlKit.query)
+Philiprehberger::TomlKit.set(data, "database.timeout", 30)
+Philiprehberger::TomlKit.exists?(data, "database.host")  # => true
+Philiprehberger::TomlKit.delete(data, "database.timeout") # => 30
 ```
 
 ### Type Coercion Hooks
@@ -268,6 +268,9 @@ Philiprehberger::TomlKit::Diff.identical?(old_config, new_config)
 | `TomlKit.save(hash, path)` | Write a Hash as a TOML file |
 | `TomlKit.parse_with_comments(string)` | Parse TOML preserving comments, returns `CommentDocument` |
 | `TomlKit.query(data, path, default:)` | Dot-path access into nested hashes |
+| `TomlKit.set(data, path, value)` | Set a nested value by dot-path; creates intermediate hashes as needed |
+| `TomlKit.delete(data, path)` | Delete a nested key by dot-path; returns the removed value or `nil` |
+| `TomlKit.exists?(data, path)` | Check whether a dot-path resolves to a value |
 | `TomlKit.merge(left, right, strategy:)` | Deep merge two hashes with conflict resolution |
 | `TomlKit.diff(left, right)` | Compare two hashes, returns array of `Diff::Change` |
 | `Schema.new(properties)` | Create a schema for validation |

data/lib/philiprehberger/toml_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TomlKit
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/toml_kit.rb

@@ -85,6 +85,36 @@ module Philiprehberger
       Query.get(data, path, default: default)
     end
 
+    # Set a nested value using a dot-path. Creates intermediate hashes/arrays
+    # as needed and mutates `data` in place. Returns the value that was set.
+    #
+    # @param data [Hash] target hash
+    # @param path [String] dot-separated path (e.g., "database.host")
+    # @param value [Object] the value to set
+    # @return [Object] the value that was set
+    def self.set(data, path, value)
+      Query.set(data, path, value)
+    end
+
+    # Delete a value at the given dot-path. Returns the removed value or `nil`
+    # if the path did not resolve.
+    #
+    # @param data [Hash] target hash
+    # @param path [String] dot-separated path
+    # @return [Object, nil] the removed value, or nil
+    def self.delete(data, path)
+      Query.delete(data, path)
+    end
+
+    # Check whether a value exists at the given dot-path.
+    #
+    # @param data [Hash] target hash
+    # @param path [String] dot-separated path
+    # @return [Boolean]
+    def self.exists?(data, path)
+      Query.exists?(data, path)
+    end
+
     # Deep merge two TOML hashes.
     #
     # @param left [Hash] base hash

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-toml_kit
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-05-01 00:00:00.000000000 Z
 dependencies: []
 description: Parse and generate TOML v1.0 documents with full type support including
   datetimes, inline tables, and array of tables. Zero dependencies.