ranges_merger 0.2.0 → 0.3.0

data/README.rdoc

@@ -2,6 +2,8 @@
 
 Very simple gem for merging range-like objects.
 
+
+
 == How to use, simple merge
 
 If you want to merge please use code just like below.
@@ -16,6 +18,8 @@ If you want to merge please use code just like below.
 
  # result => [[1, 6]]
 
+
+
 == Range objects
 
 If you want to merge Range objects.
@@ -34,6 +38,8 @@ If you want to merge Range objects.
 
  # result => [(1..3),(5..8)]
 
+
+
 == Exclusion
 
 If you want to exclude please use code just like below.
@@ -58,6 +64,8 @@ And run some processing
 
  # result => [[1, 2], [10, 11]]
 
+
+
 == I want an instance
 
 If you want to have instance, add and remove ranges as you wish just do something like that:
@@ -77,6 +85,54 @@ If you want to have instance, add and remove ranges as you wish just do somethin
  # r.to_array => [[1, 2], [4,11], [12,15]]
 
 
+
+== Dividing
+
+Then you have range you may divide it to small pieced with proper interval. You can divide it with 'partials' - smaller
+parts than interval, or without them.
+
+ r = RangesMerger.new
+
+ r += [[1, 9]]
+
+ result = r % 3
+
+ # result => [[1, 4], [4, 7]]
+
+ result = r / 3
+
+ # result => [[1, 4], [4, 7], [7, 9]]
+
+
+
+== Ranges are not only numbers
+
+They can be made from all objects which can be compared, and has simple math. operation like sum. For example - Time
+object.
+
+ t_now = Time.now
+
+ r = RangesMerger.new
+
+ r += [[t_now - 2*3600, t_now - 0*3600]]
+ r += [[t_now - 3*3600, t_now - 1.3600]]
+
+ result = r.to_array
+
+ # try by yourself or read spec :]
+
+ r -= [[t_now - 2*3600, t_now - 1*3600]]
+
+ result = r.to_array
+
+ # try by yourself or read spec :]
+
+ result = r / (10*60)
+
+ # try by yourself or read spec :]
+
+
+
 == Contributing to ranges_merger
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/lib/ranges_merger.rb

@@ -1,11 +1,13 @@
 require 'ranges_merger/ranges_merger_merging'
 require 'ranges_merger/ranges_merger_utils'
 require 'ranges_merger/ranges_merger_exclusion'
+require 'ranges_merger/ranges_merger_divider'
 
 class RangesMerger
   extend RangesMergerMerging
   extend RangesMergerUtils
   extend RangesMergerExclusion
+  extend RangesMergerDivider
 
   attr_reader :ranges
 
@@ -33,6 +35,18 @@ class RangesMerger
     remove(_array)
   end
 
+  def divide(interval, allow_partials = true)
+    return self.class.divide(@ranges, interval, allow_partials)
+  end
+
+  def /(interval)
+    divide(interval, true)
+  end
+
+  def %(interval)
+    divide(interval, false)
+  end
+
   def to_ranges
     self.class.array_to_ranges(@ranges)
   end

data/lib/ranges_merger/ranges_merger_divider.rb

@@ -0,0 +1,31 @@
+module RangesMergerDivider
+  # Divide not merged array
+  def divide(_array, interval, allow_partials = true)
+    divided_array = Array.new
+    joined_array = merge(_array)
+
+    joined_array.each do |r|
+      r_from = r[0]
+      r_to = r[1]
+      r_now = r_from
+
+      while r_now <= r_to
+        new_r_from = r_now
+        new_r_to = new_r_from + interval
+
+        if allow_partials and new_r_to > r_to and new_r_from < r_to
+          new_r_to = r_to
+        end
+
+        divided_array << [new_r_from, new_r_to] if new_r_to <= r_to
+        r_now += interval
+      end
+
+
+
+    end
+
+    return divided_array
+
+  end
+end

