attributes1 5.0.2

data/README

@@ -0,0 +1,331 @@
+NAME
+  attributes.rb
+
+INSTALL
+  gem install attributes
+
+URIS
+  http://codeforpeople.com/lib/ruby
+  http://rubyforge.org/projects/codeforpeople/
+  http://codeforpeople.rubyforge.org/svn/
+
+SYNOPSIS
+  attributes.rb provides a set of attr_* like method with several user
+  friendly additions.  attributes.rb is similar to the traits.rb package but
+  sacrifices a few features for simplicity of implementation.
+
+  the implementation of attributes.rb borrows many of the best ideas from the
+  metakoans.rb ruby quiz
+
+    http://www.rubyquiz.com/quiz67.html
+
+  in particular the solutions of Christian Neukirchen and Florian Gross along
+  with concepts from the original traits lib
+
+  key features provided by attributes are
+
+    - ability to specify default values for attrs and definition time.  values
+      can be literal objects or blocks, which are evaluated in the context of
+      self to initialize the variable
+
+    - classes remember which attributes they've defined and this information is
+     available to client code
+
+    - a whole suite of methods is defined by calls to #attributes including
+     getter, setter, query (var?) and banger (var! - which forces
+     re-initialization from the default value)
+
+    - ability to define multiple attributes at once using key => value pairs
+
+    - fast lookup of whether or not a class has defined a certain attribute
+
+    - attributes can be defined on objects on a per singleton basis as well
+
+    - getters acts as setters if an argument is given to them
+
+    - block caching, calling an attribute with a block sets the instance
+      variable to that block
+
+  all this in < 100 lines of code
+
+HISTORY
+  5.0.1
+    - removed wrong dep on pervasives from gemspec.rb
+
+  5.0.0
+    - added support for block caching. for example
+
+        - simple block caching:
+
+            class Filter 
+              attribute :process
+            end
+
+            filter = Filter.new
+
+            filter.process{|line| line.upcase}
+
+            lines.each do |line|
+              p filter.process.call(line)
+            end
+
+        - using block caching to delay block evaluation/class-factory:
+
+            module MigrationDSL
+              attribute :migration
+
+              def migration_class
+                model = self
+
+                Class.new(::ActiveRecord::Migration) do
+                  singleton_class =
+                    class << self
+                      self
+                    end
+                  singleton_class.module_eval{ attribute :model => model }
+                  singleton_class.module_eval &model.migration
+                end
+              end
+            end
+
+            class Table < ActiveRecord::Base
+              extend MigrationDSL
+            end
+
+            class Jobs < Table
+              migration do
+                def up
+                  create_table model.table_name, :primary_key => model.primary_key do |t|
+                    t.column 'vinyl_shoes', :text
+                  end
+                end
+
+                def down
+                  create_table model.table_name
+                end
+              end
+            end
+
+            ...
+
+            JobsMigration = Jobs.migration_class
+
+  4.1.0
+    - 4.0.0 introduced a bug where a query (foo?) would not initialize a var -
+      4.1.0 fixes that
+
+  4.0.0
+    - removed dependancy on, and bundle of, pervasives
+    - faster.  as fast as normal method definition.
+    - faster lookup for MyClass.attributes.include?('foobar')
+
+  3.7.0
+    small patch to use 'instance_variable_defined?' instead of defined?
+    keyword
+  
+  3.5.0
+    migrated to a pervasives based impl to attributes should work on any
+    object - even blankslate objects
+
+  3.3.0
+
+    moved to an instance variable-less model using an module level closure for
+    the attributes list
+
+SAMPLES
+
+  <========< samples/a.rb >========>
+
+  ~ > cat samples/a.rb
+
+    #
+    # basic usage is like attr, but note that attribute defines a suite of methods
+    #
+      require 'attributes'
+    
+      class C
+        attribute 'a'
+      end
+    
+      c = C.new
+    
+      c.a = 42
+      p c.a                 #=> 42
+      p 'forty-two' if c.a? #=> 'forty-two'
+    
+    #
+    # attributes works on object too 
+    #
+      o = Object.new
+      o.attribute 'answer' => 42
+      p o.answer           #=> 42
+
+  ~ > ruby samples/a.rb
+
+    42
+    "forty-two"
+    42
+
+
+  <========< samples/b.rb >========>
+
+  ~ > cat samples/b.rb
+
+    #
+    # default values may be given either directly or as a block which will be
+    # evaluated in the context of self.  in both cases (value or block) the
+    # default is set only once and only if needed - it's a lazy evaluation.  the
+    # 'banger' method can be used to re-initialize a variable at any point whether
+    # or not it's already been initialized.
+    #
+      require 'attributes'
+    
+      class C
+        attribute :a => 42
+        attribute(:b){ Float a }
+      end
+    
+      c = C.new
+      p c.a #=> 42
+      p c.b #=> 42.0
+    
+      c.a = 43
+      p c.a #=> 43
+      c.a!
+      p c.a #=> 42
+
+  ~ > ruby samples/b.rb
+
+    42
+    42.0
+    43
+    42
+
+
+  <========< samples/c.rb >========>
+
+  ~ > cat samples/c.rb
+
+    #
+    # multiple values may by given, plain names and key/val pairs may be mixed.
+    #
+      require 'attributes'
+    
+      class C
+        attributes 'x', 'y' => 0b101000, 'z' => 0b10
+      end
+    
+      c = C.new
+      c.x = c.y + c.z
+      p c.x #=> 42
+
+  ~ > ruby samples/c.rb
+
+    42
+
+
+  <========< samples/d.rb >========>
+
+  ~ > cat samples/d.rb
+
+    #
+    # a nice feature is that all attributes are enumerated in the class.  this,
+    # combined with the fact that the getter method is defined so as to delegate
+    # to the setter when an argument is given, means bulk initialization and/or
+    # attribute traversal is very easy.
+    #
+      require 'attributes'
+    
+      class C
+        attributes %w( x y z )
+    
+        def attributes
+          self.class.attributes
+        end
+    
+        def initialize
+          attributes.each_with_index{|a,i| send a, i}
+        end
+    
+        def to_hash
+          attributes.inject({}){|h,a| h.update a => send(a)}
+        end
+    
+        def inspect
+          to_hash.inspect
+        end
+      end
+    
+      c = C.new
+      p c.attributes 
+      p c 
+    
+      c.x 'forty-two' 
+      p c.x
+
+  ~ > ruby samples/d.rb
+
+    ["x", "y", "z"]
+    {"x"=>0, "y"=>1, "z"=>2}
+    "forty-two"
+
+
+  <========< samples/e.rb >========>
+
+  ~ > cat samples/e.rb
+
+    #
+    # my favourite element of attributes is that getters can also be setters.
+    # this allows incredibly clean looking code like
+    #
+      require 'attributes'
+    
+      class Config
+        attributes %w( host port)
+        def initialize(&block) instance_eval &block end
+      end
+    
+      conf = Config.new{
+        host 'codeforpeople.org'
+    
+        port 80
+      }
+    
+      p conf
+
+  ~ > ruby samples/e.rb
+
+    #<Config:0x1fb58 @port=80, @host="codeforpeople.org">
+
+
+  <========< samples/f.rb >========>
+
+  ~ > cat samples/f.rb
+
+    #
+    # of course attributes works as well at class/module level as at instance
+    # level
+    #
+      require 'attributes'
+    
+      module Logging 
+        Level_names = {
+          0 => 'INFO',
+          # ...
+          42 => 'DEBUG',
+        }
+    
+        class << self
+          attribute 'level' => 42
+          attribute('level_name'){ Level_names[level] }
+        end
+      end
+    
+    p Logging.level
+    p Logging.level_name
+
+  ~ > ruby samples/f.rb
+
+    42
+    "DEBUG"
+

data/README.tmpl

@@ -0,0 +1,133 @@
+NAME
+  attributes.rb
+
+INSTALL
+  gem install attributes
+
+URIS
+  http://codeforpeople.com/lib/ruby
+  http://rubyforge.org/projects/codeforpeople/
+  http://codeforpeople.rubyforge.org/svn/
+
+SYNOPSIS
+  attributes.rb provides a set of attr_* like method with several user
+  friendly additions.  attributes.rb is similar to the traits.rb package but
+  sacrifices a few features for simplicity of implementation.
+
+  the implementation of attributes.rb borrows many of the best ideas from the
+  metakoans.rb ruby quiz
+
+    http://www.rubyquiz.com/quiz67.html
+
+  in particular the solutions of Christian Neukirchen and Florian Gross along
+  with concepts from the original traits lib
+
+  key features provided by attributes are
+
+    - ability to specify default values for attrs and definition time.  values
+      can be literal objects or blocks, which are evaluated in the context of
+      self to initialize the variable
+
+    - classes remember which attributes they've defined and this information is
+     available to client code
+
+    - a whole suite of methods is defined by calls to #attributes including
+     getter, setter, query (var?) and banger (var! - which forces
+     re-initialization from the default value)
+
+    - ability to define multiple attributes at once using key => value pairs
+
+    - fast lookup of whether or not a class has defined a certain attribute
+
+    - attributes can be defined on objects on a per singleton basis as well
+
+    - getters acts as setters if an argument is given to them
+
+    - block caching, calling an attribute with a block sets the instance
+      variable to that block
+
+  all this in < 100 lines of code
+
+HISTORY
+  5.0.0
+    - added support for block caching. for example
+
+        - simple block caching:
+
+            class Filter 
+              attribute :process
+            end
+
+            filter = Filter.new
+
+            filter.process{|line| line.upcase}
+
+            lines.each do |line|
+              p filter.process.call(line)
+            end
+
+        - using block caching to delay block evaluation/class-factory:
+
+            module MigrationDSL
+              attribute :migration
+
+              def migration_class
+                model = self
+
+                Class.new(::ActiveRecord::Migration) do
+                  singleton_class =
+                    class << self
+                      self
+                    end
+                  singleton_class.module_eval{ attribute :model => model }
+                  singleton_class.module_eval &model.migration
+                end
+              end
+            end
+
+            class Table < ActiveRecord::Base
+              extend MigrationDSL
+            end
+
+            class Jobs < Table
+              migration do
+                def up
+                  create_table model.table_name, :primary_key => model.primary_key do |t|
+                    t.column 'vinyl_shoes', :text
+                  end
+                end
+
+                def down
+                  create_table model.table_name
+                end
+              end
+            end
+
+            ...
+
+            JobsMigration = Jobs.migration_class
+
+  4.1.0
+    - 4.0.0 introduced a bug where a query (foo?) would not initialize a var -
+      4.1.0 fixes that
+
+  4.0.0
+    - removed dependancy on, and bundle of, pervasives
+    - faster.  as fast as normal method definition.
+    - faster lookup for MyClass.attributes.include?('foobar')
+
+  3.7.0
+    small patch to use 'instance_variable_defined?' instead of defined?
+    keyword
+  
+  3.5.0
+    migrated to a pervasives based impl to attributes should work on any
+    object - even blankslate objects
+
+  3.3.0
+
+    moved to an instance variable-less model using an module level closure for
+    the attributes list
+
+SAMPLES
+  @samples

