envolve 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0957b934da66eced716f716a370f189da7633f49
+  data.tar.gz: c6198fd51c04495d8f232114d7d062afc52bbe85
+SHA512:
+  metadata.gz: ea88528575352a016613859399447d0bfc881989db78cf9ab91ca7dc531098da7c882e9dab740b6338310c5c8c7eec10b703c58f1170cd3c746efc07d9d89cc1
+  data.tar.gz: dfb14703a551ee5c85b82d7e98da09da8e732083750cefc17aa711df77989c9933723dc46802b62cde484d95b8dd822bde8a0278e1578b9e605cd886d3cc8570

data/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Hi there!
+
+I see you are interested in contributing. That is wonderful. I love
+contributions.
+
+I guarantee that there are bugs in this software. And I guarantee that there is
+a feature you want that is not in here yet. As such, any and all bugs reports
+are gratefully accepted, bugfixes even more so. Helping out with bugs is the
+easiest way to contribute.
+
+
+## The Quick Version
+
+* Have a [GitHub Account][].
+* Search the [GitHub Issues][] and see if your issue already present. If so
+  add your comments, :thumbsup:, etc.
+* Issue not there? Not a problem, open up a [new issue][].
+    * **Bug reports** please be as detailed as possible. Include:
+        * full ruby engine and version: `ruby -e 'puts RUBY_DESCRIPTION'`
+        * operating system and version
+        * version of envolve `ruby -rubygems -e "require 'envolve'; puts Envolve::VERSION"`
+        * as much detail about the bug as possible so I can replicate it. Feel free
+          to link in a [gist][]
+    * **New Feature**
+        * What the new feature should do.
+        * What benefit the new feature brings to the project.
+* Fork the [repo][].
+* Create a new branch for your issue: `git checkout -b issue/my-issue`
+* Lovingly craft your contribution:
+    * `rake develop` to get started, or if you prefer bundler `rake develop:using_bundler && bundle`.
+    * `rake test` to run tests
+* Make sure that `rake test` passes. It's important, I said it twice.
+* Add yourself to the contributors section below.
+* Submit your [pull request][].
+
+# Contributors
+
+* [Jeremy Hinegardner](https://github.com/copiousfreetime)
+
+[GitHub Account]: https://github.com/signup/free "GitHub Signup"
+[GitHub Issues]:  https://github.com/copiousfreetime/envolve/issues "Envolve Issues"
+[new issue]:      https://github.com/copiousfreetime/envolve/issues/new "New Envolve Issue"
+[gist]:           https://gist.github.com/ "New Gist"
+[repo]:           https://github.com/copiousfreetime/envolve "Envolve Repo"
+[pull request]:   https://help.github.com/articles/using-pull-requests "Using Pull Requests"

data/HISTORY.md

@@ -0,0 +1,5 @@
+# Envolve Changelog
+## Version 1.0.0
+
+* Initial Release - Yeah!
+

data/LICENSE

@@ -0,0 +1,16 @@
+ISC LICENSE - http://opensource.org/licenses/isc-license.txt
+
+Copyright (c) 2013 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/Manifest.txt

@@ -0,0 +1,19 @@
+CONTRIBUTING.md
+HISTORY.md
+LICENSE
+Manifest.txt
+README.md
+Rakefile
+lib/envolve.rb
+lib/envolve/config.rb
+lib/envolve/version.rb
+tasks/default.rake
+tasks/this.rb
+test/test_config.rb
+test/test_filtered_config.rb
+test/test_helper.rb
+test/test_key_separator_config.rb
+test/test_meta_config.rb
+test/test_prefix_config.rb
+test/test_property_config.rb
+test/test_version.rb

data/README.md

@@ -0,0 +1,57 @@
+## envolve
+
+* [Homepage](https://github.com/copiousfreetime/envolve/)
+* [Github Project](https://github.com/copiousfreetime/envolve)
+
+## DESCRIPTION
+
+Envolve provides a consistent and validating way to access your application
+configuration that is set via environment variables.
+
+This is double beneficial if you are configuring your entire application with
+environment variables. See. http://12factor.net/config
+
+## USAGE
+
+    module MyApp
+      class MyConfig < ::Envolve::Config
+        prefix 'my_app'
+      end
+
+
+      def self.config
+        @config ||= MyConfig.new
+      end
+    end
+
+
+    # deep in some code somewhere
+
+    hostname = MyApp.config.hostname  # which was originall from ENV['MY_APP_HOSTNAME']
+
+
+## FEATURES
+
+  envolve
+
+## Examples
+
+## ISC LICENSE
+
+http://opensource.org/licenses/isc-license.txt
+
+Copyright (c) 2013 Jeremy Hinegardner
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

data/Rakefile

@@ -0,0 +1,16 @@
+# vim: syntax=ruby
+load 'tasks/this.rb'
+
+This.name     = "envolve"
+This.author   = "Jeremy Hinegardner"
+This.email    = "jeremy@copiousfreetime.org"
+This.homepage = "http://github.com/copiousfreetime/#{ This.name }"
+
+This.ruby_gemspec do |spec|
+  spec.add_development_dependency( 'rake'     , '~> 10.3')
+  spec.add_development_dependency( 'minitest' , '~> 5.4' )
+  spec.add_development_dependency( 'rdoc'     , '~> 4.1' )
+  spec.add_development_dependency( 'simplecov', '~> 0.9' )
+end
+
+load 'tasks/default.rake'

data/lib/envolve.rb

@@ -0,0 +1,9 @@
+module Envolve
+  # Public: load the environment into a Config and return it.
+  #
+  def self.load( env = ENV )
+    Envolve::Config.new( env )
+  end
+end
+require 'envolve/version'
+require 'envolve/config'

data/lib/envolve/config.rb

@@ -0,0 +1,245 @@
+module Envolve
+  # Public: A Configuration class to hold your application configuration
+  #
+  # Feed it ENV or some other Hash-like object and it will allow you to access
+  # the elements in that hash via methods.
+  #
+  # You can also tell it to only pull those items from the initial has that have
+  # a particular prefix, and that prefix will be stripped off of the elements
+  # for access.
+  class Config
+    # Public: Return the default environment.
+    #
+    # Override this to return a different environment source
+    def self.environment_source( *args, &block )
+      if args.size > 0 then
+        @_default_env = args.first
+      elsif block_given? then
+        @_default_env = block.call
+      else
+        @_default_env ||= ENV.to_hash
+      end
+    end
+
+    # Public: Return the prefix to be used by the class
+    #
+    # Override this to return a different prefix, or meta program it in an
+    # inherited class.
+    def self.prefix( *args )
+      if args.size > 0 then
+        @_prefix = args.first
+      else
+        @_prefix = nil if !defined?( @_prefix )
+      end
+      @_prefix
+    end
+
+    # Public: Return the key_separator to be used by the class
+    #
+    # Override this to return a different key_separator, or meta program it in an
+    # inherited class.
+    def self.key_separator( *args, &block )
+      if args.size > 0 then
+        @_key_separator = args.first
+      else
+        @_key_separator = '_'.freeze if !defined?( @_key_separator )
+      end
+      @_key_separator
+    end
+
+    # Public: Set a property, with possible transformations
+    #
+    # In the conversion of a the environment to the configuration properties
+    # sometimes the keys and/or values need to be converted to a new name.
+    #
+    # All property transformations take place AFTER the initial keys have been downcased
+    # and prefix stripped.
+    #
+    # property - the name of the property we want to appear in the configuration
+    # key      - the source key from the environment where this property comes from
+    # value    - the new value for this property
+    # default  - setting a default for this property should it not exist
+    #
+    # value may also be a lambda, in which ase the lambda is given the original
+    # value and the return value from the labmda is used for the new value.
+    #
+    def self.property( property, key: nil, value: nil, default: nil )
+      properties[property] = { :key => key, :value => value, :default => default }
+    end
+
+    # Internal: Return the hash holding the properties
+    #
+    # Returns Hash
+    def self.properties
+      @_properties ||= Hash.new
+    end
+
+    # Internal: The internal hash holding all the keys and values
+    attr_reader :_env
+
+    # Internal: The prefix to strip off all the keys
+    attr_reader :_prefix
+
+    # Internal: The character to use as the key separator
+    attr_reader :_key_separator
+
+    # Public: Create a new Config
+    def initialize( env: self.class.environment_source, prefix: self.class.prefix,
+                   key_separator: self.class.key_separator )
+      @_key_separator = key_separator
+      @_prefix        = prefix.nil? ? nil : prefix.to_s.downcase.strip
+      @_env           = process_env( env )
+
+    end
+
+
+    # Internal: Process and Transform the keys and values from the environment
+    # into the final hash
+    #
+    def process_env( env )
+      env = downcase_keys( env )
+      if _prefix then
+        env = filter_by_prefix( env, _prefix )
+      end
+      env = transform_properties( env, self.class.properties )
+    end
+
+    # Internal: Transform the environment variables to propreties
+    #
+    # Returns the transformed hash
+    def transform_properties( env, properties )
+      transformed = env.to_h.dup
+
+      properties.each do |dest_key, trans|
+        src_key = trans[:key]
+        src_key ||= dest_key
+        if value = transformed.delete(src_key) then
+          value = apply_transformation(value, trans[:value]) if trans[:value]
+        elsif value.nil? then
+          value = trans[:default] if trans[:default]
+        end
+        transformed[dest_key] = value
+      end
+
+      return transformed
+    end
+
+    # Internal: Apply the given transformation to the input.
+    #
+    # Returns the result of the transformation
+    def apply_transformation( input, transformer )
+      return input                     if transformer.nil?
+      return transformer.call( input ) if transformer.respond_to?( :call )
+      return transformer
+    end
+
+    # Public: The number of elements in the config
+    #
+    # Returns the number of elements
+    def size
+      _env.size
+    end
+
+    # Public: Just the keys, only the keys, as Strings
+    #
+    # Returns an Array of the keys as Strings
+    def keys
+      _env.keys
+    end
+
+    # Public: return the value for the give key
+    #
+    # key - the String key to use for fetching
+    #
+    # Returns value or nil if no value is found
+    def []( key )
+      _env[key]
+    end
+
+    # Public: Return a subset of the config with just those items that have a
+    # prefix on them
+    #
+    # The resulting Config only has those keys, and all with the prefixes
+    # stripped
+    def config_with_prefix( prefix )
+      self.class.new( env: _env, prefix: prefix )
+    end
+
+    # Public: Return as hash of the keys and values
+    #
+    # Returns a Hash
+    def to_h
+      _env.to_h.dup
+    end
+    alias to_hash to_h
+
+    # Public: Return a hash of the keys and values with the keys as symbols.
+    #
+    # Returns a Hash
+    def to_symbolized_h
+      h = {}
+      _env.each do |key, value|
+        h[key.to_sym] = value
+      end
+      return h
+    end
+    alias to_symbolized_hash to_symbolized_h
+
+    # Internal: This is how we convert method calls into key lookups in the
+    # internal hash.
+    def method_missing( method, *args, &block )
+      s_method = method.to_s
+      if _env.has_key?( s_method ) then
+        _env[ s_method ]
+      else
+        super
+      end
+    end
+
+    # Internal: Respond to missing should always be implemented if you implement
+    # method_missing
+    def respond_to_missing?( symbol, include_all = false )
+      _env.has_key?( symbol.to_s ) || super
+    end
+
+    # Internal: The prefix regular expression used for stripping leading prefix
+    #
+    # This matches Beginning of String followed by the prefix followed by 0 or
+    # more key_separator characters.
+    #
+    # This will use named captures. The prefix will be under key 'prefix' and
+    # the following will be under 'rest'
+    #
+    # Returns the regex
+    def prefix_regex( prefix, key_separator  )
+      /\A(?<prefix>#{prefix}[#{key_separator}]*)(?<rest>.*)\Z/i
+    end
+
+
+    private
+
+    # Return a copy of the hash filtered by the prefix.
+    #
+    # All the keys that match the prefix will have hte prefix stripped off. All
+    # others will be ignored
+    def filter_by_prefix( in_hash, pre = _prefix, ks = _key_separator )
+      out_hash = {}
+      matcher  = prefix_regex( pre, ks )
+      in_hash.each do |key, value|
+        if md = matcher.match( key ) then
+          out_hash[ md[:rest] ] = value
+        end
+      end
+      return out_hash
+    end
+
+    # Return a copy of the hash with all the keys downcased
+    def downcase_keys( in_hash )
+      out_hash = {}
+      in_hash.each do |key, value|
+        out_hash[key.downcase] = value
+      end
+      return out_hash
+    end
+  end
+end

data/lib/envolve/version.rb

@@ -0,0 +1,3 @@
+module Envolve
+  VERSION = "1.0.0"
+end

data/tasks/default.rake

@@ -0,0 +1,259 @@
+# vim: syntax=ruby
+require 'rake/clean'
+require 'digest'
+#------------------------------------------------------------------------------
+# If you want to Develop on this project just run 'rake develop' and you'll
+# have all you need to get going. If you want to use bundler for development,
+# then run 'rake develop:using_bundler'
+#------------------------------------------------------------------------------
+namespace :develop do
+
+  # Install all the development and runtime dependencies of this gem using the
+  # gemspec.
+  task :default do
+    require 'rubygems/dependency_installer'
+    installer = ::Gem::DependencyInstaller.new
+
+    puts "Installing gem depedencies needed for development"
+    This.platform_gemspec.dependencies.each do |dep|
+      if dep.matching_specs.empty? then
+        puts "Installing : #{dep}"
+        installer.install dep
+      else
+        puts "Skipping   : #{dep} -> already installed #{dep.matching_specs.first.full_name}"
+      end
+    end
+    puts "\n\nNow run 'rake test'"
+  end
+
+  # Create a Gemfile that just references the gemspec
+  file 'Gemfile' => :gemspec do
+    File.open( "Gemfile", "w+" ) do |f|
+      f.puts "# DO NOT EDIT - This file is automatically generated"
+      f.puts "# Make changes to Manifest.txt and/or Rakefile and regenerate"
+      f.puts 'source "https://rubygems.org/"'
+      f.puts 'gemspec'
+    end
+  end
+
+  desc "Create a bundler Gemfile"
+  task :using_bundler => 'Gemfile' do
+    puts "Now you can 'bundle'"
+  end
+
+  # Gemfiles are build artifacts
+  CLOBBER << FileList['Gemfile*']
+end
+desc "Boostrap development"
+task :develop => "develop:default"
+
+#------------------------------------------------------------------------------
+# Minitest - standard TestTask
+#------------------------------------------------------------------------------
+begin
+  require 'rake/testtask'
+  Rake::TestTask.new( :test ) do |t|
+    t.ruby_opts    = %w[ -w -rubygems ]
+    t.libs         = %w[ lib spec test ]
+    t.pattern      = "{test,spec}/**/{test_*,*_spec}.rb"
+  end
+
+  task :test_requirements
+  task :test => :test_requirements
+  task :default => :test
+rescue LoadError
+  This.task_warning( 'test' )
+end
+
+#------------------------------------------------------------------------------
+# RDoc - standard rdoc rake task, although we must make sure to use a more
+#        recent version of rdoc since it is the one that has 'tomdoc' markup
+#------------------------------------------------------------------------------
+begin
+  gem 'rdoc' # otherwise we get the wrong task from stdlib
+  require 'rdoc/task'
+  RDoc::Task.new do |t|
+    t.markup   = 'tomdoc'
+    t.rdoc_dir = 'doc'
+    t.main     = 'README.md'
+    t.title    = "#{This.name} #{This.version}"
+    t.rdoc_files.include( FileList['*.{rdoc,md,txt}'], FileList['ext/**/*.c'],
+                          FileList['lib/**/*.rb'] )
+  end
+rescue StandardError, LoadError
+  This.task_warning( 'rdoc' )
+end
+
+#------------------------------------------------------------------------------
+# Coverage - optional code coverage, rcov for 1.8 and simplecov for 1.9, so
+#            for the moment only rcov is listed.
+#------------------------------------------------------------------------------
+begin
+  require 'simplecov'
+  desc 'Run tests with code coverage'
+  task :coverage do
+    ENV['COVERAGE'] = 'true'
+    Rake::Task[:test].execute
+  end
+  CLOBBER << FileList["coverage/**/*"]
+rescue LoadError
+  This.task_warning( 'simplecov' )
+end
+
+#------------------------------------------------------------------------------
+# Manifest - We want an explicit list of thos files that are to be packaged in
+#            the gem. Most of this is from Hoe.
+#------------------------------------------------------------------------------
+namespace 'manifest' do
+  desc "Check the manifest"
+  task :check => :clean do
+    files = FileList["**/*", ".*"].exclude( This.exclude_from_manifest ).to_a.sort
+    files = files.select{ |f| File.file?( f ) }
+
+    tmp = "Manifest.tmp"
+    File.open( tmp, 'w' ) do |f|
+      f.puts files.join("\n")
+    end
+
+    begin
+      sh "diff -du Manifest.txt #{tmp}"
+    ensure
+      rm tmp
+    end
+    puts "Manifest looks good"
+  end
+
+  desc "Generate the manifest"
+  task :generate => :clean do
+    files = %x[ git ls-files ].split("\n").sort
+    files.reject! { |f| f =~ This.exclude_from_manifest }
+    File.open( "Manifest.txt", "w" ) do |f|
+      f.puts files.join("\n")
+    end
+  end
+end
+
+#------------------------------------------------------------------------------
+# Fixme - look for fixmes and report them
+#------------------------------------------------------------------------------
+namespace :fixme do
+  task :default => 'manifest:check' do
+    This.manifest.each do |file|
+      next if file == __FILE__
+      next unless file =~ %r/(txt|rb|md|rdoc|css|html|xml|css)\Z/
+      puts "FIXME: Rename #{file}" if file =~ /fixme/i
+      IO.readlines( file ).each_with_index do |line, idx|
+        prefix = "FIXME: #{file}:#{idx+1}".ljust(42)
+        puts "#{prefix} => #{line.strip}" if line =~ /fixme/i
+      end
+    end
+  end
+
+  def fixme_project_root
+    This.project_path( '../fixme' )
+  end
+
+  def fixme_project_path( subtree )
+    fixme_project_root.join( subtree )
+  end
+
+  def local_fixme_files
+    This.manifest.select { |p| p =~ %r|^tasks/| }
+  end
+
+  def outdated_fixme_files
+    local_fixme_files.reject do |local|
+      upstream     = fixme_project_path( local )
+      Digest::SHA256.file( local ) == Digest::SHA256.file( upstream )
+    end
+  end
+
+  def fixme_up_to_date?
+    outdated_fixme_files.empty?
+  end
+
+  desc "See if the fixme tools are outdated"
+  task :outdated => :release_check do
+    if fixme_up_to_date? then
+      puts "Fixme files are up to date."
+    else
+      outdated_fixme_files.each do |f|
+        puts "#{f} is outdated"
+      end
+    end
+  end
+
+  desc "Update outdated fixme files"
+  task :update => :release_check do
+    if fixme_up_to_date? then
+      puts "Fixme files are already up to date."
+    else
+      puts "Updating fixme files:"
+      outdated_fixme_files.each do |local|
+        upstream = fixme_project_path( local )
+        puts "  * #{local}"
+        FileUtils.cp( upstream, local )
+      end
+      puts "Use your git commands as appropriate."
+    end
+  end
+end
+desc "Look for fixmes and report them"
+task :fixme => "fixme:default"
+
+#------------------------------------------------------------------------------
+# Gem Specification
+#------------------------------------------------------------------------------
+# Really this is only here to support those who use bundler
+desc "Build the #{This.name}.gemspec file"
+task :gemspec do
+  File.open( This.gemspec_file, "wb+" ) do |f|
+    f.puts "# DO NOT EDIT - This file is automatically generated"
+    f.puts "# Make changes to Manifest.txt and/or Rakefile and regenerate"
+    f.write This.platform_gemspec.to_ruby
+  end
+end
+
+# the gemspec is also a dev artifact and should not be kept around.
+CLOBBER << This.gemspec_file.to_s
+
+# .rbc files from ruby 2.0
+CLOBBER << FileList["**/*.rbc"]
+
+# The standard gem packaging task, everyone has it.
+require 'rubygems/package_task'
+::Gem::PackageTask.new( This.platform_gemspec ) do
+  # nothing
+end
+
+#------------------------------------------------------------------------------
+# Release - the steps we go through to do a final release, this is pulled from
+#           a compbination of mojombo's rakegem, hoe and hoe-git
+#
+# 1) make sure we are on the master branch
+# 2) make sure there are no uncommitted items
+# 3) check the manifest and make sure all looks good
+# 4) build the gem
+# 5) do an empty commit to have the commit message of the version
+# 6) tag that commit as the version
+# 7) push master
+# 8) push the tag
+# 7) pus the gem
+#------------------------------------------------------------------------------
+task :release_check do
+  unless `git branch` =~ /^\* master$/
+    abort "You must be on the master branch to release!"
+  end
+  unless `git status` =~ /^nothing to commit/m
+    abort "Nope, sorry, you have unfinished business"
+  end
+end
+
+desc "Create tag v#{This.version}, build and push #{This.platform_gemspec.full_name} to rubygems.org"
+task :release => [ :release_check, 'manifest:check', :gem ] do
+  sh "git commit --allow-empty -a -m 'Release #{This.version}'"
+  sh "git tag -a -m 'v#{This.version}' v#{This.version}"
+  sh "git push origin master"
+  sh "git push origin v#{This.version}"
+  sh "gem push pkg/#{This.platform_gemspec.full_name}.gem"
+end

data/tasks/this.rb

@@ -0,0 +1,206 @@
+require 'pathname'
+
+# Public: A Class containing all the metadata and utilities needed to manage a
+# ruby project.
+class ThisProject
+  # The name of this project
+  attr_accessor :name
+
+  # The author's name
+  attr_accessor :author
+
+  # The email address of the author(s)
+  attr_accessor :email
+
+  # The homepage of this project
+  attr_accessor :homepage 
+
+  # The regex of files to exclude from the manifest
+  attr_accessor :exclude_from_manifest
+
+  # The hash of Gem::Specifications keyed' by platform
+  attr_accessor :gemspecs
+
+  # Public: Initialize ThisProject
+  #
+  # Yields self
+  def initialize(&block)
+    @exclude_from_manifest = Regexp.union(/\.(git|DS_Store)/,
+                                          /^(doc|coverage|pkg|tmp|Gemfile(\.lock)?)/,
+                                          /^[^\/]+\.gemspec/,
+                                          /\.(swp|jar|bundle|so|rvmrc|travis.yml)$/,
+                                          /~$/)
+    @gemspecs              = Hash.new
+    yield self if block_given?
+  end
+
+  # Public: return the version of ThisProject
+  #
+  # Search the ruby files in the project looking for the one that has the
+  # version string in it. This does not eval any code in the project, it parses
+  # the source code looking for the string.
+  #
+  # Returns a String version
+  def version
+    [ "lib/#{ name }.rb", "lib/#{ name }/version.rb" ].each do |v|
+      path = project_path( v )
+      line = path.read[/^\s*VERSION\s*=\s*.*/]
+      if line then
+        return line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+      end
+    end
+  end
+
+  # Internal: Return a section of an RDoc file with the given section name
+  #
+  # path         - the relative path in the project of the file to parse
+  # section_name - the section out of the file from which to parse data
+  #
+  # Retuns the text of the section as an array of paragrphs.
+  def section_of( file, section_name )
+    re    = /^[=#]+ (.*)$/
+    sectional = project_path( file )
+    parts = sectional.read.split( re )[1..-1]
+    parts.map! { |p| p.strip }
+
+    sections = Hash.new
+    Hash[*parts].each do |k,v|
+      sections[k] = v.split("\n\n")
+    end
+    return sections[section_name]
+  end
+
+  # Internal: print out a warning about the give task
+  def task_warning( task )
+    warn "WARNING: '#{task}' tasks are not defined. Please run 'rake develop'"
+  end
+
+  # Internal: Return the full path to the file that is relative to the project
+  # root.
+  #
+  # path - the relative path of the file from the project root
+  #
+  # Returns the Pathname of the file
+  def project_path( *relative_path )
+    project_root.join( *relative_path )
+  end
+
+  # Internal: The absolute path of this file
+  #
+  # Returns the Pathname of this file.
+  def this_file_path
+    Pathname.new( __FILE__ ).expand_path
+  end
+
+  # Internal: The root directory of this project
+  #
+  # This is defined as being the directory that is in the path of this project
+  # that has the first Rakefile
+  #
+  # Returns the Pathname of the directory
+  def project_root
+    this_file_path.ascend do |p|
+      rakefile = p.join( 'Rakefile' )
+      return p if rakefile.exist?
+    end
+  end
+
+  # Internal: Returns the contents of the Manifest.txt file as an array
+  #
+  # Returns an Array of strings
+  def manifest
+    manifest_file = project_path( "Manifest.txt" )
+    abort "You need a Manifest.txt" unless manifest_file.readable?
+    manifest_file.readlines.map { |l| l.strip }
+  end
+
+  # Internal: Return the files that define the extensions
+  #
+  # Returns an Array
+  def extension_conf_files
+    manifest.grep( /extconf.rb\Z/ )
+  end
+
+  # Internal: Returns the gemspace associated with the current ruby platform
+  def platform_gemspec
+    gemspecs[platform]
+  end
+
+  def core_gemspec
+    Gem::Specification.new do |spec|
+      spec.name        = name
+      spec.version     = version
+      spec.author      = author
+      spec.email       = email
+      spec.homepage    = homepage
+
+      spec.summary     = summary
+      spec.description = description
+      spec.license     = license
+
+      spec.files       = manifest
+      spec.executables = spec.files.grep(/^bin/) { |f| File.basename(f) }
+      spec.test_files  = spec.files.grep(/^spec/)
+
+      spec.extra_rdoc_files += spec.files.grep(/(txt|rdoc|md)$/)
+      spec.rdoc_options = [ "--main"  , 'README.md',
+                            "--markup", "tomdoc" ]
+
+      spec.required_ruby_version = '~> 2.0'
+    end
+  end
+
+  # Internal: Return the gemspec for the ruby platform
+  def ruby_gemspec( core = core_gemspec, &block )
+    yielding_gemspec( 'ruby', core, &block )
+  end
+
+  # Internal: Return the gemspec for the jruby platform
+  def java_gemspec( core = core_gemspec, &block )
+    yielding_gemspec( 'java', core, &block )
+  end
+
+  # Internal: give an initial spec and a key, create a new gemspec based off of
+  # it.
+  #
+  # This will force the new gemspecs 'platform' to be that of the key, since the
+  # only reason you would have multiple gemspecs at this point is to deal with
+  # different platforms.
+  def yielding_gemspec( key, core )
+    spec = gemspecs[key] ||= core.dup
+    spec.platform = key
+    yield spec if block_given?
+    return spec
+  end
+
+  # Internal: Return the platform of ThisProject at the current moment in time.
+  def platform
+    (RUBY_PLATFORM == "java") ? 'java' : Gem::Platform::RUBY
+  end
+
+  # Internal: Return the DESCRIPTION section of the README.rdoc file
+  def description_section
+    section_of( 'README.md', 'DESCRIPTION')
+  end
+ 
+ # Internal: Return the summary text from the README 
+  def summary
+    description_section.first
+  end
+
+  # Internal: Return the full description text from the README
+  def description
+    description_section.join(" ").tr("\n", ' ').gsub(/[{}]/,'').gsub(/\[[^\]]+\]/,'') # strip rdoc
+  end
+
+  def license
+    "ISC"
+  end
+
+  # Internal: The path to the gemspec file
+  def gemspec_file
+    project_path( "#{ name }.gemspec" )
+  end
+end
+
+This = ThisProject.new

data/test/test_config.rb

@@ -0,0 +1,43 @@
+require 'test_helper'
+require 'envolve/config'
+
+class TestConfig < ::Minitest::Test
+  def env
+    { 'EV_TEST_1' => 'test-1',
+      'EV_TEST_2' => 'test-2' }
+  end
+
+  def setup
+    @config = Envolve::Config.new( env: env )
+  end
+
+  def test_access_key_as_method
+    assert_equal( 'test-1', @config.ev_test_1 )
+  end
+
+  def test_respond_to
+    assert( @config.respond_to?( :ev_test_2 ) )
+  end
+
+  def test_size
+    assert( 2, @config.size )
+  end
+
+  def test_keys
+    assert_equal( [ 'ev_test_1', 'ev_test_2'], @config.keys.sort )
+  end
+
+
+  def test_access
+    assert_equal( 'test-2', @config['ev_test_2'] )
+  end
+
+  def test_config_with_prefix
+    assert_equal( { 'test_1' => 'test-1', 'test_2' => 'test-2' }, @config.config_with_prefix( 'ev' ).to_h )
+  end
+
+  def test_symbolized_h
+    assert_equal( { test_1: 'test-1', test_2: 'test-2' }, @config.config_with_prefix( 'ev' ).to_symbolized_hash )
+  end
+
+end

data/test/test_filtered_config.rb

@@ -0,0 +1,37 @@
+require 'test_helper'
+require 'envolve/config'
+
+class TestFilteredConfig < ::Minitest::Test
+  def env
+    { 'EV_X_TEST_1' => 'test-1',
+      'EV_X_TEST_2' => 'test-2',
+      'EV_TEST_3'   => 'test-3',
+      'EV_TEST_4'   => 'test-4' }
+  end
+
+  def setup
+    @config = Envolve::Config.new( env: env, prefix: 'ev_x' )
+  end
+
+  def test_access_key_as_method
+    assert_equal( 'test-1', @config.test_1 )
+  end
+
+  def test_respond_to
+    assert( @config.respond_to?( :test_2 ) )
+  end
+
+  def test_size
+    assert( 2, @config.size )
+  end
+
+  def test_keys
+    assert_equal( [ 'test_1', 'test_2'], @config.keys.sort )
+  end
+
+
+  def test_access
+    assert_equal( 'test-2', @config['test_2'] )
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'simplecov'
+SimpleCov.start if ENV['COVERAGE']
+
+gem 'minitest'
+require 'minitest/autorun'
+require 'minitest/pride'

data/test/test_key_separator_config.rb

@@ -0,0 +1,17 @@
+require 'test_helper'
+require 'envolve/config'
+require 'test_config'
+
+class KeySeparatorConfig < Envolve::Config
+  environment_source {
+    { 'EV-TEST-1' => 'test-1', 'EV-TEST-2' => 'test-2' } 
+  }
+  key_separator '-'
+end
+
+class TestKeySeparatorConfig < ::TestConfig
+  def setup
+    @config = LambdaConfig.new
+  end
+end
+

data/test/test_meta_config.rb

@@ -0,0 +1,16 @@
+require 'test_helper'
+require 'envolve/config'
+require 'test_config'
+
+class LambdaConfig < Envolve::Config
+  environment_source {
+    { 'EV_TEST_1' => 'test-1', 'EV_TEST_2' => 'test-2' } 
+  }
+end
+
+class TestMetaConfig < ::TestConfig
+  def setup
+    @config = LambdaConfig.new
+  end
+end
+

data/test/test_prefix_config.rb

@@ -0,0 +1,20 @@
+require 'test_helper'
+require 'envolve/config'
+require 'test_filtered_config'
+
+class PrefixConfig < Envolve::Config
+  def self.env
+    { 'EV_X_TEST_1' => 'test-1',
+      'EV_X_TEST_2' => 'test-2',
+      'EV_TEST_3'   => 'test-3',
+      'EV_TEST_4'   => 'test-4' }
+  end
+
+  environment_source( env )
+  prefix 'ev_x'
+end
+class TestPrefixConfig < TestFilteredConfig
+  def setup
+    @config = PrefixConfig.new
+  end
+end

data/test/test_property_config.rb

@@ -0,0 +1,53 @@
+require 'test_helper'
+require 'envolve/config'
+
+class PropertyConfig < ::Envolve::Config
+  environment_source {
+    {
+      'EV_TEST_1' => 'test-1',
+      'EV_TEST_2' => 'test-2',
+      'EV_FOO'    => 'test-bar',
+      'EV_WIBBLE' => 'wobble',
+    }
+  }
+
+  prefix 'ev'
+
+  property 'bar',    :key => 'foo'
+  property 'wibble', :value => lambda { |val| val.gsub('o', 'ee') }
+  property 'ara',    :default => 42, :value => lambda { |val| Integer(val) }
+
+end
+
+class TestPropertyConfig < ::Minitest::Test
+  def setup
+    @config = PropertyConfig.new
+  end
+
+
+  def test_access_key_as_method
+    assert_equal( 'test-1', @config.test_1 )
+  end
+
+  def test_respond_to
+    assert( @config.respond_to?( :test_2 ) )
+  end
+
+  def test_size
+    assert( 4, @config.size )
+  end
+
+  def test_keys
+    keys = %w[ test_1 test_2 bar wibble ara].sort
+    assert_equal( keys, @config.keys.sort )
+  end
+
+  def test_access
+    assert_equal( 'weebble', @config['wibble'] )
+  end
+
+  def test_defaults
+    assert_equal( 42, @config['ara'] )
+  end
+
+end

data/test/test_version.rb

@@ -0,0 +1,12 @@
+require 'test_helper'
+require 'envolve/version'
+
+class TestVersion < ::Minitest::Test
+  def test_version_constant_match
+    assert_match(/\A\d+\.\d+\.\d+\Z/, Envolve::VERSION)
+  end
+
+  def test_version_string_match
+    assert_match(/\A\d+\.\d+\.\d+\Z/, Envolve::VERSION.to_s)
+  end
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: envolve
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeremy Hinegardner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Envolve provides a consistent and validating way to access your application
+  configuration that is set via environment variables. This is double beneficial if
+  you are configuring your entire application with environment variables. See. http://12factor.net/config
+email: jeremy@copiousfreetime.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- CONTRIBUTING.md
+- HISTORY.md
+- Manifest.txt
+- README.md
+files:
+- CONTRIBUTING.md
+- HISTORY.md
+- LICENSE
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/envolve.rb
+- lib/envolve/config.rb
+- lib/envolve/version.rb
+- tasks/default.rake
+- tasks/this.rb
+- test/test_config.rb
+- test/test_filtered_config.rb
+- test/test_helper.rb
+- test/test_key_separator_config.rb
+- test/test_meta_config.rb
+- test/test_prefix_config.rb
+- test/test_property_config.rb
+- test/test_version.rb
+homepage: http://github.com/copiousfreetime/envolve
+licenses:
+- ISC
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+- "--markup"
+- tomdoc
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Envolve provides a consistent and validating way to access your application
+  configuration that is set via environment variables.
+test_files: []