hanami-settings-stores 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c8228cf550f63d29462cb128f2949d9fa9a744aac843fbac90a811a5d550ec4
-  data.tar.gz: f4abd1d91b57a4946712d602f1f37d1274d5ac89dc2e2e18eeb5f756877e4875
+  metadata.gz: ce06f133c66bd28ca84dc455d158dea1037aafd6b09d5a3234a0c46f7ea4d7b3
+  data.tar.gz: 6a1353b35214301a89a3a43ccd34b580733c7a92e61fc32b0e2303ba1f4ec3fc
 SHA512:
-  metadata.gz: 6986d005390d907eadd3342e78da83016f495c91c48dbd7c53ecdb84d0aa3979ed459d2f5307445ae2e358fdae9db1ffa8cda6ddc02813cd199c61f39a81440f
-  data.tar.gz: bf07691cc6721383c34c095f4c8122ee0fc6724e970c2084db25cea20e3fa93d579f751d19a81bfbd299642e28cb4d8b2fa9fc7cf849c0fd6db6ff716b795c6e
+  metadata.gz: ba70b140ad251b828e18e1746e28bafedb8a40468b0fe49a0e80f40b1e7a27296880fabca5d6888d82928d801ed9788f7aa1846e9c3a61fcfbe975cb0e460ac4
+  data.tar.gz: '038e9c869bbff980f5eb563f412bf3c321ce61e216a2e269bf53e1e22eb58dd8180d2552b4dc1a3b9594cf3a0f691523dd443efb3c24d6c63920b3d7deba5afe'

data/CHANGELOG.md

@@ -7,8 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## v0.1.0 - 2026-03-17
+## [v0.1.1] - 2026-08-20
+
+### Added
+
+- `FileStore` with json, toml, and yaml support
+
+### Removed
+
+- removed unnecessary `hanami` gem as a runtime dependency
+
+## [v0.1.0] - 2026-03-17
 
 Initial release.
 
-[Unreleased]: https://github.com/aaronmallen/hanami-settings-stores/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/aaronmallen/hanami-settings-stores/compare/0.1.1...HEAD
+[v0.1.1]: https://github.com/aaronmallen/hanami-settings-stores/compare/0.1.0...0.1.1
+[v0.1.0]: https://github.com/aaronmallen/hanami-settings-stores/releases/tag/0.1.0

data/lib/hanami/settings/file_store.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "erb"
+
+module Hanami
+  class Settings
+    # A settings store backed by a local JSON, TOML, or YAML file.
+    #
+    # The file is read and parsed once, when the store is built. Its contents run through ERB
+    # first, so a file can interpolate Ruby.
+    #
+    # Only top level keys resolve. Keys are compared as strings, so a setting named
+    # `:database_url` matches the `database_url` key in the file.
+    #
+    # @example
+    #   # config/settings.yml
+    #   database_url: postgres://localhost/myapp
+    #   session_secret: <%= ENV.fetch("SESSION_SECRET") %>
+    #
+    #   # config/app.rb
+    #   config.settings_store = Hanami::Settings::CompositeStore.new(
+    #     Hanami::Settings::EnvStore.new,
+    #     Hanami::Settings::FileStore.new("config/settings.yml")
+    #   )
+    #
+    # @api public
+    # @since 0.1.1
+    class FileStore
+      # @api private
+      # @since 0.1.1
+      JSON_EXTENSIONS = %w[.json].freeze
+      private_constant :JSON_EXTENSIONS
+
+      # @api private
+      # @since 0.1.1
+      TOML_EXTENSIONS = %w[.toml].freeze
+      private_constant :TOML_EXTENSIONS
+
+      # @api private
+      # @since 0.1.1
+      YAML_EXTENSIONS = %w[.yaml .yml].freeze
+      private_constant :YAML_EXTENSIONS
+
+      # @api private
+      # @since 0.1.1
+      EXTENSIONS = (JSON_EXTENSIONS + TOML_EXTENSIONS + YAML_EXTENSIONS).freeze
+      private_constant :EXTENSIONS
+
+      # @param filepath [String, Pathname] path to the settings file
+      # @raise [Errno::ENOENT] if the file does not exist
+      # @raise [ArgumentError] if the store cannot parse the file extension
+      def initialize(filepath)
+        source = ERB.new(File.read(filepath)).result
+        @settings = case File.extname(filepath.to_s)
+                    when *JSON_EXTENSIONS
+                      require "json"
+                      JSON.parse(source)
+                    when *TOML_EXTENSIONS
+                      require "toml"
+                      TOML::Parser.new(source).parsed
+                    when *YAML_EXTENSIONS
+                      require "yaml"
+                      YAML.safe_load(source, aliases: true) || {}
+                    else raise ArgumentError, "cannot parse #{filepath}: expected one of #{EXTENSIONS.join(", ")}"
+                    end
+      end
+
+      # Fetches a setting value from the parsed file.
+      #
+      # @param name [String, Symbol] the setting name
+      # @param args [Array] optional default value
+      # @yield [name] optional block for default value
+      # @return [Object] the setting value
+      # @raise [KeyError] if the file has no such key and no default is given
+      #
+      # @api public
+      # @since 0.1.1
+      def fetch(name, *args, &block)
+        @settings.fetch(name.to_s, *args, &block)
+      end
+    end
+  end
+end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: hanami-settings-stores
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Aaron Allen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-17 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: hanami
+  name: toml
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -38,8 +38,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
-description: Pluggable settings stores that fetch secrets from password managers like
-  1Password and Bitwarden for use with Hanami::Settings.
+description: Settings stores that fetch values from password managers like 1Password
+  and Bitwarden, or from a local JSON, TOML, or YAML file, for use with Hanami::Settings.
 email:
 - hello@aaronmallen.me
 executables: []
@@ -51,6 +51,7 @@ files:
 - lib/hanami-settings-stores.rb
 - lib/hanami/settings/bitwarden_store.rb
 - lib/hanami/settings/composite_store.rb
+- lib/hanami/settings/file_store.rb
 - lib/hanami/settings/one_password_store.rb
 homepage: https://github.com/aaronmallen/hanami-settings-stores
 licenses:
@@ -79,5 +80,5 @@ requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: Password manager-backed settings stores for Hanami
+summary: Pluggable settings stores for Hanami
 test_files: []