123456789_123456789_123456789_123456789_123456789_

Class: ActiveSupport::EnvConfiguration

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
DotEnvConfiguration
Inherits: Object
Defined in: activesupport/lib/active_support/env_configuration.rb

Overview

Provide a better interface for accessing configuration options stored in ENV. Keys are accepted as symbols and turned into upcased strings. Nesting is provided by double underscores.

This interface mirrors what is used for EncryptedConfiguration and thus allows both to serve as interchangeable backends for Rails.app.credentials.

Examples:

require(:db_host)                                   # => ENV.fetch("DB_HOST")
require(:database, :host)                           # => ENV.fetch("DATABASE__HOST")
option(:database, :host)                            # => ENV["DATABASE__HOST"]
option(:debug, default: "true")                     # => ENV.fetch("DB_HOST") { "true" }
option(:database, :host, default: -> { "missing" }) # => ENV.fetch("DATABASE__HOST") { default.call }

Class Method Summary

Instance Method Summary

Constructor Details

.new ⇒ EnvConfiguration

[ GitHub ] 

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 20



def initialize
  reload
end


  







Instance Method Details



  

    #envify(*key)   (private)
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 82



def envify(*key)
  key.collect { |part| part.to_s.upcase }.join("__")
end


  








  

    #inspect  
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 73



def inspect # :nodoc:
  "#<#{self.class.name}:#{'%#016x' % (object_id << 1)} keys=#{keys.inspect}>"
end


  








  

    #keys  
  



  

    

Returns an array of symbolized keys from the environment variables.



Examples:



ENV["DB_HOST"] = "localhost"
ENV["DATABASE_PORT"] = "5432"

env_config = ActiveSupport::EnvConfiguration.new
env_config.keys
# => [:db_host, :database_port, ...]


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 69



def keys
  @envs.keys.map { |k| k.downcase.to_sym }
end


  








  

    #lookup(env_key)   (private)
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 78



def lookup(env_key)
  @envs[env_key]
end


  








  

    #option(*key, default: nil)  
  



  

    

Find an upcased and double-underscored-joined string-version of the key in ENV. Returns nil if the key isn’t found or the value of default when passed. If default is a callable, it’s called first.



Examples:



option(:db_host)                                    # => ENV["DB_HOST"]
option(:database, :host)                            # => ENV["DATABASE__HOST"]
option(:database, :host, default: "missing")        # => ENV.fetch("DATABASE__HOST", "missing")
option(:database, :host, default: -> { "missing" }) # => ENV.fetch("DATABASE__HOST") { default.call }


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 45



def option(*key, default: nil)
  if default.respond_to?(:call)
    @envs.fetch(envify(*key)) { default.call }
  else
    @envs.fetch envify(*key), default
  end
end


  








  

    #reload  
  



  

    

Reload the cached ENV values in case any of them changed or new ones were added during runtime.


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 54



def reload
  @envs = ENV.to_h
end


  








  

    #require(*key)  
  



  

    

Find an upcased and double-underscored-joined string-version of the key in ENV. Raises KeyError if not found.



Examples:



require(:db_host)         # => ENV.fetch("DB_HOST")
require(:database, :host) # => ENV.fetch("DATABASE__HOST")


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/env_configuration.rb', line 31



def require(*key)
  @envs.fetch envify(*key)
end