const_conf 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f4332160b0b98f289ef65141551d279cdd3b24e7ff8e0187c04c1c9351ec645
-  data.tar.gz: 1d63082f8583882e65a772a0122b52613eea67eaecc70ccab49fe44c8efc0e8f
+  metadata.gz: 39c7a3e3a930c218b9e3bf2c87b181b720583ce3f9a4fd6639afb3b161ad7e43
+  data.tar.gz: de6815720e1506d5d0641955d287b3745fd519ae2659e0cd49b253fdbd7eddfa
 SHA512:
-  metadata.gz: 241953d4a3f7c6265134bd300a5847a0232b59a8e4a8a62526344f34334e510a422ba313da10816b15bc9d9356f35c77a5b05164c517655bc3f335427bff460d
-  data.tar.gz: 7d30537f86f8828455ba14a3cd08741d162e15fcf1821484743bcf092cb6982e7e4b509e67b8a0b713f9e5b7fcd92d0f03fd810c0c2de288b8cbe8b46f45b12f
+  metadata.gz: 2fa096aa90afd185a5324729a2701dc59245e03b42839fd1180dbed30ce2806eeabb24d3bd8f4addee2c7303e13bc27141bb548ca201dceef8b94c1097b2e8b8
+  data.tar.gz: 55f209ad258c28d3d3aa368e085a9a61a8120acdb64d98ee9ac94b5209c16b178bd5dfdb0855bd18cf9870d2130c16ecec3123d99d8ec172c63d9c8b3abbb154

data/CHANGES.md

@@ -1,5 +1,32 @@
 # Changes
 
+## 2025-09-18 v0.3.1
+
+- Replaced `require 'rails'` with `require 'active_support/all'` to reduce
+  dependency size
+- Updated `tins` dependency from version **1.42** to **1.43**
+- Updated `complex_config` dependency from version **0.22** to **0.23**
+- Updated development dependencies: `context_spook` from **0.3** to **0.4**,
+  `all_images` from **0.6** to **0.8**, and `simplecov` from **0.22** to
+  **0.23**
+- Added required Ruby version constraint of **= 3.2**
+- Replaced `it` with `_1` in block parameters for Ruby **3.2** compatibility
+- Updated Dockerfile to install `bundler` and `gem_hadar` gems directly
+- Changed test command from `rake test` to `rake spec`
+- Added `fail_fast: true` to CI configuration
+- Added support for Ruby **3.3** and **3.2** Alpine images in CI pipeline
+- Fixed prefix computation in nested modules with
+- Added `color:#07f` to all diagram node style definitions in `README.md` to
+  improve text visibility on colored backgrounds
+
+## 2025-09-13 v0.2.2
+
+- Simplified ignore patterns in `Rakefile` by changing `*.contexts/*` to
+  `.contexts`
+- Removed `.github` from ignored patterns in `Rakefile`
+- Updated `gem_hadar` dependency from ~> **2.2** to ~> **2.6** in gemspec
+- Added documentation for getter methods with exclamation mark
+
 ## 2025-09-07 v0.2.1
 
 - Removed explicit boolean coercion previously applied to test values in

data/README.md

@@ -109,6 +109,35 @@ end
 
 Or `nil` is returned, which can then be handled accordingly.
 
+### Note that **Getter Methods (`!`)** are also defined
+
+In addition to predicate methods, ConstConf automatically defines `!` methods
+that return the actual `ConstConf::Setting` object. These are useful for:
+
+- Accessing setting metadata and properties directly
+- Calling methods like `setting.view` for detailed configuration inspection of
+  a single setting.
+- Testing specific setting characteristics beyond just their values
+
+For example:
+
+```ruby
+# Returns the Setting object itself
+db_setting = AppConfig::DATABASE_URL!
+
+# Useful for debugging/inspection
+db_setting.view  # Shows detailed configuration information
+
+# Access setting properties directly
+puts db_setting.description
+puts db_setting.required?
+puts db_setting.sensitive?
+```
+
+This complements the `?` methods which return the actual configuration value
+when active, while the `!` methods provide access to the setting object for
+more advanced use cases.
+
 ### Configuration View Explanation
 
 The `AppConfig.view` output shows the complete configuration hierarchy with
@@ -220,16 +249,16 @@ graph TD
     Y --> AA[Default Value Handling]
     Y --> AB[Validation & Processing]
 
