Introduction ¶ ↑

Know how you can’t just use ‘form_for’ in rails with a newly initialized ActiveResource object? Ever get annoyed at having to add default attributes to your newly initialized ActiveResource objects? Fortify gives you the power to DRY’ly define default attributes for your ActiveResource derived classes.

Motivation¶ ↑

Let’s suppose you’re going to create a form for creating Books. However, your Book is an ActiveResource::Base derived class:

# app/models/book.rb
class Book < ActiveResource::Base
end

# app/controllers/books_controller.rb
class BooksController < ActiveResource::Base
  def new
    @book = Book.new
  end
end

# app/view/books/new.haml
- form_for @book do |f|
  .field
    = f.label :title
    = f.text_field :title

  .field
    = f.label :author
    = f.text_field :author

  .field
    = f.label :genre
    = f.text_field :genre

This, of course fails. Why? When you create a new Book object, unlike ActiveRecord (which has the luxury of querying the database to determine the object’s attributes), ActiveResource starts off as a blank slate. In other words:

console> b = Book.new
console> b.attributes.inspect
  ==> {}

To get this to work, you would have to give your new Book object some default attributes:

# app/controllers/books_controller.rb
class BooksController < ActiveResource::Base
  def new
    @book = Book.new :title => nil, :author => nil, :genre => nil
  end
end

As you can imagine, this approach might not be very DRY. This is where fortify steps in.

Usage¶ ↑

First, install fortify by adding the following line to your config/environment.rb and then running “sudo rake gems:install”:

config.gem :fortify, :lib => 'fortify', :source => 'http://gemcutter.org'

Next, go back to your book model and add some fortification to it. You can do this in one of three ways. Let’s first assume that we just want to make sure the Book model has “author”, “title”, and “genre” attributes.

# app/models/book.rb
class Book < ActiveResource::Base
  self.site = ''
  fortify :author, :title, :genre
end

Now, your controller / views as you originally specified them will work, since now:

console> b = Book.new
console> b.attributes.inspect
  ==> {:author => nil, :title => nil, :genre => nil}

What if, however, we wanted default values for each of those attributes?

# app/models/book.rb
class Book < ActiveResource::Base
  self.site = ''
  fortify :author => 'Anonymous', :genre => 'Unknown', :title => 'Untitled'
end

In this case, a Book.new would give you:

console> b = Book.new
console> b.attributes.inspect
  ==> {:author => 'Anonymous', :title => 'Untitled', :genre => 'Unknown'}

Lastly, what if we only wanted a default value for the :author attribute? Try this:

# app/models/book.rb
class Book < ActiveResource::Base
  self.site = ''
  fortify do |attrs|
    attrs.author = 'Anonymous'
    attrs.title
    attrs.genre
  end
end

Console would report something like this:

console> b = Book.new
console> b.attributes.inspect
  ==> {:author => 'Anonymous', :title => nil, :genre => nil}