Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Merb plugin that provides support for using datamapper within a merb application

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

= merb_datamapper

A plugin for the Merb framework that provides DataMapper access

== Features

* Automatic connection to a data-store through DataMapper, via database.yml
* Easy use of multiple repositories.
* Generators for models, controllers and migrations.
* Sessions stored in a data-store managed by DataMapper
* wraps actions in DataMapper repository blocks, to enable the IdentityMap

=== Sessions

To use sessions:

1. set the session store to datamapper in init.rb:
    Merb::Config.use { |c|
      c[:session_store] = 'datamapper'

2. add the dependency in init.rb:
    use_orm :datamapper

Sessions can be configured by a few plugin options:

[:session_storage_name] The name of the table to use to store the sessions (defaults to 'session')
[:session_repository_name] The repository to use for sessions. (defaults to <tt>:default</tt>)

=== Repository Blocks

Repository Blocks are a DataMapper feature, which enables the use of the
DataMapper IdentityMap, which can help with certain DataMapper features such as
strategic eager loading.  Read on for more information
on these features.

If, for whatever reason, it doesn't suit you, it can be disabled via setting the
<tt>:use_reposity_block</tt> option to <tt>false</tt>.

    Merb::Plugins[:merb_datamapper][:use_reposity_block] = false

=== Now Compatible with DM > 1.0.1
Something went wrong with that request. Please try again.