configue 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fe53fc0c3969215bf80141f59536a4027c80009c
-  data.tar.gz: 6048c54717f66a3c840cc1f4d6af57cffb488c27
+  metadata.gz: 86aff7ac75739e3642c097da1e578ba446fb9cdf
+  data.tar.gz: 13da63cb35000679ab923d6de5f608ca61f97623
 SHA512:
-  metadata.gz: fffd57a26f941018cb692adb873071164c7a7df8f00811da59e1701f273279edd42072ee210be137338bf7e56fc7bf0631bca726918dc17ab29356fab8ef335d
-  data.tar.gz: 9588c1c6d5c29df1dea602ad9a66667705d5010bc2e15f27526c08ac495ff908e4cd4204ab37697d24dad832d2ac75799acec104e15b86d49ae5973c7de52968
+  metadata.gz: 73a694a548c2e4a3d0f0e6d5ddb45af82759281289ad18ddb5b22e11415d634cf0df90890841872ac217bf4fc8adc6787587420042645ee2e0a3bfd37455b594
+  data.tar.gz: 91a904450a5a18a26eacef5910289a2aebdf2e30e4198b6d521cd37049f2a0e573ef1105cf538d84b68718ffece338e6be652d878cfc20f69c54ac218b492f7d

data/README.md

@@ -50,6 +50,7 @@ accounts:
 You can specify `namespace` and `base_namespace`.
 
 When you write settings as follows:
+
 ```yaml
 # config/settings/base.yml
 base:
@@ -99,3 +100,31 @@ you can access it in the following manner:
 >> MyConf.foo.baz
 => ["one", "two", "three"]
 ```
+
+### source_file
+You can specify files that you want to load into your class in the following manner:
+
+```ruby
+class MyConf < Configue::Container
+  config.source_file "#{File.dirname(__FILE__)}/config/settings/base.yml"
+  config.source_file "#{File.dirname(__FILE__)}/config/settings/dev.yml"
+  config.source_file "#{File.dirname(__FILE__)}/config/settings/test.yml"
+
+  ...
+```
+
+### import_config
+You can import a configuration into an object as one of its attributes without
+defining a class for that.
+
+```ruby
+class Foo
+  include Configue::Importer
+  import_config from_dir: "#{File.dirname(__FILE__)}/config/settings",
+                as: :settings,
+                namespace: :dev
+  ...
+  def foo
+    if settings.foo.baa == ...
+    ...
+```

data/configue.gemspec

@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.require_paths = ["lib"]
-  s.version       = "0.1.2"
-  s.license       = "MIT" 
+  s.version       = "0.1.3"
+  s.license       = "MIT"
 
   s.add_development_dependency 'rspec'
 end

data/lib/configue/container.rb

@@ -4,8 +4,6 @@ require "configue/container_adapter"
 require "configue/criteria"
 
 module Configue
-  # +Configue::Container+ is a setting solution using a YAML file.
-  #
   # When you have such configuration files:
   #
   #    # config/accounts/admin_users.yml
@@ -20,7 +18,7 @@ module Configue
   #        - sleepy
   #        - dopey
   #
-  # this could be:
+  # you can load them into your class in the following ways:
   #
   #    class Foo < Configue::Container
   #      config.source_dir "#{File.dirname(__FILE__)}/config"
@@ -34,9 +32,9 @@ module Configue
   #
   class Container < Node
 
-    # When you do not know the setting has keys that you want to
-    # specify and want to avoid +NoMethodError+, you could use
-    # +query+ and +retrieve+.
+    # When you do not know whether your setting object has keys
+    # that you want to specify and want to avoid +NoMethodError+,
+    # you can use +query+ and +retrieve+.
     #
     #   Foo.query("accounts.admin_users").retrieve
     #   # => ["grumpy", "sneezy"]
@@ -54,12 +52,13 @@ module Configue
     end
 
     class << self
-      # +config+ allows you to access the object for setting container.
+      # +config+ allows you to access the object for setting up container.
       def config
         @config_access_name = "config"
         @setting ||= Setting.new(ContainerAdapter.new(self))
       end
 
+      # +config_setting+ is the same with +config+.
       def config_setting
         @config_access_name = "config_setting"
         @setting ||= Setting.new(ContainerAdapter.new(self))

data/lib/configue/importer.rb

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+module Configue
+  module Importer
+    def self.included(clazz)
+      clazz.extend(ClassMethod)
+    end
+  end
+
+  module ClassMethod
+    # Imports a configuration as one of attributes.
+    #
+    # The following keys are available:
+    #
+    # +as+:: (required) a name of an attribute for the configuration.
+    # +from_dir+:: a path of a directory that the configuration file is in.
+    # +from_file+:: a path of the configuration file.
+    # +namespace+:: a name of namespace.
+    # +base_namespace+:: a name of base namespace.
+    #
+    def import_config(args)
+      raise ArgumentError unless args.respond_to?(:[])
+      var = args.delete(:as)
+      raise if var.nil?
+
+      dirs = args.delete(:from_dir)
+      files = args.delete(:from_file)
+      args[:source_dir] = dirs if dirs
+      args[:source_file] = files if files
+
+      config = Class.new(Container)
+      args.each {|k, v| config.config.__send__(k, *Array(v)) }
+
+      define_method(var, -> { config })
+      nil
+    end
+  end
+end

data/lib/configue/node.rb

@@ -32,17 +32,43 @@ module Configue
       @hash.key?(k)
     end
     alias_method :has_key?, :key?
+    alias_method :include?, :key?
+    alias_method :member?,  :key?
 
-    def keys
-      @hash.keys
+    def assoc(key)
+      k = key.to_s
+      @hash.assoc(k)
     end
 
     def to_hash
       @hash.dup
     end
 
-    def to_s
-      @hash.to_s
+    def values_at(*keys)
+      ks = keys.map {|k| k.to_s }
+      @hash.values_at(*ks)
+    end
+
+    [ :keys,
+      :to_s,
+      :each,
+      :each_pair,
+      :each_key,
+      :empty?,
+      :value?,
+      :size,
+      :length,
+      :merge,
+      :rassoc,
+      :reject,
+      :select,
+      :sort,
+      :to_a,
+      :values,
+    ].each do |m|
+      define_method(m, ->(*args, &block) {
+                      @hash.__send__(m, *args, &block)
+                    })
     end
   end
 end

data/lib/configue/setting.rb

@@ -43,12 +43,27 @@ module Configue
       end
     end
 
+    # Specifies files that you want to load into your class.
+    #
+    # You can call this method many times.
+    #
+    # ====Arguments
+    # - +files+: files that you want to load into your class.
+    #
     def source_file(*files)
       @sources ||= []
       @sources += files.map {|f| {file: f}} unless files.empty?
       @sources
     end
 
+    def source_file=(file)
+      if file.is_a?(Array)
+        source_file(*file)
+      else
+        source_file(file)
+      end
+    end
+
     def load!
       @owner.instance ? @owner.instance : @owner.new_container(load_sources)
     end

data/lib/configue.rb

@@ -2,4 +2,4 @@
 require "configue/setting"
 require "configue/node"
 require "configue/container"
-
+require "configue/importer"

data/spec/samples/triple_yaml/base.yml

@@ -0,0 +1,10 @@
+base:
+  items:
+    foo: abc abc
+    baa: def def
+    baz: ghi ghi
+    pee: 123
+    kaa: 456
+    boo: 789
+
+  

data/spec/samples/triple_yaml/development.yml

@@ -0,0 +1,5 @@
+development:
+  items:
+    foo: aaa aaa
+    baa: bbb bbb
+    baz: ccc ccc

data/spec/samples/triple_yaml/production.yml

@@ -0,0 +1,5 @@
+production:
+  items:
+    foo: ABC ABC
+    baa: DEF DEF
+    baz: GHI GHI

data/spec/samples/triple_yaml_conf.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+
+class TripleYamlConf < Configue::Container
+  config.source_file "#{File.dirname(__FILE__)}/triple_yaml/base.yml"
+  config.source_file "#{File.dirname(__FILE__)}/triple_yaml/production.yml"
+  config.source_file "#{File.dirname(__FILE__)}/triple_yaml/development.yml"
+
+  config.base_namespace :base
+  config.namespace :development
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: configue
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - hosim
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-02 00:00:00.000000000 Z
+date: 2014-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -40,6 +40,7 @@ files:
 - lib/configue/container.rb
 - lib/configue/container_adapter.rb
 - lib/configue/criteria.rb
+- lib/configue/importer.rb
 - lib/configue/merger.rb
 - lib/configue/node.rb
 - lib/configue/setting.rb
@@ -67,6 +68,10 @@ files:
 - spec/samples/single_source_conf.rb
 - spec/samples/single_yaml/conf.yml
 - spec/samples/single_yaml_conf.rb
+- spec/samples/triple_yaml/base.yml
+- spec/samples/triple_yaml/development.yml
+- spec/samples/triple_yaml/production.yml
+- spec/samples/triple_yaml_conf.rb
 - spec/signs_spec.rb
 - spec/spec_helper.rb
 - spec/support/inner_hash.rb
@@ -117,6 +122,10 @@ test_files:
 - spec/samples/single_source_conf.rb
 - spec/samples/single_yaml/conf.yml
 - spec/samples/single_yaml_conf.rb
+- spec/samples/triple_yaml/base.yml
+- spec/samples/triple_yaml/development.yml
+- spec/samples/triple_yaml/production.yml
+- spec/samples/triple_yaml_conf.rb
 - spec/signs_spec.rb
 - spec/spec_helper.rb
 - spec/support/inner_hash.rb