Class: Chamber::FileSet

Inherits:
Object
  • Object
show all
Defined in:
lib/chamber/file_set.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ FileSet

Returns a new instance of FileSet.



120
121
122
123
124
125
 
# File 'lib/chamber/file_set.rb', line 120

def initialize(options = {})
  self.namespaces      = options[:namespaces] || {}
  self.decryption_keys = options[:decryption_keys]
  self.encryption_keys = options[:encryption_keys]
  self.paths           = options.fetch(:files)
end

Instance Attribute Details

#decryption_keys ⇒ Object

Returns the value of attribute decryption_keys.



117
118
119
 
# File 'lib/chamber/file_set.rb', line 117

def decryption_keys
  @decryption_keys
end

#encryption_keys ⇒ Object

Returns the value of attribute encryption_keys.



117
118
119
 
# File 'lib/chamber/file_set.rb', line 117

def encryption_keys
  @encryption_keys
end

#namespaces ⇒ Object

Returns the value of attribute namespaces.



115
116
117
 
# File 'lib/chamber/file_set.rb', line 115

def namespaces
  @namespaces
end

#paths ⇒ Object

Returns the value of attribute paths.



115
116
117
 
# File 'lib/chamber/file_set.rb', line 115

def paths
  @paths
end

Instance Method Details

#filenames ⇒ Object

Internal: Returns an Array of the ordered list of files that was processed by Chamber in order to get the resulting settings values. This is useful for debugging if a given settings value isn’t quite what you anticipated it should be.

Returns an Array of file path strings



135
136
137
 
# File 'lib/chamber/file_set.rb', line 135

def filenames
  @filenames ||= files.map(&:to_s)
end

#secure ⇒ Object 



180
181
182
 
# File 'lib/chamber/file_set.rb', line 180

def secure
  files.each(&:secure)
end

#to_settings ⇒ Object

Internal: Converts the FileSet into a Settings object which represents all the settings specified in all of the files in the FileSet.

This can be used in one of two ways. You may either specify a block which will be passed each file’s settings as they are converted, or you can choose not to pass a block, in which case it will pass back a single completed Settings object to the caller.

The reason the block version is used in Chamber.settings is because we want to be able to load each settings file as it’s processed so that we can use those already-processed settings in subsequently processed settings files.

Examples:

###
# Specifying a Block
#
file_set = FileSet.new files: [ '/path/to/my/settings.yml' ]

file_set.to_settings do |settings|
  # do stuff with each settings
end

###
# No Block Specified
#
file_set = FileSet.new files: [ '/path/to/my/settings.yml' ]
file_set.to_settings

# => <Chamber::Settings>



172
173
174
175
176
177
178
 
# File 'lib/chamber/file_set.rb', line 172

def to_settings
  files.inject(Settings.new) do |settings, file|
    settings.merge(file.to_settings).tap do |merged|
      yield merged if block_given?
    end
  end
end