relativity 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.swp

data/.rvmrc

@@ -0,0 +1 @@
+rvm use --create 1.9.3@relativity

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in relativity.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,21 @@
+= Relativity
+
+Time, Date and DateTime classes don't have a mode for working with relative
+time inside 1 day (or 1 week, 1 month, 1 quarter, etc.).
+
+A RelativeTime object, relative to a day or a week, is useful to describe
+e.g. opening hours of a business. In a next phase, a RelativeTimeRange
+will be built on top, so the ranges of opening hours can be represented.
+
+== Example
+
+  require 'relativity'
+  opens_at = RelativeTime.new(9) #=> 09:00:00
+  closes_at = RelativeTime.new(18,30) #=> 18:30:00
+
+  rt = RelativeTime.new #=> 21:17:40
+  rt.seconds_since_midnight #=> #<BigDecimal:9d35d48,'0.7666056825 7238E5',18(45)>
+  rt.hours #=> 21
+  rt.minutes #=> 17
+  rt.seconds #=> 40
+  rt.nano_seconds #=> 568257238

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/relativity.rb

@@ -0,0 +1,2 @@
+require 'relativity/version'
+require 'relativity/relative_time'

data/lib/relativity/relative_time.rb

@@ -0,0 +1,52 @@
+class RelativeTime
+
+  require 'bigdecimal'
+
+  attr_reader :seconds_since_midnight
+
+  def initialize(hours = nil, minutes = nil, seconds = nil, nano_seconds = nil)
+    super()
+    if hours
+      hh = hours.to_i
+      mm = minutes.to_i
+      ss = seconds.to_i
+      nn = nano_seconds.to_i
+    else
+      t = Time.new
+      hh = t.hour
+      mm = t.min
+      ss = t.sec
+      nn = t.nsec
+    end
+    @seconds_since_midnight = ((hh * 3600) + (mm * 60) + ss + BigDecimal(nn)/BigDecimal(1000000000))%(24*3600)
+  end
+
+  def hours
+    hours = Integer(@seconds_since_midnight/(3600)).tap do |h|
+      raise "Internal ERROR in RelativeTime; hours is #{h}" if (h < 0 || h > 23)
+    end
+  end
+
+  def minutes
+    Integer(@seconds_since_midnight / 60) % 60
+  end
+
+  def seconds
+    Integer(@seconds_since_midnight) % 60
+  end
+
+  def nano_seconds
+    Integer((@seconds_since_midnight % 1) * 1000000000)
+  end
+
+  def to_s
+    [hours, minutes, seconds].map{|e| rjust_2_0(e.to_s)}.join(':')
+  end
+
+  def rjust_2_0(s)
+    s.rjust(2,'0')
+  end
+
+  private :rjust_2_0
+
+end

data/lib/relativity/version.rb

@@ -0,0 +1,3 @@
+module Relativity
+  VERSION = "0.0.1"
+end

data/relativity.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "relativity/version"
+
+Gem::Specification.new do |s|
+  s.name        = "relativity"
+  s.version     = Relativity::VERSION
+  s.authors     = ["Peter Vandenabeele"]
+  s.email       = ["peter@vandenabeele.com"]
+  s.homepage    = "https://github.com/petervandenabeele/relativity"
+  s.summary     = %q{time and time_ranges relative to day, week, month, quarter etc.}
+  s.description = s.summary
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency 'rspec', '>= 2.7'
+  s.add_dependency 'bundler', '>= 1.0'
+end

data/spec/relative_time_spec.rb

