drtom_rails_config 0.5.0.beta1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8d0dab090b5c539d48bbb84dd67f60382f90d1e3
+  data.tar.gz: 514fb195b79157f83cb69589105fbd063caced7f
+SHA512:
+  metadata.gz: 5e07b93d5cdddf4860add6d4e14621c709a124225cd3aaa6570a7c5230b93c648c72ea542e5a9914857fb57e3cc35c92fab47abfc7a157679ceccb5500776479
+  data.tar.gz: 986fb806117949b1bc78b99b2b253b289c9c1cb02998437285a9be98319e620917942cf586b521b97bc2565cc312d94298818c7ed091732faccec39d19a806d0

data/.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+.rvmrc
+.idea
+.bundle
+gemfiles/*.lock
+log
+pkg
+spec/app/**/db/*.sqlite*
+spec/app/**/log/
+spec/app/**/tmp/
+spec/app/**/.sass-cache
+tmp
+Gemfile.lock
+*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.ruby-gemset

@@ -0,0 +1 @@
+rails_config

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.1

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.1.2
+before_script:
+  - bundle exec appraisal install
+script:
+  - bundle exec appraisal rspec

data/Appraisals

@@ -0,0 +1,11 @@
+appraise "rails-3" do
+  gem "rails", "3.2.18"
+end
+
+appraise "rails-4" do
+  gem "rails", "4.0.0"
+end
+
+appraise "rails-4.1" do
+  gem "rails", "4.1.0"
+end

data/CHANGELOG.md

