date-casually 0.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 twmills LLC
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,54 @@
+= DateCasually
+  
+If you've always expected the Rails date helpers to say "Today", "Yesterday" or "10 days ago" when asked about a specific date, then it's time to date casually. 
+
+I've never liked (and always seem to forget) the name of the Rails distance_of_time_in_words_to_now helper method. Additionally it doesn't handle obvious translations such as "today", "tomorrow" or "yesterday" and doesn't determine if a date is in the future ("10 days from now") or the past ("10 days ago").
+
+== Quick Examples
+
+  Date.today.casual 
+    #=> 'today'
+  
+  (Date.today + 1).casual 
+    #=> 'tomorrow'
+  
+  (Date.today - 1).casual 
+    #=> 'yesterday'          
+
+== The :as option
+
+If you'd like to change what increments of time DateCasually returns you can use the :as option. 
+  
+  (Date.today + 1).casual(:as => :months) 
+    #=> 'less than a month from now'
+
+You can also pass in multiple options:
+
+  (Date.today + 1).casual(:as => :days, :months, :years) 
+    #=> 'less than a month from now'
+    
+The default :as options for DatCasually are:
+  
+  (Date.today + 1).casual(:as => :days, :weeks, :months, :years) 
+  
+If you'd change DateCasually globally, do this:
+
+  DateCasually::Config.as = :months, :years
+
+== i18n
+
+Date-casually hooks into the i18n gem, but currently only supports English.
+
+== Dependencies
+
+* i18n
+* chronic (_only used in the test suite_)
+* timecop (_only used in the test suite_)
+
+== Roadmap
+
+* timezone support
+* configurable start of week
+* set up config class to handle global options (such as :include)
+* spanish translations (and others if people provide them)
+* configurable ranges (maybe...)

data/Rakefile

@@ -0,0 +1,41 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "date-casually"
+    gem.summary = %Q{Easy on the eyes alternative to the Rails distance_of_time_in_words_to_now helper method.}
+    gem.description = %Q{If you've never liked (and always seem to forget) the name of the Rails distance_of_time_in_words_to_now helper method, then it's time to date casually.}
+    gem.email = "twmills@twmills.com"
+    gem.homepage = "http://github.com/twmills/date-casually"
+    gem.authors = ["Theo Mills"]
+    gem.add_dependency 'i18n', ">= 0.4.1"    
+    gem.add_development_dependency "timecop", ">= 0.3.5"
+    gem.add_development_dependency "chronic", ">= 0.2.3"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "date-casually #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/date-casually.gemspec

