configuratron 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.rbc

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - rbx
+  - rbx-2.0
+  - jruby

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gemspec
+
+if RUBY_PLATFORM =~ /darwin/
+  group :development do
+    gem 'rb-fsevent'
+    gem 'growl'
+  end
+end
+

data/Guardfile

@@ -0,0 +1,8 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec', :version => 2, :cli => "--color --format nested", :rvm => ['1.8.7', '1.9.2'] do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { "spec" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts = ["--color", "--format documentation"]
+end
+
+task :default => :spec

data/configuratron.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name        = "configuratron"
+  s.version     = "0.0.1"
+  s.authors     = ["Grzesiek Kolodziejczyk"]
+  s.email       = ["gkolodziejczyk@gmail.com"]
+  s.homepage    = "https://github.com/grk/configuratron"
+  s.summary     = %q{Configuration storage library}
+  s.description = %q{Configuration storage library for Ruby with metaprogramming magic. Allows for hash-like and method-based key access.}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec", ">= 2.6.0"
+  s.add_development_dependency "guard-rspec"
+  s.add_development_dependency "rake", ">= 0.9.2"
+  s.add_development_dependency "bundler"
+end

data/lib/configuratron.rb

@@ -0,0 +1,76 @@
+require "configuratron/blank_slate"
+
+class Configuratron < BlankSlate
+  def initialize
+    @config = ConfigHash.new
+  end
+
+  def [](key)
+    @config[key]
+  end
+
+  def []=(key, value)
+    @config[key] = value
+  end
+
+  def method_missing(name, *args, &block)
+    @config.__send__(name, *args, &block)
+  end
+
+  module Configurable
+    def config
+      @config ||= Configuratron.new
+    end
+  end
+
+  class ConfigHash < BlankSlate
+    def initialize(hash = nil)
+      @hash = {}
+      if hash
+        hash.each do |k,v|
+          @hash[k] = v.is_a?(Hash) ? ConfigHash.new(v) : v
+        end
+      end
+    end
+
+    def []=(k, v)
+      @hash[k] = v.is_a?(Hash) ? ConfigHash.new(v) : v
+    end
+
+    def [](k)
+      @hash[k]
+    end
+
+    def method_missing(name, *args, &block)
+      if name.to_s[-1..-1] == '=' # workaround for 1.8 returning char
+        base_name = name.to_s[0..-2].to_sym
+        _define_singleton_method(name) do |name|
+          __send__ :[]=, base_name, value
+        end
+        __send__ :[]=, base_name, *args
+      else
+        _define_singleton_method(name) do
+          __send__ :[], name.to_sym
+        end
+        __send__ :[], name.to_sym
+      end
+    end
+
+    private
+    def _singleton_class
+      class << self
+        self
+      end
+    end
+
+    def _singleton_exec(*args, &block)
+      _singleton_class.instance_exec(*args, &block)
+    end
+
+    def _define_singleton_method(name, &block)
+      _singleton_exec(name) do |name|
+        define_method(name, &block)
+      end
+    end
+  end
+end

data/lib/configuratron/blank_slate.rb

@@ -0,0 +1,75 @@
+class BlankSlate
+  class << self
+
+    # Hide the method named +name+ in the BlankSlate class.  Don't
+    # hide +instance_eval+ or any method beginning with "__".
+    def hide(name)
+      if instance_methods.include?(name) and name.to_s !~ /^(__|instance_eval|object_id)/
+        @hidden_methods ||= {}
+        @hidden_methods[name] = instance_method(name)
+        undef_method name
+      end
+    end
+
+    def find_hidden_method(name)
+      @hidden_methods ||= {}
+      @hidden_methods[name] || (superclass.find_hidden_method(name) if superclass.respond_to?(:find_hidden_method))
+    end
+
+    # Redefine a previously hidden method so that it may be called on a blank
+    # slate object.
+    def reveal(name)
+      unbound_method = find_hidden_method(name)
+      fail "Don't know how to reveal method '#{name}'" unless unbound_method
+      define_method(name, unbound_method)
+    end
+  end
+
+  instance_methods.each { |m| hide(m) }
+end
+
+module Kernel
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+
+    # Detect method additions to Kernel and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Kernel
+      BlankSlate.hide(name)
+      result
+    end
+  end
+end
+
+class Object
+  class << self
+    alias_method :blank_slate_method_added, :method_added
+
+    # Detect method additions to Object and remove them in the
+    # BlankSlate class.
+    def method_added(name)
+      result = blank_slate_method_added(name)
+      return result if self != Object
+      BlankSlate.hide(name)
+      result
+    end
+
+    def find_hidden_method(name)
+      nil
+    end
+  end
+end
+
+class Module
+  alias blankslate_original_append_features append_features
+  def append_features(mod)
+    result = blankslate_original_append_features(mod)
+    return result if mod != Object
+    instance_methods.each do |name|
+      BlankSlate.hide(name)
+    end
+    result
+  end
+end

data/spec/configuratron/config_hash_spec.rb

