philiprehberger-toml_kit 0.2.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f26a997551860b6225437012c11bee16dd81f8b20be5daf280d87e10b3f4b842
-  data.tar.gz: 9bf2e377233636b4bf619b0bcacec17d0fa2638a46d329230eb1c2ca9af35b3b
+  metadata.gz: 8cdca57335aa874bbc1ed3f637df91a738bddc6316b82df101925c0ed383fc37
+  data.tar.gz: 6edfe631dd620f5def0c1477db9a14a2bed6eba13810a9ce03d3548abba062eb
 SHA512:
-  metadata.gz: 328d22b2d58478a2890f3e6b6470cfb6c188ff96fc0db22570422b4daecf362745659fe34a2a08a6fa6dd04208b98c67d5580811729cb6560cd7a484fa244850
-  data.tar.gz: 8cc9518b64da7aedad615f29cbb480b8778a23d9461ef1efbfe36431b79793aef03625fbe0d24459b46a4ec5df52991d6eaeacc0da6ee984d4637266f47abe01
+  metadata.gz: 56b547d9009966fc988cc954fca8a3a40b35057306b936db0a487f275a3b97bae6e959f08134c08f40198896a335bfde902484e9c026e09c7a5116cf39d5a8a4
+  data.tar.gz: 745fdff008a2c06306ccc64567119401b12578369783fe6afcf39003ef0d4604a89ff3dc2279d765eb82e68a720cdf3d888ca502379bcab94cd8682508a5f5f6

data/CHANGELOG.md

@@ -7,6 +7,18 @@ 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
+- `TomlKit.valid?(string)` predicate for checking whether a string parses as TOML without raising
+
 ## [0.2.4] - 2026-04-09
 
 ### Fixed

data/README.md

@@ -56,6 +56,15 @@ config["database"]["host"]   # => "localhost"
 config["servers"][0]["name"]  # => "alpha"
 ```
 
+### Validity Check
+
+Check whether a string is valid TOML without raising:
+
+```ruby
+Philiprehberger::TomlKit.valid?('key = "value"')  # => true
+Philiprehberger::TomlKit.valid?('key = [broken')  # => false
+```
+
 ### Loading Files
 
 ```ruby
@@ -194,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
@@ -253,11 +262,15 @@ Philiprehberger::TomlKit::Diff.identical?(old_config, new_config)
 | Method | Description |
 |--------|-------------|
 | `TomlKit.parse(string)` | Parse a TOML string into a Hash |
+| `TomlKit.valid?(string)` | Return `true` if the string parses as valid TOML |
 | `TomlKit.load(path)` | Parse a TOML file into a Hash |
 | `TomlKit.dump(hash)` | Serialize a Hash to a TOML string |
 | `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.2.4'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/toml_kit.rb

@@ -29,6 +29,17 @@ module Philiprehberger
       Parser.new.parse(string)
     end
 
+    # Check whether a string parses as valid TOML without raising.
+    #
+    # @param string [String] TOML document
+    # @return [Boolean] true if the string is valid TOML
+    def self.valid?(string)
+      parse(string)
+      true
+    rescue ParseError
+      false
+    end
+
     # Parse a TOML file into a Ruby Hash.
     #
     # @param path [String] path to a TOML file
@@ -74,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.2.4
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 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.