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+
  version_agnostic_scope :active, { where active: true } # relies on fake_arel in Rails 2 to provide 3+ Query Interface

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

Contributing

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