time_helper 1.0.0

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format doc
+

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create use 1.9.2@time_extras

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+group :test do
+  gem 'rspec'
+  gem 'time_travel'
+end

data/Gemfile.lock

@@ -0,0 +1,20 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    time_travel (0.1.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec
+  time_travel

data/README.md

@@ -0,0 +1,34 @@
+# time_helper
+
+time_helper is a slim gem that adds some of the methods that I really liked from working with Rails projects. I still to a lot of work that require date and time manipulation so I decided to finally replicate some of the methods since I don't want to rely on ActiveSupport.
+
+## Requirements
+
+None really. As long as you don't rely on ActiveSupport already it shouldn't affect your code. You'll see some warnings and this gem won't do anything if this is the case.
+
+## Installation
+
+    gem install time_helper
+
+## Examples
+
+Most of the time I use the methods in combination with Time objects but by default they return the number of seconds.
+
+    3.minutes == 180
+    
+But they become more useful when used in combination of a Time object or with the ago/from_now methods.
+At noon of April 17, 1964 `Time.utc(1964, 4, 17, 12)` these would be the results
+
+    3.days.ago == Time.utc(1964, 4, 14, 12)
+    
+and
+    
+    5.hours.from_now == Time.utc(1964, 4, 17, 17)
+    
+If you have a Time object you can use the methods to alter it i.e. using `t = Time.utc(1964, 4, 17, 12)` you will get
+
+    t - 3.days == Time.utc(1964, 4, 14, 12)
+    
+and
+
+    t + 5 hours == Time.utc(1964, 4, 17, 17)

data/lib/time_helper.rb

@@ -0,0 +1,46 @@
+module TimeHelper
+  SECOND = 1.freeze
+  MINUTE = (60 * SECOND).freeze
+  HOUR   = (60 * MINUTE).freeze
+  DAY    = (24 * HOUR).freeze
+
+  def second
+    self * SECOND
+  end
+  alias :seconds :second
+
+  def minute
+    self * MINUTE
+  end
+  alias :minutes :minute
+
+  def hour
+    self * HOUR
+  end
+  alias :hours :hour
+
+  def day
+    self * DAY
+  end
+  alias :days :day
+  
+  def ago(time = Time.now)
+    time - self
+  end
+
+  def since(time = Time.now)
+    time + self
+  end
+  alias :from_now :since
+end
+
+already_included_methods = TimeHelper.instance_methods.map { |method| method if 1.respond_to?(method)}.compact
+if already_included_methods.empty?
+  class Numeric
+    include TimeHelper
+  end
+else
+  already_included_methods.each do |method|
+    puts "WARNING: Numeric has already been altered to include a method called #{method}. TimeHelper will not be included"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+$: << File.expand_path('../../lib', __FILE__)
+
+require 'time_travel'
+require 'time_helper'

data/spec/time_helpers_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+
+describe TimeHelper do
+  describe '#minutes' do
+    it 'converts minutes to seconds' do
+      1.minute.should == 60
+      2.minutes.should == 120
+    end
+  end
+  
+  describe '#hours' do
+    it 'converts hours to seconds' do
+      1.hour.should == 60 * 60
+      2.hours.should == 2 * 60 * 60
+    end
+  end
+    
+  describe '#days' do
+    it 'converts days to seconds' do
+      1.day.should == 24 * 60 * 60
+      2.days.should == 2 * 24 * 60 * 60
+    end
+  end
+  
+  describe '#ago' do
+    it 'subtracts seconds' do
+      at_time Time.utc(1964, 04, 17) do
+        one_second_ago = Time.utc(1964, 04, 16, 23, 59, 59)
+        1.second.ago.should == one_second_ago
+        (Time.now - 1.second).should == one_second_ago
+      end
+    end
+    
+    it 'subtracts minutes' do
+      at_time Time.utc(1964, 04, 17) do
+        thirty_minutes_ago = Time.utc(1964, 04, 16, 23, 30)
+        30.minutes.ago.should == thirty_minutes_ago
+        (Time.now - 30.minutes).should == thirty_minutes_ago
+      end
+    end
+
+    it 'subtracts hours' do
+      at_time Time.utc(1964, 04, 17) do
+        twelve_hours_ago = Time.utc(1964, 04, 16, 12)
+        12.hours.ago.should == twelve_hours_ago
+        (Time.now - 12.hours).should == twelve_hours_ago
+      end
+    end
+
+    it 'subtracts days' do
+      at_time Time.utc(1964, 04, 17) do
+        three_days_ago = Time.utc(1964, 04, 14)
+        3.days.ago.should == three_days_ago
+        (Time.now - 3.days).should == three_days_ago
+      end
+    end
+  end
+  
+  describe '#from_now' do
+    it 'adds seconds' do
+      at_time Time.utc(1964, 04, 17) do
+        one_second_from_now = Time.utc(1964, 04, 17, 0, 0, 1)
+        1.second.from_now.should == one_second_from_now
+        (Time.now + 1.second).should == one_second_from_now
+      end
+    end
+
+    it 'adds minutes' do
+      at_time Time.utc(1964, 04, 17) do
+        thirty_minutes_from_now = Time.utc(1964, 04, 17, 0, 30)
+        30.minute.from_now.should == thirty_minutes_from_now
+        (Time.now + 30.minute).should == thirty_minutes_from_now
+      end
+    end
+
+    it 'adds hours' do
+      at_time Time.utc(1964, 04, 17) do
+        twelve_hours_from_now = Time.utc(1964, 04, 17, 12)
+        12.hours.from_now.should == twelve_hours_from_now
+        (Time.now + 12.hours).should == twelve_hours_from_now
+      end
+    end
+
+    it 'adds days' do
+      at_time Time.utc(1964, 04, 17) do
+        three_days_from_now = Time.utc(1964, 04, 20)
+        3.days.from_now.should == three_days_from_now
+        (Time.now + 3.days).should == three_days_from_now
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: time_helper
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Daniel Gaiottino
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-27 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70205896711280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70205896711280
+description: ''
+email:
+- daniel@burtcorp.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- README.md
+- lib/time_helper.rb
+- spec/spec_helper.rb
+- spec/time_helpers_spec.rb
+homepage: https://github.com/gaiottino/time_helper
+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: time_helper
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Some of the functions I've really liked in ActiveSupport but without relying
+  on ActiveSupport
+test_files: []