range_operators 0.0.1

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Manifest

@@ -0,0 +1,7 @@
+LICENSE
+Manifest
+README.rdoc
+Rakefile
+lib/range_operators.rb
+lib/rangify.rb
+spec/range_operators_spec.rb

data/README.rdoc

@@ -0,0 +1,27 @@
+= RangeOperators
+
+This gem will mixin range operations (addition and subtraction) into Ruby's Range class.
+
+It requires that the second operand have a '- (integer)' method defined (ie. Fixnum, Bignum, and Date).
+(This allows the determination of a previous/predecessor value of an object.)
+
+It assumes inclusive ranges (ie. 1..4) and range.first <= range.last.
+
+Values returned from the operations are in an array.
+
+= Usage
+
+The methods added are Range#- (alias Range#minus) and Range#+ (alias Range#plus).
+
+
+Examples:
+
+irb > require 'range_operators'
+
+irb > (1..10) - (4..6)  => [1..3, 7..10]
+
+irb > (1..10).minus(9..12)  => [1..8]
+
+irb > (1..10) + (9..12)  => [1..12]
+
+irb > (1..10).plus(15..20)  => [1..10, 15..20]

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('range_operators', '0.0.1') do |p|
+  p.description    = "A gem that adds addition and subtraction to Ruby's Range class."
+  p.url            = "http://github.com/monocle/range_operators"
+  p.author         = "monocle"
+  p.email          = "frappez_2000@yahoo.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+end

data/lib/range_operators.rb

@@ -0,0 +1,47 @@
+#Will add range operations ('+' and '-') to Ruby's Range class.
+#Requires that the second operand have a '- (integer)' method defined (ie. Fixnum, Bignum, and Date).
+#Assumes inclusive ranges (ie. 1..4) and range.first <= range.last.
+#Values returned from the operations are in an array.
+module RangeOperators
+	require 'rangify'
+	
+	def +(value)
+		[self, value].rangify
+	end
+
+	alias plus +
+	
+	def -(value)
+		if value.class == self.first.class
+			self.minus_obj(value)
+		else
+			[self.minus_obj(value.first)[0], self.minus_obj(value.last)[1]].compact
+		end
+	end
+	
+	alias minus -
+	
+	protected
+	
+	def minus_obj(value)
+		first = case value <=> self.first.succ
+			when -1 then nil
+			when 0 then self.first
+			else
+				value < self.last.succ ? self.first..(value - 1) : self
+		end
+
+		second = case self.last <=> value.succ
+			when -1 then nil
+			when 0 then self.last
+			else
+				value.succ > self.first ? value.succ..self.last : self
+		end
+
+		[first, second]
+	end
+end
+
+class Range
+	include RangeOperators
+end

data/lib/rangify.rb

@@ -0,0 +1,52 @@
+#= Rangify
+#
+#This gem will add the rangify method to Ruby's Array class.
+#The rangify method will produce appropriate ranges from the objects in the array.
+#
+#= Usage
+#
+#Examples:
+#
+#[1,2,3,6,7,8].rangify = [1..3, 6..8]
+#
+#[10..15, 16..20, 21, 22].rangify = [10..22]
+#
+#
+#Assumes inclusive ranges (ie. 1..4) and range.first <= range.last.
+#
+#Works with integers, dates and strings.  However, all the objects in the array must be of the same class.
+
+module Rangify
+	def rangify
+    array = self.uniq.sort_by { |element| comparison_value(element, :first) }
+    array.inject([]) do |collection, value|
+      unless collection.empty?
+        last = collection.last
+        last_value = comparison_value(last, :last)
+        current_value = comparison_value(value, :first)
+        if (last_value.succ <=> current_value) == -1
+          collection << value
+        else
+          first = [comparison_value(last, :first), comparison_value(value, :first)].min
+          second = [comparison_value(last, :last), comparison_value(value, :last)].max
+          collection[-1] = [first..second]
+          collection.flatten!
+        end
+      else
+        collection << value
+      end
+    end
+  end
+
+  private
+
+  # For a Range, will return value.first or value.last. A non-Range will return itself.  
+  def comparison_value(value, position)
+    return value if value.class != Range
+    position == :first ? value.first : value.last
+  end
+end
+
+class Array
+  include Rangify
+end

