object2module 0.4.0-i386-mswin32 → 0.4.2-i386-mswin32

data/README.markdown

@@ -0,0 +1,75 @@
+Object2module
+=============
+
+(C) John Mair (banisterfiend) 2010
+
+_Enables Classes and Objects to be mixed into ancestor chains_
+
+Using Object2module you can treat classes and object (their singletons, anyway) as if they were modules and include or extend them into ancestor chains.
+
+Object2module provides the `gen_include` and `gen_extend` methods which are generalizations of the traditional `include` and `extend`.
+
+* Install the [gem](https://rubygems.org/gems/object2module): `gem install object2module`
+* Read the [documentation](http://rdoc.info/github/banister/object2module/master/file/README.markdown)
+* See the [source code](http://github.com/banister/object2module)
+
+example: gen_include()
+--------------------------
+
+Using `gen_include` we can include a class into another class:
+
+
+    class C
+      def hello
+        :hello
+      end
+    end
+
+    class D
+      gen_include C
+    end
+
+    D.new.hello #=> :hello
+    D.ancestors #=> [D, C, Object, ...]
+    
+example: gen_extend()
+--------------------
+
+`gen_extend` lets us mix objects into objects:
+
+    o = Object.new
+    class << o
+      def bye
+        :bye
+      end
+    end
+
+    n = Object.new
+    n.gen_extend o
+    n.bye #=> :bye
+    
+How it works
+--------------
+
+Object2module simply removes the check for `T_MODULE` from `rb_include_module()`
+
+Companion Libraries
+--------------------
+
+Remix is one of a series of experimental libraries that mess with
+the internals of Ruby to bring new and interesting functionality to
+the language, see also:
+
+* [Remix](http://github.com/banister/remix) - Makes ancestor chains read/write
+* [Real Include](http://github.com/banister/real_include) - Brings in
+  module singleton classes during an include. No more ugly ClassMethods and included() hook hacks.
+* [Prepend](http://github.com/banister/prepend) - Prepends modules in front of a class; so method lookup starts with the module
+* [GenEval](http://github.com/banister/gen_eval) - A strange new breed of instance_eval
+
+Contact
+-------
+
+Problems or questions contact me at [github](http://github.com/banister)
+
+
+

data/Rakefile

@@ -1,7 +1,6 @@
 # Rakefile added by John Mair (banisterfiend)
 
 require 'rake/gempackagetask'
-require 'rake/rdoctask'
 require 'rake/clean'
 require './lib/object2module/version.rb'
 
@@ -11,7 +10,6 @@ direc = File.dirname(__FILE__)
 CLEAN.include("ext/**/*.#{dlext}", "ext/**/.log", "ext/**/.o", "ext/**/*~", "ext/**/*#*", "ext/**/.obj", "ext/**/.def", "ext/**/.pdb")
 CLOBBER.include("**/*.#{dlext}", "**/*~", "**/*#*", "**/*.log", "**/*.o", "doc/**")
 
-
 def apply_spec_defaults(s)
   s.name = "object2module"
   s.summary = "object2module enables ruby classes and objects to be used as modules"
@@ -19,13 +17,12 @@ def apply_spec_defaults(s)
   s.version = Object2module::VERSION
   s.author = "John Mair (banisterfiend)"
   s.email = 'jrmair@gmail.com'
-  s.has_rdoc = true
+  s.has_rdoc = 'yard'
   s.date = Time.now.strftime '%Y-%m-%d'
   s.require_path = 'lib'
   s.homepage = "http://banisterfiend.wordpress.com"
 end
 
-
 task :test do
   sh "bacon -k #{direc}/test/test.rb"
 end
@@ -35,7 +32,7 @@ end
     spec = Gem::Specification.new do |s|
       apply_spec_defaults(s)        
       s.platform = "i386-#{v}"
-      s.files = FileList["Rakefile", "README", "LICENSE",
+      s.files = FileList["Rakefile", "README.markdown", "LICENSE",
                          "lib/object2module.rb", "lib/1.8/object2module.#{dlext}",
                          "lib/1.9/object2module.#{dlext}", "lib/object2module/version.rb", "test/*.rb"].to_a
     end
@@ -53,7 +50,7 @@ task :ruby do
   spec = Gem::Specification.new do |s|
     apply_spec_defaults(s)        
     s.platform = Gem::Platform::RUBY
-    s.files = FileList["Rakefile", "README", "LICENSE",
+    s.files = FileList["Rakefile", "README.markdown", "LICENSE",
                        "lib/object2module.rb","lib/object2module/version.rb",
                        "test/*.rb", "ext/**/extconf.rb", "ext/**/*.h", "ext/**/*.c"].to_a
     s.extensions = ["ext/object2module/extconf.rb"]
@@ -67,7 +64,3 @@ task :ruby do
   Rake::Task[:gem].invoke
 end
 
-Rake::RDocTask.new do |rd|
-  rd.main = "README.rdoc"
-  rd.rdoc_files.include("README.rdoc", "lib/object2module.rb")
-end

data/lib/object2module.rb

@@ -28,7 +28,7 @@ class Object
   def __gen_extend_or_include__(extend_or_include, *objs)  #:nodoc:
     raise ArgumentError, "wrong number of arguments (at least 1)" if objs.empty?
 
-    objs.each { |mod|
+    objs.reverse.each { |mod|
         send(extend_or_include, mod)
     }
 

data/lib/object2module/version.rb

@@ -1,3 +1,3 @@
 module Object2module
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

data/test/test_with_remix.rb

@@ -0,0 +1,147 @@
+direc = File.dirname(__FILE__)
+require 'rubygems'
+require 'bacon'
+require 'remix'
+require "#{direc}/../lib/object2module"
+
+
+class Module
+  public :include, :remove_const
+end
+
+describe Object2module do
+  before do
+    class A
+      def hello
+        :a
+      end
+    end
+
+    class B
+      def hello
+        :b
+      end
+    end
+
+    module M
+      def m
+        :m
+      end
+    end
+
+    O = Object.new
+    class << O
+      def o
+        :o
+      end
+    end
+
+    C = Class.new
+  end
+
+  after do
+    Object.remove_const(:A)
+    Object.remove_const(:B)
+    Object.remove_const(:C)
+    Object.remove_const(:M)
+    Object.remove_const(:O)
+  end
+
+  describe 'gen_include' do
+    it 'includes two classes and swaps them' do
+      C.gen_include A
+      C.gen_include B
+      C.new.hello.should == :b
+      C.swap_modules A, B
+      C.new.hello.should == :a
+    end
+
+    it 'includes a class into a class and swaps them' do
+      A.gen_include B
+      C.gen_include A
+      C.new.hello.should == :a
+      C.swap_modules A, B
+      C.new.hello.should == :b
+    end
+
+    it 'unincludes a gen_included class' do
+      C.gen_include A
+      C.new.hello.should == :a
+      C.uninclude A
+      lambda { C.new.hello }.should.raise NameError
+    end
+
+    it 'recursively unincludes a gen_included class' do
+      A.gen_include B
+      C.gen_include A
+      C.new.hello.should == :a
+      C.ancestors.should[0..2] == [C, A, B]
+      C.uninclude A, true
+      C.ancestors.should[0..1] == [C, Object]
+    end
+
+    it 'unincludes a singleton class' do
+      o = Object.new
+      class << o
+        def hello
+          :o
+        end
+      end
+
+      C.gen_include o
+      C.new.hello.should == :o
+      C.uninclude C.ancestors[1]
+      lambda { C.new.hello }.should.raise NameError
+      C.ancestors[1].should == Object
+    end
+  end
+
+  describe 'gen_extend' do
+    it 'extends two classes into an object and swaps them' do
+      o = Object.new
+      o.gen_extend A, B
+      o.hello.should == :a
+    end
+
+    it 'unextends a class from an object' do
+      o = Object.new
+      o.gen_extend A
+      o.hello.should == :a
+      o.singleton_class.ancestors[0].should == A
+      o.unextend A
+      lambda { o.hello }.should.raise NameError
+      o.singleton_class.ancestors[0].should == Object
+    end
+
+    it 'recursively unextends a class from an object' do
+      o = Object.new
+      A.gen_include B
+      o.gen_extend A
+      o.singleton_class.ancestors[0..2].should == [A, B, Object]
+      o.unextend A, true
+      o.singleton_class.ancestors.first.should == Object
+    end
+
+    it 'recursively unextends a singleton class gen_extended into another singleton class' do
+      o = Object.new
+      def o.hello
+        :o
+      end
+
+      n = Object.new
+      def n.hello
+        :n
+      end
+
+      n.gen_extend o
+
+      v = Object.new
+      v.gen_extend n
+      
+      v.hello.should == :n
+      v.unextend n.singleton_class,  true
+      lambda { v.hello }.should.raise NameError
+      v.singleton_class.ancestors.first.should == Object
+    end
+  end
+end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: object2module
 version: !ruby/object:Gem::Version 
+  hash: 11
   prerelease: false
   segments: 
   - 0
   - 4
-  - 0
-  version: 0.4.0
+  - 2
+  version: 0.4.2
 platform: i386-mswin32
 authors: 
 - John Mair (banisterfiend)
@@ -28,7 +29,7 @@ extra_rdoc_files: []
 
 files: 
 - Rakefile
-- README
+- README.markdown
 - LICENSE
 - lib/object2module.rb
 - lib/1.8/object2module.so
@@ -36,7 +37,8 @@ files:
 - lib/object2module/version.rb
 - test/test.rb
 - test/test_stress.rb
-has_rdoc: true
+- test/test_with_remix.rb
+has_rdoc: yard
 homepage: http://banisterfiend.wordpress.com
 licenses: []
 
@@ -50,6 +52,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -58,6 +61,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"

data/README

@@ -1,18 +0,0 @@
-# Object2module
-
--   converts a Class (or the Singleton of an Object) to a Module
--   Includes gen\_extend and gen\_include methods: generalizations
-    of Object#extend and Module#include that work with Objects and
-    Classes as well as Modules
-
-How it works:
-
--   First creates an IClass for the Class in question and sets the
-    T\_MODULE flag
--   Recursively converts superclasses of the Class to IClasses
-    creating a modulified version of the Class's inheritance chain
--   gen\_include/gen\_extend automatically call #to\_module on the
-    Class/Object before inclusion/extension.
-
-
-