blended_config 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d122903d51b0e3c4a5964c9055d9a111760a1b37
-  data.tar.gz: d8a340b6cb76bc625522e4fa80b91f6fa6e84a92
+  metadata.gz: c89c46d63f7d25ad9e39c5f47b043d6874f57317
+  data.tar.gz: 47a0d52f431b747d1b9e1ba4c6553b77d8ab8f5b
 SHA512:
-  metadata.gz: 7e438035b69aeef307dd7460021b1cc132b8d442c80658bf1e3ca670789d47bbaccc3c731ed61a253da52e9c0c5029a74171fe65eff3d8a0256acd031b279f38
-  data.tar.gz: 33e8062af7e3d959dcf9e8ffa725ff63f74eaf856c7277878e0c5cd9d9236a90abdf12750ce18cc0c4f6a44806747aadc187e89a3a275d849833e6670c294677
+  metadata.gz: fa60a949062417e65cb83332301f7c25ef5f797761447058f92bd1ad59f0454071c9db2041ebc6b44064654a0da7bddea8a16145f9292bc022e0e024e167c385
+  data.tar.gz: e22293931c88f4ce655226c51dc0c165c9a857de427da34dda332e573d2978275418f3db955422d642f21beecc711047bc509561be14a79caa063ad7c18d45de

data/.gitignore

@@ -8,3 +8,4 @@
 /spec/reports/
 /tmp/
 /spec/examples.txt
+/blended_config-*.gem

data/README.md

@@ -1,8 +1,39 @@
 # BlendedConfig
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/blended_config`. To experiment with that code, run `bin/console` for an interactive prompt.
+BlendedConfig gives you a simple dsl for indicating resolution order between the contents of config files, environment variables and default values. Say you've got this beautiful config file:
+```toml
+[colors]
+blue   = "indigo"
+green  = "lime"
+red    = "maroon"
+purple = "aubergine"
+yellow = "mustard"
+```
+
+but you want only some environment variables to override these. Tell us your decisions like so:
+```ruby
+class ColorsConfig < BlendedConfig
+  group(:colors) do
+    option(:blue)   { env  || file } # pretty standard
+    option(:green)  { file || env } # the reverse
+    option(:red)    { env  || 'brick' } # never read from env vars, but have a default
+    optino(:purple) { file || 'plum' } # only read from the environment, with a default
+    option(:yellow) { env  || file || 'marigold' } # try everything first
+  end
+end
+```
+
+You can now run your program with environment variables:
+
+    $ COLORS_BLUE=cobalt COLORS_YELLOW=butterscotch spec/support/print-colors
+    cobalt
+    lime
+    brick
+    aubergine
+    butterscotch
+
+And it resolves your configuration correctly!
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
@@ -26,13 +57,13 @@ TODO: Write usage instructions here
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bundle install` to install its dependencies. Then, run `bundle exec spec` to run the tests.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/blended_config. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/yarmiganosca/blended_config. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 
 ## License

data/lib/blended_config/sources/toml_source.rb

@@ -8,12 +8,6 @@ class BlendedConfig
         super(TOML.load_file(path))
       end
       alias toml raw_source
-
-      def [](key)
-        (prefixes + [key]).reduce(toml) do |value, key_fragment|
-          value[key_fragment.to_s]
-        end
-      end
     end
   end
 end

data/lib/blended_config/version.rb

@@ -1,3 +1,3 @@
 class BlendedConfig
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/blended_config.rb

@@ -13,18 +13,18 @@ class BlendedConfig
   end
 
   def self.option(name, &resolution)
-    resolver = OptionResolver.new(name, &resolution)
-    resolvers << resolver
+    option_resolver = OptionResolver.new(name, &resolution)
+    option_resolvers << option_resolver
 
-    define_method(name) { resolver }
+    define_method(name) { option_resolver }
   end
 
   def self.option_groups
     @option_groups ||= []
   end
 
-  def self.resolvers
-    @resolvers ||= []
+  def self.option_resolvers
+    @option_resolvers ||= []
   end
 
   def initialize(file: nil, env: ENV)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blended_config
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Chris Hoffman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-17 00:00:00.000000000 Z
+date: 2016-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: toml
@@ -89,8 +89,6 @@ files:
 - lib/blended_config/option_group.rb
 - lib/blended_config/option_resolver.rb
 - lib/blended_config/source.rb
-- lib/blended_config/sources/#toml_source.rb#
-- lib/blended_config/sources/.#toml_source.rb
 - lib/blended_config/sources/environment.rb
 - lib/blended_config/sources/file.rb
 - lib/blended_config/sources/toml_source.rb
@@ -120,4 +118,3 @@ signing_key:
 specification_version: 4
 summary: Decide how your config objects choose between files, env_vars & default values.
 test_files: []
-has_rdoc: 

data/lib/blended_config/sources/#toml_source.rb#

@@ -1,13 +0,0 @@
-require 'blended_config/source'
-require 'toml'
-
-class BlendedConfig
-  module Sources
-    class TomlSource < Source
-      def initialize(path)
-        super(TOML.load_file(path))
-      end
-      alias toml raw_source
-    end
-  end
-end

data/lib/blended_config/sources/.#toml_source.rb

@@ -1 +0,0 @@
-yarmiganosca@bladelike.4274:1453821888