time-helper 1.3.1 → 2.0.0

data/README

@@ -33,6 +33,10 @@ using .add or .substract
 | Time.local(2012,05,01,12,20,31) | substract | {:month => 2, :day => 3} | Time.local(2012,05,01,12,20,31) - (60*60*24*30*2 + 60*60*24*3)|
 | Time.local(2011,12,24,22,10,54) | add | {:day => 1, :hour => 3} |Time.local(2011,12,24,22,10,54) + (60*60*24 + 60*60*3) |
 
+using =~
+this method allows you to get "close enough" times, defaults to 300 seconds (5 minutes) of acceptable difference
+time_obj =~ other_time # true or false if the difference between the objects is less than 5 minutes
+time_obj.=~ other_time, 360 # true or false if the difference is less than 6 minutes 
 
 **********************************************
 *How is this diferent than just "Time.parse"?*
@@ -42,6 +46,11 @@ Time.parse does not work well with non-American formats, if like me, you're work
 mat like: DD/MM/YYYY Time.parse will not do. In fact, if you rewrite strtotime so it just calls parse a few of the tests 
 included will fail.
 
+New in 2.0.0
+Completelly changed =~ method, the second argument is now an acceptable difference in seconds - more reliable.
+Removed the require 'time' std lib (which should reduce memory of this gem ) and as such it no longers has the parse method included in the strtotime method, if you want to use parse, use it!
+As such, with these differences this version is not retro-compatible, if you were using a previous version it may fail on this one.
+
 New in 1.3.1
 Added =~ method which allows you to see if two time objects are close enough, by default it compares up till the hour, for instance, a =~ b will be true if a and b are both objects with the same year, month, day and hour.
 Removed all the aborts! Replaced be real errors inside the class! Sorry for the mess. 

data/lib/time-helper.rb

@@ -1,8 +1,7 @@
 #encoding: utf-8
-#@version 1.3.1
+#@version 2.0.0 
 #@author Arthur
 class Time
-    require 'time'
     #class methods
     class << self
         #@param string [String] a datetime string with many possible formats
@@ -10,11 +9,7 @@ class Time
         #@return [Time] set in the date of the string passed
         def strtotime string
             unless valid_datetime? string
-                begin
-                    return Time.parse(string)
-                rescue 
-                    raise InvalidTimeStringFormat
-                end
+                raise InvalidTimeStringFormat
             end
             h,m,s = 0,0,0
 
@@ -200,26 +195,22 @@ class Time
     public
 #compares if two Time objects are close enough to each other
 #@param other_time [Time] time to be compared to
-#@param smallest_unit [Symbol] smallest unit of time to check if it's the same
+#@param acceptable_diff [Fixnum]
 # @example
 # a = Time.now
 # b = Time.now.add(:day = 1)
 # a =~ b
 # => false
-# a.=~ b,:month
+# a.=~ b, 86400
 # => true
 #@note to compare up to the hour you just need var =~ other_var,
 # but to pass the second argument you must use var.=~(other_var, :min)
 #@note minute is :min seconds is :sec
-    def =~(other_time, smallest_unit = :hour)
+    def =~(other_time, acceptable_diff = 300 )
         raise InvalidArgument.new('Argument must be an instance of Time') unless other_time.class == Time
-        equal = true
-        [:year, :month, :day, :hour, :min, :sec].each do |method|
-            self_unit, other_unit = self.method(method).call(), other_time.method(method).call()
-            equal = false unless self_unit == other_unit
-            break if method == smallest_unit
-        end
-        return equal
+        raise InvalidArgument.new('Argument must be fix number') unless acceptable_diff.class == Fixnum
+        diff = self.to_i - other_time.to_i
+        return ( diff.abs <= acceptable_diff  )
     end
 
 ##### Errors #####

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification 
 name: time-helper
 version: !ruby/object:Gem::Version 
-  version: 1.3.1
+  prerelease: 
+  version: 2.0.0
 platform: ruby
 authors: 
-- Arthur Silva
+  - Arthur Silva
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2012-08-20 00:00:00 +01:00
-default_executable: 
+date: 2012-11-04 00:00:00 Z
 dependencies: []
 
 description: "  Adds a few methods to the Time class, more significant:\n\n    strtotime which returns a Time object based on a string.\n\n    also methods add and substract that allow you to do some easy date math (doesn't take leap months/years into account)\n also tomorrow and yesterday methods witch are like Time.now +- 1 day\n\n    =~ to see if two Time objects are \"close enough\"\n"
@@ -22,9 +22,8 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/time-helper.rb
-- README
-has_rdoc: true
+  - lib/time-helper.rb
+  - README
 homepage: https://github.com/awls99/time-helper
 licenses: []
 
@@ -32,25 +31,26 @@ post_install_message:
 rdoc_options: []
 
 require_paths: 
-- lib
+  - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: A few helper functions for the Time class.
 test_files: []
 
+has_rdoc: