environment_configurable 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Atomic Object
+ 
+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,64 @@
+# environment_configurable
+
+Description
+===========
+
+A library that makes environment dependent configuration easy in rails.
+
+Rationale
+========
+
+Environment dependent configuration is a common problem in rails, and we noticed
+a common pattern:
+
+  * We tend to extract configuration variables to a yaml file
+  * We often wrap the yaml configuration in a configuration helper
+  
+Environment Configurable accomplishes both of these task succinctly.
+
+Install
+====
+  * gem install environment_configurable
+  * Add config.gem "environment_configurable" to your environment.rb file
+  
+Dependencies
+============
+
+* Rails 2.3.0 >=
+
+Example
+=======
+
+    class S3Helper
+      include EnvironmentConfigurable
+      configure_with "config/s3.yml"
+      
+      def self.connect!
+         AWS::S3::Base.establish_connection!(
+            :access_key_id     => config.access_key_id,
+            :secret_access_key => config.secret_access_key
+          )
+      end
+    end
+    
+  s3.yml
+  
+    production: &DEFAULTS
+      access_key_id: ACCESS_KEY_ID
+      secret_access_key: SECRET_ACCESS_KEY
+      bucket: the-prod-bucket
+
+    staging:
+      <<: *DEFAULTS
+      bucket: the-staging-bucket
+
+    development:
+      <<: *DEFAULTS
+      bucket: the-development-bucket
+
+    test:
+      <<: *DEFAULTS
+      bucket: the-test-bucket
+    
+    
+

data/Rakefile

@@ -0,0 +1,35 @@
+$:<< "vendor/gems/gems/rspec-1.2.9/lib" 
+
+require 'spec/rake/spectask'
+
+task :default => [:spec]
+
+desc "Executes bundler and grabs necessary dependencies to run tests"
+task "setup:contrib" do
+  system("gem bundle")
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = "spec/**/*_spec.rb"
+  t.spec_opts = ["-f s -c"]
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "environment_configurable"
+    s.summary = "A library that makes environment dependent configuration easy in rails."
+    s.description = "A library that makes environment dependent configuration easy in rails."
+    s.email = "github@atomicobject.com"
+    s.homepage = "http://github.com/atomicobject/environment_configurable"
+    s.authors = ["Atomic Object"]
+    s.executables = []
+    s.files =  FileList["lib/**/*.rb", "LICENSE", "Rakefile"]
+    s.test_files = FileList["spec/**/*.rb"]
+    s.add_dependency "rails", ">=2.3.0"
+  end
+  
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/lib/environment_configurable.rb

@@ -0,0 +1,45 @@
+module EnvironmentConfigurable 
+  module InstanceMethods
+    def config
+      self.class.config
+    end
+  end
+
+  module ClassMethods
+    def configure_with(file)
+      @configured_with_file = "#{Rails.root}/#{file}"
+      unless File.exist?(@configured_with_file)
+        raise "Can't configure class #{self.name} -- no file #{@configured_with_file}"
+      end
+    end
+
+    def config
+      unless @config_wrappers
+        @config_data = YAML.load(ERB.new(File.read(@configured_with_file)).result)
+        @config_wrappers = {}
+        @config_data.each do |env_name, hash|
+          @config_wrappers[env_name] = ConfigWrapper.new(hash)
+        end
+      end
+      @config_wrappers[Rails.env]
+    end
+  end
+
+  class ConfigWrapper
+    def initialize(hash)
+      @hash = hash
+    end
+    def method_missing(method_name,*args)
+      key = method_name.to_s
+      super unless @hash.keys.include?(key)
+      @hash[key] 
+    end
+  end
+
+  def self.included(receiver)
+    receiver.send(:include, InstanceMethods)
+    receiver.send(:extend, ClassMethods)
+  end
+
+
+end

