rext 0.4.1 → 0.5.0

data/History.rdoc

@@ -1,4 +1,15 @@
 
+0.5.0 / 2009-11-12
+==================
+
+  * Added Enumerable#take
+  * Added Enumerable#drop
+
+0.4.1 / 2009-11-10
+==================
+
+  * Fix Hash#to_query support both Rack's #build_query and #build_nested_query
+
 0.4.0 / 2009-11-10
 ==================
 

data/README.rdoc

@@ -101,6 +101,8 @@ Below are the methods currently provided by Rext.
   - group_by
   - includes_all?
   - every
+  - take
+  - drop
   
 * Symbol
   - to_proc

data/lib/rext/array/helpers.rb

@@ -4,17 +4,17 @@ require 'enumerator'
 class Array
   
   ##
-  # Return array of elements after +position+.
+  # Return array of elements after _index_.
 
-  def from position
-    self[position..-1]
+  def from index
+    self[index..-1]
   end
 
   ##
-  # Return array of elements up to +position+.
+  # Return array of elements up to _index_.
   
-  def to position
-    self[0..position]
+  def to index
+    self[0..index]
   end
   
   ##

data/lib/rext/enumerable/helpers.rb

@@ -85,4 +85,45 @@ module Enumerable
     args.all? { |arg| include? arg }
   end
   
+  ##
+  # Drop _n_ elements, returning the others.
+  # You may also pass a _block_ which acts as
+  # Enumerable#reject.
+  #
+  # === Examples
+  #
+  #  [1,2,3,4].drop                  # => [2,3,4]
+  #  [1,2,3,4].drop(2)               # => [3,4]
+  #  [1,2,3,4].drop(-2)              # => [1,2]
+  #  [1,2,3,4,5].drop { |n| n < 4 }  # => [4,5]
+  # 
+  
+  def drop n = 1, &block
+    case 
+    when block ; reject &block
+    when n < 0 ; self[0...n]
+    else         self[n..-1]
+    end
+  end
+  
+  ##
+  # Take _n_ elements, or pass a _block_ which
+  # acts as Enumerable#select.
+  #
+  # === Examples
+  #
+  #  [1,2,3,4].take              # => [1]
+  #  [1,2,3,4].take(2)           # => [1,2]
+  #  [1,2,3,4].take(-2)          # => [3,4]
+  #  [1,2,3,4].take { |n| == 1 } # => [1]
+  #
+  
+  def take n = 1, &block
+    case 
+    when block ; select &block
+    when n < 0 ; self[n..-1]
+    else         self[0...n]
+    end
+  end
+  
 end

data/lib/rext/version.rb

@@ -1,4 +1,4 @@
 
 module Rext
-  VERSION = '0.4.1'
+  VERSION = '0.5.0'
 end

data/rext.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rext}
-  s.version = "0.4.1"
+  s.version = "0.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["TJ Holowaychuk"]
-  s.date = %q{2009-11-10}
+  s.date = %q{2009-11-12}
   s.description = %q{Ruby extensions}
   s.email = %q{tj@vision-media.ca}
   s.extra_rdoc_files = ["README.rdoc", "lib/rext.rb", "lib/rext/all.rb", "lib/rext/array.rb", "lib/rext/array/helpers.rb", "lib/rext/date.rb", "lib/rext/date/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/hash.rb", "lib/rext/hash/helpers.rb", "lib/rext/integer.rb", "lib/rext/integer/helpers.rb", "lib/rext/module.rb", "lib/rext/module/helpers.rb", "lib/rext/numeric.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/object.rb", "lib/rext/object/helpers.rb", "lib/rext/object/metaclass.rb", "lib/rext/proc.rb", "lib/rext/proc/helpers.rb", "lib/rext/process.rb", "lib/rext/process/helpers.rb", "lib/rext/string.rb", "lib/rext/string/encode.rb", "lib/rext/string/helpers.rb", "lib/rext/symbol.rb", "lib/rext/symbol/helpers.rb", "lib/rext/time.rb", "lib/rext/time/helpers.rb", "lib/rext/version.rb", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]

data/spec/enumerable_spec.rb

@@ -15,6 +15,43 @@ describe Enumerable do
       end
     end
     
+    describe "#drop" do
+      it "should drop the first item" do
+        [1,2,3].drop.should == [2,3]  
+      end
+      
+      it "should drop the first n items" do
+        [1,2,3,4].drop(2).should == [3,4]
+      end
+      
+      it "should drop the last n items" do
+        [1,2,3,4].drop(-2).should == [1,2]
+      end
+      
+      it "should drop using a block" do
+        [1,2,3,4,5].drop { |n| n < 4 }.should == [4,5]
+      end
+    end
+    
+    describe "#take" do
+      it "should return the first item" do
+        [1,2,3].take.should == [1]
+      end
+      
+      it "should return the first n items" do
+        [1,2,3].take(2).should == [1,2]
+      end
+      
+      it "should return the last n items" do
+        [1,2,3,4].take(-3).should == [2,3,4]
+        [1,2,3,4].take(-1).should == [4]
+      end
+      
+      it "should return items using a block" do
+        [1,2,3].take { |n| n == 1 }.should == [1]
+      end
+    end
+    
     describe "#group_by" do
       before :each do
         @enum = 'foo', :bar, 1, 2, 3

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rext
 version: !ruby/object:Gem::Version 
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors: 
 - TJ Holowaychuk
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-10 00:00:00 -08:00
+date: 2009-11-12 00:00:00 -08:00
 default_executable: 
 dependencies: []