orm_adapter ruby Rubygems

I spiked out a Ripple (Riak) adaptor for a side project. Cut/pasted it into this project.

6 years after

= ORM Adapter

Provides a single point of entry for popular ruby ORMs. Its target audience is gem authors who want to support more than one ORM.

== Example of use

require 'orm_adapter'

User # is it an ActiveRecord, DM Resource, MongoMapper or MongoId Document?

User.to_adapter.find_first :name => 'Fred' # we don't care!

user_model = User.to_adapter user_model.get!(1) # find a record by id user_model.find_first(:name => 'fred') # find first fred user_model.find_all(:name => 'fred') # find all freds user_model.find_all(:order => :name) # find all freds, ordered by name user_model.create!(:name => 'fred') # create a fred

@see OrmAdapter::Base for more details of the supported API

== Supported ORMs

Currently supported ORMs are ActiveRecord, DataMapper, MongoMapper, and MongoId.

We welcome you to write new adapters as gems. ORM Adapter will stay focused in having these major ORMs working.

To write an adapter look at lib/orm_adapter/adapters/active_record.rb for an example of implementation. To see how to test it, look at spec/orm_adapter/example_app_shared.rb, spec/orm_adapter/adapters/active_record_spec.rb. You'll need to require the target ORM in spec/spec_helper.rb

== Goals

ORM Adapter goal is to support a minimum API used by most of the plugins that needs agnosticism beyond Active Model.

ORM Adapter will support only basic methods, as +get+, +find_first+, create! and so forth. It is not ORM Adapter's goal to support different query constructions, handle table joins, etc.

If you need complex queries, we recommend you to subclass ORM Adapters in your plugin and extend it expressing these query conditions as part of your domain logic.

== Projects using orm_adapter

Get in touch if you want your project added to this list

== History

orm_adapter is an extraction from {pickle}[http://github.com/ianwhite/pickle] by {Ian White}[http://github.com/ianwhite]. Pickle's orm adapter included work by {Daniel Neighman}[http://github.com/hassox], {Josh Bassett}[http://github.com/nullobject], {Marc Lee}[http://github.com/maleko], and {Sebastian Zuchmanski}[http://github.com/sebcioz].

{José Valim}[http://github.com/josevalim] suggested the extraction, and worked on the first release with Ian.

{Luke Cunningham}[http://github.com/icaruswings] contributes the Mongo Mapper adapter.

== Development

To run the specs, you can start from the last known good set of gem dependencies in Gemfile.lock.development:

git clone http://github.com/ianwhite/orm_adapter cd orm_adapter cp Gemfile.lock.development Gemfile.lock bundle bundle exec rake spec

== Copyright

Copyright (c) 2010-2011 Ian White and José Valim. See LICENSE for details.

Related Repositories

devise-basecamper

devise-basecamper

Add basecamp style subdomain authentication to devise. ...

sequel-devise

sequel-devise

Devise support for Sequel models ...

padrino-orm_adapter

padrino-orm_adapter

Provides a single point of entry for ORMs supported by Padrino. ...

async-messaging

async-messaging

User Messaging Async calls, compatible with Mongoid (Ruby on Rails) gem ...

orm_adapter_aws

orm_adapter_aws

Adapters for using orm_adapter with AWS services. ...


Top Contributors

ianwhite josevalim samsm icaruswings jldbasa

Releases

-   v0.0.3 zip tar
-   v0.0.2 zip tar
-   v0.0.1 zip tar