remix 0.4.6 → 0.4.7

data/README.markdown

@@ -16,18 +16,19 @@ remove modules, replace modules, move modules around and otherwise
 * Read the [documentation](http://rdoc.info/github/banister/remix/master/file/README.markdown)
 * See the [source code](http://github.com/banister/remix)
 
-example: include_at_top():
---------------------------
+example: temp_include():
+------------------------
 
-Using `include_at_top` we can include a module at the top of a chain
-rather than at the bottom (the default).
+Using `temp_include` we can temporaliy mix in a module for the
+duration of a block:
 
-    M.ancestors #=> [M, A, B, C]
+    module M def hello() :hello end end
     
-    M.include_at_top J
+    String.temp_include(M) do
+      puts "test".hello #=> "hello"
+    end
     
-    # Modified ancestor chain
-    M.ancestors #=> [M, A, B, C, J]
+    "test".hello #=> NoMethodError
     
 example: unextend()
 --------------------
@@ -90,6 +91,7 @@ Full list of functions
 
 **include-based functions:**
 
+* temp_include(mod)
 * include_at(index, mod)
 * include_at_top(mod)
 * include_before(before_mod, mod)
@@ -102,6 +104,7 @@ Full list of functions
 
 **extend-based functions:**
 
+* temp_extend(mod)
 * extend_at(index, mod)
 * extend_at_top(mod)
 * extend_before(before_mod, mod)

data/Rakefile

@@ -5,9 +5,9 @@ require 'rake/clean'
 require 'rake/gempackagetask'
 require "#{direc}/lib/remix/version"
 
-
-CLEAN.include("ext/**/*.#{dlext}", "ext/**/*.log", "ext/**/*.o", "ext/**/*~", "ext/**/*#*", "ext/**/*.obj", "ext/**/*.def", "ext/**/*.pdb")
 CLOBBER.include("**/*.#{dlext}", "**/*~", "**/*#*", "**/*.log", "**/*.o")
+CLEAN.include("ext/**/*.#{dlext}", "ext/**/*.log", "ext/**/*.o", "ext/**/*~",
+              "ext/**/*#*", "ext/**/*.obj", "ext/**/*.def", "ext/**/*.pdb")
 
 def apply_spec_defaults(s)
   s.name = "remix"
@@ -20,10 +20,11 @@ def apply_spec_defaults(s)
   s.require_path = 'lib'
   s.homepage = "http://banisterfiend.wordpress.com"
   s.has_rdoc = 'yard'
-  s.files = FileList["ext/**/extconf.rb", "ext/**/*.h", "ext/**/*.c", "lib/**/*.rb",
-                     "test/*.rb", "CHANGELOG", "README.markdown", "Rakefile"].to_a
+  s.files = Dir["ext/**/extconf.rb", "ext/**/*.h", "ext/**/*.c", "lib/**/*.rb",
+                     "test/*.rb", "CHANGELOG", "README.markdown", "Rakefile"]
 end
 
+desc "run tests"
 task :test do
   sh "bacon -k #{direc}/test/test.rb"
 end
@@ -56,9 +57,11 @@ namespace :ruby do
   end
 end
 
+desc "build the 1.8 and 1.9 binaries from source and copy to lib/"
 task :compile do
   build_for = proc do |pik_ver, ver|
     sh %{ \
+          c:\\devkit\\devkitvars.bat && \
           pik #{pik_ver} && \
           ruby extconf.rb && \
           make clean && \
@@ -69,7 +72,7 @@ task :compile do
   
   chdir("#{direc}/ext/remix") do
     build_for.call("187", "1.8")
-    build_for.call("default", "1.9")
+    build_for.call("192", "1.9")
   end
 end
 
@@ -87,6 +90,3 @@ task :pushgems => :gems do
     end
   end
 end
-
-
-

data/lib/remix.rb

@@ -44,6 +44,19 @@ module Remix
     # Temporarily extends a module for the duration of a block.
     # Module will be unextended at end of block.
     # @param [Module] mod Module to be temporarily extended
+    # @example
+    #   module M
+    #     def hello
+    #       :hello
+    #     end
+    #   end
+    #   
+    #   o = Object.new
+    #   o.temp_extend(M) do
+    #     puts hello #=> "hello"
+    #   end
+    #   
+    #   o.hello #=> NoMethodError
     def temp_extend(mod, options={}, &block)
       Remix.wrap_with_hooks(options[:before], options[:after]) do
         begin
@@ -131,10 +144,16 @@ module Remix
     end
 
     # Like `replace_module()` but for the singleton class
-    # @see Remix::ModuleExtensions#replace_module_down
+    # @see Remix::ModuleExtensions#replace_module
     def replace_extended_module(mod1, mod2)
       singleton_class.replace_module(mod1, mod2)
     end
+
+    # Like `ready_remix()` on `Module` but for the singleton class
+    # @see Remix::ModuleExtensions#ready_remix
+    def ready_remix()
+      singleton_class.ready_remix
+    end
   end
 
   module Remix::ModuleExtensions
@@ -142,6 +161,18 @@ module Remix
     # Temporarily includes a module for the duration of a block.
     # Module will be unincluded at end of block.
     # @param [Module] mod Module to be temporarily included
+    # @example
+    #   module M
+    #     def hello
+    #       :hello
+    #     end
+    #   end
+    #   
+    #   String.temp_include(M) do
+    #     puts "friendo".hello #=> "hello"
+    #   end
+    #   
+    #   "friendo".hello #=> NoMethodError
     def temp_include(mod, options={}, &block)
       Remix.wrap_with_hooks(options[:before], options[:after]) do
         begin

data/lib/remix/c_docs.rb

@@ -8,12 +8,7 @@ module Remix
     # @param [Module] mod The module to include
     # @return [Module] The receiver
     # @example
-    #   module M end
-    #   module N end
-    #   module O end
-    #   module P
-    #     include M, N
-    #   end
+    #   P.ancestors #=> [P, M, N]
     #   P.include_at 2, O
     #   P.ancestors #=> [P, M, O, N]
     def include_at(index, mod) end
@@ -110,5 +105,11 @@ module Remix
     #   M.replace_module B, J
     #   M.ancestors #=> [M, A, J]
     def replace_module(mod1, mod2) end
+
+    # Prepares the receiver's ancestor chain for remixing. This method
+    # is called automatically by all remixing methods and should
+    # never need to be invoked by the user.
+    # @return [Object] The receiver
+    def ready_remix() end
   end
 end

data/lib/remix/version.rb

@@ -1,4 +1,4 @@
 module Remix
-  VERSION = "0.4.6"
+  VERSION = "0.4.7"
 end
 

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: remix
 version: !ruby/object:Gem::Version 
+  hash: 1
   prerelease: false
   segments: 
   - 0
   - 4
-  - 6
-  version: 0.4.6
+  - 7
+  version: 0.4.7
 platform: ruby
 authors: 
 - John Mair (banisterfiend)
@@ -14,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-12 00:00:00 +13:00
+date: 2010-11-15 00:00:00 +13:00
 default_executable: 
 dependencies: []
 
@@ -52,6 +53,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -60,6 +62,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"