stacked_config 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 30df24c00c6fc0fcf0d77213239c53de0f782c0d
+  data.tar.gz: 8e9862bf7e06e6306cef5ad9967d484cf3585c90
+SHA512:
+  metadata.gz: 58aa9225b056d5325d6c3157815f538c4922cd6a36ebdfd9c97f4b94a60c3a829f735a0a38874d3f466a10e82f6c916af5f21bfd0088be23461ac168bf288e9f
+  data.tar.gz: 10d8c2e4c8e4749d0420fed026ed30466958ba77fa82bce0f423595806fb9a2d61ffe888028b40871e8bd9d562b2e64a9c8ca789d9a1f8d9e319c1bf4726995a

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in stacked_config.gemspec
+gemspec
+
+# gem 'super_stack', path: '/home/laurent/devel/ruby/gems/super_stack'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Laurent B.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# StackedConfig
+
+Code should be ready for prod
+
+No doc written for the time being
+
+Wait for version 0.1.x
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'stacked_config'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install stacked_config
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/stacked_config/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/stacked_config/layers/command_line_layer.rb

@@ -0,0 +1,67 @@
+module StackedConfig
+  module Layers
+
+    class CommandLineLayer < SuperStack::Layer
+
+      attr_reader :slop_definition
+
+      def initialize
+        @slop_definition = Slop.new
+        build_command_line_options
+      end
+
+      def load(*args)
+        slop_definition.parse
+        slop_definition.banner = build_banner
+        clear
+        merge! slop_definition.to_hash
+      end
+
+      def reload
+        load
+      end
+
+      # Yields a slop definition to modify the command line parameters
+      def add_command_line_section(title)
+        raise 'Incorrect usage' unless block_given?
+        slop_definition.separator build_separator(title)
+        yield slop_definition
+        reload
+      end
+
+      # @return [String] The formatted command line help
+      def help
+        slop_definition.to_s
+      end
+
+      private
+
+      # 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
+        if manager.nil?
+          'No banner unless added to a manager !'
+        else
+          "\nUsage: #{manager.executable_name} [options]\n#{manager.app_name} Version: #{manager.app_version}\n\n#{manager.app_description}"
+        end
+      end
+
+
+
+    end
+
+  end
+end

data/lib/stacked_config/layers/generic_layer.rb

@@ -0,0 +1,22 @@
+module StackedConfig
+  module Layers
+
+    class GenericLayer < SuperStack::Layer
+
+      include StackedConfig::SourceHelper
+
+      attr_reader :orchestrator
+
+      def rescan
+
+        set_config_file possible_sources
+      end
+
+      def initialize
+        rescan
+      end
+
+    end
+
+  end
+end

data/lib/stacked_config/layers/global_layer.rb

@@ -0,0 +1,16 @@
+module StackedConfig
+  module Layers
+
+    class GlobalLayer < StackedConfig::Layers::GenericLayer
+      def possible_sources
+        [
+            ['##SYSTEM_CONFIG_ROOT##', '##PROGRAM_NAME##.##EXTENSION##' ],
+            ['##SYSTEM_CONFIG_ROOT##', '##PROGRAM_NAME##', 'config.##EXTENSION##' ],
+            ['##SYSTEM_CONFIG_ROOT##', '##PROGRAM_NAME##', '##PROGRAM_NAME##.##EXTENSION##' ]
+        ]
+      end
+
+    end
+
+  end
+end

data/lib/stacked_config/layers/system_layer.rb

@@ -0,0 +1,15 @@
+module StackedConfig
+  module Layers
+
+    class SystemLayer < StackedConfig::Layers::GenericLayer
+      def possible_sources
+        [
+            ['##SYSTEM_CONFIG_ROOT##', 'stacked_config.##EXTENSION##' ],
+            ['##SYSTEM_CONFIG_ROOT##', 'stacked_config', 'config.##EXTENSION##' ]
+        ]
+      end
+
+    end
+
+  end
+end

data/lib/stacked_config/layers/user_layer.rb

@@ -0,0 +1,20 @@
+module StackedConfig
+  module Layers
+
+    class UserLayer < StackedConfig::Layers::GenericLayer
+
+      def possible_sources
+        [
+            ['##USER_CONFIG_ROOT##', '.##PROGRAM_NAME##.##EXTENSION##' ],
+            ['##USER_CONFIG_ROOT##', '.config', '##PROGRAM_NAME##.##EXTENSION##' ],
+            ['##USER_CONFIG_ROOT##', '.config', '##PROGRAM_NAME##', 'config.##EXTENSION##' ],
+            ['##USER_CONFIG_ROOT##', '.config', '##PROGRAM_NAME##', '##PROGRAM_NAME##.##EXTENSION##' ],
+            ['##USER_CONFIG_ROOT##', '.##PROGRAM_NAME##', 'config.##EXTENSION##' ],
+            ['##USER_CONFIG_ROOT##', '.##PROGRAM_NAME##', '##PROGRAM_NAME##.##EXTENSION##' ]
+        ]
+      end
+
+    end
+
+  end
+end

data/lib/stacked_config/orchestrator.rb

@@ -0,0 +1,48 @@
+module StackedConfig
+  class Orchestrator < SuperStack::Manager
+
+    include StackedConfig::ProgramDescriptionHelper
+
+    attr_reader :system_layer, :global_layer, :user_layer, :command_line_layer
+
+    def initialize
+      super
+      self.merge_policy = SuperStack::MergePolicies::FullMergePolicy
+      setup_layers
+      default_name = File.basename($PROGRAM_NAME)
+      describes_application executable_name: default_name, app_name: default_name
+    end
+
+    private
+
+    def setup_layers
+      # The system level
+      @system_layer = setup_layer StackedConfig::Layers::SystemLayer, 'System-wide configuration level', 10
+
+      # The global level
+      @global_layer = setup_layer StackedConfig::Layers::GlobalLayer, 'Global configuration level', 20
+
+      # The user level
+      @user_layer = setup_layer StackedConfig::Layers::UserLayer, 'User configuration level', 30
+
+      # The command line level
+      @command_line_layer = setup_layer StackedConfig::Layers::CommandLineLayer, 'Command line configuration level', 100
+
+      # The layer to write something
+      override_layer = setup_layer SuperStack::Layer, 'Overridden configuration level', 1000
+      self.write_layer = override_layer
+
+      reload_layers
+    end
+
+    def setup_layer(class_type, name, priority)
+      layer = class_type.new
+      layer.name = name
+      layer.priority = priority
+      self << layer
+      layer
+    end
+    
+    
+  end
+end

data/lib/stacked_config/program_description_helper.rb

@@ -0,0 +1,54 @@
+module StackedConfig
+  module ProgramDescriptionHelper
+
+    attr_reader :executable_name, :app_name, :app_version, :app_description
+
+    def add_command_line_section(title='Script specific', &block)
+      command_line_layer.add_command_line_section title, &block
+    end
+
+    def executable_name=(executable_name)
+      return if executable_name.nil?
+      @executable_name = executable_name
+      rescan_layers
+      reload_layers
+    end
+
+    def app_name=(app_name)
+      return if app_name.nil?
+      @app_name = app_name
+      command_line_layer.reload
+    end
+
+    def app_version=(app_version)
+      return if app_version.nil?
+      @app_version = app_version
+      command_line_layer.reload
+    end
+
+    def app_description=(app_description)
+      return if app_description.nil?
+      @app_description = app_description
+      command_line_layer.reload
+    end
+
+    def rescan_layers
+      layers.values.each do |layer|
+        if layer.respond_to? :rescan
+          layer.clear
+          layer.rescan
+        end
+      end
+
+    end
+
+    def describes_application(options = {})
+      self.app_name = options.fetch(:app_name, nil)
+      self.app_version = options.fetch(:app_version, nil)
+      self.app_description = options.fetch(:app_description, nil)
+      self.executable_name = options.fetch(:executable_name, nil)
+    end
+
+  end
+end
+

data/lib/stacked_config/source_helper.rb

@@ -0,0 +1,87 @@
+module StackedConfig
+  module SourceHelper
+
+    OS_FLAVOURS = {
+        mingw32: :windows,
+        linux: :unix
+    }
+    DEFAULT_OS_FLAVOUR = :unix
+
+    SYSTEM_CONFIG_ROOT = {
+        windows: [File.join(ENV['systemRoot'] || '', 'Config')],
+        unix: '/etc'
+    }
+
+    USER_CONFIG_ROOT = {
+        windows: ENV['APPDATA'],
+        unix: ENV['HOME']
+    }
+
+    EXTENSIONS = %w(conf CONF cfg CFG yml YML yaml YAML)
+
+    def self.os_flavour
+      OS_FLAVOURS[RbConfig::CONFIG['target_os'].to_sym] || DEFAULT_OS_FLAVOUR
+    end
+
+    def self.supported_oses
+      OS_FLAVOURS.values.sort.uniq
+    end
+
+    def self.system_config_root
+      SYSTEM_CONFIG_ROOT[os_flavour]
+    end
+
+    def self.user_config_root
+      USER_CONFIG_ROOT[os_flavour]
+    end
+
+
+    def supported_oses
+      StackedConfig::SourceHelper.supported_oses
+    end
+
+    def os_flavour
+      @os_flavour ||= StackedConfig::SourceHelper.os_flavour
+    end
+
+    def system_config_root
+      StackedConfig::SourceHelper.system_config_root
+    end
+
+    def user_config_root
+      StackedConfig::SourceHelper.user_config_root
+    end
+
+    def set_config_file(places)
+      @file_name = nil
+      places.each do |path_array|
+        # Perform path substitutions
+        potential_config_file = File.join(path_array.map do |path_part|
+          perform_substitutions path_part
+        end)
+        # Try to find config file with extension
+        EXTENSIONS.each do |extension|
+          file  = potential_config_file.gsub '##EXTENSION##', extension
+          if File.readable? file
+            @file_name = file
+            return @file_name
+          end
+        end
+      end
+    end
+
+
+
+    def perform_substitutions path_part
+      res = path_part.dup
+      res.gsub! '##SYSTEM_CONFIG_ROOT##', system_config_root
+      res.gsub! '##USER_CONFIG_ROOT##', user_config_root
+
+      exec_name = manager.nil? ? File.basename($PROGRAM_NAME) : manager.executable_name
+      res.gsub! '##PROGRAM_NAME##', exec_name
+      res
+    end
+
+
+  end
+end

data/lib/stacked_config/version.rb

@@ -0,0 +1,3 @@
+module StackedConfig
+  VERSION = '0.0.1'
+end

data/lib/stacked_config.rb

@@ -0,0 +1,13 @@
+require 'super_stack'
+require 'slop'
+
+require 'stacked_config/version'
+require 'stacked_config/source_helper'
+require 'stacked_config/program_description_helper'
+require 'stacked_config/layers/generic_layer'
+require 'stacked_config/layers/system_layer'
+require 'stacked_config/layers/global_layer'
+require 'stacked_config/layers/user_layer'
+require 'stacked_config/layers/command_line_layer'
+require 'stacked_config/orchestrator'
+

data/spec/command_line_layer_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+
+describe StackedConfig::Layers::CommandLineLayer do
+  subject { StackedConfig::Layers::CommandLineLayer.new }
+
+  it 'should have some default command line options defined' do
+    expect(subject.length > 0).to be_truthy
+  end
+
+  it 'should have a "help" command line options defined' do
+    expect(subject.keys.include? :help).to be_truthy
+  end
+
+  it 'should have a "auto" command line options defined' do
+    expect(subject.keys.include? :auto).to be_truthy
+  end
+
+  it 'should have a "simulate" command line options defined' do
+    expect(subject.keys.include? :simulate).to be_truthy
+  end
+
+  it 'should have a "verbose" command line options defined' do
+    expect(subject.keys.include? :verbose).to be_truthy
+  end
+
+
+end

data/spec/global_layer_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+
+describe StackedConfig::Layers::GlobalLayer do
+
+  # subject is a modified SystemLayer to redirect system_config_root to the test directory
+  subject {
+    s = StackedConfig::Layers::GlobalLayer.new
+    real_root_path = s.system_config_root
+    os = s.os_flavour.to_s
+    gem_path = File.expand_path '../..', __FILE__
+    allow(s).to receive(:system_config_root) {File.join(gem_path, 'test', os, real_root_path) }
+    s.rescan
+    s
+  }
+
+  it 'should return the path of the first matching config file it found' do
+    expect(subject.file_name).not_to be_nil
+  end
+
+  it 'should have an empty file_name if not present' do
+    allow(File).to receive(:readable?) {false}
+    subject.rescan
+    expect(subject.file_name).to be_nil
+  end
+
+  it 'should enable to load the file' do
+    expect(subject[:an_array]).to be_nil
+    subject.load
+    expect(subject[:an_array]).to be_an Array
+  end
+
+
+
+end

data/spec/orchestrator_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+
+describe StackedConfig::Orchestrator do
+
+  subject {
+    # Patching SourceHelper to find test config files in this gem test directory instead of from the system.
+    os = StackedConfig::SourceHelper.os_flavour
+    gem_path = File.expand_path '../..', __FILE__
+    altered_sys_conf_root = File.join gem_path, 'test', os.to_s, StackedConfig::SourceHelper::SYSTEM_CONFIG_ROOT[os]
+    altered_user_conf_root = File.join gem_path, 'test', 'user'
+
+    allow(StackedConfig::SourceHelper).to receive(:system_config_root) { altered_sys_conf_root }
+    allow(StackedConfig::SourceHelper).to receive(:user_config_root) { altered_user_conf_root }
+
+    StackedConfig::Orchestrator.new
+  }
+
+  it 'should have multiple layers' do
+    expect(subject.layers.length > 0).to be_truthy
+    # puts '#' * 80
+    # puts subject.layers.to_yaml
+    # puts '#' * 80
+    # puts subject[].to_yaml
+    # puts '#' * 80
+    # puts subject.command_line_layer.help
+  end
+
+
+  context 'when changing the executable_name' do
+
+    it 'should reload all config files' do
+      expect(subject[:user_defined]).not_to be_nil
+      expect(subject[:weird_property]).to be_nil
+      subject.executable_name = 'weird_name'
+      expect(subject[:user_defined]).to be_nil
+      expect(subject[:weird_property]).not_to be_nil
+    end
+
+    it 'should keep the modified values' do
+      subject[:modified_value] = :pipo
+      subject.executable_name = 'weird_name'
+      expect(subject[:modified_value]).not_to be_nil
+    end
+
+  end
+
+  context 'when setup by default, priorities should be defined in the Unix standard way' do
+
+    it 'should have the system layer evaluated first' do
+      expect(subject.system_layer).to be subject.to_a.first
+    end
+
+    it 'should have the global layer evaluated in second' do
+      expect(subject.global_layer).to be subject.to_a[1]
+    end
+
+    it 'should have the user layer evaluated in third' do
+      expect(subject.user_layer).to be subject.to_a[2]
+    end
+
+    it 'should have the command-line layer evaluated in fourth' do
+      expect(subject.command_line_layer).to be subject.to_a[3]
+    end
+
+    it 'should have the writable layer evaluated last' do
+      expect(subject.write_layer).to be subject.to_a.last
+    end
+
+  end
+
+
+
+
+end

data/spec/source_helper_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+
+describe StackedConfig::SourceHelper do
+
+  subject {
+    s = Object.new
+    s.extend StackedConfig::SourceHelper
+    s
+  }
+
+  it 'should provide an OS flavour' do
+    expect(subject.os_flavour).to_not be_nil
+  end
+
+  it 'should provide a system config root' do
+    expect(subject.system_config_root).to_not be_nil
+  end
+
+  it 'should provide a user config root' do
+    expect(subject.user_config_root).to_not be_nil
+  end
+
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,92 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'stacked_config'
+
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

data/spec/system_layer_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+
+describe StackedConfig::Layers::SystemLayer do
+
+  # subject is a modified SystemLayer to redirect system_config_root to the test directory
+  subject {
+    s = StackedConfig::Layers::SystemLayer.new
+    real_root_path = s.system_config_root
+    os = s.os_flavour.to_s
+    gem_path = File.expand_path '../..', __FILE__
+    allow(s).to receive(:system_config_root) {File.join(gem_path, 'test', os, real_root_path) }
+    s.rescan
+    s
+  }
+
+  it 'should return the path of the first matching config file it found' do
+    expect(subject.file_name).not_to be_nil
+  end
+
+  it 'should have an empty file_name if not present' do
+    allow(File).to receive(:readable?) {false}
+    subject.rescan
+    expect(subject.file_name).to be_nil
+  end
+
+  it 'should enable to load the file' do
+    expect(subject[:stacked_config_copyright]).to be_nil
+    subject.load
+    expect(subject[:stacked_config_copyright]).not_to be_nil
+  end
+
+
+
+end

data/spec/user_layer_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+
+describe StackedConfig::Layers::UserLayer do
+
+  # subject is a modified SystemLayer to redirect system_config_root to the test directory
+  subject {
+    s = StackedConfig::Layers::UserLayer.new
+    os = s.os_flavour.to_s
+    gem_path = File.expand_path '../..', __FILE__
+    allow(s).to receive(:user_config_root) {File.join(gem_path, 'test', 'user') }
+    s.rescan
+    s
+  }
+
+  it 'should return the path of the first matching config file it found' do
+    expect(subject.file_name).not_to be_nil
+  end
+
+  it 'should have an empty file_name if not present' do
+    allow(File).to receive(:readable?) {false}
+    subject.rescan
+    expect(subject.file_name).to be_nil
+  end
+
+  it 'should enable to load the file' do
+    expect(subject[:an_array]).to be_nil
+    subject.load
+    expect(subject[:an_array]).to be_an Array
+  end
+
+
+
+end

data/stacked_config.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'stacked_config/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'stacked_config'
+  spec.version       = StackedConfig::VERSION
+  spec.authors       = ['Laurent B.']
+  spec.email         = ['lbnetid+gh@gmail.com']
+  spec.summary       = %q{Manages config files according to standard policy.}
+  spec.description   = %q{A config file manager on steroids focusing on places.}
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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', '~> 1.5'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  spec.add_dependency 'super_stack', '~> 0.2', '>= 0.2.3'
+  spec.add_dependency 'slop'
+
+end

data/test/unix/etc/rspec/rspec.yml

@@ -0,0 +1,7 @@
+# This is supposed to be a file at "global" level.
+# It is dedicated to configuration for all users running the program rspec
+# To be used at administrator level only
+
+an_array:
+  - defined at global level
+  - pretty cool (global)

data/test/unix/etc/stacked_config.yml

@@ -0,0 +1,5 @@
+# This is supposed to be a file at "system" level.
+# It is dedicated to configuration for all gems that would use the stacked_config gem.
+# To be used at administrator level only
+
+stacked_config_copyright: (c)2014 L.Briais under MIT license

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: stacked_config
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Laurent B.
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: super_stack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A config file manager on steroids focusing on places.
+email:
+- lbnetid+gh@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/stacked_config.rb
+- lib/stacked_config/layers/command_line_layer.rb
+- lib/stacked_config/layers/generic_layer.rb
+- lib/stacked_config/layers/global_layer.rb
+- lib/stacked_config/layers/system_layer.rb
+- lib/stacked_config/layers/user_layer.rb
+- lib/stacked_config/orchestrator.rb
+- lib/stacked_config/program_description_helper.rb
+- lib/stacked_config/source_helper.rb
+- lib/stacked_config/version.rb
+- spec/command_line_layer_spec.rb
+- spec/global_layer_spec.rb
+- spec/orchestrator_spec.rb
+- spec/source_helper_spec.rb
+- spec/spec_helper.rb
+- spec/system_layer_spec.rb
+- spec/user_layer_spec.rb
+- stacked_config.gemspec
+- test/unix/etc/rspec/rspec.yml
+- test/unix/etc/stacked_config.yml
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: Manages config files according to standard policy.
+test_files:
+- spec/command_line_layer_spec.rb
+- spec/global_layer_spec.rb
+- spec/orchestrator_spec.rb
+- spec/source_helper_spec.rb
+- spec/spec_helper.rb
+- spec/system_layer_spec.rb
+- spec/user_layer_spec.rb
+- test/unix/etc/rspec/rspec.yml
+- test/unix/etc/stacked_config.yml