time_sentence 0.0.2

data/.gitignore

@@ -0,0 +1,14 @@
+*.gem
+*.rvmrc
+.bundle
+Gemfile.lock
+pkg/*
+coverage.data
+coverage/*
+.yardoc
+tmp
+vendor/bundle
+*.swp
+*.swo
+*.DS_Store
+.idea/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--order rand

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/Rakefile

@@ -0,0 +1,17 @@
+require 'bundler/gem_tasks'
+require 'rake'
+require 'rspec/core/rake_task'
+
+namespace :spec do
+
+  RSpec::Core::RakeTask.new(:normal) do |t|
+    t.pattern ='spec/**/*_spec.rb'
+    t.rcov = false
+  end
+
+end
+
+desc "RSpec tests"
+task "spec" => "spec:normal"
+
+task "default" => "spec"

data/Readme.md

@@ -0,0 +1 @@
+= Time Sentence =

data/lib/ext/numeric.rb

@@ -0,0 +1,5 @@
+class Numeric
+  def time_sentence specificity = 3
+    Time.sentence(self, specificity)
+  end
+end

data/lib/ext/time.rb

@@ -0,0 +1,35 @@
+class Time
+  def self.sentence seconds, specificity = 3
+
+    return 'now' if seconds == 0
+
+    ago = seconds < 0
+
+    time = [
+        { value: seconds.abs,   unit: 'second',      conversion: 60 },
+        { value: 0,             unit: 'minute',      conversion: 60 },
+        { value: 0,             unit: 'hour',        conversion: 24 },
+        { value: 0,             unit: 'day',         conversion: 7 },
+        { value: 0,             unit: 'week',        conversion: 4 },
+        { value: 0,             unit: 'month',       conversion: 12 },
+        { value: 0,             unit: 'year',        conversion: 10 },
+        { value: 0,             unit: 'decade',      conversion: 100 },
+        { value: 0,             unit: 'millennium',  conversion: nil },
+    ]
+
+    time.each_cons(2) do |this_time, next_time|
+      next_time[:value], this_time[:value] = this_time[:value].divmod this_time[:conversion]
+    end
+
+    time = time.delete_if { |t| t[:value] == 0 }
+
+    out = []
+    time.reverse.each do |t|
+      out << "#{t[:value]} #{t[:unit].pluralize t[:value]}"
+      break if out.count == specificity
+    end
+
+    out.join(', ') + (ago ? ' ago' : '')
+
+  end
+end

data/lib/time_sentence.rb

@@ -0,0 +1,4 @@
+require 'time_sentence/version'
+
+require 'ext/time'
+require 'ext/numeric'

data/lib/time_sentence/version.rb

@@ -0,0 +1,3 @@
+module TimeSentence
+  VERSION = '0.0.2'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'active_support/inflector'
+require 'time_sentence'

data/spec/time_sentence/sentence_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe 'Time.sentence' do
+
+  it "should accept a positive integer" do
+    Time.sentence(100000000).should eql "3 years, 5 months, 1 week"
+    100000000.time_sentence.should eql "3 years, 5 months, 1 week"
+  end
+
+  it "should accept a negative integer" do
+    Time.sentence(-3600).should eql "1 hour ago"
+    -3600.time_sentence.should eql "1 hour ago"
+  end
+
+  it "should accept 0" do
+    Time.sentence(0).should eql "now"
+    0.time_sentence.should eql "now"
+  end
+
+  it "should accept a very large number" do
+    Time.sentence(100000000000000000000000).should be_kind_of String
+    100000000000000000000000.time_sentence.should be_kind_of String
+  end
+
+  it "should accept specificity" do
+    (1..10).each do |specificity|
+      Time.sentence(123456789123456789, specificity).should be_kind_of String
+      123456789123456789.time_sentence(specificity).should be_kind_of String
+    end
+  end
+
+  it "should ignore a specificity that is out of range" do
+      Time.sentence(123456789123456789, -5).should be_kind_of String
+      123456789123456789.time_sentence(-5).should be_kind_of String
+      Time.sentence(123456789123456789, 20).should be_kind_of String
+      123456789123456789.time_sentence(20).should be_kind_of String
+  end
+
+end

data/time_sentence.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "time_sentence/version"
+
+Gem::Specification.new do |s|
+  s.name        = "time_sentence"
+  s.version     = TimeSentence::VERSION
+  s.authors     = ["Pete Michaud"]
+  s.email       = ["me@petermichaud.com"]
+  s.homepage    = "http://github.com/PeteMichaud/time-sentence"
+  s.summary     = "Translates Seconds into Human Readable Sentences"
+  s.description = "Translates Seconds into Human Readable Sentences"
+  s.rubyforge_project = "time_sentence"
+  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 = ["config", "lib"]
+
+  #s.add_dependency 'activesupport', '~> 3.2'
+  #s.add_dependency 'actionpack', '~> 3.2'
+
+  s.add_development_dependency 'rake', '~> 0.9.2'
+  s.add_development_dependency 'rspec', '~> 2.10'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'minitest-rails', '~> 0.2'
+  s.add_development_dependency 'minitest', '~> 3.0' if RUBY_PLATFORM == "java"
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: time_sentence
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Pete Michaud
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Translates Seconds into Human Readable Sentences
+email:
+- me@petermichaud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Rakefile
+- Readme.md
+- lib/ext/numeric.rb
+- lib/ext/time.rb
+- lib/time_sentence.rb
+- lib/time_sentence/version.rb
+- spec/spec_helper.rb
+- spec/time_sentence/sentence_spec.rb
+- time_sentence.gemspec
+homepage: http://github.com/PeteMichaud/time-sentence
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- config
+- 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_sentence
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Translates Seconds into Human Readable Sentences
+test_files:
+- spec/spec_helper.rb
+- spec/time_sentence/sentence_spec.rb
+has_rdoc: