ActiveAttr

Build History

ActiveAttr makes it easy to create plain old ruby models without reinventing the wheel.

API Documentation

Modules

Attributes

Including the Attributes module into your class gives you a DSL for defining the attributes of your model.

class Person
  include ActiveAttr::Attributes

  attribute :first_name
  attribute :last_name
end

p = Person.new
p.first_name = "Chris"
p.last_name = "Griego"
p.attributes #=> {"first_name"=>"Chris", "last_name"=>"Griego"}

BasicModel

Including the BasicModel module into your class gives you the bare minimum required for your model to meet the ActiveModel API requirements.

class Person
  include ActiveAttr::BasicModel
end

Person.model_name.plural #=> "people"
p = Person.new
p.valid? #=> true
p.errors.full_messages #=> []

MassAssignment

Including the MassAssignment module into your class gives you methods for bulk initializing and updating the attributes of your model. Any unknown attributes are silently ignored unless you substitute the StrictMassAssignment module which will raise an exception if an attempt is made to assign an unknown attribute.

class Person
  include ActiveAttr::MassAssignment
  attr_accessor :first_name, :last_name
end

p = Person.new(:first_name => "Chris")
p.attributes = { :last_name => "Griego" }
p.first_name #=> "Chris"
p.last_name #=> "Griego"

RSpec Integration

ActiveAttr comes with matchers and RSpec integration to assist you in testing your models.

require "active_attr/rspec"

describe Person do
  it { should have_attribute(:first_name) }
end