@@ -0,0 +1,93 @@
+require "spec_helper"
+
+describe Configuratron::ConfigHash do
+  %w(instance_variable_get is_a? methods).each do |m|
+    if RUBY18
+      Configuratron::ConfigHash.reveal(m)
+    else
+      Configuratron::ConfigHash.reveal(m.to_sym)
+    end
+  end
+
+  if defined?(RUBY_ENGINE) && RUBY_ENGINE == "rbx"
+    Configuratron::ConfigHash.reveal("singleton_methods")
+    Configuratron::ConfigHash.reveal("kind_of?")
+  end
+
+  before(:each) do
+    @ch = Configuratron::ConfigHash.new
+  end
+
+  context "when created" do
+    it "should be empty" do
+      @ch.instance_variable_get(:@hash).should be_empty
+    end
+  end
+
+  context "keys" do
+    it "should return nil for missing key" do
+      @ch[:missing_key].should be_nil
+    end
+
+    it "should set value for new key" do
+      @ch[:new_key] = :value
+      @ch.instance_variable_get(:@hash)[:new_key].should eql(:value)
+    end
+
+    it "should return value for existing key" do
+      @ch.instance_variable_get(:@hash)[:existing_key] = :value
+      @ch[:existing_key].should eql(:value)
+    end
+  end
+
+  context "method access" do
+    it "should return nil for missing key" do
+      @ch.missing_key.should be_nil
+    end
+
+    it "should set value for new key" do
+      @ch.new_key = :value
+      @ch.instance_variable_get(:@hash)[:new_key].should eql(:value)
+    end
+
+    it "should return value for existing key" do
+      @ch.instance_variable_get(:@hash)[:existing_key] = :value
+      @ch.existing_key.should eql(:value)
+    end
+  end
+
+  context "hash keys" do
+    it "should convert hash keys to self class" do
+      @ch[:hash_key] = {:new => :hash}
+      @ch[:hash_key].should be_a(Configuratron::ConfigHash)
+    end
+
+    it "should convert nested hash keys recursively" do
+      @ch[:nested_hash] = {:root => {:nested => :value}}
+      @ch[:nested_hash].should be_a(Configuratron::ConfigHash)
+      @ch[:nested_hash][:root].should be_a(Configuratron::ConfigHash)
+    end
+
+    it "should access nested hash keys by methods" do
+      @ch.nested_hash = {:root => {:nested => :value}}
+      @ch.nested_hash.should be_a(Configuratron::ConfigHash)
+      @ch.nested_hash.root.should be_a(Configuratron::ConfigHash)
+      @ch.nested_hash.root.nested.should eql(:value)
+    end
+  end
+
+  context "defining methods on method_missing" do
+    it "should not have instance methods defined before first call" do
+      @ch.methods.should_not include(RUBY18 ? "test_key" : :test_key)
+      @ch.methods.should_not include(RUBY18 ? "test_key=" : :test_key=)
+    end
+
+    it "should have instance methods defined after first call" do
+      @ch.test_key
+      @ch.methods.should include(RUBY18 ? "test_key" : :test_key)
+
+      @ch.test_key = :value
+      @ch.methods.should include(RUBY18 ? "test_key=" : :test_key=)
+    end
+  end
+end

data/spec/configuratron/configurable_spec.rb

@@ -0,0 +1,41 @@
+require "spec_helper"
+
+describe Configuratron::Configurable do
+  context "included" do
+    class A
+      include Configuratron::Configurable
+    end
+
+    before(:all) do
+      @a = A.new
+    end
+
+    it "should define config for instances" do
+      @a.should respond_to(:config)
+      @a.config.should be_a(Configuratron)
+    end
+
+    it "should not define config for class" do
+      A.should_not respond_to(:config)
+    end
+  end
+
+  context "extended" do
+    class B
+      extend Configuratron::Configurable
+    end
+
+    before(:all) do
+      @b = B.new
+    end
+
+    it "should not define config for instances" do
+      @b.should_not respond_to(:config)
+    end
+
+    it "should define config for class" do
+      B.should respond_to(:config)
+      B.config.should be_a(Configuratron)
+    end
+  end
+end

data/spec/configuratron/configuratron_spec.rb

@@ -0,0 +1,29 @@
+require "spec_helper"
+
+describe Configuratron do
+  before(:each) do
+    @c = Configuratron.new
+  end
+
+  context "hash-like access" do
+    it "should return nil for missing keys" do
+      @c[:key].should be_nil
+    end
+
+    it "should set value for new keys" do
+      @c[:key] = :value
+      @c[:key].should eql(:value)
+    end
+  end
+
+  context "method access" do
+    it "should return nil for missing keys" do
+      @c.key.should be_nil
+    end
+
+    it "should set value for new keys" do
+      @c.key = :value
+      @c.key.should eql(:value)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require "configuratron"
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+end
+
+RUBY18 = !(RUBY_VERSION =~ /^1\.8/).nil?

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: configuratron
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Grzesiek Kolodziejczyk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-11 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2156046840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2156046840
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &2156045780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2156045780
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2156044960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *2156044960
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2156044360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2156044360
+description: Configuration storage library for Ruby with metaprogramming magic. Allows
+  for hash-like and method-based key access.
+email:
+- gkolodziejczyk@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Guardfile
+- Rakefile
+- configuratron.gemspec
+- lib/configuratron.rb
+- lib/configuratron/blank_slate.rb
+- spec/configuratron/config_hash_spec.rb
+- spec/configuratron/configurable_spec.rb
+- spec/configuratron/configuratron_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/grk/configuratron
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: Configuration storage library
+test_files:
+- spec/configuratron/config_hash_spec.rb
+- spec/configuratron/configurable_spec.rb
+- spec/configuratron/configuratron_spec.rb
+- spec/spec_helper.rb