@@ -0,0 +1,88 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{date-casually}
+  s.version = "0.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Theo Mills"]
+  s.date = %q{2010-08-26}
+  s.description = %q{If you've never liked (and always seem to forget) the name of the Rails distance_of_time_in_words_to_now helper method, then it's time to date casually.}
+  s.email = %q{twmills@twmills.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "date-casually.gemspec",
+     "lib/date-casually.rb",
+     "lib/date-casually/calculator.rb",
+     "lib/date-casually/config.rb",
+     "lib/date-casually/translator.rb",
+     "lib/date-casually/translators/day_of_week.rb",
+     "lib/date-casually/translators/days.rb",
+     "lib/date-casually/translators/months.rb",
+     "lib/date-casually/translators/weeks.rb",
+     "lib/date-casually/translators/years.rb",
+     "lib/extensions/date.rb",
+     "lib/locale/en.yml",
+     "lib/locale/en.yml.sorted",
+     "lib/util/alphabetize_yaml.rb",
+     "test/helper.rb",
+     "test/test_calculator.rb",
+     "test/test_date-casually.rb",
+     "test/test_day_of_week.rb",
+     "test/test_days.rb",
+     "test/test_months.rb",
+     "test/test_translator.rb",
+     "test/test_weeks.rb",
+     "test/test_years.rb",
+     "test/timeline.rb"
+  ]
+  s.homepage = %q{http://github.com/twmills/date-casually}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Easy on the eyes alternative to the Rails distance_of_time_in_words_to_now helper method.}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_calculator.rb",
+     "test/test_date-casually.rb",
+     "test/test_day_of_week.rb",
+     "test/test_days.rb",
+     "test/test_months.rb",
+     "test/test_translator.rb",
+     "test/test_weeks.rb",
+     "test/test_years.rb",
+     "test/timeline.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<i18n>, [">= 0.4.1"])
+      s.add_development_dependency(%q<timecop>, [">= 0.3.5"])
+      s.add_development_dependency(%q<chronic>, [">= 0.2.3"])
+    else
+      s.add_dependency(%q<i18n>, [">= 0.4.1"])
+      s.add_dependency(%q<timecop>, [">= 0.3.5"])
+      s.add_dependency(%q<chronic>, [">= 0.2.3"])
+    end
+  else
+    s.add_dependency(%q<i18n>, [">= 0.4.1"])
+    s.add_dependency(%q<timecop>, [">= 0.3.5"])
+    s.add_dependency(%q<chronic>, [">= 0.2.3"])
+  end
+end
+

data/lib/date-casually/calculator.rb

@@ -0,0 +1,48 @@
+module DateCasually
+  
+  # Contains short-cut calculations for determing the distance between
+  # today and a supplied date.
+  class Calculator
+
+    def self.number_of_weeks_from_today(date)
+      ((Date.today - date) / 7).to_i.abs
+    end
+    
+    def self.number_of_months_from_today(date)
+      ((Date.today.month - date.month) + 12 * (Date.today.year - date.year)).abs      
+    end
+    
+    def self.number_of_years_from_today(date)
+      years_diff = (Date.today.year - date.year).abs
+    end
+    
+    def self.this_week_range
+      self.this_past_sunday..(self.this_past_sunday + 6)
+    end
+    
+    def self.next_week_range
+      self.next_sunday..(self.next_sunday + 6)
+    end
+
+    def self.last_week_range
+      self.last_sunday..(self.last_sunday + 6)
+    end
+    
+    def self.next_sunday
+      date = Date.today
+      (date.wday == 0) ? (date += 7) : (date += 1 until (date.wday == 0))
+      date
+    end
+    
+    def self.last_sunday
+      self.this_past_sunday - 7
+    end
+    
+    def self.this_past_sunday
+      date = Date.today
+      (date.wday == 0) ? date : (date -= 1 until (date.wday == 0)) 
+      date
+    end
+    
+  end  
+end

data/lib/date-casually/config.rb

@@ -0,0 +1,14 @@
+module DateCasually  
+  class Config
+    class << self
+      attr_accessor :as
+    end
+    
+    def self.reset
+      self.as = [:days, :weeks, :months, :years]
+    end
+    
+    #reset the first time we are loaded.
+    self.reset
+  end
+end

data/lib/date-casually/translator.rb

@@ -0,0 +1,59 @@
+module DateCasually
+  
+  # The Translator class is the core of the date-casually functionality,
+  # translating the supplied date to its casual equivalent. 
+  class Translator
+    
+    # The possible options and order of the :as toggle
+    AS_OPTIONS = [:days, :day_of_week, :weeks, :months, :years]
+    
+    # 
+    # This method takes the supplied date and determines how it should be translated 
+    # into its casual equivalent. If the :as option is passed with a valid value,
+    # then the date is evaluated against that scope, e.g. :as=>:day_of_week.
+    # Otherwise, the Translator iterates through all the available scopes until a
+    # match on the supplied date is made.
+    #
+    # Though it's easier to use date-casually date extension and monkey-patch
+    # this function into the Date class, it's also possible to call the casual
+    # function directly.
+    #
+    def self.casual(date, options = {})
+      
+      # Process in order until we hit a condition that matches
+      # the supplied date.
+      translator = nil
+      self.as_options(options).each do |option|
+          translator = self.get_translator(option)
+          translation = translator.translate(date)
+          return translation unless translation.nil?
+      end              
+      
+      # If no conditions are caught, use our last :as option to create
+      # explicit counts. I.e. 470 days ago, 46 months from now, 4 years from now, etc.
+      unless translator.nil?
+        translation = translator.translate_count(date)      
+        return translation unless translation.nil?
+      end
+      
+      raise "[date-casually] No ruleset defined for this date: #{date}"
+    end
+    
+    # 
+    # Process :as option if passed, otherwise use global config
+    def self.as_options(options)
+      as = []
+      as << (!options.nil? && options.has_key?(:as) ? options[:as] : DateCasually::Config.as)
+      self::AS_OPTIONS & as.flatten
+    end
+    
+    def self.get_translator(sym)
+      DateCasually::Translators.const_get(self.camelcase(sym.to_s))
+    end
+    
+    def self.camelcase(string)
+      string.downcase.gsub(/\b[a-z]|_+[a-z]/) { |a| a.upcase }.gsub(/\s|_/,'')
+    end
+        
+  end
+end

data/lib/date-casually/translators/day_of_week.rb

@@ -0,0 +1,30 @@
+module DateCasually
+  module Translators  
+    class DayOfWeek    
+    
+      # Scopes for translation into day of week
+      def self.translate(date)
+        today = Date.today
+        case
+        when date == today then I18n.t('date.casual.today')
+        when (date - today).abs <= 3
+          key = today < date ? "date.casual.this_wday_#{date.wday}" : "date.casual.this_past_wday_#{date.wday}"
+          I18n.t(key)
+        when DateCasually::Calculator.last_week_range.include?(date)
+          I18n.t("date.casual.last_wday_#{date.wday}")
+        when DateCasually::Calculator.next_week_range.include?(date)
+          I18n.t("date.casual.next_wday_#{date.wday}")
+        else
+          nil
+        end
+      end
+    
+      # Translates into number of days of weeks away, e.g. "6 Mondays ago"
+      def self.translate_count(date)
+        key = Date.today < date ? "date.casual.wdays_from_now_#{date.wday}" : "date.casual.wdays_ago_#{date.wday}"
+        I18n.t(key, :number => DateCasually::Calculator.number_of_weeks_from_today(date))      
+      end
+    
+    end
+  end
+end

data/lib/date-casually/translators/days.rb

@@ -0,0 +1,26 @@
+module DateCasually
+  module Translators  
+    class Days    
+    
+      # Scopes for translation into days
+      def self.translate(date)
+        today = Date.today
+        case
+        when date == today then I18n.t('date.casual.today')
+        when date == today + 1 then I18n.t('date.casual.tomorrow')
+        when date == (today - 1) then I18n.t('date.casual.yesterday')
+        when date == (today + 2) then I18n.t('date.casual.couple_of_days_from_now')
+        when date == (today - 2) then I18n.t('date.casual.couple_of_days_ago')
+        else nil
+        end
+      end
+    
+      # Translates into number of days away, e.g. "6 days ago"
+      def self.translate_count(date)
+        i18n_key = (date < Date.today) ? 'ago' : 'from_now'
+        I18n.t("date.casual.days_#{i18n_key}", :number => (date - Date.today).abs) 
+      end
+    
+    end
+  end
+end

data/lib/date-casually/translators/months.rb

@@ -0,0 +1,32 @@
+module DateCasually
+  module Translators
+  
+    class Months    
+      
+      # Scopes for translation into months
+      def self.translate(date)
+        today = Date.today
+        case
+        when (today - date).abs <= 29
+          key = today < date ? 'date.casual.less_than_a_month_from_now' : 'date.casual.less_than_a_month_ago'
+          I18n.t(key)            
+        when (30..60).include?((today - date).abs)
+          key = today < date ? 'date.casual.next_month' : 'date.casual.last_month'
+          I18n.t(key)
+        when DateCasually::Calculator.number_of_months_from_today(date) == 2
+          key = today < date ? 'date.casual.couple_of_months_from_now' : 'date.casual.couple_of_months_ago'
+          I18n.t(key)
+        else
+          nil
+        end
+      end
+    
+      # Translates into number of months away, e.g. "6 months ago"
+      def self.translate_count(date)
+        key = Date.today < date ? 'date.casual.months_from_now' : 'date.casual.months_ago'
+        date = I18n.t(key, :number => DateCasually::Calculator.number_of_months_from_today(date))
+      end    
+    
+    end
+  end
+end

data/lib/date-casually/translators/weeks.rb

@@ -0,0 +1,32 @@
+module DateCasually
+  module Translators  
+    class Weeks    
+
+        # Scopes for translation into weeks
+        def self.translate(date)
+          today = Date.today
+          case
+          when DateCasually::Calculator.this_week_range.include?(date)
+            key = today < date ? 'date.casual.less_than_a_week_from_now' : 'date.casual.less_than_a_week_ago'
+            I18n.t(key)
+          when DateCasually::Calculator.last_week_range.include?(date)
+            I18n.t('date.casual.last_week')
+          when DateCasually::Calculator.next_week_range.include?(date)
+            I18n.t('date.casual.next_week')
+          when (today - date).abs < 21
+            key = today < date ? 'date.casual.couple_of_weeks_from_now' : 'date.casual.couple_of_weeks_ago'
+            I18n.t(key)      
+          else
+            nil
+          end
+        end
+      
+        # Translates into number of weeks away, e.g. "6 weeks ago"
+        def self.translate_count(date)
+          key = Date.today < date ? 'date.casual.weeks_from_now' : 'date.casual.weeks_ago'
+          I18n.t(key, :number => DateCasually::Calculator.number_of_weeks_from_today(date))      
+        end
+    
+    end
+  end
+end

data/lib/date-casually/translators/years.rb

@@ -0,0 +1,35 @@
+module DateCasually
+  module Translators  
+    class Years    
+
+      # Scopes for translation into years
+      def self.translate(date)
+        today = Date.today
+        case
+        when DateCasually::Calculator.number_of_months_from_today(date) < 12
+          if (date.year - today.year).abs == 1
+            key = today < date ? 'date.casual.next_year' : 'date.casual.last_year'
+          else
+            key = today < date ? 'date.casual.less_than_a_year_from_now' : 'date.casual.less_than_a_year_ago'
+          end
+          I18n.t(key)      
+        when (date.year - today.year).abs == 1
+          key = today < date ? 'date.casual.next_year' : 'date.casual.last_year'    
+          I18n.t(key)      
+        when DateCasually::Calculator.number_of_months_from_today(date) <= 30
+          key = today < date ? 'date.casual.couple_of_years_from_now' : 'date.casual.couple_of_years_ago'
+          I18n.t(key)
+        else 
+          nil
+        end      
+      end
+        
+      # Translates into number of weeks away, e.g. "6 years ago"
+      def self.translate_count(date)
+        key = Date.today < date ? 'date.casual.years_from_now' : 'date.casual.years_ago'
+        I18n.t(key, :number => DateCasually::Calculator.number_of_years_from_today(date))
+      end
+    
+    end
+  end
+end

data/lib/date-casually.rb

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'date'
+require 'i18n'
+require "date-casually/config"
+require "date-casually/calculator"
+require "date-casually/translator"
+require "date-casually/translators/days"
+require "date-casually/translators/weeks"
+require "date-casually/translators/months"
+require "date-casually/translators/day_of_week"
+require "date-casually/translators/years"
+require "extensions/date"
+
+# load up translations
+I18n.load_path << Dir[File.join(File.dirname(__FILE__), 'locale', '*.{rb,yml}')]

data/lib/extensions/date.rb

@@ -0,0 +1,5 @@
+class Date
+  def casual(options = {})
+    DateCasually::Translator.casual(self, options)
+  end  
+end

data/lib/locale/en.yml

@@ -0,0 +1,93 @@
+en:
+  date:
+    casual:
+      today: "today"
+      tomorrow: "tomorrow"
+      yesterday: "yesterday"
+      next_week: "next week"
+      last_week: "last week"
+      this_wday_0: "this Sunday"
+      this_wday_1: "this Monday"
+      this_wday_2: "this Tuesday"
+      this_wday_3: "this Wednesday"
+      this_wday_4: "this Thursday"
+      this_wday_5: "this Friday"            
+      this_wday_6: "this Saturday"  
+      this_past_wday_0: "this past Sunday"
+      this_past_wday_1: "this past Monday"
+      this_past_wday_2: "this past Tuesday"
+      this_past_wday_3: "this past Wednesday"
+      this_past_wday_4: "this past Thursday"
+      this_past_wday_5: "this past Friday"            
+      this_past_wday_6: "this past Saturday"  
+      next_wday_0: "next Sunday"
+      next_wday_1: "next Monday"
+      next_wday_2: "next Tuesday"
+      next_wday_3: "next Wednesday"
+      next_wday_4: "next Thursday"
+      next_wday_5: "next Friday"            
+      next_wday_6: "next Saturday"
+      last_wday_0: "last Sunday"
+      last_wday_1: "last Monday"
+      last_wday_2: "last Tuesday"
+      last_wday_3: "last Wednesday"
+      last_wday_4: "last Thursday"
+      last_wday_5: "last Friday"            
+      last_wday_6: "last Saturday"  
+      wdays_from_now_0: "%{number} Sundays from now" 
+      wdays_from_now_1: "%{number} Mondays from now" 
+      wdays_from_now_2: "%{number} Tuesdays from now" 
+      wdays_from_now_3: "%{number} Wednesdays from now"   
+      wdays_from_now_4: "%{number} Thursdays from now"         
+      wdays_from_now_5: "%{number} Fridays from now" 
+      wdays_from_now_6: "%{number} Saturdays from now"
+      wdays_ago_0: "%{number} Sundays ago" 
+      wdays_ago_1: "%{number} Mondays ago" 
+      wdays_ago_2: "%{number} Tuesdays ago" 
+      wdays_ago_3: "%{number} Wednesdays ago"   
+      wdays_ago_4: "%{number} Thursdays ago"         
+      wdays_ago_5: "%{number} Fridays ago" 
+      wdays_ago_6: "%{number} Saturdays ago" 
+      one_day_ago: "one day ago"
+      days_ago: "%{number} days ago"
+      a_week_ago: "a week ago"
+      more_than_a_week_ago: "more than a week ago"
+      weeks_ago: "%{number} weeks ago"
+      exactly_one_month_ago: "exactly one month ago"
+      exactly_one_month_from_now: "exactly one month from now"
+      more_than_a_month_ago: "more than a month ago"
+      less_than_a_month_ago: "less than a month ago"
+      more_than_a_month_from_now: "more than a month from now"
+      less_than_a_month_from_now: "less than a month from now"
+      more_than_a_week_ago: "more than a week ago"
+      less_than_a_week_ago: "less than a week ago"
+      more_than_a_week_from_now: "more than a week from now"
+      less_than_a_week_from_now: "less than a week from now"
+      about_a_week_from_now: "about a week from now"
+      about_a_week_ago: "about a week ago"
+      more_than_a_year_ago: "more than a year ago"
+      less_than_a_year_ago: "less than a year ago"
+      more_than_a_year_from_now: "more than a year from now"
+      less_than_a_year_from_now: "less than a year from now"      
+      months_ago: "%{number} months ago"
+      next_month: "next month"
+      last_month: "last month"
+      a_year_ago: "a year ago"
+      a_year_from_now: "a year from now"
+      years_ago: "%{number} years ago"
+      next_year: "next year"
+      last_year: "last year"
+      days_from_now: "%{number} days from now"
+      weeks_from_now: "%{number} weeks from now"
+      months_from_now: "%{number} months from now"
+      years_from_now: "%{number} years from now"
+      in_a_couple_of_days: "in a couple of days"
+      in_a_couple_of_weeks: "in a couple of weeks"
+      couple_of_months_ago: "a couple of months ago"
+      couple_of_months_from_now: "a couple of months from now"  
+      couple_of_days_from_now: "a couple of days from now"  
+      couple_of_days_ago: "a couple of days ago"  
+      couple_of_weeks_ago: "a couple of weeks ago"  
+      couple_of_weeks_from_now: "a couple of weeks from now"  
+      couple_of_years_ago: "a couple of years ago"
+      couple_of_years_from_now: "a couple of years from now"  

data/lib/locale/en.yml.sorted

@@ -0,0 +1,85 @@
+en: 
+  date: 
+    casual: 
+      a_week_ago: a week ago
+      a_year_ago: a year ago
+      a_year_from_now: a year from now
+      about_a_week_ago: about a week ago
+      about_a_week_from_now: about a week from now
+      couple_of_days_ago: a couple of days ago
+      couple_of_days_from_now: a couple of days from now
+      couple_of_months_ago: a couple of months ago
+      couple_of_months_from_now: a couple of months from now
+      couple_of_weeks_ago: a couple of weeks ago
+      couple_of_weeks_from_now: a couple of weeks from now
+      couple_of_years_ago: a couple of years ago
+      couple_of_years_from_now: a couple of years from now
+      days_ago: {{number}} days ago
+      days_from_now: {{number}} days from now
+      exactly_one_month_ago: exactly one month ago
+      exactly_one_month_from_now: exactly one month from now
+      in_a_couple_of_days: in a couple of days
+      in_a_couple_of_weeks: in a couple of weeks
+      last_month: last month
+      last_wday_0: last Sunday
+      last_wday_1: last Monday
+      last_wday_2: last Tuesday
+      last_wday_3: last Wednesday
+      last_wday_4: last Thursday
+      last_wday_5: last Friday
+      last_wday_6: last Saturday
+      last_week: last week
+      last_year: last year
+      less_than_a_month_ago: less than a month ago
+      less_than_a_month_from_now: less than a month from now
+      less_than_a_week_ago: less than a week ago
+      less_than_a_week_from_now: less than a week from now
+      less_than_a_year_ago: less than a year ago
+      less_than_a_year_from_now: less than a year from now
+      months_ago: {{number}} months ago
+      months_from_now: {{number}} months from now
+      more_than_a_month_ago: more than a month ago
+      more_than_a_month_from_now: more than a month from now
+      more_than_a_week_ago: more than a week ago
+      more_than_a_week_from_now: more than a week from now
+      more_than_a_year_ago: more than a year ago
+      more_than_a_year_from_now: more than a year from now
+      next_month: next month
+      next_wday_0: next Sunday
+      next_wday_1: next Monday
+      next_wday_2: next Tuesday
+      next_wday_3: next Wednesday
+      next_wday_4: next Thursday
+      next_wday_5: next Friday
+      next_wday_6: next Saturday
+      next_week: next week
+      next_year: next year
+      one_day_ago: one day ago
+      this_past_wday_0: this past Sunday
+      this_past_wday_1: this past Monday
+      this_past_wday_2: this past Tuesday
+      this_past_wday_3: this past Wednesday
+      this_past_wday_4: this past Thursday
+      this_past_wday_5: this past Friday
+      this_past_wday_6: this past Saturday
+      this_wday_0: this Sunday
+      this_wday_1: this Monday
+      this_wday_2: this Tuesday
+      this_wday_3: this Wednesday
+      this_wday_4: this Thursday
+      this_wday_5: this Friday
+      this_wday_6: this Saturday
+      today: today
+      tomorrow: tomorrow
+      wdays_ago_0: {{number}} Sundays ago
+      wdays_ago_1: {{number}} Mondays ago
+      wdays_ago_2: {{number}} Tuesdays ago
+      wdays_ago_3: {{number}} Wednesdays ago
+      wdays_ago_4: {{number}} Thursdays ago
+      wdays_ago_5: {{number}} Fridays ago
+      wdays_ago_6: {{number}} Saturdays ago
+      weeks_ago: {{number}} weeks ago
+      weeks_from_now: {{number}} weeks from now
+      years_ago: {{number}} years ago
+      years_from_now: {{number}} years from now
+      yesterday: yesterday

data/lib/util/alphabetize_yaml.rb

@@ -0,0 +1,38 @@
+require 'yaml'
+class Hash
+  def to_sorted_yaml( opts = {} )
+    YAML::quick_emit( object_id, opts ) do |out|
+      out.map( taguri, to_yaml_style ) do |map|
+        sort.each do |k, v| 
+          map.add(k,v)
+          if v.is_a? Hash
+            v.sort.each do |x,y|
+              if y.is_a? Hash
+                y.sort.each do |u,t|
+                  map.add(u,t)
+                end
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+  
+end
+files = Dir.glob(File.join(File.dirname(__FILE__),"*.yml"))
+
+files.each do |file|
+  hash = YAML::load(File.read(file))
+  def alphabetize(hash, tabs = 0)
+    string=""
+    hash.keys.sort.each do |key| 
+      tabs.times { string << " " }
+      string << (hash[key].is_a?(Hash) ? ("#{key}: \n" + alphabetize(hash[key], tabs + 2)) : "#{key}: #{hash[key]}\n")
+    end
+    string
+  end
+  File.open(file + '.sorted', 'w') { |f| f.write(alphabetize(hash)) }
+end
+

data/test/helper.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'test/unit'
+require 'chronic'
+require 'timecop'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'date-casually'
+
+# freeze time for test consistency
+t = Time.local(2008, 9, 1, 10, 5, 0)
+Timecop.travel(t)
+
+class Test::Unit::TestCase
+  def parse(string)
+    Date.parse(Chronic.parse(string).strftime('%b %d, %Y'))
+  end
+
+  def self.method_name(name, options)
+    if (options != nil) && options.has_key?(:as)
+      "test_#{name}_as_#{options[:as]}"
+    else
+      "test_#{name}"
+    end
+  end  
+    
+end

data/test/test_calculator.rb

@@ -0,0 +1,59 @@
+require 'helper'
+
+class TestCalculator < Test::Unit::TestCase
+  
+  def test_last_week_range
+    sunday = Date.today.wday == 0 ? Date.today : parse('last Sunday')
+    sunday -= 7
+    saturday = sunday + 6
+    assert_equal sunday..saturday, DateCasually::Calculator.last_week_range
+  end
+  
+  def test_last_sunday
+    sunday = Date.today.wday == 0 ? Date.today : parse('last Sunday')
+    sunday -= 7
+    assert_equal sunday, DateCasually::Calculator.last_sunday
+  end
+  
+  def test_this_past_sunday
+    sunday = Date.today.wday == 0 ? Date.today : parse('last Sunday')
+    assert_equal sunday, DateCasually::Calculator.this_past_sunday
+  end
+  
+  def test_next_week_range
+    sunday = parse('next Sunday')
+    assert_equal sunday..sunday + 6, DateCasually::Calculator.next_week_range
+  end
+  
+  def test_this_week_range
+    sunday = Date.today.wday == 0 ? Date.today : parse('last Sunday')
+    saturday = sunday + 6
+    assert_equal sunday..saturday, DateCasually::Calculator.this_week_range
+  end
+  
+  def test_next_sunday
+    assert_equal parse('next Sunday'), DateCasually::Calculator.next_sunday
+  end
+  
+  (1..100).each do |x|
+    define_method("test_#{x}_weeks_from_today".to_sym) do
+      assert_equal x, DateCasually::Calculator.number_of_weeks_from_today(parse("in #{x} weeks"))
+    end
+  end
+
+  (1..200).each do |x|
+    define_method("test_#{x}_months_from_today".to_sym) do
+      assert_equal x, DateCasually::Calculator.number_of_months_from_today(parse("in #{x} months"))
+    end
+    define_method("test_#{x}_months_ago".to_sym) do
+      assert_equal x, DateCasually::Calculator.number_of_months_from_today(parse("#{x} months ago"))
+    end
+  end
+
+  (1..400).each do |x|
+    define_method("test_#{x}_years_from_today".to_sym) do
+      assert_equal x, DateCasually::Calculator.number_of_years_from_today(parse("in #{x} years"))
+    end
+  end
+  
+end

data/test/test_date-casually.rb

@@ -0,0 +1,2 @@
+require "test_calculator"
+require "test_translator"

data/test/test_day_of_week.rb

@@ -0,0 +1,37 @@
+require 'helper'
+
+class TestDayOfWeek < Test::Unit::TestCase
+  
+  def test_next_wday
+    date = parse('7 days from now')      
+    assert_equal I18n.t("date.casual.next_wday_#{date.wday}"), date.casual(:as => :day_of_week)
+  end
+  
+  def test_this_wday
+    date = parse('3 days from now')      
+    assert_equal I18n.t("date.casual.this_wday_#{date.wday}"), date.casual(:as => :day_of_week)
+  end  
+  
+  def test_last_wday
+    date = parse('7 days ago')
+    assert_equal I18n.t("date.casual.last_wday_#{date.wday}"), date.casual(:as => :day_of_week)
+  end
+  
+  def test_this_past_wday
+    date = parse('3 days ago')
+    assert_equal I18n.t("date.casual.this_past_wday_#{date.wday}"), date.casual(:as => :day_of_week)
+  end
+
+  (14..366).each do |x|
+    weeks = x / 7
+    define_method "test_#{x}_wdays_ago" do
+      date = parse("#{x} days ago")
+      assert_equal I18n.t("date.casual.wdays_ago_#{date.wday}", :number => weeks), date.casual(:as => :day_of_week)
+    end
+    define_method "test_#{x}_wdays_from_now" do
+      date = parse("in #{x} days")
+      assert_equal I18n.t("date.casual.wdays_from_now_#{date.wday}", :number => weeks), date.casual(:as => :day_of_week)
+    end
+  end
+  
+end

data/test/test_days.rb

@@ -0,0 +1,40 @@
+require 'helper'
+
+class TestDays < Test::Unit::TestCase
+  
+  # Test day ranges both with and without the :as => :days option
+  [nil, {:as => :days}].each do |options|
+    define_method method_name('yesterday', options) do
+      date = parse('yesterday')
+      assert_equal I18n.t('date.casual.yesterday'), date.casual(options)
+    end
+
+    define_method method_name('tomorrow', options) do
+      date = parse('tomorrow')    
+      assert_equal I18n.t('date.casual.tomorrow'), date.casual(options)
+    end
+  
+    define_method method_name('couple_of_days_ago', options) do
+      date = parse('today') - 2
+      assert_equal I18n.t('date.casual.couple_of_days_ago'), date.casual(options) 
+    end
+  
+    define_method method_name('couple_of_days_from_now', options) do
+      date = parse('today') + 2
+      assert_equal I18n.t('date.casual.couple_of_days_from_now'), date.casual(options) 
+    end
+  end
+
+  (3..366).each do |x|
+    define_method "test_#{x}_days_ago_as_days" do
+      date = parse("#{x} days ago")
+      assert_equal I18n.t('date.casual.days_ago', :number => x), date.casual(:as => :days)
+    end
+    define_method "test_#{x}_days_from_now_as_days" do
+      date = parse("in #{x} days")
+      assert_equal I18n.t('date.casual.days_from_now', :number => x), date.casual(:as => :days)
+    end
+  end
+
+  
+end

data/test/test_months.rb

@@ -0,0 +1,59 @@
+require 'helper'
+
+class TestMonths < Test::Unit::TestCase
+  
+  # Test month ranges both with and without the :as => :months option
+  [nil, {:as => :months}].each do |options|
+    define_method method_name('less_than_a_month_ago', options) do
+      date = parse('3 weeks ago')
+      assert_equal I18n.t('date.casual.less_than_a_month_ago'), date.casual(options)    
+    end
+
+    define_method method_name('less_than_a_month_from_now', options) do
+      date = parse('in 3 weeks')
+      assert_equal I18n.t('date.casual.less_than_a_month_from_now'), date.casual(options)    
+    end
+  
+    define_method method_name('exactly_one_month_from_now', options) do
+      date = parse('1 month from now')
+      assert_equal I18n.t('date.casual.next_month'), date.casual(options)    
+    end
+  
+    define_method method_name('exactly_one_month_ago', options) do
+      date = parse('1 month ago')
+      assert_equal I18n.t('date.casual.last_month'), date.casual(options)    
+    end
+  
+    define_method method_name('next_month', options) do
+      date = parse('in 1 month') + 1
+      assert_equal I18n.t('date.casual.next_month'), date.casual(options)    
+    end
+  
+    define_method method_name('last_month', options) do
+      date = parse('1 month ago') - 1
+      assert_equal I18n.t('date.casual.last_month'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_months_from_now', options) do
+      date = parse('in 2 months')
+      assert_equal I18n.t('date.casual.couple_of_months_from_now'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_months_ago', options) do
+      date = parse('2 months ago')
+      assert_equal I18n.t('date.casual.couple_of_months_ago'), date.casual(options)    
+    end
+  end
+  
+  (3..24).each do |x|
+    define_method "test_#{x}_months_ago_as_months" do
+      date = parse("#{x} months ago")
+      assert_equal I18n.t('date.casual.months_ago', :number => x), date.casual(:as => :months)
+    end
+    define_method "test_#{x}_months_from_now_as_months" do
+      date = parse("in #{x} months")
+      assert_equal I18n.t('date.casual.months_from_now', :number => x), date.casual(:as => :months)
+    end
+  end
+  
+end

data/test/test_translator.rb

@@ -0,0 +1,4 @@
+require "test_days"
+require "test_weeks"
+require "test_months"
+require "test_years"

data/test/test_weeks.rb

@@ -0,0 +1,40 @@
+require 'helper'
+
+class TestWeeks < Test::Unit::TestCase
+  
+  # Test week ranges both with and without the :as => :weeks option
+  [nil, {:as => :weeks}].each do |options|
+  
+    define_method method_name('next_week', options) do
+      date = DateCasually::Calculator.this_week_range.last + 3
+      assert_equal I18n.t('date.casual.next_week'), date.casual(options)    
+    end
+  
+    define_method method_name('last_week', options) do
+      date = DateCasually::Calculator.last_sunday + 1
+      assert_equal I18n.t('date.casual.last_week'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_weeks_from_now', options) do
+      date = parse('in 2 weeks')
+      assert_equal I18n.t('date.casual.couple_of_weeks_from_now'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_weeks_ago', options) do
+      date = parse('2 weeks ago')
+      assert_equal I18n.t('date.casual.couple_of_weeks_ago'), date.casual(options)    
+    end
+  end
+  
+  (3..53).each do |x|
+    define_method "test_#{x}_weeks_ago_as_weeks" do
+      date = parse("#{x} weeks ago")
+      assert_equal I18n.t('date.casual.weeks_ago', :number => x), date.casual(:as => :weeks)
+    end
+    define_method "test_#{x}_weeks_from_now_as_weeks" do
+      date = parse("in #{x} weeks")
+      assert_equal I18n.t('date.casual.weeks_from_now', :number => x), date.casual(:as => :weeks)
+    end
+  end
+  
+end

data/test/test_years.rb

@@ -0,0 +1,60 @@
+require 'helper'
+
+class TestYears < Test::Unit::TestCase
+  
+  # Test year ranges both with and without the :as => :years option
+  [nil, {:as => :years}].each do |options|
+    define_method method_name('less_than_a_year_ago', options) do
+      date = parse('3 months ago')
+      assert_equal I18n.t('date.casual.less_than_a_year_ago'), date.casual(options)    
+    end
+
+    define_method method_name('less_than_a_year_from_now', options) do
+      date = parse('in 3 months')
+      assert_equal I18n.t('date.casual.less_than_a_year_from_now'), date.casual(options)    
+    end
+  
+    define_method method_name('exactly_one_year_from_now', options) do
+      date = parse('in 1 year')
+      assert_equal I18n.t('date.casual.next_year'), date.casual(options)    
+    end
+  
+    define_method method_name('exactly_one_year_ago', options) do
+      date = parse('1 year ago')
+      assert_equal I18n.t('date.casual.last_year'), date.casual(options)    
+    end
+  
+    define_method method_name('next_year', options) do
+      date = parse('in 1 year') + 2
+      assert_equal I18n.t('date.casual.next_year'), date.casual(options)    
+    end
+  
+    define_method method_name('last_year', options) do
+      date = parse('1 year ago') - 2
+      assert_equal I18n.t('date.casual.last_year'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_years_from_now', options) do
+      date = parse('in 2 years')
+      assert_equal I18n.t('date.casual.couple_of_years_from_now'), date.casual(options)    
+    end
+  
+    define_method method_name('couple_of_years_ago', options) do
+      date = parse('2 years ago')
+      assert_equal I18n.t('date.casual.couple_of_years_ago'), date.casual(options)    
+    end
+    
+    # Since years is our highest unit of time (as opposed to decades, etc),
+    # we'll also test year counts both with and without the :as => :years option.
+    (3..10).each do |x|
+      define_method method_name("#{x}_years_ago", options) do
+        date = parse("#{x} years ago")
+        assert_equal I18n.t('date.casual.years_ago', :number => x), date.casual(options)        
+      end
+      define_method method_name("#{x}_years_from_now", options) do
+        date = parse("in #{x} years")
+        assert_equal I18n.t('date.casual.years_from_now', :number => x), date.casual(options)
+      end
+    end
+  end
+end

data/test/timeline.rb

@@ -0,0 +1,11 @@
+require 'helper'
+# max = 400
+# as = :week
+# max.downto(1).each do |x|
+#   puts "+#{(Date.today + x).to_s} = #{(Date.today + x).casual(:as => as)}"
+# end
+# 1.upto(max).each do |x|
+#   puts "-#{(Date.today - x).to_s} = #{(Date.today - x).casual(:as => as)}"
+# end
+DateCasually::Config.as = :months
+puts (Date.today + 1).casual

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification 
+name: date-casually
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- Theo Mills
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-26 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 0
+        - 4
+        - 1
+        version: 0.4.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: timecop
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 0
+        - 3
+        - 5
+        version: 0.3.5
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: chronic
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 0
+        - 2
+        - 3
+        version: 0.2.3
+  type: :development
+  version_requirements: *id003
+description: If you've never liked (and always seem to forget) the name of the Rails distance_of_time_in_words_to_now helper method, then it's time to date casually.
+email: twmills@twmills.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- date-casually.gemspec
+- lib/date-casually.rb
+- lib/date-casually/calculator.rb
+- lib/date-casually/config.rb
+- lib/date-casually/translator.rb
+- lib/date-casually/translators/day_of_week.rb
+- lib/date-casually/translators/days.rb
+- lib/date-casually/translators/months.rb
+- lib/date-casually/translators/weeks.rb
+- lib/date-casually/translators/years.rb
+- lib/extensions/date.rb
+- lib/locale/en.yml
+- lib/locale/en.yml.sorted
+- lib/util/alphabetize_yaml.rb
+- test/helper.rb
+- test/test_calculator.rb
+- test/test_date-casually.rb
+- test/test_day_of_week.rb
+- test/test_days.rb
+- test/test_months.rb
+- test/test_translator.rb
+- test/test_weeks.rb
+- test/test_years.rb
+- test/timeline.rb
+has_rdoc: true
+homepage: http://github.com/twmills/date-casually
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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.3.7
+signing_key: 
+specification_version: 3
+summary: Easy on the eyes alternative to the Rails distance_of_time_in_words_to_now helper method.
+test_files: 
+- test/helper.rb
+- test/test_calculator.rb
+- test/test_date-casually.rb
+- test/test_day_of_week.rb
+- test/test_days.rb
+- test/test_months.rb
+- test/test_translator.rb
+- test/test_weeks.rb
+- test/test_years.rb
+- test/timeline.rb