-    style A fill:#e1f5fe
-    style B fill:#f3e5f5
-    style C fill:#e8f5e9
-    style D fill:#fff3e0
-    style E fill:#fce4ec
-    style F fill:#f1f8e9
-    style G fill:#e0f2f1
-    style H fill:#f1f8e9
-    style I fill:#fafafa
-    style Y fill:#ffebee
+    style A fill:#e1f5fe;color:#07f
+    style B fill:#f3e5f5;color:#07f
+    style C fill:#e8f5e9;color:#07f
+    style D fill:#fff3e0;color:#07f
+    style E fill:#fce4ec;color:#07f
+    style F fill:#f1f8e9;color:#07f
+    style G fill:#e0f2f1;color:#07f
+    style H fill:#f1f8e9;color:#07f
+    style I fill:#fafafa;color:#07f
+    style Y fill:#ffebee;color:#07f
 ```
 
 #### FilePlugin

data/Rakefile

@@ -18,18 +18,20 @@ GemHadar do
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble', '.bundle',
     '.yardoc', 'doc', 'tags', 'coverage', 'cscope.out', '.starscope.db'
   package_ignore '.all_images.yml', '.gitignore', 'VERSION', '.utilsrc',
-    '.github', *Dir['.contexts/*']
+    '.contexts'
   readme      'README.md'
 
-  dependency 'tins',           '~> 1.42'
+  required_ruby_version '~> 3.2'
+
+  dependency 'tins',           '~> 1.43'
   dependency 'json',           '~> 2.0'
-  dependency 'complex_config', '~> 0.22'
+  dependency 'complex_config', '~> 0.23'
   dependency 'activesupport',  '~> 8'
   development_dependency 'debug'
   development_dependency 'rspec',         '~> 3.13'
-  development_dependency 'context_spook', '~> 0.3'
-  development_dependency 'all_images',    '~> 0.6'
-  development_dependency 'simplecov',     '~> 0.22'
+  development_dependency 'context_spook', '~> 0.4'
+  development_dependency 'all_images',    '~> 0.8'
+  development_dependency 'simplecov',     '~> 0.23'
 
   licenses << 'MIT'
 end

data/const_conf.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: const_conf 0.2.1 ruby lib
+# stub: const_conf 0.3.1 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "const_conf".freeze
-  s.version = "0.2.1".freeze
+  s.version = "0.3.1".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -16,20 +16,21 @@ Gem::Specification.new do |s|
   s.homepage = "https://github.com/flori/const_conf".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "ConstConf - Clean DSL for config settings with validation and Rails integration".freeze, "--main".freeze, "README.md".freeze]
+  s.required_ruby_version = Gem::Requirement.new("~> 3.2".freeze)
   s.rubygems_version = "3.6.9".freeze
   s.summary = "Clean DSL for config settings with validation and Rails integration".freeze
   s.test_files = ["spec/const_conf/dir_plugin_spec.rb".freeze, "spec/const_conf/env_dir_extension_spec.rb".freeze, "spec/const_conf/file_plugin_spec.rb".freeze, "spec/const_conf/json_plugin_spec.rb".freeze, "spec/const_conf/setting_accessor_spec.rb".freeze, "spec/const_conf/setting_spec.rb".freeze, "spec/const_conf/tree_spec.rb".freeze, "spec/const_conf/yaml_plugin_spec.rb".freeze, "spec/const_conf_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.2".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.6".freeze])
   s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<rspec>.freeze, ["~> 3.13".freeze])
-  s.add_development_dependency(%q<context_spook>.freeze, ["~> 0.3".freeze])
-  s.add_development_dependency(%q<all_images>.freeze, ["~> 0.6".freeze])
-  s.add_development_dependency(%q<simplecov>.freeze, ["~> 0.22".freeze])
-  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.42".freeze])
+  s.add_development_dependency(%q<context_spook>.freeze, ["~> 0.4".freeze])
+  s.add_development_dependency(%q<all_images>.freeze, ["~> 0.8".freeze])
+  s.add_development_dependency(%q<simplecov>.freeze, ["~> 0.23".freeze])
+  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.43".freeze])
   s.add_runtime_dependency(%q<json>.freeze, ["~> 2.0".freeze])
-  s.add_runtime_dependency(%q<complex_config>.freeze, ["~> 0.22".freeze])
+  s.add_runtime_dependency(%q<complex_config>.freeze, ["~> 0.23".freeze])
   s.add_runtime_dependency(%q<activesupport>.freeze, ["~> 8".freeze])
 end

data/lib/const_conf/setting.rb

@@ -226,7 +226,7 @@ class ConstConf::Setting
   #
   # @return [String] the constructed environment variable name
   def env_var_name
-    prefix = @prefix.full? { "#{it}::" }.to_s
+    prefix = @prefix.full? { "#{_1}::" }.to_s
     name.sub(/^#{parent_namespace}::/,  prefix).gsub(/::/, ?_)
   end
 

data/lib/const_conf/tree.rb

@@ -71,7 +71,7 @@ module ConstConf
       # @return [ConstConf::Tree] a tree object representing the module's
       # configuration hierarchy
       def convert_module(modul)
-        desc = "#{modul.description.full? { italic(' # %s' % it) }}"
+        desc = "#{modul.description.full? { italic(' # %s' % _1) }}"
         obj  = new("#{modul.name}#{desc}")
         obj << new("prefix #{modul.prefix.inspect}")
         obj << new("#{modul.settings.size} settings")
@@ -105,7 +105,7 @@ module ConstConf
       #
       # @return [ConstConf::Tree] a tree node representing the configuration setting
       def convert_setting(setting)
-        desc = "#{setting.description.full? { italic(' # %s' % it) }}"
+        desc = "#{setting.description.full? { italic(' # %s' % _1) }}"
         obj  = new("#{bold(setting.name)}#{desc}")
 
         length = (Tins::Terminal.columns / 4).clamp(20..)

data/lib/const_conf/version.rb

@@ -1,6 +1,6 @@
 module ConstConf
   # ConstConf version
-  VERSION         = '0.2.1'
+  VERSION         = '0.3.1'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/const_conf.rb

@@ -1,5 +1,5 @@
 require 'tins/xt'
-require 'rails'
+require 'active_support/all'
 
 # A configuration management module that provides environment variable-based
 # settings with validation and thread-safe operations.
@@ -94,7 +94,7 @@ module ConstConf
     # files. It performs this operation in a thread-safe manner using the
     # monitor for synchronization.
     def reload
-      monitor.synchronize { destroy.each { load it } }
+      monitor.synchronize { destroy.each { load _1 } }
       nil
     end
   end
@@ -140,7 +140,7 @@ module ConstConf
           include ConstConf
         end
         prefix = [ self, *module_parents ].find {
-          !it.prefix.nil? and break it.prefix
+          !_1.prefix.nil? and break _1.prefix
         }
         const.prefix [ prefix, const.name.sub(/.*::/, '') ].select(&:present?) * ?_
       end
@@ -149,7 +149,7 @@ module ConstConf
           self.last_setting = nil
           remove_const(id)
           prefix = [ self, *module_parents ].find {
-            !it.prefix.nil? and break it.prefix
+            !_1.ask_and_send(:prefix).nil? and break _1.prefix
           }
           setting = Setting.new(name: [ name, id ], prefix:, &setting_block)
           if previous_setting = outer_configuration.setting_for(setting.env_var_name)
@@ -274,7 +274,7 @@ module ConstConf
     # @return [ Module, nil ] the outer configuration module if found, or nil
     # if none exists
     def outer_configuration
-      [ self, *module_parents ].reverse_each.find { it < ConstConf }
+      [ self, *module_parents ].reverse_each.find { _1 < ConstConf }
     end
 
     # Returns an array containing all nested configuration modules recursively,
@@ -442,8 +442,8 @@ module ConstConf
       configuration_modules = [ self ]
       while configuration = configuration_modules.pop
         configuration.nested_configurations.reverse_each do
-          configuration_modules.member?(it) and next
-          configuration_modules << it
+          configuration_modules.member?(_1) and next
+          configuration_modules << _1
         end
         yield configuration
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: const_conf
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.1
 platform: ruby
 authors:
 - Florian Frank
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: debug
   requirement: !ruby/object:Gem::Requirement
@@ -57,56 +57,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: all_images
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.23'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.23'
 - !ruby/object:Gem::Dependency
   name: tins
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.42'
+        version: '1.43'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.42'
+        version: '1.43'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -127,14 +127,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.23'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.23'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -220,9 +220,9 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="