data/range_operators.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{range_operators}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["monocle"]
+  s.cert_chain = ["/ruby/keys/range_operators/gem-public_cert.pem"]
+  s.date = %q{2010-07-03}
+  s.description = %q{A gem that adds addition and subtraction to Ruby's Range class.}
+  s.email = %q{frappez_2000@yahoo.com}
+  s.extra_rdoc_files = ["LICENSE", "README.rdoc", "lib/range_operators.rb", "lib/rangify.rb"]
+  s.files = ["LICENSE", "Manifest", "README.rdoc", "Rakefile", "lib/range_operators.rb", "lib/rangify.rb", "spec/range_operators_spec.rb", "range_operators.gemspec"]
+  s.homepage = %q{http://github.com/monocle/range_operators}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Range_operators", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{range_operators}
+  s.rubygems_version = %q{1.3.6}
+  s.signing_key = %q{/ruby/keys/range_operators/gem-private_key.pem}
+  s.summary = %q{A gem that adds addition and subtraction to Ruby's Range class.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/range_operators_spec.rb

@@ -0,0 +1,180 @@
+require 'lib/range_operators'
+
+describe RangeOperators do
+	describe '#+' do
+		describe 'when given a range of integers' do
+			before :each do
+				@range = 1..10
+			end
+			
+			it '1..10 + 11  = [1..11]' do
+				(@range + 11).should == [1..11]
+			end
+			
+			it '1..10 + 12 = [1..10, 12]' do
+				(@range + 12).should == [1..10, 12]
+			end
+
+			it '1..10 + 10..12 = [1..12]' do
+				(@range + (10..12)).should == [1..12]
+			end
+
+			it '1..10 + 11..12 = [1..12]' do
+				(@range + (11..12)).should == [1..12]
+			end
+
+			it '1..10 + 9..12 = [1..12]' do
+				(@range + (9..12)).should == [1..12]
+			end
+
+			it '1..10 + 1..12 = [1..12]' do
+				(@range + (1..12)).should == [1..12]
+			end
+
+			it '1..10 + 12..20 = [1..10, 12..20]' do
+				(@range + (12..20)).should == [1..10, 12..20]
+			end
+
+			it '1..10 + 0 = [0..10]' do
+				(@range + 0).should == [0..10]
+			end
+
+			it '1..10 + -1 = [-1, 1..10]' do
+				(@range + -1).should == [-1, 1..10]
+			end			
+
+			it '1..10 + (-10..-1) = [-10..-1, 1..10]' do
+				(@range + (-10..-1)).should == [-10..-1, 1..10]
+			end		
+
+			it '1..10 + (-10..0) = [-10..10]' do
+				(@range + (-10..0)).should == [-10..10]
+			end		
+
+			it '1..10 + (-10..1) = [-10..10]' do
+				(@range + (-10..1)).should == [-10..10]
+			end		
+
+			it '1..10 + (-10..2) = [-10..10]' do
+				(@range + (-10..2)).should == [-10..10]
+			end		
+
+			it '1..10 + (-10..20) = [-10..20]' do
+				(@range + (-10..20)).should == [-10..20]
+			end		
+		end
+	end
+
+	describe '#-' do
+		describe 'when given a range of integers' do
+			before :each do
+				@range = 1..10 
+			end
+			
+			it 'should raise error if subtracting a non-integer' do
+				lambda{@range - 'a'}.should raise_error
+			end
+			
+			describe 'and subtracting an integer' do
+				it '(1..10) - 5 = [1..4, 6..10]' do
+					(@range - 5).should == [1..4, 6..10]
+				end
+
+				it '(1..10) - 2 = [1, 3..10]' do
+					(@range - 2).should == [1, 3..10]
+				end
+
+				it '(1..10)- 9 = [1..8, 10]' do
+					(@range - 9).should == [1..8, 10]
+				end
+
+				it '(1..10) - 10 = [1..9, nil]' do
+					(@range - 10).should == [1..9, nil]
+				end
+
+				it '(1..10) - 1 = [nil, 2..10]' do
+					(@range - 1).should == [nil, 2..10]
+				end
+
+				it '(1..10) - 11 = [1..10, nil]' do
+					(@range - 11).should == [1..10, nil]
+				end
+
+				it '(1..10) - 12 = [1..10, nil]' do
+					(@range - 12).should == [1..10, nil]
+				end
+
+				it '(1..10) - 0 = [nil, 1..10]' do
+					(@range - 0).should == [nil, 1..10]
+				end
+
+				it '(1..10) - -1 = [nil, 1..10]' do
+					(@range - -1).should == [nil, 1..10]
+				end
+			end
+		
+			describe 'and subtracting another range' do
+
+				it '1..10 - 4..6 = [1..3, 7..10]' do
+					(@range - (4..6)).should == [1..3, 7..10]
+				end
+
+				it '1..10 - 2..6 = [1, 7..10]' do
+					(@range - (2..6)).should == [1, 7..10]
+				end
+
+				it '1..10 - 4..9 = [1..3, 10]' do
+					(@range - (4..9)).should == [1..3, 10]
+				end
+
+				it '1..10 - 2..9 = [1, 10]' do
+					(@range - (2..9)).should == [1, 10]
+				end
+
+				it '1..10 - 2..11 = [1]' do
+					(@range - (2..11)).should == [1]
+				end
+
+				it '1..10 - 0..9 = [10]' do
+					(@range - (0..9)).should == [10]
+				end
+				
+				it '1..10 - 4..10 = [1..3]' do
+					(@range - (4..10)).should == [1..3]
+				end
+
+				it '1..10 - 4..12 = [1..3]' do
+					(@range - (4..12)).should == [1..3]
+				end
+
+				it '1..10 - 1..6 = [7..10]' do
+					(@range - (1..6)).should == [7..10]
+				end
+
+				it '1..10 - (-2..6) = [7..10]' do
+					(@range - (-2..6)).should == [7..10]
+				end
+
+				it '1..10 - 11..20 = [1..10]' do
+					(@range - (11..20)).should == [1..10]
+				end
+
+				it '1..10 - (-10..0) = [1..10]' do
+					(@range - (-10..0)).should == [1..10]
+				end
+
+				it '1..10 - (-10..20) = []' do
+					(@range - (-10..20)).should == []
+				end
+			end
+		end
+	end
+	
+	it '#minus is an alias of #-' do
+		RangeOperators.instance_method(:minus).should == RangeOperators.instance_method(:-)
+	end
+
+	it '#plus is an alias of #+' do
+		RangeOperators.instance_method(:plus).should == RangeOperators.instance_method(:+)
+	end
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: range_operators
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- monocle
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDOjCCAiKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxmcmFw
+  cGV6XzIwMDAxFTATBgoJkiaJk/IsZAEZFgV5YWhvbzETMBEGCgmSJomT8ixkARkW
+  A2NvbTAeFw0xMDA3MDQwMzE1NDlaFw0xMTA3MDQwMzE1NDlaMEMxFTATBgNVBAMM
+  DGZyYXBwZXpfMjAwMDEVMBMGCgmSJomT8ixkARkWBXlhaG9vMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvItTt36D
+  sudZebh5I4GSDLEU+eWS2rUP4K8M86AQiwu/39Uro7ZxFbreHIkFrZskLloT+yo9
+  pJS9ng8BKttTjL8OOkX/29Fi258hOJ/Y1LT/Lc+M1LT1n4GqQClZzlYeAlLlVDrr
+  fG4TiA0uZUXI4YDBhPWcfUsQierGcW62PpU2h3iH/b8I7+vxV+YU2NIkBe9QsNm6
+  U3Qini4ASAn9/B/OQkW41BdywXq9uHLRzGFwoxR9zUAgKYOn3i0qUAWWTSoDdR1C
+  GrmY/rNIM5skCFFSDWp9a7Uc0abHeb4FBhSAkpOud4+007MyXbt6tar/kNzhE/I7
+  buUX5u9ZCvjSywIDAQABozkwNzAJBgNVHRMEAjAAMB0GA1UdDgQWBBTFXNz226Hp
+  rqbDtxebnFGqSwgIqTALBgNVHQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQADggEBADVg
+  ROLUTcNYRy9B5qCgZCKr3NnkKXSCmbQyG3T+9Iy5t7KcaDVQOkuuUpMi62j4Slor
+  Wa6zqcUThZvrs84nbnsrGtQhLzGYFBp3D/3teeXHmXTq8Xwes0kbUi7JtAE2Z1IK
+  98N4/kUg8qN+UQXdO7rODfD4tupYj9IzHOyYIrNgQxgEmzEGfAKE1qzAMgmTHOGz
+  M6J99Rayo0SoYJCoRCi4aX1dpZnEzfT1RGc2IlkCWdzWkcLvJFBSKtDdjnpG/9SB
+  GEIH3y7N759WvBM49n8gsO+yclEacYeJlyaEg1Z+hhmYPykUpDXzb39Vd7kbWmkp
+  lTblHT4UBS6VZYs6PY8=
+  -----END CERTIFICATE-----
+
+date: 2010-07-03 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: A gem that adds addition and subtraction to Ruby's Range class.
+email: frappez_2000@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+- lib/range_operators.rb
+- lib/rangify.rb
+files: 
+- LICENSE
+- Manifest
+- README.rdoc
+- Rakefile
+- lib/range_operators.rb
+- lib/rangify.rb
+- spec/range_operators_spec.rb
+- range_operators.gemspec
+has_rdoc: true
+homepage: http://github.com/monocle/range_operators
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Range_operators
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: range_operators
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A gem that adds addition and subtraction to Ruby's Range class.
+test_files: []
+