data/a.rb

@@ -0,0 +1,29 @@
+require 'attributes'
+
+module M
+  p(( attribute 'a' => 42 ))
+  p(( attribute('b'){ "forty-two (#{ self })" } ))
+end
+p M.attributes
+p M.attributes.include?('a')
+p M.attributes.include?('b')
+p M.attributes.include?('c')
+
+class C
+  include M
+end
+p C.new.a
+p C.new.b
+p C.attributes
+p C.attributes.include?('a')
+p C.attributes.include?('b')
+p C.attributes.include?('c')
+
+class B < C
+end
+p B.new.a
+p B.new.b
+p B.attributes
+p B.attributes.include?('a')
+p B.attributes.include?('b')
+p B.attributes.include?('c')

data/b.rb

@@ -0,0 +1,47 @@
+require 'lib/attributes.rb'
+require 'rubygems'
+require 'active_record'
+require 'yaml'
+
+options = YAML.load <<-txt
+  adapter: postgresql
+  database: votelink
+  username: www
+  host: localhost 
+  encoding: UTF8
+txt
+ActiveRecord::Base.establish_connection options
+
+module MigrationDSL
+  attribute :migration
+
+  def migration_class
+    model = self
+    Class.new(::ActiveRecord::Migration) do
+      singleton_class =
+        class << self
+          self
+        end
+      singleton_class.module_eval{ attribute :model => model }
+      singleton_class.module_eval &model.migration
+    end
+  end
+end
+
+class Table < ActiveRecord::Base
+  extend MigrationDSL
+end
+
+class Jobs < Table
+  migration do
+    def up
+      create_table model.table_name, :primary_key => model.primary_key do |t|
+        t.column 'rockin', :text
+      end
+    end
+
+    def down
+      create_table model.table_name
+    end
+  end
+end

data/gemspec.rb

@@ -0,0 +1,28 @@
+
+lib, version = File::basename(File::dirname(File::expand_path(__FILE__))).split %r/-/, 2
+
+require 'rubygems'
+
+Gem::Specification::new do |spec|
+  $VERBOSE = nil
+  lib = 'attributes'
+  spec.name = 'attributes1' 
+  spec.version = version 
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = lib 
+
+  spec.files = Dir::glob "**/**"
+  spec.executables = Dir::glob("bin/*").map{|exe| File::basename exe}
+  
+  spec.require_path = "lib" 
+  spec.autorequire = lib
+
+  spec.has_rdoc = File::exist? "doc" 
+  spec.test_suite_file = "test/#{ lib }.rb" if File::directory? "test"
+  #spec.add_dependency 'pervasives', '>= 1.0'
+
+  spec.extensions << "extconf.rb" if File::exists? "extconf.rb"
+
+  spec.author = "Mitesh Jain"
+  spec.email = "mitijain123@gmail.com"
+end

data/gen_readme.rb

@@ -0,0 +1,32 @@
+require 'pathname'
+
+$VERBOSE=nil
+
+def indent s, n = 2
+  ws = ' ' * n
+  s.gsub %r/^/, ws 
+end
+
+template = IO::read 'README.tmpl'
+
+samples = ''
+prompt = '~ > '
+
+Dir['sample*/*'] .each do |sample|
+  samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+  cmd = "cat #{ sample }" 
+  samples << indent(prompt + cmd, 2) << "\n\n" 
+  samples << indent(`#{ cmd }`, 4) << "\n" 
+
+  cmd = "ruby #{ sample }" 
+  samples << indent(prompt + cmd, 2) << "\n\n" 
+
+  cmd = "ruby -Ilib #{ sample }" 
+  samples << indent(`#{ cmd } 2>&1`, 4) << "\n" 
+end
+
+#samples.gsub! %r/^/, '  '
+
+readme  = template.gsub %r/^\s*@samples\s*$/, samples
+print readme 

data/install.rb

@@ -0,0 +1,206 @@
+#!/usr/bin/env ruby
+require 'rbconfig'
+require 'find'
+require 'ftools'
+require 'tempfile'
+include Config
+
+LIBDIR      = "lib"
+LIBDIR_MODE = 0644
+
+BINDIR      = "bin"
+BINDIR_MODE = 0755
+
+
+$srcdir            = CONFIG["srcdir"]
+$version           = CONFIG["MAJOR"]+"."+CONFIG["MINOR"]
+$libdir            = File.join(CONFIG["libdir"], "ruby", $version)
+$archdir           = File.join($libdir, CONFIG["arch"])
+$site_libdir       = $:.find {|x| x =~ /site_ruby$/}
+$bindir            = CONFIG["bindir"] || CONFIG['BINDIR']
+$ruby_install_name = CONFIG['ruby_install_name'] || CONFIG['RUBY_INSTALL_NAME'] || 'ruby'
+$ruby_ext          = CONFIG['EXEEXT'] || ''
+$ruby              = File.join($bindir, ($ruby_install_name + $ruby_ext))
+
+if !$site_libdir
+  $site_libdir = File.join($libdir, "site_ruby")
+elsif $site_libdir !~ %r/#{Regexp.quote($version)}/
+  $site_libdir = File.join($site_libdir, $version)
+end
+
+def install_rb(srcdir=nil, destdir=nil, mode=nil, bin=nil)
+#{{{
+  path   = []
+  dir    = []
+  Find.find(srcdir) do |f|
+    next unless FileTest.file?(f)
+    next if (f = f[srcdir.length+1..-1]) == nil
+    next if (/CVS$/ =~ File.dirname(f))
+    next if f =~ %r/\.lnk/
+    path.push f
+    dir |= [File.dirname(f)]
+  end
+  for f in dir
+    next if f == "."
+    next if f == "CVS"
+    File::makedirs(File.join(destdir, f))
+  end
+  for f in path
+    next if (/\~$/ =~ f)
+    next if (/^\./ =~ File.basename(f))
+    unless bin
+      File::install(File.join(srcdir, f), File.join(destdir, f), mode, true)
+    else
+      from = File.join(srcdir, f)
+      to = File.join(destdir, f)
+      shebangify(from) do |sf|
+        $deferr.print from, " -> ", File::catname(from, to), "\n"
+        $deferr.printf "chmod %04o %s\n", mode, to 
+        File::install(sf, to, mode, false)
+      end
+    end
+  end
+#}}}
+end
+def shebangify f
+#{{{
+  open(f) do |fd|
+    buf = fd.read 42 
+    if buf =~ %r/^\s*#\s*!.*ruby/o
+      ftmp = Tempfile::new("#{ $$ }_#{ File::basename(f) }")
+      begin
+        fd.rewind
+        ftmp.puts "#!#{ $ruby  }"
+        while((buf = fd.read(8192)))
+          ftmp.write buf
+        end
+        ftmp.close
+        yield ftmp.path
+      ensure
+        ftmp.close!
+      end
+    else
+      yield f
+    end
+  end
+#}}}
+end
+def ARGV.switch
+#{{{
+  return nil if self.empty?
+  arg = self.shift
+  return nil if arg == '--'
+  if arg =~ /^-(.)(.*)/
+    return arg if $1 == '-'
+    raise 'unknown switch "-"' if $2.index('-')
+    self.unshift "-#{$2}" if $2.size > 0
+    "-#{$1}"
+  else
+    self.unshift arg
+    nil
+  end
+#}}}
+end
+def ARGV.req_arg
+#{{{
+  self.shift || raise('missing argument')
+#}}}
+end
+def linkify d, linked = []
+#--{{{
+  if test ?d, d
+    versioned = Dir[ File::join(d, "*-[0-9].[0-9].[0-9].rb") ]
+    versioned.each do |v| 
+      src, dst = v, v.gsub(%r/\-[\d\.]+\.rb$/, '.rb')
+      lnk = nil
+      begin
+        if test ?l, dst
+          lnk = "#{ dst }.lnk"
+          puts "#{ dst } -> #{ lnk }"
+          File::rename dst, lnk
+        end
+        unless test ?e, dst
+          puts "#{ src } -> #{ dst }"
+          File::copy src, dst 
+          linked << dst
+        end
+      ensure
+        if lnk
+          at_exit do
+            puts "#{ lnk } -> #{ dst }"
+            File::rename lnk, dst
+          end
+        end
+      end
+    end
+  end
+  linked
+#--}}}
+end
+
+
+#
+# main program
+#
+
+libdir = $site_libdir
+bindir = $bindir
+no_linkify = false
+linked = nil
+help = false
+
+usage = <<-usage
+  #{ File::basename $0 }
+    -d, --destdir    <destdir>
+    -l, --libdir     <libdir>
+    -b, --bindir     <bindir>
+    -r, --ruby       <ruby>
+    -n, --no_linkify
+    -s, --sudo
+    -h, --help
+usage
+
+begin
+  while switch = ARGV.switch
+    case switch
+    when '-d', '--destdir'
+      libdir = ARGV.req_arg
+    when '-l', '--libdir'
+      libdir = ARGV.req_arg
+    when '-b', '--bindir'
+      bindir = ARGV.req_arg
+    when '-r', '--ruby'
+      $ruby = ARGV.req_arg
+    when '-n', '--no_linkify'
+      no_linkify = true
+    when '-s', '--sudo'
+      sudo = 'sudo' 
+    when '-h', '--help'
+      help = true
+    else
+      raise "unknown switch #{switch.dump}"
+    end
+  end
+rescue
+  STDERR.puts $!.to_s
+  STDERR.puts usage
+  exit 1
+end    
+
+if help
+  STDOUT.puts usage
+  exit
+end
+
+unless no_linkify
+  linked = linkify('lib') + linkify('bin')
+end
+
+system "#{ $ruby } extconf.rb && make && #{ sudo } make install" if test(?s, 'extconf.rb')
+
+install_rb(LIBDIR, libdir, LIBDIR_MODE)
+install_rb(BINDIR, bindir, BINDIR_MODE, bin=true)
+
+if linked
+  linked.each{|path| File::rm_f path}
+end

