Inheritor

• rubyworks.github.com/inheritor
• github.com/rubyworks/inheritor

DESCRIPTION

Inheritor provides a means to store and inherit data along the class heirarchy. An inheritor creates two methods, one named after for the key that provides a reader, and one named key! which provides the writer. Because of the unique nature of Inheritor, the reader cannot be used to modify the underlying store b/c it is a calculated attribute, thus any modifications to the result would not be passed on to the descendents.

The most notable feature of Inheritor is that it is dynamic. Unlike other solutions, such as ActiveSupport’s class_inheritable_accessor, Inheritor dynamically generates the inherited value whenever the reader is called, as opposed to copying the parents variable value upon class creation or some other specific trigger.

FEATURES/ISSUES

• Create inheritable attributes.
• Works with modules, providing module method inheritance.
• Easily handles any data and inheritance type.

RELEASE NOTES

Please see HISTORY file.

SYNOPSIS

To create an inheritable class variable provide the inheritor method with the name of the variable, it’s initial value, and the methdod to be used to process inheritence from descendent to descendent.

   class X
     inheritor :foo, [], :+
   end

   class Y < X
   end

   X.x! << :a
   X.x => [:a]
   Y.x => [:a]

   Y.x! << :b
   X.x => [:a]
   Y.x => [:a, :b]

HOW TO INSTALL

To install with RubyGems simply open a console and type:

  gem install inheritor

Local installation requires Setup.rb (gem install setup), then download the tarball package and type:

  tar -xvzf inheritor-1.0.0.tgz
  cd inheritor-1.0.0
  sudo setup.rb all

Windows users use ‘ruby setup.rb all’.

COPYING

(MIT License)

Copyright © 2004 Thomas Sawyer

This program is ditributed unser the terms of the MIT license.

See LICENSE or COPYING file for details.