Ramaze - The Underrated Ruby Web Framework

The Underrated Web Framework

underrated: Not given enough recognition for its quality

Motivation

What's your experience with Ramaze?

a) Never heard of it

b) Noob

c) Expert

Getting Started

Simple Light Modular

sudo gem install ramaze

http://github.com/manveru/ramaze

Features

M V C

KISS

Light

You can write an application in one file.

Modular

Only one dependency

ORM-agnostic

Templating Engines:

Ezamar

Erubis

Haml

Liquid

Markaby

Maruku

Nagoro

Redcloth

Sass

Tagz

Tenjin

XSLT

Amrita

Builder

Remarkably

Stable

...started more than 2 years ago.

Well Documented

Beautiful Code

BDD

Ruby 1.9

Most bugs fixed in 48 hours.

IRC Population

Basics

Controllers

MainController maps to '/'

BlueController maps to '/blue'

...unless you use map

_ .

Action methods accept arguments via URL

http://localhost:7000/archive? page=2 request[:page] == '2'

Errors redirect to error action

Routing (String Routers) Ramaze::Route [ '/foo' ] = '/bar' # '/foo' => '/bar'

Routing (Regex Routers) Ramaze::Route [ %r!^/(d+).txt$! ] = "/text/%d" # '/123.txt' => '/text/123'

Routing Ramaze::Route [ 'name of route' ] = lambda { |path, request| '/bar' if path == '/foo' and request[ :bar ] == '1' } (Lambda Routers) # '/foo' => '/foo' # '/foo?bar=1' => '/bar'

Testing

Views

Ezamar Erubis (bundled) (default) (my favorite) (plenty of other choices)

inline vs. external

START NO YES Run return value of action through templating engine Send to browser External Template Is there an external template?

Instance variables set in the action can be accessed in template (just like in Rails)

(convention) /view

(configuration) view_root 'my_templates'

Layouts

# apply to all actions except index layout :layout deny_layout :index # apply only to index layout :layout => [ :index ] Layouts

Ezamar Very simple reimplementation of the Templating-engine found in Nitro. <?r rubycode ?> == <% rubycode %> #{ rubycode } == <%= rubycode %>

Ezamar::Element

Models

That's up to you to figure out...

ActiveRecord DataMapper Sequel Og DBI

Ramaze::Store

Helpers

Default Helpers

CGI

File

Link

Redirect

Session/Flash

Optional Helpers

Aspect

Auth

Cache

Identity (OpenID)

Pager

Form

Partial

Captcha

etc...

Custom Helpers

Link Helper R(AdminController, :index) => /admin/index Rs(:index) => /admin/index Rs(:/) => / A('text') => <a href=”/text”>text</a> A('foo/bar') => <a href=”/foo/bar”>foo/bar</a> A('Home', :href => Rs(:/)) => <a href=”/”>Home</a>

Aspect Helper Allows you to wrap different Actions on your Controller with code.

Extras

Deployment