passive_record

Description

PassiveRecord is an extremely lightweight in-memory pseudo-relational algebra.

We implement a simplified subset of AR's interface in pure Ruby.

Why?

Do you need to track objects by ID and look them up again, or look them up based on attributes, or even utilize some relational semantics, but have no real need for persistence?

PassiveRecord may be right for you!

Features

Build relationships with belongs_to, has_one and has_many
Query on attributes and associations
Supports many-to-many and self-referential relationships
No database required!
Just include PassiveRecord to activate a PORO in the system

Examples

    require 'passive_record'

    class Model
      include PassiveRecord
    end

    class Dog < Model
      belongs_to :child
    end

    class Child < Model
      has_one :dog
      belongs_to :parent
    end

    class Parent < Model
      has_many :children
      has_many :dogs, :through => :children
    end

    # Let's create some models!
    parent = Parent.create
    => Parent (id: 1)

    child = parent.create_child
    => Child (id: 1)

    dog = child.create_dog
    => Dog (id: 1)

    # inverse relationships
    dog.child
    => Child (id: 1)

    Dog.find_by child: child
    => Dog (id: 1)

    # has many thru
    parent.dogs
    => [Dog (id: 1)]

    # nested queries
    Dog.find_all_by(child: { parent: parent })
    => [Dog (id: 1)]

Requirements

Install

$ gem install passive_record

Synopsis

$ passive_record

Copyright

See LICENSE for details.