data/spec/environment_configurable_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe EnvironmentConfigurable do
+  class MyHouse
+    include EnvironmentConfigurable
+    configure_with "config/s3.yml"
+    
+    def self.peek_access_key_id
+      config.access_key_id
+    end
+
+    def self.peek_bucket
+      config.bucket
+    end
+
+    def self.blow_up
+      config.oops
+    end
+
+    def i_access_key_id
+      config.access_key_id
+    end
+
+    def i_bucket
+      config.bucket
+    end
+  end
+  
+  class ErbTown
+    include EnvironmentConfigurable
+    configure_with "test_files/erb_example.yml"
+    
+    def self.path
+      config.path
+    end
+  end
+  
+  it "gives a class clean, environment-specific access to a yml config" do
+    @yml_data = YAML.load_file("#{Rails.root}/config/s3.yml")
+
+    MyHouse.peek_access_key_id.should_not be_nil 
+    MyHouse.peek_access_key_id.should == @yml_data["test"]["access_key_id"]
+
+    MyHouse.peek_bucket.should_not be_nil 
+    MyHouse.peek_bucket.should == @yml_data["test"]["bucket"]
+  end
+
+  it "returns nil for unknown config vars" do
+    lambda { MyHouse.blow_up }.should raise_error(NoMethodError, /oops/)
+  end
+
+  it "explodes when config file is not there" do
+    lambda do 
+      Class.new do
+        include EnvironmentConfigurable
+        configure_with "config/nono.yml"
+      end
+    end.should raise_error(/nono.yml/)
+  end
+  
+  it "erb loads the yaml files" do
+    ErbTown.path.should == File.join(Rails.root, "/the/path")
+  end
+  
+  it "provides instance methods with access to config as well" do
+    @yml_data = YAML.load_file("#{Rails.root}/config/s3.yml")
+
+    @my_house = MyHouse.new
+    @my_house.i_access_key_id.should == @yml_data["test"]["access_key_id"]
+    @my_house.i_bucket.should == @yml_data["test"]["bucket"]
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+here = File.expand_path(File.dirname(__FILE__))
+$:<< File.expand_path("../lib")
+
+ENV["RAILS_ENV"] ||= 'test'
+require File.join(here, "..", "vendor/gems/environment")
+require 'stub_rails/config/environment'
+require 'environment_configurable'
+Bundler.require_env :test
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+Spec::Runner.configure do |config|
+  config.include(SpecInstanceHelpers)
+  config.mock_with :mocha
+end

data/spec/stub_rails/app/controllers/application_controller.rb

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  # filter_parameter_logging :password
+end

data/spec/stub_rails/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# Methods added to this helper will be available to all templates in the application.
+module ApplicationHelper
+end

data/spec/stub_rails/config/boot.rb

