dotiw 0.7.0 → 1.0.0

data/.bundle/config

@@ -1,2 +1,3 @@
 --- 
 BUNDLE_DISABLE_SHARED_GEMS: "1"
+BUNDLE_WITHOUT: production

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dotiw (0.7.0)
+    dotiw (1.0.0)
       actionpack (~> 3.0.0)
 
 GEM

data/README.markdown

@@ -115,6 +115,20 @@ Using something other than ', and':
     >> distance_of_time_in_words(Time.now, Time.now + 1.hour + 1.minute + 1.second, true, { :last_word_connector => ', finally ' })
     => "1 hour, 1 minute, finally 1 second"
 
+#### :highest\_measure\_only
+
+For times when Rails `distance_of_time_in_words` is not precise enough and `DOTIW` is too precise. For instance, if you only want to know the highest time part (measure) that elapsed between two dates.
+
+    >> distance_of_time_in_words(Time.now, Time.now + 1.hour + 1.minute + 1.second, true, { :highest_measure_only => true })
+    => "1 hour"
+
+Notice how minutes and seconds were removed from the output. Another example:
+
+    >> distance_of_time_in_words(Time.now, Time.now + 1.minute + 1.second, true, { :highest_measure_only => true })
+    => "1 minute"
+
+Minutes are the highest measure, so seconds were discarded from the output.
+
 ## distance\_of\_time
 
 If you have simply a number of seconds you can get the "stringified" version of this by using `distance_of_time`:

data/lib/dotiw.rb

@@ -60,6 +60,8 @@ module ActionView
 
           output = []
 
+          time_measurements = Hash[*time_measurements.first] if options.delete(:highest_measure_only)
+
           time_measurements.each do |measure, key|
             name = options[:singularize] == :always || hash[key].between?(-1, 1) ? key.singularize : key
             output += ["#{hash[key]} #{name}"]

data/lib/dotiw/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module DOTIW
-  VERSION = "0.7.0"
+  VERSION = "1.0.0"
 end

data/spec/lib/dotiw_spec.rb

@@ -199,10 +199,14 @@ describe "A better distance_of_time_in_words" do
        Time.now + 1.year + 2.months + 3.days + 4.hours + 5.minutes + 6.seconds,
        { "except" => "minutes" },
        "1 year, 2 months, 3 days, 4 hours, and 6 seconds"],
+      [Time.now,
+        Time.now + 1.hour + 2.minutes + 3.seconds,
+        { :highest_measure_only => true },
+        "1 hour"],
       [Time.now,
        Time.now + 2.year + 3.months + 4.days + 5.hours + 6.minutes + 7.seconds,
        { :singularize => :always },
-       "2 year, 3 month, 4 day, 5 hour, 6 minute, and 7 second"]
+       "2 year, 3 month, 4 day, 4 hour, 6 minute, and 7 second"]
     ].each do |start, finish, options, output|
       it "should be #{output}" do
         distance_of_time_in_words(start, finish, true, options).should eql(output)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: dotiw
 version: !ruby/object:Gem::Version 
-  hash: 3
+  hash: 23
   prerelease: false
   segments: 
+  - 1
   - 0
-  - 7
   - 0
-  version: 0.7.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Ryan Bigg
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-23 00:00:00 +10:00
+date: 2010-12-23 00:00:00 +11:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency