easy_app_helper 1.0.3 → 1.0.4

data/Rakefile

@@ -1 +1,8 @@
-require "bundler/gem_tasks"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec
+

data/easy_app_helper.gemspec

@@ -1,26 +1,27 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'easy_app_helper/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "easy_app_helper"
-  spec.version       = EasyAppHelper::EASY_APP_HELPER_VERSION
-  spec.authors       = ["L.Briais"]
-  spec.email         = ["lbnetid+rb@gmail.com"]
-  spec.description   = %q{Easy Application Helpers framework}
-  spec.summary       = %q{Provides cool helpers to your application, including configuration and logging features}
-  spec.homepage      = "https://github.com/lbriais/easy_app_helper"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "pry"
-
-  spec.add_runtime_dependency "slop"
-end
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'easy_app_helper/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "easy_app_helper"
+  spec.version       = EasyAppHelper::EASY_APP_HELPER_VERSION
+  spec.authors       = ["L.Briais"]
+  spec.email         = ["lbnetid+rb@gmail.com"]
+  spec.description   = %q{Easy Application Helpers framework}
+  spec.summary       = %q{Provides cool helpers to your application, including configuration and logging features}
+  spec.homepage      = "https://github.com/lbriais/easy_app_helper"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|rspec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rspec"
+
+  spec.add_runtime_dependency "slop"
+end

data/lib/easy_app_helper.rb

@@ -1,20 +1,20 @@
-################################################################################
-# EasyAppHelper 
-#
-# Copyright (c) 2013 L.Briais under MIT license
-# http://opensource.org/licenses/MIT
-################################################################################
-
-require 'easy_app_helper/version'
-
-# When this module is included in any class, it mixes in automatically
-# EasyAppHelper::ModuleManager methods both into the
-# instance and the class of the instance that includes it.
-# Thus to have access to the helper methods, the only requirement is to include
-# this module...
-module EasyAppHelper
-  require 'easy_app_helper/module_manager'
-  include ModuleManager
-end
-
-
+################################################################################
+# EasyAppHelper 
+#
+# Copyright (c) 2013 L.Briais under MIT license
+# http://opensource.org/licenses/MIT
+################################################################################
+
+require 'easy_app_helper/version'
+
+# When this module is included in any class, it mixes in automatically
+# EasyAppHelper::ModuleManager methods both into the
+# instance and the class of the instance that includes it.
+# Thus to have access to the helper methods, the only requirement is to include
+# this module...
+module EasyAppHelper
+  require 'easy_app_helper/module_manager'
+  include ModuleManager
+end
+
+

data/lib/easy_app_helper/core/base.rb

@@ -1,142 +1,169 @@
-################################################################################
-# EasyAppHelper
-#
-# Copyright (c) 2013 L.Briais under MIT license
-# http://opensource.org/licenses/MIT
-################################################################################
-
-require 'slop'
-
-# This class is the base class for the {EasyAppHelper::Core::Config config} object.
-# It handles the internal_configs hash that actually contains all configurations read from
-# various sources: command line, config files etc...
-
-class EasyAppHelper::Core::Base
-  CHANGED_BY_CODE = 'Changed by code'
-
-  attr_reader :script_filename, :app_name, :app_version, :app_description, :internal_configs, :logger
-
-  def initialize(logger)
-    @app_name = @app_version = @app_description = ""
-    @script_filename = File.basename $0, '.*'
-    @internal_configs = {modified: {content: {}, source: CHANGED_BY_CODE}}
-    @logger = logger
-    @slop_definition = Slop.new
-    build_command_line_options
-  end
-
-
-  # @return [String] The formatted command line help
-  def help
-    @slop_definition.to_s
-  end
-
-  # sets the filename while maintaining the slop definition upto date
-  # @param [String] filename
-  def script_filename=(filename)
-    @script_filename = filename
-    @slop_definition.banner = build_banner
-  end
-  # sets the application name used for logging while maintaining the slop definition upto date
-  # @param [String] fname
-  def app_name=(name)
-    @app_name = name
-    @slop_definition.banner = build_banner
-  end
-  # sets the version while maintaining the slop definition upto date
-  # @param [String] version
-  def app_version=(version)
-    @app_version = version
-    @slop_definition.banner = build_banner
-  end
-  # sets the filename while maintaining the slop definition upto date
-  # @param [String] description
-  def app_description=(description)
-    @app_description = description
-    @slop_definition.banner = build_banner
-  end
-
-  # helper to add in one command any of the four base properties used
-  # by the logger and the config objects.
-  # @param [String] app_name
-  # @param [String] script_filename
-  # @param [String] app_version
-  # @param [String] app_description
-  def describes_application(app_name: nil, script_filename: nil, app_version: nil, app_description: nil)
-    self.app_name = app_name unless app_name.nil?
-    self.app_version = app_version unless app_version.nil?
-    self.app_description = app_description unless app_description.nil?
-    self.script_filename = script_filename unless script_filename.nil?
-  end
-
-  # @return [Hash] This hash built from slop definition correspond to the :command_line layer of internal_configs
-  def command_line_config
-    @slop_definition.parse
-    @slop_definition.to_hash
-  end
-
-  # Yields a slop definition to modify the command line parameters
-  # @param [String] title used to insert a slop separator
-  def add_command_line_section(title='Script specific')
-    raise "Incorrect usage" unless block_given?
-    @slop_definition.separator build_separator(title)
-    yield @slop_definition
-  end
-
-  # Sets the :command_line layer of internal_configs to the computed {#command_line_config}
-  def load_config
-    internal_configs[:command_line] = {content: command_line_config, source: 'Command line'}
-  end
-
-  # Any modification done to the config is in fact stored in the :modified layer of internal_configs
-  # @param [String] key
-  # @param [String] value
-  def []=(key,value)
-    internal_configs[:modified][:content][key] = value
-  end
-
-  # Reset the :modified layer of internal_configs rolling back any change done to the config
-  def reset
-    internal_configs[:modified] = {content: {}, source: CHANGED_BY_CODE}
-  end
-
-
-  # @return [Array] List of layers
-  def layers
-    internal_configs.keys
-  end
-
-  # Executes code (block given) unless :simulate is in the config.
-  # If :simulate specified then display message instead of executing the code (block).
-  def safely_exec(message, *args)
-    raise "No block given" unless block_given?
-    if self[:simulate]
-      logger.puts_and_logs "SIMULATING: #{message}" unless message.nil?
-    else
-      logger.puts_and_logs message
-      yield(*args)
-    end
-  end
-
-
-  private
-
-  def build_separator(title)
-    "-- #{title} ".ljust 80, '-'
-  end
-
-  # Builds common used command line options
-  def build_command_line_options
-    add_command_line_section('Generic options') do |slop|
-      slop.on :auto, 'Auto mode. Bypasses questions to user.', :argument => false
-      slop.on :simulate, 'Do not perform the actual underlying actions.', :argument => false
-      slop.on :v, :verbose, 'Enable verbose mode.', :argument => false
-      slop.on :h, :help, 'Displays this help.', :argument => false
-    end
-  end
-
-  def build_banner
-    "\nUsage: #{script_filename} [options]\n#{app_name} Version: #{app_version}\n\n#{app_description}"
-  end
-
+################################################################################
+# EasyAppHelper
+#
+# Copyright (c) 2013 L.Briais under MIT license
+# http://opensource.org/licenses/MIT
+################################################################################
+
+require 'slop'
+
+# This class is the base class for the {EasyAppHelper::Core::Config config} object.
+# It handles the internal_configs hash that actually contains all configurations read from
+# various sources: command line, config files etc...
+
+class EasyAppHelper::Core::Base
+  CHANGED_BY_CODE = 'Changed by code'
+
+  attr_reader :script_filename, :app_name, :app_version, :app_description, :internal_configs, :logger
+
+  def initialize(logger)
+    @app_name = @app_version = @app_description = ""
+    @script_filename = File.basename $0, '.*'
+    @internal_configs = {modified: {content: {}, source: CHANGED_BY_CODE}}
+    @logger = logger
+    @slop_definition = Slop.new
+    build_command_line_options
+  end
+
+
+  # @return [String] The formatted command line help
+  def help
+    @slop_definition.to_s
+  end
+
+  # sets the filename while maintaining the slop definition upto date
+  # @param [String] filename
+  def script_filename=(filename)
+    @script_filename = filename
+    @slop_definition.banner = build_banner
+  end
+  # sets the application name used for logging while maintaining the slop definition upto date
+  # @param [String] fname
+  def app_name=(name)
+    @app_name = name
+    @slop_definition.banner = build_banner
+  end
+  # sets the version while maintaining the slop definition upto date
+  # @param [String] version
+  def app_version=(version)
+    @app_version = version
+    @slop_definition.banner = build_banner
+  end
+  # sets the filename while maintaining the slop definition upto date
+  # @param [String] description
+  def app_description=(description)
+    @app_description = description
+    @slop_definition.banner = build_banner
+  end
+
+  # helper to add in one command any of the four base properties used
+  # by the logger and the config objects.
+  # @param [String] app_name
+  # @param [String] script_filename
+  # @param [String] app_version
+  # @param [String] app_description
+  def describes_application(app_name: nil, script_filename: nil, app_version: nil, app_description: nil)
+    self.app_name = app_name unless app_name.nil?
+    self.app_version = app_version unless app_version.nil?
+    self.app_description = app_description unless app_description.nil?
+    self.script_filename = script_filename unless script_filename.nil?
+  end
+
+  # @return [Hash] This hash built from slop definition correspond to the :command_line layer of internal_configs
+  def command_line_config
+    @slop_definition.parse
+    @slop_definition.to_hash
+  end
+
+  # Yields a slop definition to modify the command line parameters
+  # @param [String] title used to insert a slop separator
+  def add_command_line_section(title='Script specific')
+    raise "Incorrect usage" unless block_given?
+    @slop_definition.separator build_separator(title)
+    yield @slop_definition
+  end
+
+  # Sets the :command_line layer of internal_configs to the computed {#command_line_config}
+  def load_config
+    internal_configs[:command_line] = {content: command_line_config, source: 'Command line'}
+  end
+
+  # Any modification done to the config is in fact stored in the :modified layer of internal_configs
+  # @param [String] key
+  # @param [String] value
+  def []=(key,value)
+    internal_configs[:modified][:content][key] = value unless check_hardcoded_properties key, value
+  end
+
+  # Reset the :modified layer of internal_configs rolling back any change done to the config
+  def reset
+    internal_configs[:modified] = {content: {}, source: CHANGED_BY_CODE}
+  end
+
+
+  # @return [Array] List of layers
+  def layers
+    internal_configs.keys
+  end
+
+  def find_layer(key)
+    [:modified, :command_line].each do |layer|
+      return layer if internal_configs[layer][:content][key]
+    end
+    nil
+  end
+
+
+  # Executes code (block given) unless :simulate is in the config.
+  # If :simulate specified then display message instead of executing the code (block).
+  def safely_exec(message, *args)
+    raise "No block given" unless block_given?
+    if self[:simulate]
+      logger.puts_and_logs "SIMULATING: #{message}" unless message.nil?
+    else
+      logger.puts_and_logs message
+      yield(*args)
+    end
+  end
+
+
+  private
+
+  # Performs actions related the very specific config parameters
+  # @param [String] key The parameter to check
+  # @param [Object] value The value it expects to be set to
+  # @param [Symbol] layer Optional layer, default is :modified
+  # @return [Boolean] Whether or not the internal state has been changed
+  def check_hardcoded_properties(key, value, layer = :modified)
+    processed = false
+    case key
+      when :'log-level'
+        logger.send :level=, value, false
+      when :'config-file'
+        internal_configs[layer][:content][key] = value
+        force_reload
+        processed = true
+    end
+    processed
+  end
+
+  # Builds a nice separator
+  def build_separator(title, width = 80, filler = '-')
+    "#{filler * 2} #{title} ".ljust width, filler
+  end
+
+  # Builds common used command line options
+  def build_command_line_options
+    add_command_line_section('Generic options') do |slop|
+      slop.on :auto, 'Auto mode. Bypasses questions to user.', :argument => false
+      slop.on :simulate, 'Do not perform the actual underlying actions.', :argument => false
+      slop.on :v, :verbose, 'Enable verbose mode.', :argument => false
+      slop.on :h, :help, 'Displays this help.', :argument => false
+    end
+  end
+
+  def build_banner
+    "\nUsage: #{script_filename} [options]\n#{app_name} Version: #{app_version}\n\n#{app_description}"
+  end
+
 end

