slotter 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Bjarki Gudlaugsson
+
+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/README.rdoc

@@ -0,0 +1,39 @@
+= Slotter
+
+Create and manipulate time slots simply and easily. The gem allows you to perform operations like addition, subtraction and splitting on time slots. Time slots are immutable.
+
+== Installation
+
+  sudo gem install slotter --source http://gemcutter.org
+
+== Examples
+
+  a = TimeSlot.new(Chronic.parse("today 10:00"), Chronic.parse("today 11:00"))
+  b = TimeSlot.new(Chronic.parse("today 10:00"), Chronic.parse("today 12:00"))
+  c = TimeSlot.new(Chronic.parse("today 11:00"), Chronic.parse("today 12:00"))
+  
+=== Concatenating
+  
+  a + b #=> [#<TimeSlot:0x1018f90b0 @finish=Sun Nov 01 12:00:00 +0000 2009, 
+            @start=Sun Nov 01 10:00:00 +0000 2009>]
+  a + c #=> [#<TimeSlot:0x1018df890 @finish=Sun Nov 01 12:00:00 +0000 2009, 
+            @start=Sun Nov 01 10:00:00 +0000 2009>]
+  
+=== Subtracting
+  
+  b - a #=> [#<TimeSlot:0x1018d91c0 @finish=Sun Nov 01 12:00:00 +0000 2009, 
+            @start=Sun Nov 01 11:00:00 +0000 2009>]
+  b - c #=> [#<TimeSlot:0x1018dc528 @finish=Sun Nov 01 11:00:00 +0000 2009, 
+            @start=Sun Nov 01 10:00:00 +0000 2009>]
+  
+=== Splitting
+  
+  b.split(3600) #=> 
+            [#<TimeSlot:0x1018d57f0 @finish=Sun Nov 01 11:00:00 +0000 2009, 
+            @start=Sun Nov 01 10:00:00 +0000 2009>, 
+            #<TimeSlot:0x1018d5728 @finish=Sun Nov 01 12:00:00 +0000 2009,        
+            @start=Sun Nov 01 11:00:00 +0000 2009>]
+
+== Copyright
+
+Copyright (c) 2009 Bjarki Gudlaugsson. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "slotter"
+    gem.summary = %Q{create and manipulate time slots simply and easily}
+    gem.description = %Q{the gem allows you to perform operations like addition, subtraction and splitting on time slots}
+    gem.email = "bjarkigud@gmail.com"
+    gem.homepage = "http://github.com/bjarkigud/slotter"
+    gem.authors = ["Bjarki Gudlaugsson"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_development_dependency "chronic", ">= 0.2.3"
+    gem.add_development_dependency "cucumber", ">= 0.4.2"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:cucumber)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "slotter #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/features/case_subtraction.txt

@@ -0,0 +1,91 @@
+##############################
+# Case 1
+# +-----+   +-----+
+# |  A  | - |  B  | => nil
+# +-----+   +-----+
+##############################
+# Case 2
+# +-----+   +-----+
+# |  A  |   |     |
+# +-----+ - |  B  | => nil
+#           |     |
+#           +-----+
+##############################
+# Case 3
+#           +-----+ 
+# +-----+   |     |
+# |  A  | - |  B  | => nil
+# +-----+   |     |
+#           +-----+
+##############################
+# Case 4
+# +-----+              +-----+ A.start
+# |  A  |              |  C  |
+# +-----+ - +-----+ => +-----+ A.finish
+#           |  B  |
+#           +-----+
+##############################
+# Case 5
+#           +-----+
+#           |  B  |
+# +-----+ - +-----+ => +-----+ A.start
+# |  A  |              |  C  |
+# +-----+              +-----+ A.finish
+##############################
+# Case 6
+# +-----+              +-----+ A.start
+# |  A  |              |  C  |
+# +-----+              +-----+ A.finish
+#         -         => 
+#           +-----+
+#           |  B  |
+#           +-----+
+##############################
+# Case 7
+#           +-----+
+#           |  B  |
+#           +-----+
+#         -         =>
+# +-----+              +-----+ A.start
+# |  A  |              |  C  |
+# +-----+              +-----+ A.finish
+##############################
+# Case 8
+# +-----+   +-----+
+# |     |   |  B  |
+# |  A  | - +-----+ => +-----+ B.finish
+# |     |              |  C  |
+# +-----+              +-----+ A.finish
+##############################
+# Case 9
+# +-----+              +-----+ A.start
+# |     |              |  C  |
+# |  A  | - +-----+ => +-----+ B.start
+# |     |   |  B  |
+# +-----+   +-----+
+##############################
+# Case 10
+# +-----+              +-----+ A.start
+# |     |              |  C  |
+# |     |   +-----+    +-----+ B.start
+# |  A  | - |  B  | =>
+# |     |   +-----+    +-----+ B.finish
+# |     |              |  C  |
+# +-----+              +-----+ A.finish
+##############################
+# Case 11
+# +-----+              +-----+ A.start
+# |     |              |     |
+# |  A  |              |  C  |
+# |     | - +-----+ => +-----+ B.start
+# +-----+   |  B  |
+#           +-----+
+##############################
+# Case 12
+#           +-----+
+# +-----+   |  B  |
+# |     | - +-----+ => +-----+ B.finish
+# |  A  |              |  C  |
+# |     |              |     |
+# +-----+              +-----+ A.finish
+##############################

