free 0.2.0 → 0.2.5

data/HISTORY

@@ -1,3 +1,6 @@
+4/1/2011 version 0.2.5
+* added Free.free() (for freeing multiple values) (credit to coderrr)
+
 4/1/2011 version 0.2.0
 * added destructors
 * added greater error checking

data/README.md

@@ -50,6 +50,7 @@ Features and limitations
 * Works in both Ruby 1.8 and 1.9.
 * Some protection from freeing critical objects and immediate values.
 * Supports object destructors
+* Can free multiple objects at same time, e.g: `Free.free a, b, c`
 
 ### Limitations
 

data/ext/free/free.c

@@ -91,7 +91,7 @@ make_deferred(RVALUE *p)
 
 #endif
 
-VALUE object_free(VALUE obj)
+VALUE rb_object_free(VALUE obj)
 {
   ID id_destructor = rb_intern("__destruct__");
 
@@ -384,10 +384,20 @@ VALUE object_free(VALUE obj)
   return destruct_value;
 }
 
+VALUE
+rb_object_free_args(int argc, VALUE *argv, VALUE self)
+{
+  for (int i = 0; i < argc; i++)
+    rb_object_free(argv[i]);
+  
+  return Qnil;  
+}
+
 void
 Init_free()
 {
   VALUE cFree = rb_define_module("Free");
   
-  rb_define_method(cFree, "free", object_free, 0);
+  rb_define_method(cFree, "free", rb_object_free, 0);
+  rb_define_singleton_method(cFree, "free", rb_object_free_args, -1);
 }

data/ext/free/free.h

@@ -2,5 +2,6 @@
 #define GUARD_FREE_H
 
 VALUE rb_object_free(VALUE obj);
+VALUE rb_object_free_args(int argc, VALUE *argv, VALUE self);
 
 #endif

data/lib/free/version.rb

@@ -1,3 +1,3 @@
 module Free
-  VERSION = "0.2.0"
+  VERSION = "0.2.5"
 end     

data/lib/free.rb

@@ -8,6 +8,17 @@ require "#{direc}/free/version"
 # @author John Mair (banisterfiend)
 module Free
 
+  # Free multiple objects at once.
+  # @param [Array] args The objects to free.
+  # @return [nil] Returns nil.
+  # @example
+  #   h = "hello"
+  #   g = "goodbye"
+  #   m = "good morning"
+  #
+  #   Free.free h, g, m
+  def self.free(*args) end
+    
   # Force garbage collection on an object and free its internal structures.
   # @return [nil, Object] Return value of \_\_destruct\_\_ method (if
   #   defined) or nil (if no \_\_destruct\_\_ method)

data/test/test.rb

@@ -11,7 +11,7 @@ describe Free do
 
   ["hello", Object.new, Class.new, /hello/, [], {}, 10.5].each do |v|
     it "should free a #{v.class}" do
-      v
+
       # make sure test doesn't pass as a result of normal garbage
       # collection, so keep a reference to v
       c = v
@@ -33,6 +33,17 @@ describe Free do
     end
   end
 
+  it 'should free multiple objects at once' do
+    a,b,c = 'a','b','c'
+    a_id, b_id, c_id = a.object_id, b.object_id, c.object_id
+
+    Free.free a, b, c
+
+    [a_id, b_id, c_id].each do |id|
+      (ObjectSpace._id2ref(id)  != v || lambda { ObjectSpace._id2ref(id) } rescue true).should == true
+    end
+  end
+
   it 'should run destructor before freeing object' do
     o = Object.new
     

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: free
 version: !ruby/object:Gem::Version 
+  hash: 29
   prerelease: false
   segments: 
   - 0
   - 2
-  - 0
-  version: 0.2.0
+  - 5
+  version: 0.2.5
 platform: ruby
 authors: 
 - John Mair (banisterfiend)
@@ -71,6 +72,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
@@ -79,6 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"