philiprehberger-ini_parser 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93708d0491bff1c5ee3788cbcb1aab784b9131a9ce058b91a6b03297952e41af
-  data.tar.gz: 7874c6feb79c7b55e637a97d4543f0f8b9a27ce527a8ab2ad0759681bf82cbb5
+  metadata.gz: 1cf47dfaf9c22a83ad5c659ed8264686b292c1f4250a5074405e8a87fd240ea5
+  data.tar.gz: f42efc500aa01b7e54472336039616897c16777392c70ff600d679c26966c9ce
 SHA512:
-  metadata.gz: ad831aa4e3cf52c46423e9b6d3adbe87e05f971080bbf83a596fead270150498416458195d582f05d3130ffb48b880f571ef9bf8dff94c2227d30eb8fdd44523
-  data.tar.gz: 52692e08ffd91e0bc95f5e2f045e456be2936bcf9ae0322b495dd298a0f6123923373e416f39faa3911809c0f978077683ebb959a26296cdbc96645fdb431504
+  metadata.gz: 621e14af7bb9aa33cc22c2db58485d80f0b18c17d5d0905cc20bda7107e411a2aeef502028673e4ec8ada389736d04ab608e7b8d19f7eab3bb34e16322781e33
+  data.tar.gz: ec971c74c15edb83fb355ced07fe7200e19a735e0fffb81b7de82f0fa8b7127891fa2e93a4819ca7bda8017cf80d217e4d28cf77a25749a5dc559ed182597c9a

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-09
+
+### Added
+- `valid?(string)` method to check INI syntax without raising exceptions
+- `get(hash, path, default: nil)` for dot-path access to nested config values
+- `set(hash, path, value)` for dot-path mutation of nested config values
+
 ## [0.2.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -115,6 +115,26 @@ diff[:removed] # => {"section" => {"old_key" => "value"}}
 diff[:changed] # => {"section" => {"key" => {from: "old", to: "new"}}}
 ```
 
+### Dot-Path Access
+
+Retrieve or set nested values using dot-separated paths:
+
+```ruby
+config = Philiprehberger::IniParser.load("config.ini")
+
+Philiprehberger::IniParser.get(config, "database.host")                   # => "localhost"
+Philiprehberger::IniParser.get(config, "database.missing", default: 3306) # => 3306
+
+Philiprehberger::IniParser.set(config, "database.port", 5433)
+```
+
+### Validation
+
+```ruby
+Philiprehberger::IniParser.valid?("[section]\nkey = value") # => true
+Philiprehberger::IniParser.valid?("not valid ini")          # => false
+```
+
 ### Listing Sections
 
 ```ruby
@@ -132,6 +152,9 @@ sections = Philiprehberger::IniParser.sections("config.ini")
 | `IniParser.save(hash, path)` | Write a Hash to an INI file |
 | `IniParser.merge(base, override)` | Deep merge two INI configurations |
 | `IniParser.diff(a, b)` | Compare two parsed hashes and return added, removed, and changed keys |
+| `IniParser.valid?(string)` | Check if an INI string is syntactically valid |
+| `IniParser.get(hash, path, default: nil)` | Retrieve a value using a dot-separated path |
+| `IniParser.set(hash, path, value)` | Set a value using a dot-separated path |
 | `IniParser.sections(string_or_path)` | Extract section names without fully parsing values |
 
 ## Development

data/lib/philiprehberger/ini_parser/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module IniParser
-    VERSION = '0.2.1'
+    VERSION = '0.3.0'
   end
 end

data/lib/philiprehberger/ini_parser.rb

@@ -95,6 +95,57 @@ module Philiprehberger
       result
     end
 
+    # Check whether an INI string is syntactically valid.
+    #
+    # @param string [String] INI content
+    # @return [Boolean] true if the content parses without errors
+    def self.valid?(string)
+      parse(string)
+      true
+    rescue ParseError
+      false
+    end
+
+    # Retrieve a value from a parsed hash using a dot-separated path.
+    #
+    # @param hash [Hash] parsed configuration
+    # @param path [String] dot-separated key path (e.g. "database.host")
+    # @param default [Object] value to return if the path does not exist
+    # @return [Object] the value at the path, or the default
+    def self.get(hash, path, default: nil)
+      keys = path.to_s.split('.')
+      current = hash
+
+      keys.each do |key|
+        return default unless current.is_a?(Hash) && current.key?(key)
+
+        current = current[key]
+      end
+
+      current
+    end
+
+    # Set a value in a parsed hash using a dot-separated path.
+    #
+    # Creates intermediate section hashes as needed.
+    #
+    # @param hash [Hash] parsed configuration (mutated in place)
+    # @param path [String] dot-separated key path (e.g. "database.host")
+    # @param value [Object] the value to set
+    # @return [Object] the value that was set
+    def self.set(hash, path, value)
+      keys = path.to_s.split('.')
+      last = keys.pop
+      current = hash
+
+      keys.each do |key|
+        current[key] = {} unless current[key].is_a?(Hash)
+        current = current[key]
+      end
+
+      current[last] = value
+    end
+
     # Extract section names from INI content without fully parsing values.
     #
     # @param string_or_path [String] INI content string or file path

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-ini_parser
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-10 00:00:00.000000000 Z
 dependencies: []
 description: Parse and generate INI configuration files with sections, inline comments,
   multiline values, escape sequences, quoted values, and automatic type coercion for
@@ -26,11 +26,11 @@ files:
 - lib/philiprehberger/ini_parser/parser.rb
 - lib/philiprehberger/ini_parser/serializer.rb
 - lib/philiprehberger/ini_parser/version.rb
-homepage: https://github.com/philiprehberger/rb-ini-parser
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-ini_parser
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-ini-parser
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-ini_parser
   source_code_uri: https://github.com/philiprehberger/rb-ini-parser
   changelog_uri: https://github.com/philiprehberger/rb-ini-parser/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-ini-parser/issues