API DSL

gistfile1.rb

# places/index.api
@places.each do |place|
  template('places/show', :place => place)               # user shall be available as @user in the template
end

# places/show.api
object(@place) do
  :name,                                                 # plain attribute
  :address => address_for(@user),                        # helper used
  :location => {                                         # hash
    :lat => 52.0,
    :lng => 10.0
  },
  :category => :place_type,                              # renaming/mapping (@place.place_type exists)
  :links => [
    {rel => 'self', :href => 'http://...'},
    {rel => 'full', :href => 'http://...'}
  ],
  :host => template('users/show', :user => @place.host)  # child_object
end

# users/show.api
...