Installation
============
 
Instructions for installation:
 
file: config/init.rb
 
# add the slice as a regular dependency
 
dependency 'merb_mart'
 
# if needed, configure which slices to load and in which order
 
Merb::Plugins.config[:merb_slices] = { :queue => ["MerbMart", ...] }
 
# optionally configure the plugins in a before_app_loads callback
 
Merb::BootLoader.before_app_loads do
  
  Merb::Slices::config[:merb_E_mart] = { ... }
  
end
 
file: config/router.rb
 
# example: /merb_mart/:controller/:action/:id
 
r.add_slice(:MerbMart)
 
# example: /foo/:controller/:action/:id
 
r.add_slice(:MerbMart, 'foo') # same as :path => 'foo'
 
# example: /:lang/:controller/:action/:id (with :a param set)
 
r.add_slice(:MerbMart, :path => ':lang', :params => { :a => 'b' })
 
# example: /:controller/:action/:id
 
r.slice(:MerbMart)
 
Normally you should also run the following rake task:
 
rake slices:merb_E_mart:install
 
------------------------------------------------------------------------------
 
You can put your application-level overrides in:
 
host-app/slices/merb_mart/app - controllers, models, views ...
 
Templates are located in this order:
 
1. host-app/slices/merb_mart/app/views/*
2. gems/merb_mart/app/views/*
3. host-app/app/views/*
 
You can use the host application's layout by configuring the
merb_mart slice in a before_app_loads block:
 
Merb::Slices.config[:merb_E_mart] = { :layout => :application }
 
By default :merb_E_mart is used. If you need to override
stylesheets or javascripts, just specify your own files in your layout
instead/in addition to the ones supplied (if any) in 
host-app/public/slices/merb_mart.
 
In any case don't edit those files directly as they may be clobbered any time
rake merb_E_mart:install is run.
 
Dependencies
------------
 
MerbMart master branch is being built on the cutting-edge Merb framework, and
the bleeding edge DataMapper framework. As such, you'll have to get yourself 
setup with those gems before you get the chance to play with MerbMart.
 
Dependencies for MerbMart:
 
 * **DataMapper 0.9** - 'edge' development
    * *DataObjects*
        * `git clone git://github.com/sam/do.git`
        * `cd data_objects && rake gem && sudo gem install pkg/data_objects-0.9.0.gem`
        * install the relevant driver for your database
    * *dm-core* 
        * `git clone git://github.com/sam/dm-core.git`
    * *dm-more* 
        * `git clone git://github.com/sam/dm-more.git`
        * *dm-aggregates*
        * *dm-is-tree*
        * *dm-migrations*
        * *dm-timestamps*
        * *dm-types*
        * *dm-validations*
        * *merb\_datamapper*  
        (NOTE: do not use the *merb\_datamapper* included in the 0.9.2 distribution of
         *merb_plugins*, as it was designed for DataMapper 0.3 series)
 * **Merb 0.9.3** (or above)
    * *merb-core*           : `sudo gem install merb-core`
    * *merb-more*           : `sudo gem install merb-more`
    * *merb\_plugins*
        * *merb\_helpers*   : `sudo gem install merb_helpers`
        * *merb\_stories*  
        (NOTE:> 0.9.3 required. Install from merb\_plugins source.
        See merb-plugins issue 
        [106](http://merb.lighthouseapp.com/projects/7588/tickets/106-merb_stories-require-old-rspec-plugin) )
    
Running Specs
-------------
 
To run all specs:
 
    rake spec
 
You can also run individual groups of specs. To see tasks available to you:
 
    rake -T