data/features/cases_addition.txt

@@ -0,0 +1,91 @@
+##############################
+# Case 1
+# +-----+   +-----+    +-----+ A.start
+# |  A  | + |  B  | => |  C  |
+# +-----+   +-----+    +-----+ A.finish
+##############################
+# Case 2
+# +-----+   +-----+    +-----+ B.start
+# |  A  |   |     |    |     |
+# +-----+ + |  B  | => |  C  |
+#           |     |    |     |
+#           +-----+    +-----+ B.finish
+##############################
+# Case 3
+#           +-----+    +-----+ B.start
+# +-----+   |     |    |     |
+# |  A  | + |  B  | => |  C  |
+# +-----+   |     |    |     |
+#           +-----+    +-----+ B.finish
+##############################
+# Case 4
+# +-----+              +-----+ A.start
+# |  A  |              |     |
+# +-----+ + +-----+ => |  C  |
+#           |  B  |    |     |
+#           +-----+    +-----+ B.finish
+##############################
+# Case 5
+#           +-----+    +-----+ B.start
+#           |  B  |    |     |
+# +-----+ + +-----+ => |  C  |
+# |  A  |              |     |
+# +-----+              +-----+ A.finish
+##############################
+# Case 6
+# +-----+              +-----+ A.start
+# |  A  |              |  C  |
+# +-----+              +-----+ A.finish
+#         +         => 
+#           +-----+    +-----+ B.start
+#           |  B  |    |  C  |
+#           +-----+    +-----+ B.finish
+##############################
+# Case 7
+#           +-----+    +-----+ B.start
+#           |  B  |    |  C  |
+#           +-----+    +-----+ B.finish
+#         +         =>
+# +-----+              +-----+ A.start
+# |  A  |              |  C  |
+# +-----+              +-----+ A.finish
+##############################
+# Case 8
+# +-----+   +-----+    +-----+ A.start
+# |     |   |  B  |    |     |
+# |  A  | + +-----+ => |  C  |
+# |     |              |     |
+# +-----+              +-----+ A.finish
+##############################
+# Case 9
+# +-----+              +-----+ A.start
+# |     |              |     |
+# |  A  | + +-----+ => |  C  |
+# |     |   |  B  |    |     |
+# +-----+   +-----+    +-----+ A.finish
+##############################
+# Case 10
+# +-----+              +-----+ A.start
+# |     |              |     |
+# |     |   +-----+    |     |
+# |  A  | + |  B  | => |  C  |
+# |     |   +-----+    |     | 
+# |     |              |     |
+# +-----+              +-----+ A.finish
+##############################
+# Case 11
+# +-----+              +-----+ A.start
+# |     |              |     |
+# |  A  |              |     |
+# |     | + +-----+ => |  C  |
+# +-----+   |  B  |    |     |
+#           +-----+    +-----+ B.finish
+##############################
+# Case 12
+#           +-----+    +-----+ B.start
+# +-----+   |  B  |    |     |
+# |     | + +-----+ => |  C  |
+# |  A  |              |     |
+# |     |              |     |
+# +-----+              +-----+ A.finish
+##############################

data/features/step_definitions/time_slot_definitions.rb

@@ -0,0 +1,48 @@
+Given /^I have a time slot "([^\"]*)" between "([^\"]*)" and "([^\"]*)"$/ do |name, start, finish|
+  @time_slots ||= {}
+  @time_slots[name] = TimeSlot.new(Chronic.parse("today " + start), Chronic.parse("today " + finish))
+end
+
+When /^I subtract time slot "([^\"]*)" from time slot "([^\"]*)"$/ do |a, b|
+  @result = @time_slots[b] - @time_slots[a]
+end
+
+When /^I add time slot "([^\"]*)" to time slot "([^\"]*)"$/ do |a, b|
+  @result = @time_slots[b] + @time_slots[a]
+end
+
+When /^I split time slot "([^\"]*)" into ([0-9]+) second slots$/ do |name, duration|
+  @result = @time_slots[name].split(duration.to_i)
+end
+
+Then /^I should have a time slot between "([^\"]*)" and "([^\"]*)"$/ do |start, finish|
+  @result.start.should == Chronic.parse(start)
+  @result.finish.should == Chronic.parse(finish)
+end
+
+Then /^I should have an array of ([0-9]+) time slots$/ do |size|
+  @result.is_a?(Array).should == true
+  @result.length.should == size.to_i
+  for slot in @result
+    slot.is_a?(TimeSlot).should == true
+  end
+end
+
+Then /^one should be between "([^\"]*)" and "([^\"]*)"$/ do |start, finish|
+  found = false
+  for slot in @result
+    if slot.start == Chronic.parse("today " + start) and 
+       slot.finish == Chronic.parse("today " + finish)
+       found = true
+     end
+  end
+  found.should == true
+end
+
+Then /^I should have nil as a result$/ do
+  @result.should == nil
+end
+
+Then /^the array should be empty$/ do
+  @result.should be_empty
+end

data/features/support/env.rb

@@ -0,0 +1,5 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'spec/expectations'
+require 'rubygems'
+require 'chronic'
+require 'slotter'

data/features/time_slot_addition.feature

@@ -0,0 +1,103 @@
+Feature: Time slot addition
+  In order to simplify creating applications based around time slots
+  As a developer
+  I want to be able to concatenate time slots through code
+  
+  # Case 1
+  Scenario: Add a time slot to another where they are equal
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    Then one should be between "10:00" and "11:00"
+  
+  # Case 2
+  Scenario: Add A.start == B.start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "10:00" and "12:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    Then one should be between "10:00" and "12:00"
+  
+  # Case 3
+  Scenario: Add A.start > B.start and A.finish < B.finish
+    Given I have a time slot "A" between "11:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "13:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    Then one should be between "10:00" and "13:00"
+  
+  # Case 4
+  Scenario: Add A.finish == B.start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    Then one should be between "10:00" and "12:00"
+  
+  # Case 5
+  Scenario: Add A.start == B.finish
+    Given I have a time slot "A" between "11:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    Then one should be between "10:00" and "12:00"
+  
+  # Case 6
+  Scenario: Add non-intersecting A.finish < B.start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "12:00" and "13:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+    And one should be between "12:00" and "13:00"
+  
+  # Case 7
+  Scenario: Add non-intersecting A.start > B.finish
+    Given I have a time slot "A" between "12:00" and "13:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 2 time slots
+    And one should be between "10:00" and "11:00"
+    And one should be between "12:00" and "13:00"
+  
+  # Case 8
+  Scenario: Add A.start == B.start and A.finish > B.finish
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "12:00"
+  
+  # Case 9
+  Scenario: Add A.start < B.start and A.finish == B.finish
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "12:00"
+  
+  # Case 10
+  Scenario: Add A.start < B.start and A.finish > B.finish
+    Given I have a time slot "A" between "10:00" and "13:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "13:00"
+  
+  # Case 11
+  Scenario: Add a half intersecting time slot (A.finish < B.finish)
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "11:00" and "13:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "13:00"
+  
+  # Case 12
+  Scenario: Add a half intersecting time slot (A.start > B.start)
+    Given I have a time slot "A" between "11:00" and "13:00"
+    And I have a time slot "B" between "10:00" and "12:00"
+    When I add time slot "B" to time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "13:00"
+  

data/features/time_slot_intersection.feature

@@ -0,0 +1,5 @@
+Feature: Time slot intersection
+  In order to do correct time slot calculations
+  As a developer
+  I want to be able to identify time slot intersections through code
+  