data/lib/attributes-5.0.0.rb

@@ -0,0 +1,118 @@
+module Attributes
+  Attributes::VERSION = '5.0.0' unless defined? Attributes::VERSION
+  def self.version() Attributes::VERSION end
+
+  class List < ::Array
+    def << element
+      super
+      self
+    ensure
+      uniq!
+      index!
+    end
+    def index!
+      @index ||= Hash.new
+      each{|element| @index[element] = true}
+    end
+    def include? element
+      @index ||= Hash.new
+      @index[element] ? true : false
+    end
+    def initializers
+      @initializers ||= Hash.new
+    end
+  end
+
+  def attributes *a, &b
+    unless a.empty?
+      returned = Hash.new
+
+      hashes, names = a.partition{|x| Hash === x}
+      names_and_defaults = {}
+      hashes.each{|h| names_and_defaults.update h}
+      names.flatten.compact.each{|name| names_and_defaults.update name => nil}
+
+      initializers = __attributes__.initializers
+
+      names_and_defaults.each do |name, default|
+        raise NameError, "bad instance variable name '@#{ name }'" if "@#{ name }" =~ %r/[!?=]$/o
+        name = name.to_s
+
+        initialize = b || lambda { default }
+        initializer = lambda do |this|
+          Object.instance_method('instance_eval').bind(this).call &initialize
+        end
+        initializer_id = initializer.object_id
+        __attributes__.initializers[name] = initializer
+
+        module_eval <<-code
+          def #{ name }=(*value, &block)
+            value.unshift block if block
+            @#{ name } = value.first
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }(*value, &block)
+            value.unshift block if block
+            return self.send('#{ name }=', value.first) unless value.empty?
+            #{ name }! unless defined? @#{ name }
+            @#{ name }
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }!
+            initializer = ObjectSpace._id2ref #{ initializer_id }
+            self.#{ name } = initializer.call(self)
+            @#{ name }
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }?
+            #{ name }
+          end
+        code
+
+        attributes << name
+        returned[name] = initializer 
+      end
+
+      returned
+    else
+      begin
+        __attribute_list__
+      rescue NameError
+        singleton_class =
+          class << self
+            self
+          end
+        klass = self
+        singleton_class.module_eval do
+          attribute_list = List.new 
+          define_method('attribute_list'){ klass == self ? attribute_list : raise(NameError) }
+          alias_method '__attribute_list__', 'attribute_list'
+        end
+        __attribute_list__
+      end
+    end
+  end
+
+  %w( __attributes__ __attribute__ attribute ).each{|dst| alias_method dst, 'attributes'}
+end
+
+class Object
+  def attributes *a, &b
+    sc = 
+      class << self
+        self
+      end
+    sc.attributes *a, &b
+  end
+  %w( __attributes__ __attribute__ attribute ).each{|dst| alias_method dst, 'attributes'}
+end
+
+class Module
+  include Attributes
+end

data/lib/attributes.rb

@@ -0,0 +1,118 @@
+module Attributes
+  Attributes::VERSION = '5.0.0' unless defined? Attributes::VERSION
+  def self.version() Attributes::VERSION end
+
+  class List < ::Array
+    def << element
+      super
+      self
+    ensure
+      uniq!
+      index!
+    end
+    def index!
+      @index ||= Hash.new
+      each{|element| @index[element] = true}
+    end
+    def include? element
+      @index ||= Hash.new
+      @index[element] ? true : false
+    end
+    def initializers
+      @initializers ||= Hash.new
+    end
+  end
+
+  def attributes *a, &b
+    unless a.empty?
+      returned = Hash.new
+
+      hashes, names = a.partition{|x| Hash === x}
+      names_and_defaults = {}
+      hashes.each{|h| names_and_defaults.update h}
+      names.flatten.compact.each{|name| names_and_defaults.update name => nil}
+
+      initializers = __attributes__.initializers
+
+      names_and_defaults.each do |name, default|
+        raise NameError, "bad instance variable name '@#{ name }'" if "@#{ name }" =~ %r/[!?=]$/o
+        name = name.to_s
+
+        initialize = b || lambda { default }
+        initializer = lambda do |this|
+          Object.instance_method('instance_eval').bind(this).call &initialize
+        end
+        initializer_id = initializer.object_id
+        __attributes__.initializers[name] = initializer
+
+        module_eval <<-code
+          def #{ name }=(*value, &block)
+            value.unshift block if block
+            @#{ name } = value.first
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }(*value, &block)
+            value.unshift block if block
+            return self.send('#{ name }=', value.first) unless value.empty?
+            #{ name }! unless defined? @#{ name }
+            @#{ name }
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }!
+            initializer = ObjectSpace._id2ref #{ initializer_id }
+            self.#{ name } = initializer.call(self)
+            @#{ name }
+          end
+        code
+
+        module_eval <<-code
+          def #{ name }?
+            #{ name }
+          end
+        code
+
+        attributes << name
+        returned[name] = initializer 
+      end
+
+      returned
+    else
+      begin
+        __attribute_list__
+      rescue NameError
+        singleton_class =
+          class << self
+            self
+          end
+        klass = self
+        singleton_class.module_eval do
+          attribute_list = List.new 
+          define_method('attribute_list'){ klass == self ? attribute_list : raise(NameError) }
+          alias_method '__attribute_list__', 'attribute_list'
+        end
+        __attribute_list__
+      end
+    end
+  end
+
+  %w( __attributes__ __attribute__ attribute ).each{|dst| alias_method dst, 'attributes'}
+end
+
+class Object
+  def attributes *a, &b
+    sc = 
+      class << self
+        self
+      end
+    sc.attributes *a, &b
+  end
+  %w( __attributes__ __attribute__ attribute ).each{|dst| alias_method dst, 'attributes'}
+end
+
+class Module
+  include Attributes
+end

data/samples/a.rb

