assistance 0.1 → 0.1.1

data/CHANGELOG

@@ -1,3 +1,7 @@
+=== 0.1.1 (2008-01-18)
+
+* Added Array#extract_options! method.
+
 === 0.1 (2008-01-14)
 
 * First "official" release.

data/Rakefile

@@ -9,7 +9,7 @@ include FileUtils
 # Configuration
 ##############################################################################
 NAME = "assistance"
-VERS = "0.1"
+VERS = "0.1.1"
 CLEAN.include ["**/.*.sw?", "pkg/*", ".config", "doc/*", "coverage/*"]
 RDOC_OPTS = [
   "--quiet", 

data/lib/assistance/extract_options.rb

@@ -0,0 +1,14 @@
+# Array extensions
+class Array
+  # Removes and returns the last member of the array if it is a hash. Otherwise,
+  # an empty hash is returned This method is useful when writing methods that 
+  # take an options hash as the last parameter. For example:
+  #
+  #   def validate_each(*args, &block)
+  #     opts = args.extract_options!
+  #     ...
+  #   end
+  def extract_options!
+    last.is_a?(Hash) ? pop : {}
+  end
+end

data/lib/assistance.rb

@@ -5,4 +5,5 @@ dir = File.join(File.dirname(__FILE__), "assistance")
   connection_pool
   inflector
   blank
+  extract_options
 ].each {|f| require(File.join(dir, f))}

data/spec/extract_options.rb

@@ -0,0 +1,25 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe Array, "#extract_options!" do
+  specify "should return an empty hash for an empty array" do
+    [].extract_options!.should == {}
+  end
+  
+  specify "should remove the last member and return it only if it's a hash" do
+    a = [1, 2, 3]
+    a.extract_options!.should == {}
+    a.should == [1, 2, 3]
+
+    a = [1, {1 => 2}, 3]
+    a.extract_options!.should == {}
+    a.should == [1, {1 => 2}, 3]
+
+    a = [1, {1 => 2}]
+    a.extract_options!.should == {1 => 2}
+    a.should == [1]
+
+    a = [{1 => 2}]
+    a.extract_options!.should == {1 => 2}
+    a.should == []
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: assistance
 version: !ruby/object:Gem::Version 
-  version: "0.1"
+  version: 0.1.1
 platform: ruby
 authors: 
 - Ezra Zygmuntowicz, Sam Smoot, Sharon Rosner
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-01-14 00:00:00 +02:00
+date: 2008-01-18 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -30,6 +30,7 @@ files:
 - doc/rdoc
 - spec/blank_spec.rb
 - spec/connection_pool_spec.rb
+- spec/extract_options.rb
 - spec/inflector_spec.rb
 - spec/rcov.opts
 - spec/spec.opts
@@ -39,6 +40,7 @@ files:
 - lib/assistance/blank.rb
 - lib/assistance/connection_pool.rb
 - lib/assistance/core_ext.rb
+- lib/assistance/extract_options.rb
 - lib/assistance/inflections.rb
 - lib/assistance/inflector.rb
 - lib/assistance/time_calculations.rb