anyway_config 2.7.2 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4687cf9a7a8ee20387726a47452a2e2b204742096d7070885f176e53e1fc285
-  data.tar.gz: 36dc3777a2cce19788c0e189f740f0dccc708a02bf240a5ded89533e85929f6e
+  metadata.gz: 414ea061d65832bc84e8cd08504abbea04e356431f2e85210fb458780bc9623b
+  data.tar.gz: 5ebbb3638e8ad4b870de6a8a8d3a35560a0cc4f0f13095da950e50aeb04dc928
 SHA512:
-  metadata.gz: bf601ef44033901a08350ba687b0d9f7ad112160b3cc6a6058168fe44e7093ef6cf1e28c382feb7c70fd0177b27b2d79cf893bf93a1ccb9b61143624ebd49f32
-  data.tar.gz: af6505ce86371203fb4e1744123191904b99b837892ff6b79fd722f051ed1f2b01fcbb0075bcb92f0e20ff07cea56597262987145dea1ba20d36732b99ae4059
+  metadata.gz: 3a4c7e785d4a9153b64247c1b5730bf72c73ced33967a15359c5651f2da9390b8f3ad4baba2d226eb8e66e4084cc5871d69dbf9790b67c5aa8f795b2c0142f99
+  data.tar.gz: b5a2e8c483fb9120f53439e90391f6b4ef9d605cd2531a91223a0a47e43e01912cf3da8e739054a1d2d12240aadd79dbf3e1558374ee5985c7a04d0f912c291e

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## master
 
+- Do not require optional loader dependencies to speed up loading. ([@ardecvz][])
+
+## 2.8.0 (2025-06-24)
+
+- Add `configuration_sources` option to config classes to specify which data sources to use. ([@palkan][])
+
 ## 2.7.2 (2025-04-01)
 
 - Address NameError: instance variable @secrets not defined issue ([@fbuys][])
@@ -604,3 +610,4 @@ No we're dependency-free!
 [@OlegChuev]: https://github.com/OlegChuev
 [@dominikb]: https://github.com/dominikb
 [@klondaiker]: https://github.com/klondaiker
+[@ardecvz]: https://github.com/ardecvz

data/README.md

@@ -105,8 +105,8 @@ gem "anyway_config", "~> 2.0"
 
 ### Supported Ruby versions
 
-- Ruby (MRI) >= 2.5.0
-- JRuby >= 9.2.9
+- Ruby (MRI) >= 2.7.0
+- JRuby >= 9.3.0
 
 ## Usage
 
@@ -347,7 +347,7 @@ end
 
 ## Using with Rails
 