data/features/time_slot_split.feature

@@ -0,0 +1,32 @@
+Feature: Time slot split
+  In order to do correct time slot calculations
+  As a developer
+  I want to be able to split time slots through code
+
+  Scenario: Split a 1 hour time slot into 1 hour time slots
+    Given I have a time slot "A" between "10:00" and "11:00"
+    When I split time slot "A" into 3600 second slots
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+  
+  Scenario: Split a 3 hour time slot into 1 hour time slots
+    Given I have a time slot "A" between "10:00" and "13:00"
+    When I split time slot "A" into 3600 second slots
+    Then I should have an array of 3 time slots
+    And one should be between "10:00" and "11:00"
+    And one should be between "11:00" and "12:00"
+    And one should be between "12:00" and "13:00"
+  
+  Scenario: Split a 2 hour and 45 minute time slot into 1 hour time slots
+    Given I have a time slot "A" between "10:00" and "12:45"
+    When I split time slot "A" into 3600 second slots
+    Then I should have an array of 3 time slots
+    And one should be between "10:00" and "11:00"
+    And one should be between "11:00" and "12:00"
+    And one should be between "12:00" and "12:45"
+  
+  Scenario: Split a 30 minute slot into 1 hour time slots
+    Given I have a time slot "A" between "10:00" and "10:30"
+    When I split time slot "A" into 3600 second slots
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "10:30"

data/features/time_slot_subtraction.feature

@@ -0,0 +1,99 @@
+Feature: Time slot subtraction
+  In order to simplify creating applications based around time slots
+  As a developer
+  I want to be able to subtract time slots through code
+  
+  # Case 1
+  Scenario: Subtract a time slot from another where they are equal
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 0 time slots
+  
+  # Case 2
+  Scenario: Subtract a large time slot from a small time slot with equal start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "10:00" and "12:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 0 time slots
+  
+  # Case 3
+  Scenario: Subtract a bigger time slot from a smaller
+    Given I have a time slot "A" between "11:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "13:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 0 time slots
+  
+  # Case 4
+  Scenario: Subtract non-intersecting A.finish == B.start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+  
+  # Case 5
+  Scenario: Subtract non-intersecting A.start == B.finish
+    Given I have a time slot "A" between "11:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "11:00" and "12:00"
+  
+  # Case 6
+  Scenario: Subtract non-intersecting A.finish < B.start
+    Given I have a time slot "A" between "10:00" and "11:00"
+    And I have a time slot "B" between "12:00" and "13:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+  
+  # Case 7
+  Scenario: Subtract non-intersecting A.start > B.finish
+    Given I have a time slot "A" between "12:00" and "13:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "12:00" and "13:00"
+  
+  # Case 8
+  Scenario: Subtract a small time slot from a bit time slot when start is equal
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "10:00" and "11:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "11:00" and "12:00"
+  
+  # Case 9
+  Scenario: Subtract a small time slot from a big time slot when finish is equal
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+  
+  # Case 10
+  Scenario: Subtract a contained time slot
+    Given I have a time slot "A" between "10:00" and "13:00"
+    And I have a time slot "B" between "11:00" and "12:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 2 time slots
+    And one should be between "10:00" and "11:00"
+    And one should be between "12:00" and "13:00"
+  
+  # Case 11
+  Scenario: Subtract a half intersecting time slot (A.finish < B.finish)
+    Given I have a time slot "A" between "10:00" and "12:00"
+    And I have a time slot "B" between "11:00" and "13:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "10:00" and "11:00"
+  
+  # Case 12
+  Scenario: Subtract a half intersecting time slot (A.start > B.start)
+    Given I have a time slot "A" between "11:00" and "13:00"
+    And I have a time slot "B" between "10:00" and "12:00"
+    When I subtract time slot "B" from time slot "A"
+    Then I should have an array of 1 time slots
+    And one should be between "12:00" and "13:00"
+  

data/lib/slotter/time_slot.rb

@@ -0,0 +1,154 @@
+# A TimeSlot object holds the start date and finish date of a period in time
+class TimeSlot
+  include Comparable
+  attr_reader :start, :finish
+  
+  def initialize(start, finish)
+    @start = start
+    @finish = finish
+  end
+  
+  # Returns the difference between start and finish of the TimeSlot in seconds
+  def duration
+    (self.finish - self.start)
+  end
+  
+  # Subtraction---Returns a set of new TimeSlot(s) that are the result of 
+  # removing the other_slot from this slot.
+  def -(other_slot)
+    # Case 1, Case 2 or Case 3
+    if (self.start == other_slot.start and self.finish == other_slot.finish) or
+       (self.start == other_slot.start and self.finish < other_slot.finish) or
+       (self.start > other_slot.start and self.finish < other_slot.finish)
+      return []
+    end
+    # Case 4, Case 5, Case 6 or Case 7
+    if (self.finish == other_slot.start) or
+       (self.start == other_slot.finish) or
+       (self.finish < other_slot.start) or
+       (self.start > other_slot.finish)
+      return [self.clone]
+    end
+    # Case 8
+    if self.start == other_slot.start and self.finish > other_slot.finish
+      return [TimeSlot.new(other_slot.finish, self.finish)]
+    end
+    # Case 9 or Case 11
+    if (self.start < other_slot.start and self.finish == other_slot.finish) or
+       (self.start < other_slot.start and self.finish < other_slot.finish and self.finish > other_slot.start)
+      return [TimeSlot.new(self.start, other_slot.start)]
+    end
+    # Case 10
+    if self.start < other_slot.start and self.finish > other_slot.finish
+      return [TimeSlot.new(self.start, other_slot.start),
+              TimeSlot.new(other_slot.finish, self.finish)]
+    end
+    # Case 12
+    if self.start > other_slot.start and self.finish > other_slot.finish and self.start < other_slot.finish
+      return [TimeSlot.new(other_slot.finish, self.finish)]
+    end
+  end
+  
+  # Concatenation---Returns a set of new TimeSlot(s) that are the result of
+  # concatenating the other_slot to this slot.
+  def +(other_slot)
+    # Case 1
+    if self.start == other_slot.start and self.finish == other_slot.finish
+      return [self.clone]
+    end
+    # Case 2 or Case 3
+    if (self.start == other_slot.start and self.finish < other_slot.finish) or
+       (self.start > other_slot.start and self.finish < other_slot.finish)
+      return [other_slot.clone]
+    end
+    # Case 4
+    if self.finish == other_slot.start
+      return [TimeSlot.new(self.start, other_slot.finish)]
+    end
+    # Case 5
+    if self.start == other_slot.finish
+      return [TimeSlot.new(other_slot.start, self.finish)]
+    end
+    # Case 6 or Case 7
+    if (self.finish < other_slot.start) or
+       (self.start > other_slot.finish)
+      return [self.clone, other_slot.clone].sort!
+    end
+    # Case 8, Case 9 or Case 10
+    if (self.start == other_slot.start and self.finish > other_slot.finish) or
+       (self.start < other_slot.start and self.finish == other_slot.finish) or
+       (self.start < other_slot.start and self.finish > other_slot.finish)
+      return [self.clone]
+    end
+    # Case 11
+    if self.start < other_slot.start and self.finish < other_slot.finish and self.finish > other_slot.start
+      return [TimeSlot.new(self.start, other_slot.finish)]
+    end
+    # Case 12
+    if self.start > other_slot.start and self.finish > other_slot.finish and self.start < other_slot.finish
+      return [TimeSlot.new(other_slot.start, self.finish)]
+    end
+  end
+  
+  # Equality---Two time slots are equal if they have the same start and finish
+  def ==(other_slot)
+    (self.start == other_slot.start and self.finish == other_slot.finish)
+  end
+    
+  # Comparison---Returns an integer (-1, 0,
+  # or +1) if this time slot is less than, equal to, or greater than
+  # other_slot. First we compare the start of both slots and if they are equal
+  # then we compare the finish of both slots. Thus, two arrays are ``equal''
+  # according to <code>TimeSlot#<=></code> if an only if they have the same
+  # start and finish.
+  #
+  #   today_at_nine = Chronic.parse("today 09:00")
+  #   today_at_ten = Chronic.parse("today 10:00")
+  #   today_at_eleven = Chronic.parse("today 11:00")
+  #
+  #   a = TimeSlot.new(today_at_nine, today_at_ten)
+  #   b = TimeSlot.new(today_at_ten, today_at_eleven)
+  #   c = TimeSlot.new(today_at_nine, today_at_eleven)
+  #   
+  #   a <=> b   #=> -1
+  #   a <=> c   #=> -1
+  #   b <=> c   #=> +1
+  #
+  def <=>(other_slot)
+    cmp = self.start <=> other_slot.start
+    (cmp == 0) ? self.finish <=> other_slot.finish : cmp
+  end
+  
+  # Split this time slot into a set of new TimeSlot(s) where the duration of  
+  # each slot is equal to or smaller than <i>length</i>.
+  #
+  # The duration of the last slot in the result will be set to the remainder if
+  # the this time slot cannot be divided equally based on <i>length</i>.
+  #
+  #   a = TimeSlot.new(Chronic.parse("today 10:00"), Chronic.parse("today 12:30"))
+  #   
+  #   a.split(3600) #=> [
+  #       #<TimeSlot:0x1018cf3a0 @start=Sun Nov 01 10:00:00 +0000 2009, 
+  #         @finish=Sun Nov 01 11:00:00 +0000 2009>, 
+  #       #<TimeSlot:0x1018cf260 @start=Sun Nov 01 11:00:00 +0000 2009, 
+  #         @finish=Sun Nov 01 12:00:00 +0000 2009>, 
+  #       #<TimeSlot:0x1018cf198 @start=Sun Nov 01 12:00:00 +0000 2009, 
+  #         @finish=Sun Nov 01 12:30:00 +0000 2009>]
+  #
+  def split(length)
+    result = []
+    if self.duration <= length
+      result << self.clone
+    else
+      current = TimeSlot.new(self.start, self.start + length)
+      result << current
+      result += (self - current)[0].split(length)
+    end
+    return result
+  end
+  
+  # Shows the start and end of this TimeSlot
+  def to_s
+    "#{self.start} to #{self.finish}"
+  end
+end

