human-date 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.swp

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in human-date.gemspec
+gemspec

data/README.md

@@ -0,0 +1,28 @@
+human-date
+==========
+
+Installation:
+-------------
+```
+gem install human-date
+```
+
+Usage:
+------
+
+```ruby
+date_translator = HumanDate::DateTranslator.new
+from = DateTime.now
+sleep 10
+to = DateTime.now
+
+date_translator.translate(from, to)
+=> '10 seconds'
+
+date_translator.translate(to, from)
+=> '10 seconds ago'
+
+date_translator.tolerance = 10
+date_translator.translate(from, to)
+=> 'now'
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+    t.pattern = "test/test_*.rb"
+end

data/human-date.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "human-date/version"
+
+Gem::Specification.new do |s|
+  s.name        = "human-date"
+  s.version     = Human::Date::VERSION
+  s.authors     = ["Andrew Vos"]
+  s.email       = ["andrew.vos@gmail.com"]
+  s.homepage    = "https://github.com/AndrewVos/human-date"
+  s.summary     = %q{Human readable date differences}
+  s.description = %q{Human readable date differences}
+
+  s.rubyforge_project = "human-date"
+
+  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 = ["lib"]
+  s.add_development_dependency "minitest"
+end

data/lib/human-date.rb

@@ -0,0 +1,2 @@
+require "human-date/version"
+require "human-date/date_translator"

data/lib/human-date/date_translator.rb

@@ -0,0 +1,35 @@
+require 'date'
+
+module HumanDate
+  class DateTranslator
+    attr_accessor :tolerance
+
+    TIME = {
+      :year     => 365 * 24 * 60 * 60,
+      :month    => 30 * 24 * 60 * 60,
+      :day      => 24 * 60 * 60,
+      :hour     => 60 * 60,
+      :minute   => 60,
+      :second   => 1
+    }
+
+    def initialize
+      @tolerance = 1
+    end
+
+    def translate(from, to)
+      total_difference_in_seconds = ((to-from) * 60 * 60 * 24).to_i
+      return 'now' if total_difference_in_seconds.abs <= tolerance
+
+      TIME.keys.each do |key|
+        if total_difference_in_seconds.abs >= TIME[key]
+          result = "#{total_difference_in_seconds.abs / TIME[key]} #{key}"
+          result += 's' if total_difference_in_seconds.abs >= (TIME[key] * 2)
+          result += ' ago' if total_difference_in_seconds < 0
+          return result
+        end
+      end
+    end
+
+  end
+end

data/lib/human-date/version.rb

@@ -0,0 +1,5 @@
+module Human
+  module Date
+    VERSION = "0.0.1"
+  end
+end

data/test/test_date_translator.rb

@@ -0,0 +1,63 @@
+require 'minitest/pride'
+require 'minitest/unit'
+require 'minitest/autorun'
+require_relative '../lib/human-date'
+
+class DateTranslatorTest < MiniTest::Unit::TestCase
+  def setup
+    @date_translator = HumanDate::DateTranslator.new
+  end
+
+  def translate to
+    from = DateTime.parse("2011-10-23T00:00:00")
+    to   = DateTime.parse(to)
+    @date_translator.translate(from, to)
+  end
+
+  def test_translate_returns_now_if_dates_are_equal
+    assert_equal "now", translate("2011-10-23T00:00:00")
+  end
+
+  def test_translate_returns_now_if_date_difference_is_within_tolerance
+    @date_translator.tolerance = 15
+    assert_equal "now", translate("2011-10-23T00:00:15")
+    assert_equal "now", translate("2011-10-23T00:00:10")
+  end
+
+  def test_translate_returns_years
+    assert_equal "1 year", translate("2012-10-23T00:00:00")
+    assert_equal "2 years", translate("2013-10-23T00:00:00")
+  end
+
+  def test_translate_returns_months
+    assert_equal "1 month", translate("2011-11-23T00:00:00")
+    assert_equal "2 months", translate("2011-12-23T00:00:00")
+  end
+
+  def test_translate_returns_days
+    assert_equal "1 day", translate("2011-10-24T00:00:00")
+    assert_equal "2 days", translate("2011-10-25T00:00:00")
+  end
+
+  def test_translate_returns_hours
+    assert_equal "1 hour", translate("2011-10-23T01:00:00")
+    assert_equal "2 hours", translate("2011-10-23T02:00:00")
+  end
+
+  def test_translate_returns_minutes
+    assert_equal "1 minute", translate("2011-10-23T00:01:00")
+    assert_equal "2 minutes", translate("2011-10-23T00:02:00")
+  end
+
+  def test_translate_returns_seconds
+    @date_translator.tolerance = 0
+    assert_equal "1 second", translate("2011-10-23T00:00:01")
+    assert_equal "2 seconds", translate("2011-10-23T00:00:02")
+  end
+
+  def test_translate_appends_ago_if_to_is_before_from
+    assert_equal "20 seconds ago", translate("2011-10-22T23:59:40")
+    assert_equal "1 day ago", translate("2011-10-22T00:00:00")
+  end
+
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: human-date
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Andrew Vos
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-31 00:00:00.000000000 +01:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &70305826377680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70305826377680
+description: Human readable date differences
+email:
+- andrew.vos@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- human-date.gemspec
+- lib/human-date.rb
+- lib/human-date/date_translator.rb
+- lib/human-date/version.rb
+- test/test_date_translator.rb
+has_rdoc: true
+homepage: https://github.com/AndrewVos/human-date
+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: human-date
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Human readable date differences
+test_files:
+- test/test_date_translator.rb