-**NOTE:** version 2.x supports Rails >= 5.0; for Rails 4.x use version 1.x of the gem.
+**NOTE:** version 2.x supports Rails >= 6.0; for older versions use version 1.x of the gem.
 
 We recommend going through [Data population](#data-population) and [Organizing configs](#organizing-configs) sections first,
 and then use [Rails generators](#generators) to make your application Anyway Config-ready.
@@ -653,8 +653,6 @@ MYCOOLGEM = "Nif-Nif, Naf-Naf and Nouf-Nouf"
 
 ## Type coercion
 
-> 🆕 v2.2.0
-
 You can define custom type coercion rules to convert string data to config values. To do that, use `.coerce_types` method:
 
 ```ruby
@@ -827,6 +825,8 @@ class MyConfig < Anyway::Config
 end
 ```
 
+**NOTE:** You can opt-out from EJSON loader by specifying the `ANYWAY_CONFIG_DISABLE_EJSON=true` env var (in case you have the `ejson` executable in your PATH, but don't want to use it with Anyway Config).
+
 ### Custom loaders
 
 You can provide your own data loaders or change the existing ones using the Loaders API (which is very similar to Rack middleware builder):
@@ -884,6 +884,24 @@ def call(name:, **_opts)
 end
 ```
 
+### Specifying which loaders to use
+
+Sometimes you may want to pick only specific loaders for a particular configuration class. For that, you can use the `.configuration_sources=` writer method:
+
+```ruby
+class MyConfig < Anyway::Config
+  # Only load configuraiton data from ENV and credentials
+  self.configuration_sources = [:env, :credentials]
+  # ...
+end
+```
+
+You can access the list of available loader identifiers as follows:
+
+```ruby
+Anyway.loaders.keys #=> [:yml, :credentials, :env]
+```
+
 ## Tracing
 
 Since Anyway Config loads data from multiple source, it could be useful to know where a particular value came from.

data/lib/.rbnext/2.7/anyway/loaders/yaml.rb

@@ -3,7 +3,6 @@
 require "pathname"
 require "anyway/ext/hash"
 
-using RubyNext
 using Anyway::Ext::Hash
 
 module Anyway

data/lib/.rbnext/2.7/anyway/tracing.rb

@@ -29,7 +29,7 @@ module Anyway
       def record_value(val, *path, **opts)
         key = path.pop
         trace = if val.is_a?(Hash)
-          Trace.new.tap { |_1| it = _1;it.merge_values(val, **opts) }
+          Trace.new.tap { |it| it.merge_values(val, **opts) }
         else
           Trace.new(:value, val, **opts)
         end
@@ -84,7 +84,7 @@ module Anyway
 
       def to_h
         if trace?
-          value.transform_values(&:to_h).tap { |_1| it = _1;it.default_proc = nil }
+          value.transform_values(&:to_h).tap { |it| it.default_proc = nil }
         else
           {value: value, source: source}
         end

data/lib/.rbnext/2.7/anyway/type_casting.rb

@@ -34,7 +34,7 @@ module Anyway
 
       if array
         raw_arr = raw.is_a?(String) ? raw.split(/\s*,\s*/) : Array(raw)
-        raw_arr.map { |_1| it = _1;caster.call(it) }
+        raw_arr.map { |it| caster.call(it) }
       else
         caster.call(raw)
       end

data/lib/.rbnext/3.0/anyway/auto_cast.rb

@@ -13,9 +13,9 @@ module Anyway
 
         case val
         when Hash
-          val.transform_values { it = _1;call(it) }
+          val.transform_values { |it| call(it) }
         when ARRAY_RXP
-          val.split(/\s*,\s*/).map { it = _1;call(it) }
+          val.split(/\s*,\s*/).map { |it| call(it) }
         when /\A(true|t|yes|y)\z/i
           true
         when /\A(false|f|no|n)\z/i

data/lib/.rbnext/3.0/anyway/config.rb

@@ -4,7 +4,6 @@ require "anyway/optparse_config"
 require "anyway/dynamic_config"
 
 module Anyway # :nodoc:
-  using RubyNext
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
@@ -154,7 +153,7 @@ module Anyway # :nodoc:
         if block
           load_callbacks << BlockCallback.new(block)
         else
-          load_callbacks.push(*names.map { it = _1;NamedCallback.new(it) })
+          load_callbacks.push(*names.map { |it| NamedCallback.new(it) })
         end
       end
 
@@ -261,6 +260,15 @@ module Anyway # :nodoc:
         @fallback_type_caster = ::Anyway::NoCast
       end
 
+      def configuration_sources
+        return @configuration_sources if instance_variable_defined?(:@configuration_sources)
+        return @configuration_sources = superclass.configuration_sources.dup if superclass.respond_to?(:configuration_sources)
+
+        @configuration_sources = nil
+      end
+
+      attr_writer :configuration_sources
+
       private
 
       def define_config_accessor(*names)
@@ -380,7 +388,7 @@ module Anyway # :nodoc:
       trace&.keep_if { |key| self.class.config_attributes.include?(key.to_sym) }
 
       # Run on_load callbacks
-      self.class.load_callbacks.each { it = _1;it.apply_to(self) }
+      self.class.load_callbacks.each { |it| it.apply_to(self) }
 
       # Set trace after we write all the values to
       # avoid changing the source to accessor
@@ -390,7 +398,10 @@ module Anyway # :nodoc:
     end
 
     def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
+      source_filter = self.class.configuration_sources
+
+      Anyway.loaders.each do |(id, loader)|
+        next if source_filter && !source_filter.include?(id)
         Utils.deep_merge!(base_config, loader.call(**opts))
       end
       base_config

data/lib/.rbnext/3.0/anyway/loaders/yaml.rb

@@ -3,7 +3,6 @@
 require "pathname"
 require "anyway/ext/hash"
 
-using RubyNext
 using Anyway::Ext::Hash
 
 module Anyway

data/lib/.rbnext/3.0/anyway/loaders.rb

@@ -1,9 +1,14 @@
 # frozen_string_literal: true
 
-module Anyway
-  using RubyNext
+require "anyway/loaders/base"
 
+module Anyway
   module Loaders
+    autoload :YAML, "anyway/loaders/yaml"
+    autoload :Env, "anyway/loaders/env"
+    autoload :EJSON, "anyway/loaders/ejson"
+    autoload :Doppler, "anyway/loaders/doppler"
+
     class Registry
       attr_reader :registry
 
@@ -55,6 +60,8 @@ module Anyway
         registry.each(&block)
       end
 
+      def keys() ;  registry.map(&:first); end
+
       def freeze() ;  registry.freeze; end
 
       private
@@ -71,9 +78,3 @@ module Anyway
     end
   end
 end
-
-require "anyway/loaders/base"
-require "anyway/loaders/yaml"
-require "anyway/loaders/env"
-require "anyway/loaders/doppler"
-require "anyway/loaders/ejson"

data/lib/.rbnext/3.0/anyway/tracing.rb

@@ -29,7 +29,7 @@ module Anyway
       def record_value(val, *path, **opts)
         key = path.pop
         trace = if val.is_a?(Hash)
-          Trace.new.tap { it = _1;it.merge_values(val, **opts) }
+          Trace.new.tap { |it| it.merge_values(val, **opts) }
         else
           Trace.new(:value, val, **opts)
         end
@@ -84,7 +84,7 @@ module Anyway
 
       def to_h
         if trace?
-          value.transform_values(&:to_h).tap { it = _1;it.default_proc = nil }
+          value.transform_values(&:to_h).tap { |it| it.default_proc = nil }
         else
           {value: value, source: source}
         end

data/lib/.rbnext/3.1/anyway/config.rb

@@ -4,7 +4,6 @@ require "anyway/optparse_config"
 require "anyway/dynamic_config"
 
 module Anyway # :nodoc:
-  using RubyNext
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
@@ -154,7 +153,7 @@ module Anyway # :nodoc:
         if block
           load_callbacks << BlockCallback.new(block)
         else
-          load_callbacks.push(*names.map { it = _1;NamedCallback.new(it) })
+          load_callbacks.push(*names.map { |it| NamedCallback.new(it) })
         end
       end
 
@@ -261,6 +260,15 @@ module Anyway # :nodoc:
         @fallback_type_caster = ::Anyway::NoCast
       end
 
+      def configuration_sources
+        return @configuration_sources if instance_variable_defined?(:@configuration_sources)
+        return @configuration_sources = superclass.configuration_sources.dup if superclass.respond_to?(:configuration_sources)
+
+        @configuration_sources = nil
+      end
+
+      attr_writer :configuration_sources
+
       private
 
       def define_config_accessor(*names)
@@ -380,7 +388,7 @@ module Anyway # :nodoc:
       trace&.keep_if { |key| self.class.config_attributes.include?(key.to_sym) }
 
       # Run on_load callbacks
-      self.class.load_callbacks.each { it = _1;it.apply_to(self) }
+      self.class.load_callbacks.each { |it| it.apply_to(self) }
 
       # Set trace after we write all the values to
       # avoid changing the source to accessor
@@ -390,7 +398,10 @@ module Anyway # :nodoc:
     end
 
     def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
+      source_filter = self.class.configuration_sources
+
+      Anyway.loaders.each do |(id, loader)|
+        next if source_filter && !source_filter.include?(id)
         Utils.deep_merge!(base_config, loader.call(**opts))
       end
       base_config

data/lib/.rbnext/3.1/anyway/env.rb

@@ -4,7 +4,6 @@ module Anyway
   # Parses environment variables and provides
   # method-like access
   class Env
-    using RubyNext
     using Anyway::Ext::DeepDup
     using Anyway::Ext::Hash
 

data/lib/.rbnext/3.1/anyway/tracing.rb

@@ -29,7 +29,7 @@ module Anyway
       def record_value(val, *path, **opts)
         key = path.pop
         trace = if val.is_a?(Hash)
-          Trace.new.tap { it = _1;it.merge_values(val, **opts) }
+          Trace.new.tap { |it| it.merge_values(val, **opts) }
         else
           Trace.new(:value, val, **opts)
         end
@@ -84,7 +84,7 @@ module Anyway
 
       def to_h
         if trace?
-          value.transform_values(&:to_h).tap { it = _1;it.default_proc = nil }
+          value.transform_values(&:to_h).tap { |it| it.default_proc = nil }
         else
           {value: value, source: source}
         end

data/lib/.rbnext/3.2/anyway/config.rb

@@ -4,7 +4,6 @@ require "anyway/optparse_config"
 require "anyway/dynamic_config"
 
 module Anyway # :nodoc:
-  using RubyNext
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
@@ -154,7 +153,7 @@ module Anyway # :nodoc:
         if block
           load_callbacks << BlockCallback.new(block)
         else
-          load_callbacks.push(*names.map { it = _1;NamedCallback.new(it) })
+          load_callbacks.push(*names.map { |it| NamedCallback.new(it) })
         end
       end
 
@@ -261,6 +260,15 @@ module Anyway # :nodoc:
         @fallback_type_caster = ::Anyway::NoCast
       end
 
+      def configuration_sources
+        return @configuration_sources if instance_variable_defined?(:@configuration_sources)
+        return @configuration_sources = superclass.configuration_sources.dup if superclass.respond_to?(:configuration_sources)
+
+        @configuration_sources = nil
+      end
+
+      attr_writer :configuration_sources
+
       private
 
       def define_config_accessor(*names)
@@ -380,7 +388,7 @@ module Anyway # :nodoc:
       trace&.keep_if { |key| self.class.config_attributes.include?(key.to_sym) }
 
       # Run on_load callbacks
-      self.class.load_callbacks.each { it = _1;it.apply_to(self) }
+      self.class.load_callbacks.each { |it| it.apply_to(self) }
 
       # Set trace after we write all the values to
       # avoid changing the source to accessor
@@ -390,7 +398,10 @@ module Anyway # :nodoc:
     end
 
     def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
+      source_filter = self.class.configuration_sources
+
+      Anyway.loaders.each do |(id, loader)|
+        next if source_filter && !source_filter.include?(id)
         Utils.deep_merge!(base_config, loader.call(**opts))
       end
       base_config

data/lib/.rbnext/3.2/anyway/tracing.rb

@@ -29,7 +29,7 @@ module Anyway
       def record_value(val, *path, **opts)
         key = path.pop
         trace = if val.is_a?(Hash)
-          Trace.new.tap { it = _1;it.merge_values(val, **opts) }
+          Trace.new.tap { |it| it.merge_values(val, **opts) }
         else
           Trace.new(:value, val, **opts)
         end
@@ -84,7 +84,7 @@ module Anyway
 
       def to_h
         if trace?
-          value.transform_values(&:to_h).tap { it = _1;it.default_proc = nil }
+          value.transform_values(&:to_h).tap { |it| it.default_proc = nil }
         else
           {value:, source:}
         end

data/lib/.rbnext/3.4/anyway/auto_cast.rb

@@ -13,9 +13,9 @@ module Anyway
 
         case val
         when Hash
-          val.transform_values { it = _1;call(it) }
+          val.transform_values { |it| call(it) }
         when ARRAY_RXP
-          val.split(/\s*,\s*/).map { it = _1;call(it) }
+          val.split(/\s*,\s*/).map { |it| call(it) }
         when /\A(true|t|yes|y)\z/i
           true
         when /\A(false|f|no|n)\z/i

data/lib/.rbnext/3.4/anyway/config.rb

@@ -4,7 +4,6 @@ require "anyway/optparse_config"
 require "anyway/dynamic_config"
 
 module Anyway # :nodoc:
-  using RubyNext
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
@@ -154,7 +153,7 @@ module Anyway # :nodoc:
         if block
           load_callbacks << BlockCallback.new(block)
         else
-          load_callbacks.push(*names.map { it = _1;NamedCallback.new(it) })
+          load_callbacks.push(*names.map { |it| NamedCallback.new(it) })
         end
       end
 
@@ -261,6 +260,15 @@ module Anyway # :nodoc:
         @fallback_type_caster = ::Anyway::NoCast
       end
 
+      def configuration_sources
+        return @configuration_sources if instance_variable_defined?(:@configuration_sources)
+        return @configuration_sources = superclass.configuration_sources.dup if superclass.respond_to?(:configuration_sources)
+
+        @configuration_sources = nil
+      end
+
+      attr_writer :configuration_sources
+
       private
 
       def define_config_accessor(*names)
@@ -380,7 +388,7 @@ module Anyway # :nodoc:
       trace&.keep_if { |key| self.class.config_attributes.include?(key.to_sym) }
 
       # Run on_load callbacks
-      self.class.load_callbacks.each { it = _1;it.apply_to(self) }
+      self.class.load_callbacks.each { |it| it.apply_to(self) }
 
       # Set trace after we write all the values to
       # avoid changing the source to accessor
@@ -390,7 +398,10 @@ module Anyway # :nodoc:
     end
 
     def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
+      source_filter = self.class.configuration_sources
+
+      Anyway.loaders.each do |(id, loader)|
+        next if source_filter && !source_filter.include?(id)
         Utils.deep_merge!(base_config, loader.call(**opts))
       end
       base_config

data/lib/.rbnext/3.4/anyway/tracing.rb

@@ -29,7 +29,7 @@ module Anyway
       def record_value(val, *path, **opts)
         key = path.pop
         trace = if val.is_a?(Hash)
-          Trace.new.tap { it = _1;it.merge_values(val, **opts) }
+          Trace.new.tap { |it| it.merge_values(val, **opts) }
         else
           Trace.new(:value, val, **opts)
         end
@@ -84,7 +84,7 @@ module Anyway
 
       def to_h
         if trace?
-          value.transform_values(&:to_h).tap { it = _1;it.default_proc = nil }
+          value.transform_values(&:to_h).tap { |it| it.default_proc = nil }
         else
           {value:, source:}
         end

data/lib/.rbnext/3.4/anyway/type_casting.rb

@@ -34,7 +34,7 @@ module Anyway
 
       if array
         raw_arr = raw.is_a?(String) ? raw.split(/\s*,\s*/) : Array(raw)
-        raw_arr.map { it = _1;caster.call(it) }
+        raw_arr.map { |it| caster.call(it) }
       else
         caster.call(raw)
       end

data/lib/anyway/config.rb

@@ -4,7 +4,6 @@ require "anyway/optparse_config"
 require "anyway/dynamic_config"
 
 module Anyway # :nodoc:
-  using RubyNext
   using Anyway::Ext::DeepDup
   using Anyway::Ext::DeepFreeze
   using Anyway::Ext::Hash
@@ -261,6 +260,15 @@ module Anyway # :nodoc:
         @fallback_type_caster = ::Anyway::NoCast
       end
 
+      def configuration_sources
+        return @configuration_sources if instance_variable_defined?(:@configuration_sources)
+        return @configuration_sources = superclass.configuration_sources.dup if superclass.respond_to?(:configuration_sources)
+
+        @configuration_sources = nil
+      end
+
+      attr_writer :configuration_sources
+
       private
 
       def define_config_accessor(*names)
@@ -390,7 +398,10 @@ module Anyway # :nodoc:
     end
 
     def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
+      source_filter = self.class.configuration_sources
+
+      Anyway.loaders.each do |(id, loader)|
+        next if source_filter && !source_filter.include?(id)
         Utils.deep_merge!(base_config, loader.call(**opts))
       end
       base_config

data/lib/anyway/env.rb

@@ -4,7 +4,6 @@ module Anyway
   # Parses environment variables and provides
   # method-like access
   class Env
-    using RubyNext
     using Anyway::Ext::DeepDup
     using Anyway::Ext::Hash
 

data/lib/anyway/loaders/doppler.rb

@@ -5,8 +5,6 @@ require "net/http"
 require "json"
 
 module Anyway
-  using RubyNext
-
   module Loaders
     class Doppler < Base
       class RequestError < StandardError; end

data/lib/anyway/loaders/env.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module Anyway
-  using RubyNext
-
   module Loaders
     class Env < Base
       def call(env_prefix:, **_options)

data/lib/anyway/loaders/yaml.rb

@@ -3,7 +3,6 @@
 require "pathname"
 require "anyway/ext/hash"
 
-using RubyNext
 using Anyway::Ext::Hash
 
 module Anyway

data/lib/anyway/loaders.rb

@@ -1,9 +1,14 @@
 # frozen_string_literal: true
 
-module Anyway
-  using RubyNext
+require "anyway/loaders/base"
 
+module Anyway
   module Loaders
+    autoload :YAML, "anyway/loaders/yaml"
+    autoload :Env, "anyway/loaders/env"
+    autoload :EJSON, "anyway/loaders/ejson"
+    autoload :Doppler, "anyway/loaders/doppler"
+
     class Registry
       attr_reader :registry
 
@@ -55,6 +60,8 @@ module Anyway
         registry.each(&block)
       end
 
+      def keys() = registry.map(&:first)
+
       def freeze() = registry.freeze
 
       private
@@ -71,9 +78,3 @@ module Anyway
     end
   end
 end
-
-require "anyway/loaders/base"
-require "anyway/loaders/yaml"
-require "anyway/loaders/env"
-require "anyway/loaders/doppler"
-require "anyway/loaders/ejson"

data/lib/anyway/option_parser_builder.rb

@@ -19,7 +19,7 @@ module Anyway # :nodoc:
       private
 
       def option_parser_on_args(key, flag: false, desc: nil, type: ::String)
-        on_args = ["--#{key.to_s.tr("_", "-")}#{flag ? "" : " VALUE"}"]
+        on_args = ["--#{key.to_s.tr("_", "-")}#{" VALUE" unless flag}"]
         on_args << type unless flag
         on_args << desc unless desc.nil?
         on_args

data/lib/anyway/rails/autoload.rb

@@ -4,8 +4,6 @@
 # when Anyway Config is loaded before Rails (e.g., in config/puma.rb).
 module Anyway
   module Rails
-    using RubyNext
-
     class << self
       attr_reader :tracer, :name_method
       attr_accessor :disable_postponed_load_warning

data/lib/anyway/rails/loaders/credentials.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module Anyway
-  using RubyNext
-
   module Rails
     module Loaders
       class Credentials < Anyway::Loaders::Base

data/lib/anyway/rails/loaders/secrets.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 module Anyway
-  using RubyNext
-
   module Rails
     module Loaders
       class Secrets < Anyway::Loaders::Base

data/lib/anyway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Anyway # :nodoc:
-  VERSION = "2.7.2"
+  VERSION = "2.8.0"
 end

data/lib/anyway_config.rb

@@ -37,10 +37,13 @@ module Anyway # :nodoc:
 
   # Configure default loaders
   loaders.append :yml, Loaders::YAML
-  loaders.append :ejson, Loaders::EJSON if Utils.which("ejson")
   loaders.append :env, Loaders::Env
 
-  if ENV.key?("DOPPLER_TOKEN") && ENV["ANYWAY_CONFIG_DISABLE_DOPPLER"] != "true"
+  # Configure optional loaders
+  if ENV["ANYWAY_CONFIG_DISABLE_EJSON"] != "true" && Utils.which("ejson")
+    loaders.append :ejson, Loaders::EJSON
+  end
+  if ENV["ANYWAY_CONFIG_DISABLE_DOPPLER"] != "true" && ENV.key?("DOPPLER_TOKEN")
     loaders.append :doppler, Loaders::Doppler
   end
 end

data/sig/anyway_config.rbs

@@ -83,6 +83,8 @@ module Anyway
     def self.coerce_types: (**mappingType) -> void
     def self.coercion_mapping: -> Hash[untyped, untyped]?
     def self.disable_auto_cast!: -> void
+    def self.configuration_sources: -> Array[Symbol]?
+    def self.configuration_sources=: (Array[Symbol]) -> void
 
     attr_reader config_name: String
     attr_reader env_prefix: String
@@ -145,6 +147,7 @@ module Anyway
       def override: (Symbol id, _Loader loader) -> void
                   | (Symbol id) { (**untyped) -> Hash[untyped, untyped] } -> void
       def delete: (Symbol id) -> void
+      def keys: () -> Array[Symbol]
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anyway_config
 version: !ruby/object:Gem::Version
-  version: 2.7.2
+  version: 2.8.0
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-01 00:00:00.000000000 Z
+date: 2026-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-next-core
@@ -121,8 +121,6 @@ files:
 - LICENSE.txt
 - README.md
 - lib/.rbnext/2.6/anyway/ejson_parser.rb
-- lib/.rbnext/2.7/anyway/auto_cast.rb
-- lib/.rbnext/2.7/anyway/config.rb
 - lib/.rbnext/2.7/anyway/loaders/yaml.rb
 - lib/.rbnext/2.7/anyway/rbs.rb
 - lib/.rbnext/2.7/anyway/settings.rb
@@ -214,7 +212,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/.rbnext/2.7/anyway/auto_cast.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module Anyway
-  module AutoCast
-    # Regexp to detect array values
-    # Array value is a values that contains at least one comma
-    # and doesn't start/end with quote or curly braces
-    ARRAY_RXP = /\A[^'"{].*\s*,\s*.*[^'"}]\z/
-
-    class << self
-      def call(val)
-        return val unless val.is_a?(::Hash) || val.is_a?(::String)
-
-        case val
-        when Hash
-          val.transform_values { |_1| it = _1;call(it) }
-        when ARRAY_RXP
-          val.split(/\s*,\s*/).map { |_1| it = _1;call(it) }
-        when /\A(true|t|yes|y)\z/i
-          true
-        when /\A(false|f|no|n)\z/i
-          false
-        when /\A(nil|null)\z/i
-          nil
-        when /\A\d+\z/
-          val.to_i
-        when /\A\d*\.\d+\z/
-          val.to_f
-        when /\A['"].*['"]\z/
-          val.gsub(/(\A['"]|['"]\z)/, "")
-        else
-          val
-        end
-      end
-
-      def cast_hash(obj)
-        obj.transform_values do |val|
-          val.is_a?(::Hash) ? cast_hash(val) : call(val)
-        end
-      end
-
-      def coerce(_key, val)
-        call(val)
-      end
-    end
-  end
-
-  module NoCast
-    def self.call(val) ;  val; end
-
-    def self.coerce(_key, val) ;  val; end
-  end
-end

data/lib/.rbnext/2.7/anyway/config.rb

@@ -1,475 +0,0 @@
-# frozen_string_literal: true
-
-require "anyway/optparse_config"
-require "anyway/dynamic_config"
-
-module Anyway # :nodoc:
-  using RubyNext
-  using Anyway::Ext::DeepDup
-  using Anyway::Ext::DeepFreeze
-  using Anyway::Ext::Hash
-  using Anyway::Ext::FlattenNames
-
-  using(Module.new do
-    refine Object do
-      def vm_object_id() ;  (object_id << 1).to_s(16); end
-    end
-  end)
-
-  # Base config class
-  # Provides `attr_config` method to describe
-  # configuration parameters and set defaults
-  class Config
-    PARAM_NAME = /^[a-z_](\w+)?$/
-
-    # List of names that couldn't be used as config names
-    # (the class instance methods we use)
-    RESERVED_NAMES = %i[
-      config_name
-      env_prefix
-      as_env
-      values
-      class
-      clear
-      deconstruct_keys
-      dig
-      dup
-      initialize
-      load
-      load_from_sources
-      option_parser
-      pretty_print
-      raise_validation_error
-      reload
-      resolve_config_path
-      tap
-      to_h
-      to_source_trace
-      write_config_attr
-      __type_caster__
-    ].freeze
-
-    class Error < StandardError; end
-
-    class ValidationError < Error; end
-
-    include OptparseConfig
-    include DynamicConfig
-
-    class BlockCallback
-      attr_reader :block
-
-      def initialize(block)
-        @block = block
-      end
-
-      def apply_to(config)
-        config.instance_exec(&block)
-      end
-    end
-
-    class NamedCallback
-      attr_reader :name
-
-      def initialize(name)
-        @name = name
-      end
-
-      def apply_to(config) ;  config.send(name); end
-    end
-
-    class << self
-      def attr_config(*args, **hargs)
-        new_defaults = hargs.deep_dup
-        new_defaults.stringify_keys!
-
-        defaults.merge! new_defaults
-
-        new_keys = ((args + new_defaults.keys) - config_attributes)
-
-        validate_param_names! new_keys.map(&:to_s)
-
-        new_keys.map!(&:to_sym)
-
-        unless (reserved_names = (new_keys & RESERVED_NAMES)).empty?
-          raise ArgumentError, "Can not use the following reserved names as config attrubutes: " \
-            "#{reserved_names.sort.map(&:to_s).join(", ")}"
-        end
-
-        config_attributes.push(*new_keys)
-
-        define_config_accessor(*new_keys)
-
-        # Define predicate methods ("param?") for attributes
-        # having `true` or `false` as default values
-        new_defaults.each do |key, val|
-          next unless val.is_a?(TrueClass) || val.is_a?(FalseClass)
-          alias_method :"#{key}?", :"#{key}"
-        end
-      end
-
-      def defaults
-        return @defaults if instance_variable_defined?(:@defaults)
-
-        @defaults = if superclass < Anyway::Config
-          superclass.defaults.deep_dup
-        else
-          new_empty_config
-        end
-      end
-
-      def config_attributes
-        return @config_attributes if instance_variable_defined?(:@config_attributes)
-
-        @config_attributes = if superclass < Anyway::Config
-          superclass.config_attributes.dup
-        else
-          []
-        end
-      end
-
-      def required(*names, env: nil, **nested)
-        unknown_names = names + nested.keys - config_attributes
-        raise ArgumentError, "Unknown config param: #{unknown_names.join(",")}" if unknown_names.any?
-
-        return unless Settings.matching_env?(env)
-
-        required_attributes.push(*names)
-        required_attributes.push(*nested.flatten_names)
-      end
-
-      def required_attributes
-        return @required_attributes if instance_variable_defined?(:@required_attributes)
-
-        @required_attributes = if superclass < Anyway::Config
-          superclass.required_attributes.dup
-        else
-          []
-        end
-      end
-
-      def on_load(*names, &block)
-        raise ArgumentError, "Either methods or block should be specified, not both" if block && !names.empty?
-
-        if block
-          load_callbacks << BlockCallback.new(block)
-        else
-          load_callbacks.push(*names.map { |_1| it = _1;NamedCallback.new(it) })
-        end
-      end
-
-      def load_callbacks
-        return @load_callbacks if instance_variable_defined?(:@load_callbacks)
-
-        @load_callbacks = if superclass <= Anyway::Config
-          superclass.load_callbacks.dup
-        else
-          []
-        end
-      end
-
-      def config_name(val = nil)
-        return (@explicit_config_name = val.to_s) unless val.nil?
-
-        return @config_name if instance_variable_defined?(:@config_name)
-
-        @config_name = explicit_config_name || build_config_name
-      end
-
-      def explicit_config_name
-        return @explicit_config_name if instance_variable_defined?(:@explicit_config_name)
-
-        @explicit_config_name =
-          if superclass.respond_to?(:explicit_config_name)
-            superclass.explicit_config_name
-          end
-      end
-
-      def explicit_config_name?() ;  !explicit_config_name.nil?; end
-
-      def env_prefix(val = nil)
-        return (@env_prefix = val.to_s.upcase) unless val.nil?
-
-        return @env_prefix if instance_variable_defined?(:@env_prefix)
-
-        @env_prefix = if superclass < Anyway::Config && superclass.explicit_config_name?
-          superclass.env_prefix
-        else
-          config_name.upcase
-        end
-      end
-
-      def loader_options(val = nil)
-        return (@loader_options = val) unless val.nil?
-
-        return @loader_options if instance_variable_defined?(:@loader_options)
-
-        @loader_options = if superclass < Anyway::Config
-          superclass.loader_options
-        else
-          {}
-        end
-      end
-
-      def new_empty_config() ;  {}; end
-
-      def coerce_types(mapping)
-        Utils.deep_merge!(coercion_mapping, mapping)
-
-        mapping.each do |key, val|
-          type = val.is_a?(::Hash) ? val[:type] : val
-          next if type != :boolean
-
-          alias_method :"#{key}?", :"#{key}"
-        end
-      end
-
-      def coercion_mapping
-        return @coercion_mapping if instance_variable_defined?(:@coercion_mapping)
-
-        @coercion_mapping = if superclass < Anyway::Config
-          superclass.coercion_mapping.deep_dup
-        else
-          {}
-        end
-      end
-
-      def type_caster(val = nil)
-        return @type_caster unless val.nil?
-
-        @type_caster ||=
-          if coercion_mapping.empty?
-            fallback_type_caster
-          else
-            ::Anyway::TypeCaster.new(coercion_mapping, fallback: fallback_type_caster)
-          end
-      end
-
-      def fallback_type_caster(val = nil)
-        return (@fallback_type_caster = val) unless val.nil?
-
-        return @fallback_type_caster if instance_variable_defined?(:@fallback_type_caster)
-
-        @fallback_type_caster = if superclass < Anyway::Config
-          superclass.fallback_type_caster.deep_dup
-        else
-          ::Anyway::AutoCast
-        end
-      end
-
-      def disable_auto_cast!
-        @fallback_type_caster = ::Anyway::NoCast
-      end
-
-      private
-
-      def define_config_accessor(*names)
-        names.each do |name|
-          accessors_module.module_eval <<~RUBY, __FILE__, __LINE__ + 1
-            def #{name}=(val)
-              __trace__&.record_value(val, "#{name}", **Tracing.current_trace_source)
-              values[:#{name}] = val
-            end
-
-            def #{name}
-              values[:#{name}]
-            end
-          RUBY
-        end
-      end
-
-      def accessors_module
-        return @accessors_module if instance_variable_defined?(:@accessors_module)
-
-        @accessors_module = Module.new.tap do |mod|
-          include mod
-        end
-      end
-
-      def build_config_name
-        unless name
-          raise "Please, specify config name explicitly for anonymous class " \
-            "via `config_name :my_config`"
-        end
-
-        # handle two cases:
-        # - SomeModule::Config => "some_module"
-        # - SomeConfig => "some"
-        unless name =~ /^(\w+)(::)?Config$/
-          raise "Couldn't infer config name, please, specify it explicitly " \
-            "via `config_name :my_config`"
-        end
-
-        # TODO(v3.0): Replace downcase with underscore
-        Regexp.last_match[1].tap(&:downcase!)
-      end
-
-      def validate_param_names!(names)
-        invalid_names = names.reject { |name| name =~ PARAM_NAME }
-        return if invalid_names.empty?
-
-        raise ArgumentError, "Invalid attr_config name: #{invalid_names.join(", ")}.\n" \
-          "Valid names must satisfy /#{PARAM_NAME.source}/."
-      end
-    end
-
-    on_load :validate_required_attributes!
-
-    attr_reader :config_name, :env_prefix
-
-    # Instantiate config instance.
-    #
-    # Example:
-    #
-    #   my_config = Anyway::Config.new()
-    #
-    #   # provide some values explicitly
-    #   my_config = Anyway::Config.new({some: :value})
-    #
-    def initialize(overrides = nil)
-      @config_name = self.class.config_name
-
-      raise ArgumentError, "Config name is missing" unless @config_name
-
-      @env_prefix = self.class.env_prefix
-      @values = {}
-
-      load(overrides)
-    end
-
-    def reload(overrides = nil)
-      clear
-      load(overrides)
-      self
-    end
-
-    def clear
-      values.clear
-      @__trace__ = nil
-      self
-    end
-
-    def load(overrides = nil)
-      base_config = self.class.defaults.deep_dup
-
-      trace = Tracing.capture do
-        Tracing.trace!(:defaults) { base_config }
-
-        config_path = resolve_config_path(config_name, env_prefix)
-
-        load_from_sources(
-          base_config,
-          name: config_name,
-          env_prefix: env_prefix,
-          config_path: config_path,
-          **self.class.loader_options
-        )
-
-        if overrides
-          Tracing.trace!(:load) { overrides }
-
-          Utils.deep_merge!(base_config, overrides)
-        end
-      end
-
-      base_config.each do |key, val|
-        write_config_attr(key.to_sym, val)
-      end
-
-      # Trace may contain unknown attributes
-      trace&.keep_if { |key| self.class.config_attributes.include?(key.to_sym) }
-
-      # Run on_load callbacks
-      self.class.load_callbacks.each { |_1| it = _1;it.apply_to(self) }
-
-      # Set trace after we write all the values to
-      # avoid changing the source to accessor
-      @__trace__ = trace
-
-      self
-    end
-
-    def load_from_sources(base_config, **opts)
-      Anyway.loaders.each do |(_id, loader)|
-        Utils.deep_merge!(base_config, loader.call(**opts))
-      end
-      base_config
-    end
-
-    def dig(*__rest__) ;  values.dig(*__rest__); end
-
-    def to_h() ;  values.deep_dup.deep_freeze; end
-
-    def dup
-      self.class.allocate.tap do |new_config|
-        %i[config_name env_prefix __trace__].each do |ivar|
-          new_config.instance_variable_set(:"@#{ivar}", send(ivar).dup)
-        end
-        new_config.instance_variable_set(:@values, values.deep_dup)
-      end
-    end
-
-    def resolve_config_path(name, env_prefix)
-      Anyway.env.fetch(env_prefix).delete("conf") || Settings.default_config_path.call(name)
-    end
-
-    def deconstruct_keys(keys) ;  values.deconstruct_keys(keys); end
-
-    def to_source_trace() ;  __trace__&.to_h; end
-
-    def inspect
-      "#<#{self.class}:0x#{vm_object_id.rjust(16, "0")} config_name=\"#{config_name}\" env_prefix=\"#{env_prefix}\" " \
-      "values=#{values.inspect}>"
-    end
-
-    def pretty_print(q)
-      q.object_group self do
-        q.nest(1) do
-          q.breakable
-          q.text "config_name=#{config_name.inspect}"
-          q.breakable
-          q.text "env_prefix=#{env_prefix.inspect}"
-          q.breakable
-          q.text "values:"
-          q.pp __trace__
-        end
-      end
-    end
-
-    def as_env
-      Env.from_hash(to_h, prefix: env_prefix)
-    end
-
-    private
-
-    attr_reader :values, :__trace__
-
-    def validate_required_attributes!
-      return if Settings.suppress_required_validations
-
-      self.class.required_attributes.select do |name|
-        val = values.dig(*name.to_s.split(".").map(&:to_sym))
-        val.nil? || (val.is_a?(String) && val.empty?)
-      end.then do |missing|
-        next if missing.empty?
-        raise_validation_error "The following config parameters for `#{self.class.name}(config_name: #{self.class.config_name})` are missing or empty: #{missing.join(", ")}"
-      end
-    end
-
-    def write_config_attr(key, val)
-      key = key.to_sym
-      return unless self.class.config_attributes.include?(key)
-
-      val = __type_caster__.coerce(key, val)
-      public_send(:"#{key}=", val)
-    end
-
-    def raise_validation_error(msg)
-      raise ValidationError, msg
-    end
-
-    def __type_caster__
-      self.class.type_caster
-    end
-  end
-end