mguymon-figaro 0.7.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+/.bundle
+/Gemfile.lock
+/coverage
+/gemfiles/*.gemfile.lock
+/pkg
+/tmp

data/.travis.yml

@@ -0,0 +1,19 @@
+before_script:
+  - unset RAILS_ENV
+  - unset RACK_ENV
+branches: master
+gemfile:
+  - gemfiles/rails30.gemfile
+  - gemfiles/rails31.gemfile
+  - gemfiles/rails32.gemfile
+  - gemfiles/rails40.gemfile
+language: ruby
+matrix:
+  include:
+    - gemfile: Gemfile
+      rvm: 2.0.0
+      env: COVERAGE=1
+rvm:
+  - 1.9.3
+  - 2.0.0
+script: rspec

data/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "rails", ">= 3.0.3", "< 5"
+
+group :test do
+  gem "aruba", "~> 0.5"
+  gem "coveralls", "~> 0.7", require: false
+  gem "rake", "~> 10.1"
+  gem "rspec", "~> 2.14"
+  gem "sqlite3", "~> 1.3"
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Steve Richert
+
+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,139 @@
+# Figaro
+[![Gem Version](https://badge.fury.io/rb/figaro.png)](http://badge.fury.io/rb/figaro)
+[![Build Status](https://travis-ci.org/laserlemon/figaro.png?branch=master)](https://travis-ci.org/laserlemon/figaro)
+[![Code Climate](https://codeclimate.com/github/laserlemon/figaro.png)](https://codeclimate.com/github/laserlemon/figaro)
+[![Coverage Status](https://coveralls.io/repos/laserlemon/figaro/badge.png?branch=master)](https://coveralls.io/r/laserlemon/figaro)
+[![Dependency Status](https://gemnasium.com/laserlemon/figaro.png)](https://gemnasium.com/laserlemon/figaro)
+
+Simple Rails app configuration
+
+## What is this for?
+
+Figaro is for configuring Rails (3 and 4) apps, especially open source Rails apps.
+
+Open sourcing a Rails app can be a little tricky when it comes to sensitive configuration information like [Pusher](http://pusher.com/) or [Stripe](https://stripe.com/) credentials. You don't want to check private credentials into the repo but what other choice is there?
+
+Figaro provides a clean and simple way to configure your app and keep the private stuff… private.
+
+## How does it work?
+
+There are a few similar solutions out there, and a lot of homegrown attempts. Most namespace your configuration under a `Config` (or similar) namespace. That's fine, but there's already a place to describe the application environment… `ENV`!
+
+`ENV` is a collection of simple string key/value pairs and it works just great for application configuration.
+
+As an added bonus, this is exactly how apps on [Heroku](http://www.heroku.com/) are configured. So if you configure your Rails app using `ENV`, you're already set to deploy to Heroku.
+
+## Give me an example.
+
+Okay. Add Figaro to your Gemfile and run the `bundle` command to install it:
+
+```ruby
+gem "figaro"
+```
+
+Next up, use the generator provided by Figaro:
+
+```bash
+rails generate figaro:install
+```
+
+This creates a commented `config/application.yml` file and ignores it in your `.gitignore`. Add your own configuration to this file and you're done!
+
+Your configuration will be available as key/value pairs in `ENV`. For example, here's `config/initializers/pusher.rb`:
+
+```ruby
+Pusher.app_id = ENV["PUSHER_APP_ID"]
+Pusher.key    = ENV["PUSHER_KEY"]
+Pusher.secret = ENV["PUSHER_SECRET"]
+```
+
+In addition, you can access these same configuration values through Figaro itself:
+
+```ruby
+Pusher.app_id = Figaro.env.pusher_app_id
+Pusher.key    = Figaro.env.pusher_key
+Pusher.secret = Figaro.env.pusher_secret
+```
+
+But wait… I thought configuration via constant was bad! Well, this is different. Rather than storing a _copy_ of `ENV` internally, `Figaro.env` passes directly through to `ENV`, making it just like using `ENV` itself. So why two approaches? Having your configurations available via method calls makes it easy to stub them out in tests. Either way is fine. The choice is yours!
+
+If your app requires Rails-environment-specific configuration, you can also namespace your configuration under a key for `Rails.env`.
+
+```yaml
+HELLO: world
+development:
+  HELLO: developers
+production:
+  HELLO: users
+```
+
+
+In this case, `ENV["HELLO"]` will produce `"developers"` in development, `"users"` in production and `"world"` otherwise.
+
+**NOTE:** Figaro uses Rails' standard hooks to initialize. Unfortunately, this hook apparently occurs after `database.yml` is read. Because of this issue, environment variables created in `application.yml` don't work inside `database.yml`. 
+
+
+## How does it work with Heroku?
+
+Heroku's beautifully simple application configuration was the [inspiration](http://laserlemon.com/blog/2011/03/08/heroku-friendly-application-configuration/) for Figaro.
+
+Typically, to configure your application `ENV` on Heroku, you would do the following from the command line using the `heroku` gem:
+
+```bash
+heroku config:add PUSHER_APP_ID=8926
+heroku config:add PUSHER_KEY=0463644d89a340ff1132
+heroku config:add PUSHER_SECRET=0eadfd9847769f94367b
+heroku config:add STRIPE_API_KEY=jHXKPPE0dUW84xJNYzn6CdWM2JfrCbPE
+heroku config:add STRIPE_PUBLIC_KEY=pk_HHtUKJwlN7USCT6nE5jiXgoduiNl3
+```
+
+But Figaro provides a rake task to do just that! Just run:
+
+```bash
+rake figaro:heroku
+```
+
+Optionally, you can pass in the name of the Heroku app:
+
+```bash
+rake figaro:heroku[my-awesome-app]
+```
+
+Additionally, if `RAILS_ENV` is configured on your Heroku server, Figaro will use that environment automatically in determining your proper configuration.
+
+## What if I'm not using Heroku?
+
+No problem. Just add `config/application.yml` to your production app on the server.
+
+## This sucks. How can I make it better?
+
+1. Fork it.
+2. Make it better.
+3. Send me a pull request.
+
+## Does Figaro have a mascot?
+
+Yes.
+
+[![Figaro](http://images2.wikia.nocookie.net/__cb20100628192722/disney/images/5/53/Pinocchio-pinocchio-4947890-960-720.jpg "Figaro's mascot: Figaro")](http://en.wikipedia.org/wiki/Figaro_(Disney\))
+
+## Thank you!
+
+Figaro is made possible by the continued contributions and insights from kind-hearted developers everywhere. Just to name a few:
+
+* [@ersatzryan](https://github.com/ersatzryan)
+* [@robertjwhitney](https://github.com/robertjwhitney)
+* [@maxwell](https://github.com/maxwell)
+* [@GuilhermeSimoes](https://github.com/GuilhermeSimoes)
+* [@mikeycgto](https://github.com/mikeycgto)
+* [@subosito](https://github.com/subosito)
+* [@srushti](https://github.com/srushti)
+* [@ptyagi16](https://github.com/ptyagi16)
+* [@jspradlin](https://github.com/jspradlin)
+* [@hadifarnoud](https://github.com/hadifarnoud)
+* [@eloyesp](https://github.com/eloyesp)
+* [@etuya-ix](https://github.com/etuya-ix)
+* [@MarkDBlackwell](https://github.com/MarkDBlackwell)
+* [@HALapeno](https://github.com/HALapeno)
+* [@severin](https://github.com/severin)
+* [@sethvargo](https://github.com/sethvargo)

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/figaro.gemspec

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+Gem::Specification.new do |gem|
+  gem.name    = "mguymon-figaro"
+  gem.version = "0.7.0.1"
+
+  gem.author      = "Steve Richert"
+  gem.email       = "steve.richert@gmail.com"
+  gem.summary     = "Simple Rails app configuration"
+  gem.description = "Simple, Heroku-friendly Rails app configuration using ENV and a single YAML file"
+  gem.homepage    = "https://github.com/laserlemon/figaro"
+  gem.license     = "MIT"
+
+  gem.add_dependency "bundler", "~> 1.0"
+  gem.add_dependency "rails", ">= 3", "< 5"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.test_files    = gem.files.grep(/^(features|spec)/)
+  gem.require_paths = ["lib"]
+end

data/gemfiles/rails30.gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 3.0.2"
+
+group :test do
+  gem "aruba", "~> 0.5"
+  gem "rspec", "~> 2.14"
+  gem "sqlite3", "~> 1.3"
+end

data/gemfiles/rails31.gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 3.1.0"
+
+group :test do
+  gem "aruba", "~> 0.5"
+  gem "rspec", "~> 2.14"
+  gem "sqlite3", "~> 1.3"
+end

data/gemfiles/rails32.gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 3.2.0"
+
+group :test do
+  gem "aruba", "~> 0.5"
+  gem "rspec", "~> 2.14"
+  gem "sqlite3", "~> 1.3"
+end

data/gemfiles/rails40.gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 4.0.0"
+
+group :test do
+  gem "aruba", "~> 0.5"
+  gem "rspec", "~> 2.14"
+  gem "sqlite3", "~> 1.3"
+end

data/lib/figaro.rb

@@ -0,0 +1,26 @@
+require "figaro/application"
+require "figaro/env"
+require "figaro/rails"
+require "figaro/tasks"
+
+module Figaro
+  extend self
+
+  attr_writer :backend, :application
+
+  def env
+    Figaro::ENV
+  end
+
+  def backend
+    @backend ||= Figaro::Rails::Application
+  end
+
+  def application
+    @application ||= backend.new
+  end
+
+  def load
+    application.load
+  end
+end

data/lib/figaro/application.rb

@@ -0,0 +1,77 @@
+require "erb"
+require "yaml"
+
+require "figaro/error"
+
+module Figaro
+  class Application
+    FIGARO_ENV_PREFIX = "FIGARO_"
+
+    attr_writer :path, :environment
+
+    def initialize(options = {})
+      @path = options[:path]
+      @environment = options[:environment]
+    end
+
+    def path
+      (@path || default_path).to_s
+    end
+
+    def environment
+      (@environment || default_environment).to_s
+    end
+
+    def configuration
+      global_configuration.merge(environment_configuration)
+    end
+
+    def load
+      configuration.each do |key, value|
+        set(key, value) unless skip?(key)
+      end
+    end
+
+    private
+
+    def default_path
+      raise NotImplementedError
+    end
+
+    def default_environment
+      raise NotImplementedError
+    end
+
+    def raw_configuration
+      (@parsed ||= Hash.new { |hash, path| hash[path] = parse(path) })[path]
+    end
+
+    def parse(path)
+      File.exist?(path) && YAML.load(ERB.new(File.read(path)).result) || {}
+    end
+
+    def global_configuration
+      raw_configuration.reject { |_, value| value.is_a?(Hash) }
+    end
+
+    def environment_configuration
+      raw_configuration.fetch(environment) { {} }
+    end
+
+    def set(key, value)
+      non_string_configuration!(key) unless key.is_a?(String)
+      non_string_configuration!(value) unless value.is_a?(String)
+
+      ::ENV[key.to_s] = value.to_s
+      ::ENV[FIGARO_ENV_PREFIX + key.to_s] = value.to_s
+    end
+
+    def skip?(key)
+      ::ENV.key?(key.to_s) && !::ENV.key?(FIGARO_ENV_PREFIX + key.to_s)
+    end
+
+    def non_string_configuration!(value)
+      warn "WARNING: Use strings for Figaro configuration. #{value.inspect} was converted to #{value.to_s.inspect}."
+    end
+  end
+end

data/lib/figaro/env.rb

@@ -0,0 +1,37 @@
+module Figaro
+  module ENV
+    extend self
+
+    def respond_to?(method, *)
+      key, punctuation = extract_key_from_method(method)
+
+      case punctuation
+      when "!" then ::ENV.keys.any? { |k| k.upcase == key } || super
+      when "?", nil then true
+      else super
+      end
+    end
+
+    private
+
+    def method_missing(method, *)
+      key, punctuation = extract_key_from_method(method)
+      _, value = ::ENV.detect { |k, _| k.upcase == key }
+
+      case punctuation
+      when "!" then value || missing_key!(key)
+      when "?" then !!value
+      when nil then value
+      else super
+      end
+    end
+
+    def extract_key_from_method(method)
+      method.to_s.upcase.match(/^(.+?)([!?=])?$/).captures
+    end
+
+    def missing_key!(key)
+      raise MissingKey.new("Missing required Figaro configuration key #{key.inspect}.")
+    end
+  end
+end

data/lib/figaro/error.rb

@@ -0,0 +1,6 @@
+module Figaro
+  class Error < StandardError; end
+
+  class RailsNotInitialized < Error; end
+  class MissingKey < Error; end
+end

data/lib/figaro/rails.rb

@@ -0,0 +1,9 @@
+begin
+  require "rails"
+rescue LoadError
+end
+
+if defined?(::Rails)
+  require "figaro/rails/application"
+  require "figaro/rails/railtie"
+end