data/lib/slotter.rb

@@ -0,0 +1,2 @@
+$:.unshift File.dirname(__FILE__)
+require 'slotter/time_slot'

data/slotter.gemspec

@@ -0,0 +1,70 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{slotter}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Bjarki Gudlaugsson"]
+  s.date = %q{2009-11-01}
+  s.description = %q{the gem allows you to perform operations like addition, subtraction and splitting on time slots}
+  s.email = %q{bjarkigud@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "features/case_subtraction.txt",
+     "features/cases_addition.txt",
+     "features/step_definitions/time_slot_definitions.rb",
+     "features/support/env.rb",
+     "features/time_slot_addition.feature",
+     "features/time_slot_intersection.feature",
+     "features/time_slot_split.feature",
+     "features/time_slot_subtraction.feature",
+     "lib/slotter.rb",
+     "lib/slotter/time_slot.rb",
+     "slotter.gemspec",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/time_slot_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/bjarkigud/slotter}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{create and manipulate time slots simply and easily}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/time_slot_spec.rb"
+  ]
+
+  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
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_development_dependency(%q<cucumber>, [">= 0.4.2"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<chronic>, [">= 0.2.3"])
+      s.add_dependency(%q<cucumber>, [">= 0.4.2"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<chronic>, [">= 0.2.3"])
+    s.add_dependency(%q<cucumber>, [">= 0.4.2"])
+  end
+end
+

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--color
+--format specdoc
+--loadby mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'slotter'
+require 'spec'
+require 'spec/autorun'
+require 'rubygems'
+require 'chronic'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/time_slot_spec.rb

@@ -0,0 +1,4 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe TimeSlot do
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: slotter
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Bjarki Gudlaugsson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-01 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: chronic
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.2
+    version: 
+description: the gem allows you to perform operations like addition, subtraction and splitting on time slots
+email: bjarkigud@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- features/case_subtraction.txt
+- features/cases_addition.txt
+- features/step_definitions/time_slot_definitions.rb
+- features/support/env.rb
+- features/time_slot_addition.feature
+- features/time_slot_intersection.feature
+- features/time_slot_split.feature
+- features/time_slot_subtraction.feature
+- lib/slotter.rb
+- lib/slotter/time_slot.rb
+- slotter.gemspec
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/time_slot_spec.rb
+has_rdoc: true
+homepage: http://github.com/bjarkigud/slotter
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: create and manipulate time slots simply and easily
+test_files: 
+- spec/spec_helper.rb
+- spec/time_slot_spec.rb