humantime 0.1.0

data/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) 2012 James Inman <james@jamesinman.co.uk>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,22 @@
+Gem to return human readable times.
+
+#### Usage
+
+Output a number of seconds in human readable form:
+
+    >> HumanTime.output 1
+    => "1 second"
+    >> HumanTime.output 45
+    => "45 seconds"
+    >> HumanTime.output 70
+    => "1 minute 10 seconds"
+    >> HumanTime.output 234
+    => "3 minutes 54 seconds"
+    >> HumanTime.output 53005
+    => "14 hours 43 minutes"
+    >> HumanTime.output 530052
+    => "6 days"
+    >> HumanTime.output 1209600
+    => "14 days"
+    >> HumanTime.output 5452302
+    => "2 months"

data/lib/humantime.rb

@@ -0,0 +1,137 @@
+class HumanTime
+  
+  SECOND = 1
+  MINUTE = 60
+  HOUR = 3600
+  DAY = 86400
+  MONTH = 2629743
+  YEAR = 31556926
+  
+  # Parse an integer and return the string representation of a time
+  def self.output int
+    str = []
+    display = ['years', 'months', 'days', 'hours', 'minutes', 'seconds']    
+        
+    # Years
+    if int > ( YEAR - 1 ) && display.include?('years')
+      years = int / YEAR
+      int = int - ( years * YEAR )
+      display.delete 'minutes' 
+      display.delete 'seconds' 
+      display.delete 'hours'
+      
+      if years.round == 1
+        str << "#{years.round} year"
+      else
+        str << "#{years.round} years"
+        display.delete('months')
+      end
+    end
+        
+    # Months
+    if int < YEAR && int > ( MONTH - 1 ) && display.include?('months')
+      months = int / MONTH
+      int = int - ( months * MONTH )
+      display.delete 'minutes'
+      display.delete 'seconds'
+      display.delete 'hours' 
+      
+      if months.round == 1
+        str << "#{months.round} month"
+      elsif months.round == 12
+        str << "1 year"
+      else
+        str << "#{months.round} months"
+        display.delete 'days'
+      end
+    end
+        
+    # Days
+    if int < MONTH && int > ( DAY - 1 ) && display.include?('hours')
+      days = int / DAY
+      int = int - ( days * DAY )
+      display.delete 'minutes' 
+      display.delete 'seconds'
+      
+      if days.round == 1
+        str << "#{days.round} day"
+      else
+        str << "#{days.round} days"
+        display.delete 'hours'
+      end
+    end    
+        
+    # Hours
+    if int < DAY && int > ( HOUR - 1 ) && display.include?('hours')
+      hours = int / HOUR
+      int = int - ( hours * HOUR )
+      display.delete 'seconds'
+      
+      if hours.round == 1
+        str << "#{hours.round} hour"
+      else
+        str << "#{hours.round} hours"
+      end
+    end
+        
+    # Minutes
+    if int < HOUR && int > ( MINUTE - 1 ) && display.include?('minutes')
+      mins = int / MINUTE
+      int = int - ( mins * MINUTE )
+      
+      if mins.round == 1
+        str << "#{mins.round} minute"
+      else
+        str << "#{mins.round} minutes"
+      end
+    end
+        
+    # Seconds
+    if int < MINUTE && int > 0 && display.include?('seconds')
+      if int.round == 1
+        str << "#{int.round} second"
+      else
+        str << "#{int.round} seconds"
+      end
+    end
+    
+    str.join(' ') 
+  end
+    
+  # From https://github.com/hpoydar/chronic_duration
+  # For future parsing methods
+  def mappings
+    { 
+      'seconds' => 'seconds',
+      'second'  => 'seconds',
+      'secs'    => 'seconds',
+      'sec'     => 'seconds',
+      's'       => 'seconds',
+      'minutes' => 'minutes',
+      'minute'  => 'minutes',
+      'mins'    => 'minutes',
+      'min'     => 'minutes',
+      'm'       => 'minutes',
+      'hours'   => 'hours',
+      'hour'    => 'hours',
+      'hrs'     => 'hours',
+      'hr'      => 'hours',
+      'h'       => 'hours',
+      'days'    => 'days',
+      'day'     => 'days',
+      'dy'      => 'days',
+      'd'       => 'days',
+      'weeks'   => 'weeks',
+      'week'    => 'weeks',
+      'w'       => 'weeks',
+      'months'  => 'months',
+      'mos'     => 'months',
+      'month'   => 'months',
+      'years'   => 'years',
+      'year'    => 'years',
+      'yrs'     => 'years',
+      'y'       => 'years'
+    }
+  end
+
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification 
+name: humantime
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- James Inman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-25 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rcov
+  type: :development
+  prerelease: false
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: bundler
+  type: :development
+  prerelease: false
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 1
+        - 8
+        - 3
+        version: 1.8.3
+  name: jeweler
+  type: :development
+  prerelease: false
+  requirement: *id003
+description: Outputs human readable times
+email: james@jamesinman.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- LICENSE
+- README.md
+- lib/humantime.rb
+homepage: http://github.com/jfi/humantime
+licenses: 
+- ISC
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Outputs human readable times
+test_files: []
+