@@ -0,0 +1,21 @@
+#
+# basic usage is like attr, but note that attribute defines a suite of methods
+#
+  require 'attributes'
+
+  class C
+    attribute 'a'
+  end
+
+  c = C.new
+
+  c.a = 42
+  p c.a                 #=> 42
+  p 'forty-two' if c.a? #=> 'forty-two'
+
+#
+# attributes works on object too 
+#
+  o = Object.new
+  o.attribute 'answer' => 42
+  p o.answer           #=> 42

data/samples/b.rb

@@ -0,0 +1,22 @@
+#
+# default values may be given either directly or as a block which will be
+# evaluated in the context of self.  in both cases (value or block) the
+# default is set only once and only if needed - it's a lazy evaluation.  the
+# 'banger' method can be used to re-initialize a variable at any point whether
+# or not it's already been initialized.
+#
+  require 'attributes'
+
+  class C
+    attribute :a => 42
+    attribute(:b){ Float a }
+  end
+
+  c = C.new
+  p c.a #=> 42
+  p c.b #=> 42.0
+
+  c.a = 43
+  p c.a #=> 43
+  c.a!
+  p c.a #=> 42

data/samples/c.rb

@@ -0,0 +1,12 @@
+#
+# multiple values may by given, plain names and key/val pairs may be mixed.
+#
+  require 'attributes'
+
+  class C
+    attributes 'x', 'y' => 0b101000, 'z' => 0b10
+  end
+
+  c = C.new
+  c.x = c.y + c.z
+  p c.x #=> 42

data/samples/d.rb

@@ -0,0 +1,34 @@
+#
+# a nice feature is that all attributes are enumerated in the class.  this,
+# combined with the fact that the getter method is defined so as to delegate
+# to the setter when an argument is given, means bulk initialization and/or
+# attribute traversal is very easy.
+#
+  require 'attributes'
+
+  class C
+    attributes %w( x y z )
+
+    def attributes
+      self.class.attributes
+    end
+
+    def initialize
+      attributes.each_with_index{|a,i| send a, i}
+    end
+
+    def to_hash
+      attributes.inject({}){|h,a| h.update a => send(a)}
+    end
+
+    def inspect
+      to_hash.inspect
+    end
+  end
+
+  c = C.new
+  p c.attributes 
+  p c 
+
+  c.x 'forty-two' 
+  p c.x

data/samples/e.rb

@@ -0,0 +1,18 @@
+#
+# my favourite element of attributes is that getters can also be setters.
+# this allows incredibly clean looking code like
+#
+  require 'attributes'
+
+  class Config
+    attributes %w( host port)
+    def initialize(&block) instance_eval &block end
+  end
+
+  conf = Config.new{
+    host 'codeforpeople.org'
+
+    port 80
+  }
+
+  p conf

data/samples/f.rb

@@ -0,0 +1,21 @@
+#
+# of course attributes works as well at class/module level as at instance
+# level
+#
+  require 'attributes'
+
+  module Logging 
+    Level_names = {
+      0 => 'INFO',
+      # ...
+      42 => 'DEBUG',
+    }
+
+    class << self
+      attribute 'level' => 42
+      attribute('level_name'){ Level_names[level] }
+    end
+  end
+
+p Logging.level
+p Logging.level_name

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: attributes1
+version: !ruby/object:Gem::Version
+  version: 5.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Mitesh Jain
+autorequire: attributes
+bindir: bin
+cert_chain: []
+date: 2011-11-24 00:00:00.000000000Z
+dependencies: []
+description: 
+email: mitijain123@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- a.rb
+- b.rb
+- gemspec.rb
+- gen_readme.rb
+- install.rb
+- lib/attributes-5.0.0.rb
+- lib/attributes.rb
+- README
+- README.tmpl
+- samples/a.rb
+- samples/b.rb
+- samples/c.rb
+- samples/d.rb
+- samples/e.rb
+- samples/f.rb
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: attributes
+test_files: []