RailsAgnosticModels

The purpose of this project is to ease the pain of upgrading Rails versions by abstracting away differences between the Rails 2.3 and 3.2 API.

Wait, if I'm gonna update my code, why don't I just update to Rails 3 or 4 instead of this crap?

If your codebase is small enough to do that in one go, please, by all means.

However if you have a large legacy code base that you simply can't update all at once, this gem will (eventually) enable you to do small incremental changes and eventually make the jump without crashing and burning quite as bad.

Installation

Add this line to your application's Gemfile:

gem 'rails_agnostic_models'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rails_agnostic_models

Usage

class MyModel < ActiveRecord::Base
  # Manage flat_out incompatible code with Rails Edition Specific Blocks
  rails_2 { acts_as_audited }
  rails_3 { audited }

  # scoping, named_scope in Rails 2, scope in Rails 3+
  # We recommend using FakeArel in Rails 2 projects to get a universal query interface, but it is not required
  version_agnostic_scope :active, { where active: true }

  # single table inheritance, set_inheritance_column in rails 2, self.inheritance_column= in Rails 3+
  version_agnostic_inheritance_column "type_inheritance"

  # sends the options hash onto default_scope in Rails 2
  # translates to an arel method chain in Rails 3+
  # Currenlty only :order and :conditions are supported
  version_agnostic_default_scope(:order => "created_at DESC", :conditions => {:active => true})
end

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request