class Puma::UserFileDefaultOptions

A class used for storing “leveled” configuration options.

In this class any “user” specified options take precedence over any “file” specified options, take precedence over any “default” options.

User input is preferred over “defaults”:

user_options    = { foo: "bar" }
default_options = { foo: "zoo" }
options = UserFileDefaultOptions.new(user_options, default_options)
puts options[:foo]
# => "bar"

All values can be accessed via `all_of`

puts options.all_of(:foo)
# => ["bar", "zoo"]

A “file” option can be set. This config will be preferred over “default” options but will defer to any available “user” specified options.

user_options    = { foo: "bar" }
default_options = { rackup: "zoo.rb" }
options = UserFileDefaultOptions.new(user_options, default_options)
options.file_options[:rackup] = "sup.rb"
puts options[:rackup]
# => "sup.rb"

The “default” options can be set via procs. These are resolved during runtime via calls to `finalize_values`

Attributes

default_options[R]
file_options[R]
user_options[R]

Public Class Methods

new(user_options, default_options) click to toggle source
# File lib/puma/configuration.rb, line 39
def initialize(user_options, default_options)
  @user_options    = user_options
  @file_options    = {}
  @default_options = default_options
end

Public Instance Methods

[](key) click to toggle source
# File lib/puma/configuration.rb, line 47
def [](key)
  fetch(key)
end
[]=(key, value) click to toggle source
# File lib/puma/configuration.rb, line 51
def []=(key, value)
  user_options[key] = value
end
all_of(key) click to toggle source
# File lib/puma/configuration.rb, line 63
def all_of(key)
  user    = user_options[key]
  file    = file_options[key]
  default = default_options[key]

  user    = [user]    unless user.is_a?(Array)
  file    = [file]    unless file.is_a?(Array)
  default = [default] unless default.is_a?(Array)

  user.compact!
  file.compact!
  default.compact!

  user + file + default
end
fetch(key, default_value = nil) click to toggle source
# File lib/puma/configuration.rb, line 55
def fetch(key, default_value = nil)
  return user_options[key]    if user_options.key?(key)
  return file_options[key]    if file_options.key?(key)
  return default_options[key] if default_options.key?(key)

  default_value
end
final_options() click to toggle source
# File lib/puma/configuration.rb, line 87
def final_options
  default_options
    .merge(file_options)
    .merge(user_options)
end
finalize_values() click to toggle source
# File lib/puma/configuration.rb, line 79
def finalize_values
  @default_options.each do |k,v|
    if v.respond_to? :call
      @default_options[k] = v.call
    end
  end
end