@@ -0,0 +1,24 @@
+# 0.5.0.beta1
+
+* Made rails_config work without Rails as a hard dependency ([#86](https://github.com/railsjedi/rails_config/issues/86 [#88](https://github.com/railsjedi/rails_config/issues/88)
+* Fix generate error when .gitignore is missing ([#85](https://github.com/railsjedi/rails_config/issues/85))
+* Fix deprecation warning on File.exists? ([#81](https://github.com/railsjedi/rails_config/issues/81))
+* Add a shortcut method for setting files ([#67](https://github.com/railsjedi/rails_config/issues/67))
+* Improve YAMLSource load error message by outputting offending file path ([#88](https://github.com/railsjedi/rails_config/issues/88))
+
+# 0.4.2
+* Ability to specify the app name when calling the Heroku rake task ([#75](https://github.com/railsjedi/rails_config/issues/75))
+
+# 0.4.1
+
+* Fixed compatibility with Rails 4.1 ([#72](https://github.com/railsjedi/rails_config/issues/72))
+* Testing suite verifies compatibility with Rails 3.2, 4.0 and 4.1
+
+# 0.4.0
+
+* Compatibility with Heroku ([#64](https://github.com/railsjedi/rails_config/issues/64))
+
+# 0.3.4
+
+* Expose Settings in application.rb, so you don't have to duplicate configuration for each environment file ([#59](https://github.com/railsjedi/rails_config/issues/59))
+* Adding support for Rails 4.1.0.rc ([#70](https://github.com/railsjedi/rails_config/issues/70))

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Declare your gem's dependencies in rails_config.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec

data/LICENSE.md

@@ -0,0 +1,27 @@
+The MIT License (MIT)
+
+Copyright (c) 2010-2014 Jacques Crocker, Fred Wu, Piotr Kuczynski
+
+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.
+
+
+Third-party materials and licenses:
+
+* RailsConfig contains Deep Merge (deep_merge.rb) which is governed by the MIT license
+  Copyright (C) 2008 Steve Midgley

data/README.md

@@ -0,0 +1,317 @@
+# RailsConfig
+
+THIS IS A FORK! 
+
+This variant of the `rails_config` gem uses a much easier to understand and
+therefore easier to use and more reliable deep-merge strategy. The key 
+property can be summarized in the following sentence:  
+
+** Values which are to be merged in and are not maps/hashes always overwrite
+exiting values. **
+
+
+The formal descriptions reads as follows: 
+
+
+Let `M1` and `M2` be a maps, and let `M` be the result of `deep_merge M1 M2`
+Then the  following holds true:
+
+1. If the key `k` with the value `v1` is present in `M1` but not in `M2`, then
+  the key value pair `(k,v1)` is be present in `M`.
+
+2. If the key `k` with the value `v2` is present in `M2` but not in `M1`, then
+  the key value pair `(k,v2)` is be present in `M`.
+
+3. If `k` is present in `M1` and `M2`
+
+    1. and  `v1` and `v2` are both maps, then the pair `(k,  deep_merge v1 v2 )` is present in `M`.
+
+    2. otherwise the pair `(k,v2)` is present in `M`.
+
+
+The implementation comprises about 30 lines whereas the original one extends to
+about 180 lines including some rather diffuse comments. 
+
+
+
+## Summary
+
+RailsConfig helps you easily manage environment specific Rails settings in an easy and usable manner
+
+## Features
+
+* simple YAML config files
+* config files support ERB
+* config files support inheritance
+* access config information via convenient object member notation
+
+## Compatibility
+
+* Rails 3.x and 4.x
+* Padrino
+* Sinatra
+
+For older versions of Rails and other Ruby apps, use [AppConfig](http://github.com/fredwu/app_config).
+
+## Installing on Rails 3 or 4
+
+Add this to your `Gemfile`:
+
+```ruby
+gem "rails_config"
+```
+
+## Installing on Padrino
+
+Add this to your `Gemfile`:
+
+```ruby
+gem "rails_config"
+```
+
+in your app.rb, you'll also need to register RailsConfig
+
+```ruby
+register RailsConfig
+```
+
+## Installing on Sinatra
+
+Add this to your `Gemfile`:
+
+```ruby
+gem "rails_config"
+```
+
+in your app, you'll need to register RailsConfig. You'll also need to give it a root so it can find the config files.
+
+```ruby
+set :root, File.dirname(__FILE__)
+register RailsConfig
+```
+
+It's also possible to initialize it manually within your configure block if you want to just give it some yml paths to load from.
+
+```ruby
+RailsConfig.load_and_set_settings("/path/to/yaml1", "/path/to/yaml2", ...)
+```
+
+## Customizing RailsConfig
+
+You may customize the behavior of RailsConfig by generating an initializer file:
+
+    rails g rails_config:install
+
+This will generate `config/initializers/rails_config.rb` with a set of default settings as well as to generate a set of default settings files:
+
+    config/settings.yml
+    config/settings/development.yml
+    config/settings/production.yml
+    config/settings/test.yml
+
+## Accessing the Settings object
+
+After installing this plugin, the `Settings` object will be available globally. Entries are accessed via object member notation:
+
+```ruby
+Settings.my_config_entry
+```
+
+Nested entries are supported:
+
+```ruby
+Settings.my_section.some_entry
+```
+
+Alternatively, you can also use the `[]` operator if you don't know which exact setting you need to access ahead of time.
+
+```ruby
+# All the following are equivalent to Settings.my_section.some_entry
+Settings.my_section[:some_entry]
+Settings.my_section['some_entry']
+Settings[:my_section][:some_entry]
+```
+
+If you have set a different constant name for the object in the initializer file, use that instead.
+
+## Common config file
+
+Config entries are compiled from:
+
+    config/settings.yml
+    config/settings/#{environment}.yml
+    config/environments/#{environment}.yml
+
+    config/settings.local.yml
+    config/settings/#{environment}.local.yml
+    config/environments/#{environment}.local.yml
+
+Settings defined in files that are lower in the list override settings higher.
+
+### Reloading settings
+
+You can reload the Settings object at any time by running `Settings.reload!`.
+
+### Reloading settings and config files
+
+You can also reload the `Settings` object from different config files at runtime.
+
+For example, in your tests if you want to test the production settings, you can:
+
+```ruby
+Rails.env = "production"
+Settings.reload_from_files(
+  Rails.root.join("config", "settings.yml").to_s,
+  Rails.root.join("config", "settings", "#{Rails.env}.yml").to_s,
+  Rails.root.join("config", "environments", "#{Rails.env}.yml").to_s
+)
+```
+
+### Environment specific config files
+
+You can have environment specific config files. Environment specific config entries take precedence over common config entries.
+
+Example development environment config file:
+
+```ruby
+#{Rails.root}/config/environments/development.yml
+```
+
+Example production environment config file:
+
+```ruby
+#{Rails.root}/config/environments/production.yml
+```
+
+### Developer specific config files
+
+If you want to have local settings, specific to your machine or development environment,
+you can use the following files, which are automatically `.gitignored` :
+
+    Rails.root.join("config", "settings.local.yml").to_s,
+    Rails.root.join("config", "settings", "#{Rails.env}.local.yml").to_s,
+    Rails.root.join("config", "environments", "#{Rails.env}.local.yml").to_s
+
+
+### Adding sources at Runtime
+
+You can add new YAML config files at runtime. Just use:
+
+```ruby
+Settings.add_source!("/path/to/source.yml")
+Settings.reload!
+```
+
+This will use the given source.yml file and use its settings to overwrite any previous ones.
+
+One thing I like to do for my Rails projects is provide a local.yml config file that is .gitignored (so its independent per developer). Then I create a new initializer in `config/initializers/add_local_config.rb` with the contents
+
+```ruby
+Settings.add_source!("#{Rails.root}/config/settings/local.yml")
+Settings.reload!
+```
+
+> Note: this is an example usage, it is easier to just use the default local files `settings.local.yml, settings/#{Rails.env}.local.yml and environments/#{Rails.env}.local.yml`
+>       for your developer specific settings.
+
+## Embedded Ruby (ERB)
+
+Embedded Ruby is allowed in the configuration files. See examples below.
+
+## Accessing Configuration Settings
+
+Consider the two following config files.
+
+ #{Rails.root}/config/settings.yml:
+
+```yaml
+size: 1
+server: google.com
+```
+
+ #{Rails.root}/config/environments/development.yml:
+
+```yaml
+size: 2
+computed: <%= 1 + 2 + 3 %>
+section:
+  size: 3
+  servers: [ {name: yahoo.com}, {name: amazon.com} ]
+```
+
+Notice that the environment specific config entries overwrite the common entries.
+
+```ruby
+Settings.size   # => 2
+Settings.server # => google.com
+```
+
+Notice the embedded Ruby.
+
+```ruby
+Settings.computed # => 6
+```
+
+Notice that object member notation is maintained even in nested entries.
+
+```ruby
+Settings.section.size # => 3
+```
+
+Notice array notation and object member notation is maintained.
+
+```ruby
+Settings.section.servers[0].name # => yahoo.com
+Settings.section.servers[1].name # => amazon.com
+```
+
+## Working with Heroku
+
+Heroku uses ENV object to store sensitive settings which are like the local files described above. You cannot upload such files to Heroku because it's ephemeral filesystem gets recreated from the git sources on each instance refresh.
+
+To use rails_config with Heroku just set the `use_env` var to `true` in your `config/initializers/rails_config.rb` file. Eg:
+
+```ruby
+RailsConfig.setup do |config|
+  config.const_name = 'AppSettings'
+  config.use_env = true
+end
+```
+
+Now rails_config would read values from the ENV object to the settings. For the example above it would look for keys starting with 'AppSettings'. Eg:
+
+```ruby
+ENV['AppSettings.section.size'] = 1
+ENV['AppSettings.section.server'] = 'google.com'
+```
+
+It won't work with arrays, though.
+
+To upload your local values to Heroku you could ran `bundle exec rake rails_config:heroku`.
+
+
+## Contributing
+
+Bootstrap
+
+```bash
+$ appraisal install
+```
+
+Running the test suite
+
+```bash
+$ appraisal rspec
+```
+
+
+## Authors
+
+* [Jacques Crocker](http://github.com/railsjedi)
+* [Fred Wu](http://github.com/fredwu)
+* [Piotr Kuczynski](http://github.com/pkuczynski)
+* Inherited from [AppConfig](http://github.com/cjbottaro/app_config) by [Christopher J. Bottaro](http://github.com/cjbottaro)
+
+## License
+
+RailsConfig is released under the [MIT License](http://www.opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,53 @@
+#!/usr/bin/env rake
+
+begin
+  require 'bundler/setup'
+
+  Bundler::GemHelper.install_tasks
+
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+
+##
+# Testing
+#
+require "rspec"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+# Test for multiple Rails scenarios
+if !ENV["APPRAISAL_INITIALIZED"] && !ENV["TRAVIS"]
+  require "appraisal"
+
+  task :default => :appraisal
+end
+
+
+##
+# Documentation
+#
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = "RailsConfig #{RailsConfig::VERSION}"
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.*')
+  rdoc.rdoc_files.include('CHANGELOG.*')
+  rdoc.rdoc_files.include('LICENSE.*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+##
+# Rails Application
+#
+
+# APP_RAKEFILE = File.expand_path("../spec/app/rails/Rakefile", __FILE__)
+# load 'rails/tasks/engine.rake'
+
+