range_splitter 1.0.0 → 2.0.0

data/README.md

@@ -4,34 +4,45 @@ Splits a range into multiple ranges.
 
 ## Usage
 
-Splits are made as evenly as possible. The larger ranges are placed at the beginning of the array.
+Splits are made as evenly as possible. The larger ranges are placed at the beginning of the array unless the endianness is changed.
 
 ```ruby
+require 'range_splitter'
+
 (1..10).split
 #=> [1..5, 6..10]
 
 (1..9).split
 #=> [1..5, 6..9]
 
-(1..10).split(3)
+(1..9).split(:endianness => :little)
+#=> [1..4, 5..9]
+
+(1..10).split(:into => 3)
 #=> [1..4, 5..7, 8..10]
 
-(1..9).split(3)
+(1..9).split(:into => 3)
 #=> [1..3, 4..6, 7..9]
 
-(-5..5).split(5)
+(-5..5).split(:into => 5)
 #=> [-5..-3, -2..-1, 0..1, 2..3, 4..5]
 
-(1..3).split(100)
+(5..8).split(:into => 3, :endianness => :little)
+#=> [5..5, 6..6, 7..8]
+
+(1..3).split(:into => 100)
 #=> [1..1, 2..2, 3..3]
 
-(1..3).split(1)
+(1..1).split
+#=> [1..1]
+
+(1..3).split(:into => 1)
 #=> [1..3]
 
-(1..3).split(0)
+(1..3).split(:into => 0)
 # ArgumentError: Cannot split 1..3 into 0 ranges.
 
-(1..3).split(-3)
+(1..3).split(:into => -3)
 # ArgumentError: Cannot split 1..3 into -3 ranges.
 ```
 

data/lib/range_splitter.rb

@@ -1,9 +1,19 @@
 class Range
-  def split(into = 2)
+  def split(params = {})
+    into = params[:into] || 2
+    endianness = params[:endianness] || :big
+
+    unless [:big, :little].include?(endianness)
+      err = 'The endianness parameter must be either :big or :little'
+      raise ArgumentError.new(err)
+    end
+
     if into <= 0
       err = "Cannot split #{self} into #{into} ranges."
       raise ArgumentError.new(err)
-    elsif into == 1
+    end
+
+    if into == 1
       [self]
     else
       partition = min + (count.to_f / into).ceil - 1
@@ -11,8 +21,11 @@ class Range
       if max == partition
         [self]
       else
+        args = params.merge(:into => into - 1)
+        partition -= 1 if endianness == :little
+
         head = min..partition
-        tail = ((partition + 1)..max).split(into - 1)
+        tail = ((partition + 1)..max).split(args)
 
         [head] + tail
       end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: range_splitter
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 15
   prerelease: 
   segments: 
-  - 1
+  - 2
   - 0
   - 0
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors: 
 - Christopher Patuzzo
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-10-27 00:00:00 Z
+date: 2012-11-01 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec