Merb plugin that provides support for using datamapper within a merb application
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 27 commits behind merb:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


= 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