@@ -0,0 +1,110 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    def preinitialize
+      load(preinitializer_path) if File.exist?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+      Rails::Initializer.run(:install_gem_spec_stubs)
+      Rails::GemDependency.add_frozen_gem_path
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion rescue nil
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        min_version = '1.3.2'
+        require 'rubygems'
+        unless rubygems_version >= min_version
+          $stderr.puts %Q(Rails requires RubyGems >= #{min_version} (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %Q(Rails requires RubyGems >= #{min_version}. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!

data/spec/stub_rails/config/environment.rb

@@ -0,0 +1,41 @@
+# Be sure to restart your server when you modify this file
+
+# Specifies gem version of Rails to use when vendor/rails is not present
+RAILS_GEM_VERSION = '2.3.5' unless defined? RAILS_GEM_VERSION
+
+# Bootstrap the Rails environment, frameworks, and default configuration
+require File.join(File.dirname(__FILE__), 'boot')
+
+Rails::Initializer.run do |config|
+  # Settings in config/environments/* take precedence over those specified here.
+  # Application configuration should go into files in config/initializers
+  # -- all .rb files in that directory are automatically loaded.
+
+  # Add additional load paths for your own custom dirs
+  # config.load_paths += %W( #{RAILS_ROOT}/extras )
+
+  # Specify gems that this application depends on and have them installed with rake gems:install
+  # config.gem "bj"
+  # config.gem "hpricot", :version => '0.6', :source => "http://code.whytheluckystiff.net"
+  # config.gem "sqlite3-ruby", :lib => "sqlite3"
+  # config.gem "aws-s3", :lib => "aws/s3"
+
+  # Only load the plugins named here, in the order given (default is alphabetical).
+  # :all can be used as a placeholder for all plugins not explicitly named
+  # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
+
+  # Skip frameworks you're not going to use. To use Rails without a database,
+  # you must remove the Active Record framework.
+  # config.frameworks -= [ :active_record, :active_resource, :action_mailer ]
+
+  # Activate observers that should always be running
+  # config.active_record.observers = :cacher, :garbage_collector, :forum_observer
+
+  # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
+  # Run "rake -D time" for a list of tasks for finding time zone names.
+  config.time_zone = 'UTC'
+
+  # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
+  # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}')]
+  # config.i18n.default_locale = :de
+end

data/spec/stub_rails/config/environments/development.rb

@@ -0,0 +1,17 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# In the development environment your application's code is reloaded on
+# every request.  This slows down response time but is perfect for development
+# since you don't have to restart the webserver when you make code changes.
+config.cache_classes = false
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_view.debug_rjs                         = true
+config.action_controller.perform_caching             = false
+
+# Don't care if the mailer can't send
+config.action_mailer.raise_delivery_errors = false

data/spec/stub_rails/config/environments/production.rb

@@ -0,0 +1,28 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The production environment is meant for finished, "live" apps.
+# Code is not reloaded between requests
+config.cache_classes = true
+
+# Full error reports are disabled and caching is turned on
+config.action_controller.consider_all_requests_local = false
+config.action_controller.perform_caching             = true
+config.action_view.cache_template_loading            = true
+
+# See everything in the log (default is :info)
+# config.log_level = :debug
+
+# Use a different logger for distributed setups
+# config.logger = SyslogLogger.new
+
+# Use a different cache store in production
+# config.cache_store = :mem_cache_store
+
+# Enable serving of images, stylesheets, and javascripts from an asset server
+# config.action_controller.asset_host = "http://assets.example.com"
+
+# Disable delivery errors, bad email addresses will be ignored
+# config.action_mailer.raise_delivery_errors = false
+
+# Enable threaded mode
+# config.threadsafe!

data/spec/stub_rails/config/environments/test.rb

@@ -0,0 +1,28 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The test environment is used exclusively to run your application's
+# test suite.  You never need to work with it otherwise.  Remember that
+# your test database is "scratch space" for the test suite and is wiped
+# and recreated between test runs.  Don't rely on the data there!
+config.cache_classes = true
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_controller.perform_caching             = false
+config.action_view.cache_template_loading            = true
+
+# Disable request forgery protection in test environment
+config.action_controller.allow_forgery_protection    = false
+
+# Tell Action Mailer not to deliver emails to the real world.
+# The :test delivery method accumulates sent emails in the
+# ActionMailer::Base.deliveries array.
+config.action_mailer.delivery_method = :test
+
+# Use SQL instead of Active Record's schema dumper when creating the test database.
+# This is necessary if your schema can't be completely dumped by the schema dumper,
+# like if you have constraints or database-specific column types
+# config.active_record.schema_format = :sql

data/spec/stub_rails/config/initializers/backtrace_silencers.rb

@@ -0,0 +1,7 @@
+# Be sure to restart your server when you modify this file.
+
+# You can add backtrace silencers for libraries that you're using but don't wish to see in your backtraces.
+# Rails.backtrace_cleaner.add_silencer { |line| line =~ /my_noisy_library/ }
+
+# You can also remove all the silencers if you're trying do debug a problem that might steem from framework code.
+# Rails.backtrace_cleaner.remove_silencers!

data/spec/stub_rails/config/initializers/inflections.rb

@@ -0,0 +1,10 @@
+# Be sure to restart your server when you modify this file.
+
+# Add new inflection rules using the following format 
+# (all these examples are active by default):
+# ActiveSupport::Inflector.inflections do |inflect|
+#   inflect.plural /^(ox)$/i, '\1en'
+#   inflect.singular /^(ox)en/i, '\1'
+#   inflect.irregular 'person', 'people'
+#   inflect.uncountable %w( fish sheep )
+# end

data/spec/stub_rails/config/initializers/mime_types.rb

@@ -0,0 +1,5 @@
+# Be sure to restart your server when you modify this file.
+
+# Add new mime types for use in respond_to blocks:
+# Mime::Type.register "text/richtext", :rtf
+# Mime::Type.register_alias "text/html", :iphone

data/spec/stub_rails/config/initializers/new_rails_defaults.rb

@@ -0,0 +1,21 @@
+# Be sure to restart your server when you modify this file.
+
+# These settings change the behavior of Rails 2 apps and will be defaults
+# for Rails 3. You can remove this initializer when Rails 3 is released.
+
+if defined?(ActiveRecord)
+  # Include Active Record class name as root for JSON serialized output.
+  ActiveRecord::Base.include_root_in_json = true
+
+  # Store the full class name (including module namespace) in STI type column.
+  ActiveRecord::Base.store_full_sti_class = true
+end
+
+ActionController::Routing.generate_best_match = false
+
+# Use ISO 8601 format for JSON serialized times and dates.
+ActiveSupport.use_standard_json_time_format = true
+
+# Don't escape HTML entities in JSON, leave that for the #json_escape helper.
+# if you're including raw json in an HTML page.
+ActiveSupport.escape_html_entities_in_json = false

data/spec/stub_rails/config/initializers/session_store.rb

@@ -0,0 +1,15 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying cookie session data integrity.
+# If you change this key, all old sessions will become invalid!
+# Make sure the secret is at least 30 characters and all random, 
+# no regular words or you'll be exposed to dictionary attacks.
+ActionController::Base.session = {
+  :key         => '_stub_rails_session',
+  :secret      => '3a182c6602a162a9ee6a1894a24eb4b8de5047ce3383bf3506c2b308b93b1715c75e14d3fa52e6c17350cd9d76f98b9479a1c9c45217e0f9bf0449ece5d7a542'
+}
+
+# Use the database for sessions instead of the cookie-based default,
+# which shouldn't be used to store highly confidential information
+# (create the session table with "rake db:sessions:create")
+# ActionController::Base.session_store = :active_record_store

data/spec/stub_rails/config/routes.rb

@@ -0,0 +1,43 @@
+ActionController::Routing::Routes.draw do |map|
+  # The priority is based upon order of creation: first created -> highest priority.
+
+  # Sample of regular route:
+  #   map.connect 'products/:id', :controller => 'catalog', :action => 'view'
+  # Keep in mind you can assign values other than :controller and :action
+
+  # Sample of named route:
+  #   map.purchase 'products/:id/purchase', :controller => 'catalog', :action => 'purchase'
+  # This route can be invoked with purchase_url(:id => product.id)
+
+  # Sample resource route (maps HTTP verbs to controller actions automatically):
+  #   map.resources :products
+
+  # Sample resource route with options:
+  #   map.resources :products, :member => { :short => :get, :toggle => :post }, :collection => { :sold => :get }
+
+  # Sample resource route with sub-resources:
+  #   map.resources :products, :has_many => [ :comments, :sales ], :has_one => :seller
+  
+  # Sample resource route with more complex sub-resources
+  #   map.resources :products do |products|
+  #     products.resources :comments
+  #     products.resources :sales, :collection => { :recent => :get }
+  #   end
+
+  # Sample resource route within a namespace:
+  #   map.namespace :admin do |admin|
+  #     # Directs /admin/products/* to Admin::ProductsController (app/controllers/admin/products_controller.rb)
+  #     admin.resources :products
+  #   end
+
+  # You can have the root of your site routed with map.root -- just remember to delete public/index.html.
+  # map.root :controller => "welcome"
+
+  # See how all your routes lay out with "rake routes"
+
+  # Install the default routes as the lowest priority.
+  # Note: These default routes make all actions in every controller accessible via GET requests. You should
+  # consider removing or commenting them out if you're using named routes and resources.
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end

data/spec/stub_rails/db/seeds.rb

@@ -0,0 +1,7 @@
+# This file should contain all the record creation needed to seed the database with its default values.
+# The data can then be loaded with the rake db:seed (or created alongside the db with db:setup).
+#
+# Examples:
+#   
+#   cities = City.create([{ :name => 'Chicago' }, { :name => 'Copenhagen' }])
+#   Major.create(:name => 'Daley', :city => cities.first)

data/spec/stub_rails/test/performance/browsing_test.rb

@@ -0,0 +1,9 @@
+require 'test_helper'
+require 'performance_test_help'
+
+# Profiling results for each test method are written to tmp/performance.
+class BrowsingTest < ActionController::PerformanceTest
+  def test_homepage
+    get '/'
+  end
+end

data/spec/stub_rails/test/test_helper.rb

@@ -0,0 +1,38 @@
+ENV["RAILS_ENV"] = "test"
+require File.expand_path(File.dirname(__FILE__) + "/../config/environment")
+require 'test_help'
+
+class ActiveSupport::TestCase
+  # Transactional fixtures accelerate your tests by wrapping each test method
+  # in a transaction that's rolled back on completion.  This ensures that the
+  # test database remains unchanged so your fixtures don't have to be reloaded
+  # between every test method.  Fewer database queries means faster tests.
+  #
+  # Read Mike Clark's excellent walkthrough at
+  #   http://clarkware.com/cgi/blosxom/2005/10/24#Rails10FastTesting
+  #
+  # Every Active Record database supports transactions except MyISAM tables
+  # in MySQL.  Turn off transactional fixtures in this case; however, if you
+  # don't care one way or the other, switching from MyISAM to InnoDB tables
+  # is recommended.
+  #
+  # The only drawback to using transactional fixtures is when you actually 
+  # need to test transactions.  Since your test is bracketed by a transaction,
+  # any transactions started in your code will be automatically rolled back.
+  self.use_transactional_fixtures = true
+
+  # Instantiated fixtures are slow, but give you @david where otherwise you
+  # would need people(:david).  If you don't want to migrate your existing
+  # test cases which use the @david style and don't mind the speed hit (each
+  # instantiated fixtures translates to a database query per test method),
+  # then set this back to true.
+  self.use_instantiated_fixtures  = false
+
+  # Setup all fixtures in test/fixtures/*.(yml|csv) for all tests in alphabetical order.
+  #
+  # Note: You'll currently still have to declare fixtures explicitly in integration tests
+  # -- they do not yet inherit this setting
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+end

data/spec/support/stub_helpers.rb

@@ -0,0 +1,164 @@
+module SpecInstanceHelpers
+  def stub_instance_hash(*instance_names)
+    hash = {}
+    instance_names.each do |instance_name|
+      hash[instance_name] = stub_instance(instance_name)
+    end
+    hash
+  end
+
+  def stub_string_hash(*instance_names)
+    hash = {}
+    instance_names.each do |instance_name|
+      hash[instance_name] = stub_string(instance_name)
+    end
+    hash
+  end
+  
+  def create_array_of_stubs(instance, count, stubbings)
+    stub_array = stub_array_instance(instance, count, instance.to_s.singularize)
+    stub_array.each do |stub|
+      stubbings.each do |key, value_lambda|
+        stub.stub!(key).and_return(value_lambda.call)
+      end
+    end
+  end
+  
+  def stub_instance(var_name, options={})
+    var_name = var_name.to_s.gsub(/[\?!]/, "")
+    the_stub = stub(var_name.to_s.humanize, options)
+    instance_variable_set("@#{var_name}", the_stub)
+    the_stub
+  end
+  
+  def stub_array_instance(ivar_sym, count, label=nil)
+    label ||= ivar_sym.to_s.singularize
+    array = stub_array(count, label)
+    instance_variable_set("@#{ivar_sym}", array)
+    array
+  end
+  
+  def stub_array(count, label)
+    array = []
+    1.upto(count) do |i| 
+      array << stub("#{label} #{i}")
+    end
+    array
+  end
+
+  def stub_instances(*var_names)
+    var_names.map do |var_name|
+      stub_instance var_name
+    end
+  end
+  
+  def stub_params(*param_names)
+    @params = {}
+    param_names.each do |param_name|
+      instance_variable_set("@#{param_name}", "param #{param_name}")
+      @params[param_name.to_s] = "param #{param_name}"
+    end
+    @params
+  end
+
+  def stub_partial(partial, options={})
+    options = _prepare_stub_partial_options(partial, options)
+    template.stub!(:render).with(options).and_return(%|<p id="#{partial.gsub(/\//,'_')}_partial"></p>|)
+  end
+
+  def stub_partials(*partials)
+    partials.each &method(:stub_partial)
+  end
+
+  def stub_string(sym)
+    the_stub = sym.to_s.humanize
+    instance_variable_set("@#{sym}", the_stub)
+    the_stub
+  end
+
+  def stub_strings(*syms)
+    syms.each &method(:stub_string)
+  end
+
+  def stub_for_view(name, field_names)
+    the_stub = stub_instance(name)
+    _stub_methods_for_view(the_stub, field_names) 
+    the_stub
+  end
+  
+  
+
+  def expect_and_render_partial(partial,options={})
+    options = _prepare_stub_partial_options(partial, options)
+    template.should_receive(:render).with(options).and_return(%|<p id="#{partial.gsub(/\//,'_')}_partial"></p>|)
+  end
+
+  def _stub_methods_for_view(the_stub, field_names) 
+    field_names.each do |fname|
+      case fname
+      when String, Symbol
+        field_name = fname.to_sym
+        field_value = block_given?  ? yield(fname) : "The #{fname.to_s.humanize}"
+        the_stub.stub!(field_name).and_return(field_value)
+      when Hash
+        fname.each do |k,v|
+          the_stub.stub!(k.to_sym).and_return(v)
+        end
+      end
+    end
+  end
+  
+  def _prepare_stub_partial_options(partial, options)
+    options.reverse_merge!(:partial => partial)
+    if options[:locals] == false
+      options.delete(:locals)
+    else
+      options.reverse_merge!(:locals => anything)
+    end
+    options
+  end
+
+  def stub_array_for_view(count, name_base, field_names)
+    the_array = []
+    count.times do |i|
+      i = i + 1 # one-based numbering
+      name = "#{name_base.to_s.singularize}#{i}"
+      the_stub = stub_instance(name)
+      _stub_methods_for_view(the_stub, field_names) do |fname|
+        "The #{fname.to_s.humanize} #{i}"
+      end
+      the_array << the_stub
+    end
+    instance_variable_set("@#{name_base}", the_array)
+    the_array
+  end
+
+
+end
+
+class NilClass
+  # Mocha:
+  
+  def expects(*args)
+    raise "Don't expects(#{args.inspect}) on nil"
+  end
+
+  def stubs(*args)
+    raise "Don't stubs(#{args.inspect}) on nil"
+  end
+
+  # RSpec mocks:
+  #
+  def stub!(*args)
+    raise "Don't stub! on nil."
+  end
+
+  def should_receive(*args)
+    raise "Don't should_receive on nil."
+  end
+
+  def should_not_receive(*args)
+    raise "Don't should_not_receive on nil."
+  end
+
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: environment_configurable
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Atomic Object
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-15 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.0
+    version: 
+description: A library that makes environment dependent configuration easy in rails.
+email: github@atomicobject.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- LICENSE
+- Rakefile
+- lib/environment_configurable.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/atomicobject/environment_configurable
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A library that makes environment dependent configuration easy in rails.
+test_files: 
+- spec/environment_configurable_spec.rb
+- spec/spec_helper.rb
+- spec/stub_rails/app/controllers/application_controller.rb
+- spec/stub_rails/app/helpers/application_helper.rb
+- spec/stub_rails/config/boot.rb
+- spec/stub_rails/config/environment.rb
+- spec/stub_rails/config/environments/development.rb
+- spec/stub_rails/config/environments/production.rb
+- spec/stub_rails/config/environments/test.rb
+- spec/stub_rails/config/initializers/backtrace_silencers.rb
+- spec/stub_rails/config/initializers/inflections.rb
+- spec/stub_rails/config/initializers/mime_types.rb
+- spec/stub_rails/config/initializers/new_rails_defaults.rb
+- spec/stub_rails/config/initializers/session_store.rb
+- spec/stub_rails/config/routes.rb
+- spec/stub_rails/db/seeds.rb
+- spec/stub_rails/test/performance/browsing_test.rb
+- spec/stub_rails/test/test_helper.rb
+- spec/support/stub_helpers.rb