@@ -0,0 +1,147 @@
+require 'spec_helper'
+
+describe RelativeTime do
+
+  it "new creates a RelativeTime" do
+    lambda { subject }.should_not raise_error
+  end
+
+  context "time in a day" do
+
+    it "seconds_since_midnight" do
+      lambda { subject.seconds_since_midnight }.should_not raise_error
+    end
+
+    it "new creates a RelativeTime close to now" do
+      rt_s = subject.seconds_since_midnight
+      t = Time.new
+      t_s = (t.hour*60 + t.min)*60 + t.sec # seconds_since_midnight from Time
+      (((t_s-rt_s).abs+2)%(24*60*60)).should be <= 4
+    end
+
+    it "hours" do
+      (((subject.hours - Time.new.hour).abs+1)%24).should be <= 2
+    end
+
+    it "minutes" do
+      (((subject.minutes - Time.new.min).abs+1)%60).should be <= 2
+    end
+
+    it "seconds" do
+      (((subject.seconds - Time.new.sec).abs+2)%60).should be <= 4
+    end
+
+    it "seconds_since_midnight should be BigDecimal" do
+      subject.seconds_since_midnight.should be_kind_of(BigDecimal)
+    end
+
+    it "hours should be Integer" do
+      subject.hours.should be_kind_of(Integer)
+    end
+
+    it "minutes should be Integer" do
+      subject.minutes.should be_kind_of(Integer)
+    end
+
+    it "seconds should be Integer" do
+      subject.seconds.should be_kind_of(Integer)
+    end
+
+    it "nano_seconds should be Integer" do
+      subject.nano_seconds.should be_kind_of(Integer)
+    end
+
+    it "new with argument hours" do
+      RelativeTime.new(10).hours.should == 10
+      rt = RelativeTime.new(20)
+      rt.hours.should == 20
+      rt.minutes.should == 0
+      rt.seconds.should == 0
+      rt.nano_seconds.should == 0
+    end
+
+    it "new with argument minutes" do
+      rt = RelativeTime.new(10,25)
+      rt.minutes.should == 25
+      rt.seconds.should == 0
+      rt.nano_seconds.should == 0
+    end
+
+    it "new with argument seconds" do
+      rt = RelativeTime.new(10,37,45)
+      rt.seconds.should == 45
+      rt.nano_seconds.should == 0
+    end
+
+    it "new with argument nano_seconds" do
+      rt = RelativeTime.new(0,23,45,457834889)
+      rt.nano_seconds.should == 457834889
+    end
+
+  end
+
+  context "overflow / underflow " do
+
+    it "normalizes on overflow of hours" do
+      rt = RelativeTime.new(24,1,2,3)
+      rt.hours.should == 0
+      rt.minutes.should == 1
+      rt.seconds.should == 2
+      rt.nano_seconds.should == 3
+    end
+
+    it "normalizes on underflow of hours" do
+      rt = RelativeTime.new(-3,1,2,3)
+      rt.hours.should == 21
+      rt.minutes.should == 1
+      rt.seconds.should == 2
+      rt.nano_seconds.should == 3
+    end
+
+    it "normalizes on overflow of minutes" do
+      rt = RelativeTime.new(23,65,2,3)
+      rt.hours.should == 0
+      rt.minutes.should == 5
+      rt.seconds.should == 2
+      rt.nano_seconds.should == 3
+    end
+
+    it "normalizes on underflow of minutes" do
+      rt = RelativeTime.new(1,-100,2,3)
+      rt.hours.should == 23
+      rt.minutes.should == 20
+      rt.seconds.should == 2
+      rt.nano_seconds.should == 3
+    end
+
+    it "normalizes on overflow of nano_seconds" do
+      rt = RelativeTime.new(22,55,2,3600000000)
+      rt.hours.should == 22
+      rt.minutes.should == 55
+      rt.seconds.should == 5
+      rt.nano_seconds.should == 600000000
+    end
+
+    it "normalizes on underflow of nano_seconds" do
+      rt = RelativeTime.new(22,55,2,-3600000000)
+      rt.hours.should == 22
+      rt.minutes.should == 54
+      rt.seconds.should == 58
+      rt.nano_seconds.should == 400000000
+    end
+
+  end
+
+  context "output" do
+
+    it "does HH:MM:SS for to_s" do
+      subject.to_s.should match(/\d{2}:\d{2}:\d{2}/)
+    end
+
+    it "does correct hours, minutes, seconds for to_s" do
+      rt = RelativeTime.new(0,23,45,457834889)
+      rt.to_s.should == "00:23:45"
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'relativity'

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: relativity
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Vandenabeele
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &83683860 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :development
+  prerelease: false
+  version_requirements: *83683860
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &83683550 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *83683550
+description: time and time_ranges relative to day, week, month, quarter etc.
+email:
+- peter@vandenabeele.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/relativity.rb
+- lib/relativity/relative_time.rb
+- lib/relativity/version.rb
+- relativity.gemspec
+- spec/relative_time_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/petervandenabeele/relativity
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: time and time_ranges relative to day, week, month, quarter etc.
+test_files: []