annotate_model, gem útil da semana
Trabalhar com Rails é certeza de encontrar ótimo material para trabalhar/documentar sua aplicação. Tenho uma lista de plugins/gems úteis para o desenvolvimento, o que daria um enorme post. Seguindo os conceitos do Getting Real, rapidinho vou postando (é muito material).
O primeiro da lista é o annotate_model, um gem que gera para cada model as informações da estrutura da tabela daquela entidade. Por exemplo:
# == Schema Information
# Schema version: 20080628203259
#
# Table name: comments
#
# id :integer(11) not null, primary key
# name :string(255)
# email :string(255)
# body :text
# code_id :integer(11)
# created_at :datetime
# updated_at :datetime
#
class Comment < ActiveRecord::Base
# ...
end
Uma forma de se conhecer os atributos de uma entidade é, a partir do script/console, digitar: Model.new.attributes
, entretanto com o gem, o conhecimento dessas informações fica bem mais fácil. Após instalada (sudo gem install annotate-models), bastar executar o comando annotate na pasta do seu aplicativo. Simples, rápido e quebra um galhão.