ActiveMapper
ActiveMapper is a data-mapper using ActiveRecord/Arel as a backend. It allows you to create models using PORO and comes with a Memory adapter which you can use during testing to make your tests faster and not reliant on a database. The only requirements are that your models have an id attribute (auto-incrementing int) and respond to a valid? and .model_name ( ActiveSupport::Name). These can easily be injected into your models by including ActiveModel::Model.
Installation
Add this line to your application's Gemfile:
gem 'active_mapper'
And then execute:
$ bundle
Or install it yourself as:
$ gem install active_mapper
Usage
class Post
include ActiveModel::Model
attr_accessor :id, :title, :content, :status, :created_at, :updated_at
def persisted?
id
end
end
post = Post.new(title: 'Post', content: 'My First Post')
# ActiveMapper[Class] will automatically create and wire up the mapper
# if it does not exist. The only requirement is that the table exists
# with the proper columns (e.g. use ActiveRecord migrations).
ActiveMapper[Post].save(post)
record = ActiveMapper[Post].find(post.id)
Querying
mapper = ActiveMapper[Post]
# some methods return an ActiveMapper::Relation which will not execute
# any queries until #to_a, #each or #map are called.
mapper.select { |post| post.title.starts_with('Post') }
mapper.reject { |post| post.status == 'draft' }
# some methods actually execute the query immediately
mapper.first { |post| !(post.status == 'draft') }
mapper.last { |post| (post.status == 'published') & (post.created_at > 5.days.ago) }
mapper.all { |post| (post.content.contains('monkey')) & (post.status == 'published) }
Contributing
- Fork it ( http://github.com//active_mapper/fork )
- 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