eigenclass 1.0.1

data/CHANGELOG

@@ -0,0 +1,6 @@
+2009-01-07 - Sean Huber (shuber@huberry.com)
+  * Initial commit
+  * Update README
+  * Add gemspec
+  * Update gemspec to force github to rebuild gem
+  * Rename cattr_* methods to eattr_* to avoid confusion and conflict with ActiveSupport's version

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Sean Huber - shuber@huberry.com
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,55 @@
+Eigenclass
+==========
+
+Utility methods for modifying a ruby object's eigenclass/metaclass
+
+
+Installation
+------------
+
+	gem install shuber-eigenclass --source http://gems.github.com
+
+
+Usage
+-----
+
+This gem allows you to define class level accessors, readers, and writers
+
+	class SomeClass
+	  eattr_accessor :test_accessor
+	  eattr_reader :test_reader
+	  eattr_writer :test_writer
+	end
+	
+	SomeClass.test_accessor = 'testing'
+
+
+You can also dynamically create class methods
+
+	SomeClass.class_eval do
+	  define_class_method 'test_class_method' do
+	    'test'
+	  end
+	end
+	
+	SomeClass.test_class_method # returns 'test'
+
+
+You can even evaluate a block of code inside the scope of an object's eigenclass
+
+	SomeClass.eigenclass_eval do
+	  attr_accessor :test_eigenclass_eval
+	end
+	
+	SomeClass.test_eigenclass_eval = true
+
+
+A reference to any object's eigenclass can be accessed by calling
+
+	SomeObject.eigenclass
+
+
+Contact
+-------
+
+Problems, comments, and suggestions all welcome: [shuber@huberry.com](mailto:shuber@huberry.com)

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the eigenclass gem.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the eigenclass gem.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Eigenclass'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.markdown')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/eigenclass.rb

@@ -0,0 +1,79 @@
+module Huberry
+  module Eigenclass
+    # Uses <tt>eigenclass_eval</tt> to define attr_accessors in an object's <tt>eigenclass</tt>
+    # which can be called like a class methods
+    #
+    # Example
+    #
+    #   class User
+    #     eattr_accessor :testing
+    #   end
+    #
+    #   User.testing = true
+    def eattr_accessor(*attrs)
+      eigenclass_eval { attr_accessor *attrs }
+    end
+    
+    # Uses <tt>eigenclass_eval</tt> to define attr_readers in an object's <tt>eigenclass</tt>
+    # which can be called like a class methods
+    #
+    # Example
+    #
+    #   class User
+    #     eattr_reader :testing
+    #     @testing = true
+    #   end
+    #
+    #   User.testing # returns true
+    def eattr_reader(*attrs)
+      eigenclass_eval { attr_reader *attrs }
+    end
+    
+    # Uses <tt>eigenclass_eval</tt> to define attr_writers in an object's <tt>eigenclass</tt>
+    # which can be called like a class methods
+    #
+    # Example
+    #
+    #   class User
+    #     eattr_writer :testing
+    #   end
+    #
+    #   User.testing = true
+    def eattr_writer(*attrs)
+      eigenclass_eval { attr_writer *attrs }
+    end
+    
+    # Uses <tt>eigenclass_eval</tt> to define a method in an object's <tt>eigenclass</tt>
+    # which can be called like a class method
+    #
+    # Example
+    #
+    #   User.class_eval do
+    #     define_class_method 'testing' do
+    #       'test'
+    #     end
+    #   end
+    #
+    #   User.testing # returns 'test'
+    def define_class_method(name, &block)
+      eigenclass_eval { define_method name, &block }
+    end
+    
+    # Returns an object's eigenclass
+    def eigenclass
+      class << self; self; end
+    end
+    
+    # Accepts a block to evaluate inside the scope of an object's <tt>eigenclass</tt>
+    #
+    # Example
+    #
+    #   User.eigenclass_eval { attr_accessor :testing }
+    #   User.testing = true
+    def eigenclass_eval(&block)
+      eigenclass.instance_eval &block
+    end
+  end
+end
+
+Object.send :include, Huberry::Eigenclass

data/test/eigenclass_test.rb

@@ -0,0 +1,90 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/eigenclass'
+
+class TestClass; end
+class ChildTestClass < TestClass; end
+class AnotherTestClass; end
+
+class EigenclassTest < Test::Unit::TestCase
+  
+  def test_should_return_the_eigenclass
+    assert_equal (class << TestClass; self; end), TestClass.eigenclass
+  end
+  
+  def test_should_return_the_same_instance_of_the_eigenclass
+    assert_equal TestClass.eigenclass.object_id, TestClass.eigenclass.object_id
+  end
+  
+  def test_should_eigenclass_eval_correctly
+    assert !TestClass.respond_to?(:testing)
+    TestClass.eigenclass_eval do
+      define_method 'testing' do
+        'test'
+      end
+    end
+    assert TestClass.respond_to?(:testing)
+    assert_equal 'test', TestClass.testing
+  end
+  
+  def test_should_define_class_method
+    assert !TestClass.respond_to?(:testing_again)
+    TestClass.class_eval do
+      define_class_method 'testing_again' do
+        'test'
+      end
+    end
+    assert TestClass.respond_to?(:testing_again)
+    assert_equal 'test', TestClass.testing_again
+  end
+  
+  def test_child_class_should_inherit_defined_class_methods
+    assert !ChildTestClass.respond_to?(:testing_yet_again)
+    TestClass.class_eval do
+      define_class_method 'testing_yet_again' do
+        'test'
+      end
+    end
+    assert ChildTestClass.respond_to?(:testing_yet_again)
+    assert_equal 'test', ChildTestClass.testing_yet_again
+  end
+  
+  def test_should_not_define_methods_accross_all_classes
+    assert !TestClass.respond_to?(:testing_one_more_time)
+    assert !AnotherTestClass.respond_to?(:testing_one_more_time)
+    TestClass.class_eval do
+      define_class_method 'testing_one_more_time' do
+        'test'
+      end
+    end
+    assert TestClass.respond_to?(:testing_one_more_time)
+    assert !AnotherTestClass.respond_to?(:testing_one_more_time)
+  end
+  
+  def test_cattr_accessor
+    assert !TestClass.respond_to?(:this_is_a_test)
+    TestClass.eattr_accessor :this_is_a_test
+    assert TestClass.respond_to?(:this_is_a_test)
+    assert TestClass.this_is_a_test.nil?
+    TestClass.this_is_a_test = true
+    assert TestClass.this_is_a_test
+  end
+  
+  def test_cattr_reader
+    assert !TestClass.respond_to?(:this_is_another_test)
+    TestClass.eattr_reader :this_is_another_test
+    assert TestClass.respond_to?(:this_is_another_test)
+    assert TestClass.this_is_another_test.nil?
+    TestClass.instance_variable_set('@this_is_another_test', true)
+    assert TestClass.this_is_another_test
+  end
+  
+  def test_cattr_writer
+    assert !TestClass.respond_to?(:this_is_yet_another_test=)
+    TestClass.eattr_writer :this_is_yet_another_test
+    assert TestClass.respond_to?(:this_is_yet_another_test=)
+    assert TestClass.instance_variable_get('@this_is_yet_another_test').nil?
+    TestClass.this_is_yet_another_test = true
+    assert TestClass.instance_variable_get('@this_is_yet_another_test')
+  end
+  
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: eigenclass
+version: !ruby/object:Gem::Version 
+  version: 1.0.1
+platform: ruby
+authors: 
+- Sean Huber
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-07 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Utility methods for modifying a ruby object's eigenclass/metaclass
+email: shuber@huberry.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- CHANGELOG
+- lib/eigenclass.rb
+- MIT-LICENSE
+- Rakefile
+- README.markdown
+has_rdoc: false
+homepage: http://github.com/shuber/eigenclass
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Utility methods for modifying a ruby object's eigenclass/metaclass
+test_files: 
+- test/eigenclass_test.rb