Merb Wiki howto

Merb Authentication

2010-02-14T07:06:30-07:00

Merb Authentication MerbAuth examples: * Authenticated Hello World * Example app showing how to test an authenticated route * Example of how to set up authentication with couchdb and couchrest

howto:cache

2008-11-24T15:23:30-07:00

Cookies!

2008-11-14T01:53:21-07:00

There may come a point in your life when you want to start putting aside a few cookies now and then for times of need. Unless you interpret “cookies” as a metaphor for money, Merb can help you! Handling cookies in Merb is super easy; however, there's a simple method and a more comprehensive method for doing so. Fear not, they're explained in their entirety here.

CRUD view examples

2008-12-08T10:26:58-07:00

CRUD view examples CRUD stands for Create Read Update Delete. Often, web developers decide to follow this principle and create a few views matching the following actions: * New (to collect the data to create) * Create (to actually create an object, no views required: if the creation worked, the user gets redirected, otherwise the new action gets re-rendered)

Database Support HOWTOs

2008-10-18T10:07:19-07:00

* Selecting an ORM DataMapper Howtos Howtos specific to DataMapper. * Migrations CouchDB CouchDB is a document oriented database that doesn’t impose the constraints of schemas and fixed size fields on your data. It's a natural fit for semi-structured data, and hence, many web apps.

Debugging HowTos

2008-10-21T09:29:45-07:00

Getting Started Merb uses ruby-debug (“rdebug”). Odds are good you have it installed already, but if not... > gem install ruby-debug To launch merb with ruby-debug enabled add the ”-D” flag: > merb -D Hint: If you spend more than a couple minutes using rdebug, you'll want to set up a ~/.rdebugrc file that looks something like this :

Dependencies - Require but Awesome

2008-11-29T00:09:49-07:00

If you are requiring a gem that is named differently than the name of the library (like from a Github account) then you need to pass the correct name into require_as: dependency("notch8-webrat", :require_as => 'webrat') dependency 'rest-client', :require_as => 'rest_client'

Deployment HOWTOs

2008-12-20T10:26:52-07:00

* Bundling a Merb application * Deploying a Merb application * Deploying on JRuby * Deploying with Passenger * Deploying with HAProxy * Merb on Slicehost: * Part 1: Users and Permissions * Part 2: Install Software * Part 3: Version and Deploy

Application Development HOWTOs

2008-11-14T07:57:45-07:00

* Generating a new Merb app * CRUD view examples * Merb Router * Sending emails from a Merb app * Handling Exceptions * Quickstart for Rails Users * Serving static content * Use the resource url helpers * Rails-style "flash" messages

Installation HOWTOs

2008-11-22T14:50:52-07:00

* Installing Merb from gems (recommended) * Installing Merb from edge Do I want gems or edge? “edge” is what most people refer to as “trunk” in the svn world. It represents the cutting edge of the source. As such, most people don't actually need it.

Mailers

2010-04-08T12:11:31-07:00

A plugin for the Merb framework that allows you to send email from Merb application. It separates email composition and sending into micro MVC: you may have mail controllers that compose complex emails, emails have their own views and models (models use MailFactory library and are non-persistable).

Models in Merb

2008-11-27T20:51:05-07:00

Datamapper You can find a quick overview of DataMapper features below, but you should check out the DataMapper documentation for more in-depth information. Properties When defining a model in Datamapper you specify the properties in the model file. This is handy when you want to see what the column was that has all of your headline content in it. The basic syntax is this...

What is the Model-View-Controller architectural pattern?

2008-11-22T19:33:46-07:00

The MVC architectural pattern is the notion of abstracting your application into three layers: * The View layer presents the data to the user. This is the only layer that actually generates markup that is outputted to the user's browser. In Merb, you have two options for templating engines: eRuby and Haml. Which you choose depends on personal preference and application. * The Model layer embodies objects that the user is interacting with. Posts, Articles, even Users (in authentication) …

Parts

2009-01-29T15:38:27-07:00

Parts in merb are just like small controllers that you can use to perform logic. One very good usage for them is when you want add a “widget” to a view, that has its own logic. We'll look at an example on how to make a part that, displays the news titles.

About Merb Plugins

2008-11-14T17:09:25-07:00

About Merb Plugins Merb plugins are distributed as gems, which makes for easy versioning and management. Your merb plugin gems can be installed either on a per-application basis, or for an entire system. The following sections will outline how to get started with plugins.

Intro

2009-01-20T11:52:22-07:00

Have a request for a HowTo that's not up yet? Create a link to the non-existent HowTo on the main wiki page and add your request below. If the HowTo you want is already on this page, feel free to add a * after it to ”+1” it. * Example HowTo Request *

The Router

2009-01-31T03:37:24-07:00

All routes are defined in the “router.rb” file which is in your config directory. The router uses restful routing which makes several helper urls for common operations. General Matcher To attach a path to a specific action/controller pair you use the match.to methods

Delete action view example with jquery confirmation

2009-04-07T16:40:07-07:00

Delete action view example with jquery confirmation This should really be the destroy action. Delete action is more like new and edit action. So should be more like the following down below: def delete(id) only_provides :html @article = Article.get(id) raise NotFound unless @article display @article end def destroy(id) @article = Article.get(id) raise NotFound unless @article if @article.destroy redirect resource(:articles) else raise Inte…

howto:simple_edit_form

2008-11-02T16:21:44-07:00

Note how the form helper ends by <% end =%> You might get in trouble if you miss that.

Article controller, edit action

<%= form_for(@article, :action => resource(@article)) do %>

<%= text_field :title, :label => "Title" %>

<%= text_field :author, :label => "Author" %>

<%= submit "Update" %>

<% end =%> <%= link_to 'Show', resource(@article) %> | <%= link_to 'Back', resource(:articles) %>

Index action view example

2008-10-19T20:50:06-07:00

Index action view example

Article controller, index action

<% @articles.each do |article| %> <% end %>

Title	Author	Actions
<%=h article.title %>	<%=h article.author %>	<%= link_to 'Show', resource(article) %>	<%= link_to 'Edit', resource(article, :edit) %>	<%= delete_button(article, "Delete #{article.title}") %>

<%= li…

New action view example

2009-01-11T10:24:49-07:00

New action view example

Article controller, new action

<%= form_for(@article, :action => resource(:articles) ) do %>

<%= text_field :title, :label => "Title " %>

<%= text_field :content, :label => "Content " %>

<%= submit "Create" %>

<% end =%> <%= link_to 'Back', resource(:articles) %>

Show action view example

2008-10-28T00:46:44-07:00

Show action view example

Article controller, show action

<%=h @article.title %>

by: <%=h @article.author %>

<%=h @article.body %>

<%= link_to 'Back', resource(:articles) %>

How to Quickstart Merb Slice Development

2009-02-09T05:32:33-07:00

What are Merb Slices? Merb Slices are a kind of mini Merb Application that can be packaged up as gems and used as is (or with customizations) within actual Merb Applications. They are full Model-View-Controller stacks to support a large feature within a larger application. Examples could be a full blogging system, user management system or a file upload system.

howto:start

2008-10-10T22:58:04-07:00

Testing HOWTOs

2008-11-27T18:54:33-07:00

* Testing the full stack with request specs * Testing a Merb app with Rspec * Testing transactional specs with DataMapper * View matchers * Using Cucumber/Webrat with Merb * Tips & Tricks * DataMapper

Troubleshooting HOWTOs

2008-10-10T22:59:50-07:00

* Common Exceptions

Using Cucumber/Webrat with Merb

2009-02-05T18:25:04-07:00

Guide on getting up and running with Cucumber + Webrat on Merb: * attach_file support in Webrat for Merb can be found in the auxesis-webrat gem: *

Notes on Very Flat Apps:

2009-01-14T01:16:16-07:00

* to have the app reload itself while in development mode, add this to your file: Merb.push_path(:application, __FILE__) * to have the app reload itself only when the file is modified, try this: Merb.push_path(:lib, File.dirname(__FILE__), File.basename(__FILE__))