data/lib/easy_app_helper/core/config.rb

@@ -1,203 +1,213 @@
-################################################################################
-# EasyAppHelper
-#
-# Copyright (c) 2013 L.Briais under MIT license
-# http://opensource.org/licenses/MIT
-################################################################################
-
-require 'yaml'
-# This is the class that will handle the configuration.
-# Configuration is read from different sources:
-# - config files (system, global, user, specified on the command line)
-# - command line options
-# - any extra config you provide programmatically
-#
-# == Config files:
-# system, global, and user config files are searched in the file system according to
-# complex rules. First the place where to search them depends on the OS
-# (Provided by {EasyAppHelper::Core::Config::Places}), and then multiple file extensions are
-# tested ({EasyAppHelper::Core::Config::CONFIG_FILE_POSSIBLE_EXTENSIONS}). This is basically
-# performed by the private method {#find_file}. The config specified on command line (if any)
-# is loaded the same way.
-#
-# == Command line:
-# Any option can be declared as being callable from the command line. Modules add already some
-# command line options, but the application can obviously add its own (see
-# {EasyAppHelper::Core::Base#add_command_line_section}).
-#
-# Each of the config sources are kept in a separated "layer" and addressed this way using the
-# #internal_configs attribute reader. But of course the config object provides a "merged" config
-# result of the computation of all the sources. See the {#to_hash} method to see the order for the
-# merge.
-# Any option can be accessed or modified directly using the {#[]} and {#[]=} methods.
-# Any change to the global config should be done using the {#[]=} method and is kept in the last separated
-# layer called "modified". Therefore the config can be easily reset using the {#reset}
-# method.
-class EasyAppHelper::Core::Config < EasyAppHelper::Core::Base
-end
-
-require 'easy_app_helper/core/places'
-require 'easy_app_helper/core/merge_policies'
-
-
-class EasyAppHelper::Core::Config < EasyAppHelper::Core::Base
-  include EasyAppHelper::Core::HashesMergePolicies
-  include EasyAppHelper::Core::Config::Places.get_OS_module
-
-  ADMIN_CONFIG_FILENAME = EasyAppHelper.name
-
-
-  # Potential extensions a config file can have
-  CONFIG_FILE_POSSIBLE_EXTENSIONS = %w(conf yml cfg yaml CFG YML YAML Yaml)
-  ADMIN_CONFIG_FILENAME
-
-  # @param [EasyAppHelper::Core::Logger] logger
-  # The logger passed to this constructor should be a temporary logger until the full config is loaded.
-  def initialize(logger)
-    super
-    add_cmd_line_options
-    load_config
-  end
-
-  # After calling the super method, triggers a forced reload of the file based config.
-  # @param [String] name of the config file
-  # @see Base#script_filename=
-  def script_filename=(name)
-    super
-    force_reload
-  end
-
-  # Sets the Application name and passes it to the logger.
-  # @param [String] name
-  # @see Base#app_name=
-  def app_name=(name)
-    super
-    logger.progname = name
-  end
-
-  # Loads all config (command line and config files)
-  # Do not reload a file if already loaded unless forced too.
-  # It *does not flush the "modified" layer*. Use {#reset} instead
-  # @param [Boolean] force to force the reload
-  def load_config(force=false)
-    super()
-    load_layer_config :system, ADMIN_CONFIG_FILENAME, force
-    load_layer_config :global, script_filename, force
-    load_layer_config :user, script_filename, force
-    load_layer_config :specific_file, internal_configs[:command_line][:content][:'config-file'], force
-  end
-
-  # @see #load_config
-  def force_reload
-    load_config true
-  end
-
-
-  # This is the main method that provides the config as a hash.
-  #
-  # Every layer is kept untouched (and could accessed independently
-  # using {#internal_configs}), while this methods provides a merged config.
-  # @return [Hash] The hash of the merged config.
-  def to_hash
-    merged_config = [:system, :global, :user].inject({}) do |temp_config, config_level|
-      hashes_second_level_merge temp_config, internal_configs[config_level][:content]
-    end
-    if command_line_config[:'config-file']
-      if command_line_config[:'config-override']
-        override_merge merged_config, internal_configs[:specific_file][:content]
-      else
-        hashes_second_level_merge merged_config, internal_configs[:specific_file][:content]
-      end
-
-    end
-    hashes_second_level_merge merged_config, command_line_config
-    hashes_second_level_merge merged_config, internal_configs[:modified][:content]
-  end
-
-  # @param [Object] key: The key to access the data in the merged_config hash (see {#to_hash})
-  # @return [String] Value for this key in the merged config.
-  def [](key)
-    self.to_hash[key]
-  end
-
-
-  # @return [String] The merged config (see {#to_hash}) rendered as Yaml
-  def to_yaml
-    to_hash.to_yaml
-  end
-
-  #############################################################################
-  private
-
-  # Command line options specific to config manipulation
-  def add_cmd_line_options
-    add_command_line_section('Configuration options') do |slop|
-      slop.on 'config-file', 'Specify a config file.', :argument => true
-      slop.on 'config-override', 'If specified override all other config.', :argument => false
-    end
-  end
-
-  # Tries to find a config file to be loaded into the config layer cake unless cached.
-  def load_layer_config(layer, filename_or_pattern, force=false)
-    unless_cached(layer,  filename_or_pattern, force) do |layer, filename_or_pattern|
-      fetch_config_layer layer, filename_or_pattern
-    end
-  end
-
-  # Actual loads
-  def fetch_config_layer(layer, filename_or_pattern)
-    if filename_or_pattern.nil?
-      internal_configs[layer] = {content: {}}
-      filename = nil
-    else
-      if File.exists? filename_or_pattern and !File.directory? filename_or_pattern
-        filename = filename_or_pattern
-      else
-        filename = find_file POSSIBLE_PLACES[layer], filename_or_pattern
-      end
-      internal_configs[layer] = {content: load_config_file(filename), source: filename, origin: filename_or_pattern}
-    end
-  ensure
-    logger.info "No config file found for layer #{layer}." if filename.nil?
-  end
-
-  def unless_cached(layer, filename_or_pattern, forced)
-    cached = false
-    if internal_configs[layer]
-      cached = true unless internal_configs[layer][:origin] == filename_or_pattern
-    end
-    if forced or not cached
-      yield layer, filename_or_pattern
-    end
-  end
-
-  # Tries to find config files according to places (array) given and possible extensions
-  def find_file(places, filename)
-    return nil if places.nil? or filename.nil? or filename.empty?
-    places.each do |dir|
-      CONFIG_FILE_POSSIBLE_EXTENSIONS.each do |ext|
-        filename_with_path = dir + '/' + filename + '.' + ext
-        if File.exists? filename_with_path and !File.directory? filename_with_path
-          return filename_with_path 
-        else
-          logger.debug "Trying \"#{filename_with_path}\" as config file."
-        end
-      end
-    end
-    nil
-  end
-
-  def load_config_file(conf_filename)
-    conf = {}
-    return conf if conf_filename.nil?
-    
-    begin
-      logger.debug "Loading config file \"#{conf_filename}\""
-      conf = Hash[YAML::load(open(conf_filename)).map { |k, v| [k.to_sym, v] }]
-    rescue => e
-      logger.error "Invalid config file \"#{conf_filename}\". Skipped as not respecting YAML syntax!\n#{e.message}"
-    end
-    conf
-  end
-
-end
+################################################################################
+# EasyAppHelper
+#
+# Copyright (c) 2013 L.Briais under MIT license
+# http://opensource.org/licenses/MIT
+################################################################################
+
+require 'yaml'
+# This is the class that will handle the configuration.
+# Configuration is read from different sources:
+# - config files (system, global, user, specified on the command line)
+# - command line options
+# - any extra config you provide programmatically
+#
+# == Config files:
+# system, global, and user config files are searched in the file system according to
+# complex rules. First the place where to search them depends on the OS
+# (Provided by {EasyAppHelper::Core::Config::Places}), and then multiple file extensions are
+# tested ({EasyAppHelper::Core::Config::CONFIG_FILE_POSSIBLE_EXTENSIONS}). This is basically
+# performed by the private method {#find_file}. The config specified on command line (if any)
+# is loaded the same way.
+#
+# == Command line:
+# Any option can be declared as being callable from the command line. Modules add already some
+# command line options, but the application can obviously add its own (see
+# {EasyAppHelper::Core::Base#add_command_line_section}).
+#
+# Each of the config sources are kept in a separated "layer" and addressed this way using the
+# #internal_configs attribute reader. But of course the config object provides a "merged" config
+# result of the computation of all the sources. See the {#to_hash} method to see the order for the
+# merge.
+# Any option can be accessed or modified directly using the {#[]} and {#[]=} methods.
+# Any change to the global config should be done using the {#[]=} method and is kept in the last separated
+# layer called "modified". Therefore the config can be easily reset using the {#reset}
+# method.
+class EasyAppHelper::Core::Config < EasyAppHelper::Core::Base
+end
+
+require 'easy_app_helper/core/places'
+require 'easy_app_helper/core/merge_policies'
+
+
+class EasyAppHelper::Core::Config
+  include EasyAppHelper::Core::HashesMergePolicies
+  include EasyAppHelper::Core::Config::Places.get_OS_module
+
+  ADMIN_CONFIG_FILENAME = EasyAppHelper.name
+
+
+  # Potential extensions a config file can have
+  CONFIG_FILE_POSSIBLE_EXTENSIONS = %w(conf yml cfg yaml CFG YML YAML Yaml)
+  ADMIN_CONFIG_FILENAME
+
+  # @param [EasyAppHelper::Core::Logger] logger
+  # The logger passed to this constructor should be a temporary logger until the full config is loaded.
+  def initialize(logger)
+    super
+    add_cmd_line_options
+    load_config
+  end
+
+  # After calling the super method, triggers a forced reload of the file based config.
+  # @param [String] name of the config file
+  # @see Base#script_filename=
+  def script_filename=(name)
+    super
+    force_reload
+  end
+
+  # Sets the Application name and passes it to the logger.
+  # @param [String] name
+  # @see Base#app_name=
+  def app_name=(name)
+    super
+    logger.progname = name
+  end
+
+  # Loads all config (command line and config files)
+  # Do not reload a file if already loaded unless forced too.
+  # It *does not flush the "modified" layer*. Use {#reset} instead
+  # @param [Boolean] force to force the reload
+  def load_config(force=false)
+    super()
+    load_layer_config :system, ADMIN_CONFIG_FILENAME, force
+    load_layer_config :global, script_filename, force
+    load_layer_config :user, script_filename, force
+    load_layer_config :specific_file, internal_configs[:command_line][:content][:'config-file'], force
+  end
+
+  # @see #load_config
+  def force_reload
+    load_config true
+  end
+
+
+  # This is the main method that provides the config as a hash.
+  #
+  # Every layer is kept untouched (and could accessed independently
+  # using {#internal_configs}), while this methods provides a merged config.
+  # @return [Hash] The hash of the merged config.
+  def to_hash
+    merged_config = [:system, :global, :user].inject({}) do |temp_config, config_level|
+      hashes_second_level_merge temp_config, internal_configs[config_level][:content]
+    end
+    if internal_configs[:command_line][:content][:'config-file']
+      if internal_configs[:command_line][:content][:'config-override']
+        override_merge merged_config, internal_configs[:specific_file][:content]
+      else
+        hashes_second_level_merge merged_config, internal_configs[:specific_file][:content]
+      end
+
+    end
+    hashes_second_level_merge merged_config, internal_configs[:command_line][:content]
+    hashes_second_level_merge merged_config, internal_configs[:modified][:content]
+  end
+
+  # @param [Object] key: The key to access the data in the merged_config hash (see {#to_hash})
+  # @return [String] Value for this key in the merged config.
+  def [](key = nil)
+    key.nil? ? self.to_hash : self.to_hash[key]
+  end
+
+
+  # @return [String] The merged config (see {#to_hash}) rendered as Yaml
+  def to_yaml
+    to_hash.to_yaml
+  end
+
+  def find_layer(key)
+    layer = super
+    return layer unless layer.nil?
+    [:specific_file, :user, :global, :system].each do |layer|
+      return layer if internal_configs[layer][:content][key]
+    end
+    nil
+  end
+
+
+  #############################################################################
+  private
+
+  # Command line options specific to config manipulation
+  def add_cmd_line_options
+    add_command_line_section('Configuration options') do |slop|
+      slop.on 'config-file', 'Specify a config file.', :argument => true
+      slop.on 'config-override', 'If specified override all other config.', :argument => false
+    end
+  end
+
+  # Tries to find a config file to be loaded into the config layer cake unless cached.
+  def load_layer_config(layer, filename_or_pattern, force=false)
+    unless_cached(layer,  filename_or_pattern, force) do |layer, filename_or_pattern|
+      fetch_config_layer layer, filename_or_pattern
+    end
+  end
+
+  # Actual loads
+  def fetch_config_layer(layer, filename_or_pattern)
+    if filename_or_pattern.nil?
+      internal_configs[layer] = {content: {}}
+      filename = nil
+    else
+      if File.exists? filename_or_pattern and !File.directory? filename_or_pattern
+        filename = filename_or_pattern
+      else
+        filename = find_file POSSIBLE_PLACES[layer], filename_or_pattern
+      end
+      internal_configs[layer] = {content: load_config_file(filename), source: filename, origin: filename_or_pattern}
+    end
+  ensure
+    logger.info "No config file found for layer #{layer}." if filename.nil?
+  end
+
+  def unless_cached(layer, filename_or_pattern, forced)
+    cached = false
+    if internal_configs[layer]
+      cached = true unless internal_configs[layer][:origin] == filename_or_pattern
+    end
+    if forced or not cached
+      yield layer, filename_or_pattern
+    end
+  end
+
+  # Tries to find config files according to places (array) given and possible extensions
+  def find_file(places, filename)
+    return nil if places.nil? or filename.nil? or filename.empty?
+    places.each do |dir|
+      CONFIG_FILE_POSSIBLE_EXTENSIONS.each do |ext|
+        filename_with_path = dir + '/' + filename + '.' + ext
+        if File.exists? filename_with_path and !File.directory? filename_with_path
+          return filename_with_path 
+        else
+          logger.debug "Trying \"#{filename_with_path}\" as config file."
+        end
+      end
+    end
+    nil
+  end
+
+  def load_config_file(conf_filename)
+    conf = {}
+    return conf if conf_filename.nil?
+    
+    begin
+      logger.debug "Loading config file \"#{conf_filename}\""
+      conf = Hash[YAML::load(open(conf_filename)).map { |k, v| [k.to_sym, v] }]
+    rescue => e
+      logger.error "Invalid config file \"#{conf_filename}\". Skipped as not respecting YAML syntax!\n#{e.message}"
+    end
+    conf
+  end
+
+end