Class: Configurate::LookupChain
- Inherits:
-
Object
- Object
- Configurate::LookupChain
- Defined in:
- lib/configurate/lookup_chain.rb
Overview
This object builds a chain of configuration providers to try to find the value of a setting.
Instance Method Summary collapse
-
#add_provider(provider, *args) ⇒ void
Adds a provider to the chain.
-
#initialize ⇒ LookupChain
constructor
A new instance of LookupChain.
-
#lookup(setting, *args) ⇒ Array, ...
(also: #[])
Tries all providers in the order they were added to provide a response for setting.
Constructor Details
#initialize ⇒ LookupChain
Returns a new instance of LookupChain.
5 6 7 |
# File 'lib/configurate/lookup_chain.rb', line 5 def initialize @provider = [] end |
Instance Method Details
#add_provider(provider, *args) ⇒ void
This method returns an undefined value.
Adds a provider to the chain. Providers are tried in the order they are added, so the order is important.
16 17 18 19 20 21 22 |
# File 'lib/configurate/lookup_chain.rb', line 16 def add_provider(provider, *args) unless provider.respond_to?(:instance_methods) && provider.instance_methods.include?(:lookup) raise ArgumentError, "the given provider does not respond to lookup" end @provider << provider.new(*args) end |
#lookup(setting, *args) ⇒ Array, ... Also known as: []
Tries all providers in the order they were added to provide a response for setting.
33 34 35 36 37 38 39 40 41 42 |
# File 'lib/configurate/lookup_chain.rb', line 33 def lookup(setting, *args) setting = SettingPath.new setting if setting.is_a? String @provider.each do |provider| begin return special_value_or_string(provider.lookup(setting.clone, *args)) rescue SettingNotFoundError; end end nil end |