data/ranges_merger.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "ranges_merger"
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Aleksander Kwiatkowski"]
-  s.date = "2011-12-06"
+  s.date = "2011-12-08"
   s.description = "Simple gem used for merging range-like objects. If you have problems with operations on ranges this gem can save you some time."
   s.email = "bobikx@poczta.fm"
   s.extra_rdoc_files = [
@@ -27,6 +27,7 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "lib/ranges_merger.rb",
+    "lib/ranges_merger/ranges_merger_divider.rb",
     "lib/ranges_merger/ranges_merger_exclusion.rb",
     "lib/ranges_merger/ranges_merger_merging.rb",
     "lib/ranges_merger/ranges_merger_utils.rb",

data/spec/ranges_merger_spec.rb

@@ -278,4 +278,73 @@ describe "RangesMerger" do
     r.to_array.should == [[-2, 3], [5, 20], [30, 50]]
   end
 
+  # Dividing
+
+  it "should divide simple range" do
+    r = RangesMerger.new
+    r += [[10, 50]]
+    #result = r.divide(5)
+    result = r / 5
+    result.should == [[10, 15], [15, 20], [20, 25], [25, 30], [30, 35], [35, 40], [40, 45], [45, 50]]
+
+    result = r % 5
+    result.should == [[10, 15], [15, 20], [20, 25], [25, 30], [30, 35], [35, 40], [40, 45], [45, 50]]
+  end
+
+  it "should divide simple range with partials and without" do
+    r = RangesMerger.new
+    r += [[1, 9]]
+    result = r % 3
+    result.should == [[1, 4], [4, 7]]
+    result = r / 3
+    result.should == [[1, 4], [4, 7], [7, 9]]
+  end
+
+  it "should divide simple range with partials and without" do
+    r = RangesMerger.new
+    r += [[1, 2], [3, 5], [6, 9]]
+    result = r % 2
+    result.should == [[3, 5], [6, 8]]
+    result = r / 2
+    result.should == [[1, 2], [3, 5], [6, 8], [8, 9]]
+  end
+
+  it "should merge Time ranges" do
+    t_now = Time.now
+
+    r = RangesMerger.new
+    r += [[t_now - 2*3600, t_now - 0*3600]]
+    r += [[t_now - 3*3600, t_now - 1.3600]]
+
+    result = r.to_array
+    (result[0][1] - result[0][0]).should == 3*3600
+
+    r -= [[t_now - 2*3600, t_now - 1*3600]]
+
+    result = r.to_array
+    result.should == [
+      [t_now - 3*3600, t_now - 2*3600],
+      [t_now - 1*3600, t_now - 0*3600]
+    ]
+
+    result = r / (10*60)
+    result.size.should == 12
+    (result.first[1] - result.first[0]).should == 10*60
+  end
+
+  it "should divide simple Time ranges" do
+    t_now = Time.now
+    r = RangesMerger.new
+    r += [[t_now - 1*3600, t_now - 1*3600 + 45*60]]
+
+    result = r / (10*60)
+    result.size.should == 5
+    (result.last[1] - result.last[0]).should == 5*60
+
+    result = r % (10*60)
+    result.size.should == 4
+    (result.last[1] - result.last[0]).should == 10*60
+  end
+
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ranges_merger
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-06 00:00:00.000000000Z
+date: 2011-12-08 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &83398430 !ruby/object:Gem::Requirement
+  requirement: &90032930 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 2.3.0
   type: :development
   prerelease: false
-  version_requirements: *83398430
+  version_requirements: *90032930
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &83398180 !ruby/object:Gem::Requirement
+  requirement: &90032640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *83398180
+  version_requirements: *90032640
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &83397940 !ruby/object:Gem::Requirement
+  requirement: &90032340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *83397940
+  version_requirements: *90032340
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &83333790 !ruby/object:Gem::Requirement
+  requirement: &90032040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *83333790
+  version_requirements: *90032040
 description: Simple gem used for merging range-like objects. If you have problems
   with operations on ranges this gem can save you some time.
 email: bobikx@poczta.fm
@@ -74,6 +74,7 @@ files:
 - Rakefile
 - VERSION
 - lib/ranges_merger.rb
+- lib/ranges_merger/ranges_merger_divider.rb
 - lib/ranges_merger/ranges_merger_exclusion.rb
 - lib/ranges_merger/ranges_merger_merging.rb
 - lib/ranges_merger/ranges_merger_utils.rb
@@ -95,7 +96,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -671424623
+      hash: 29790049
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: