smarter_dates 0.2.7.8

data/.gitignore

@@ -0,0 +1,2 @@
+pkg
+.rvmrc

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [Paul Belt]
+
+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,38 @@
+= SmarterDates -- Natural languange date parsing for all date/datetime attributes
+
+machina to automatically parse (with the chronic gem) date/datetime attributes upon assignment
+
+
+== Example
+
+  require File.join(File.dirname(__FILE__),'lib','smarter_dates')
+
+  class MyObject
+    attr_accessor :birth_d
+
+    include SmarterDates
+  end
+
+  obj = MyObject.new
+  obj.birth_d = '7 days ago'
+
+  puts obj.birth_d
+  # => Thu Apr 22 12:00:00 -0500 1976
+
+== Use case
+
+Humans want to think of date and datetime attributes in a natural manner.
+Standard ruby Date and DateTime objects do not support this well.
+
+== Installation
+
+ % gem install smarter_dates
+
+== License
+
+Copyright (c) 2010 [Paul Belt], released under the MIT license
+
+== Support
+
+http://github.com/belt/smarter_dates
+

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the smarter_dates gem.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the smarter_dates gem.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'SmarterDates'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = 'smarter_dates'
+    gemspec.summary = 'machina to automatically parse date/datetime attributes upon assignment.'
+    gemspec.description = "Humans want to think of date and datetime attributes in a natural manner.\nStandard ruby Date and DateTime objects do not support this well."
+    gemspec.email = 'Paul Belt'
+    gemspec.authors = ['Paul Belt']
+    gemspec.homepage = 'http://github.com/belt/smarter_dates'
+    gemspec.extra_rdoc_files = ['README.rdoc']
+    gemspec.rdoc_options = ['--charset=UTF-8']
+    gemspec.add_dependency('chronic', '~> 0.2.3')
+    gemspec.rubyforge_project = 'smarter_dates'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:minor: 2
+:patch: 7
+:build: 8

data/lib/smarter_dates.rb

@@ -0,0 +1,59 @@
+module SmarterDates
+require 'chronic'
+
+def self.included( klass ) # :nodoc:
+  dt_attributes = []
+  db_migrated = true
+  if defined?(Rails)
+    begin
+      dt_attributes.concat(klass.column_names.select{|k|k.match(/_(?:at|on|dt|d)$/)})
+      Rails.logger.debug(RuntimeError,"unused include - #{klass.class.to_s} does not have any attributes ending in _at, _on, _dt, or _d") if db_migrated && dt_attributes.empty?
+    rescue ActiveRecord::StatementInvalid => e
+      db_migrated = false
+    rescue => e
+      Rails.logger.debug(e.inspect)
+      db_migrated = false
+    end
+  else
+    dt_attributes.concat(klass.instance_methods.select{|k|k.match(/_(?:at|on|dt|d)$/)})
+  end
+
+  # :call-seq:
+  #   _on(string)
+  #   _at(string)
+  #   _dt(string)
+  #   _d(string)
+  #
+  # Any attribute ending in _at, _on, _dt, or _d are parsed by Chronic.parse
+  # (for flexibility).  Values are passed as is to Chronic.parse()
+  #
+  # == Arguments
+  # <tt>string</tt>:: A string
+
+  dt_attributes.each do |k|
+    parse = Proc.new do |val|
+      begin
+        dt = Chronic.parse(val.to_s(:db))
+      rescue
+        dt = Chronic.parse(val.to_s)
+      rescue
+        dt = DateTime.parse(val)
+      rescue
+        dt = Date.parse(val)
+      rescue
+        dt = val
+      end
+
+      if respond_to?(:write_attribute)
+        write_attribute(k,dt)
+      else
+        instance_variable_set(:"@#{k}",dt)
+      end
+    end
+    klass.send(:define_method, "#{k}=".to_sym, &parse)
+  end
+end
+
+# /module
+end
+

data/smarter_dates.gemspec

@@ -0,0 +1,52 @@
+# 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{smarter_dates}
+  s.version = "0.2.7.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Paul Belt"]
+  s.date = %q{2010-10-20}
+  s.description = %q{Humans want to think of date and datetime attributes in a natural manner.
+Standard ruby Date and DateTime objects do not support this well.}
+  s.email = %q{Paul Belt}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "lib/smarter_dates.rb",
+     "smarter_dates.gemspec",
+     "test/smarter_dates_test.rb"
+  ]
+  s.homepage = %q{http://github.com/belt/smarter_dates}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{smarter_dates}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{machina to automatically parse date/datetime attributes upon assignment.}
+  s.test_files = [
+    "test/smarter_dates_test.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<chronic>, ["~> 0.2.3"])
+    else
+      s.add_dependency(%q<chronic>, ["~> 0.2.3"])
+    end
+  else
+    s.add_dependency(%q<chronic>, ["~> 0.2.3"])
+  end
+end
+

data/test/smarter_dates_test.rb

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'test/unit'
+require File.join(File.dirname(__FILE__),'..','lib','smarter_dates')
+
+class Model
+  attr_accessor :name
+  attr_accessor :birth_d
+  attr_accessor :meeting_dt
+  attr_accessor :created_on
+  attr_accessor :updated_at
+
+  include SmarterDates
+end
+
+class SmarterDatesTest < Test::Unit::TestCase
+  def setup
+    @model = Model.new
+  end
+
+  def test_date_parsing
+    now = Time.now
+    last_week = now - 60 * 60 * 24 * 7
+    yesterday = now - 60 * 60 * 24
+
+    @model.name = "Paul Belt"
+    @model.birth_d = "22 April 1976"
+    @model.meeting_dt = "today"
+    @model.created_on = "one week ago"
+    @model.updated_at = "yesterday"
+
+    assert_equal "Paul Belt", @model.name
+
+    assert_equal 1976, @model.birth_d.year
+    assert_equal 4, @model.birth_d.mon
+    assert_equal 22, @model.birth_d.mday
+
+    assert_equal now.year, @model.meeting_dt.year
+    assert_equal now.month, @model.meeting_dt.mon
+    assert_equal now.mday, @model.meeting_dt.mday
+
+    assert_equal last_week.year, @model.created_on.year
+    assert_equal last_week.month, @model.created_on.mon
+    assert_equal last_week.day, @model.created_on.mday
+
+    assert_equal yesterday.year, @model.updated_at.year
+    assert_equal yesterday.month, @model.updated_at.mon
+    assert_equal yesterday.day, @model.updated_at.mday
+  end
+end
+

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: smarter_dates
+version: !ruby/object:Gem::Version 
+  hash: 83
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 7
+  - 8
+  version: 0.2.7.8
+platform: ruby
+authors: 
+- Paul Belt
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-20 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: chronic
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 0
+        - 2
+        - 3
+        version: 0.2.3
+  type: :runtime
+  version_requirements: *id001
+description: |-
+  Humans want to think of date and datetime attributes in a natural manner.
+  Standard ruby Date and DateTime objects do not support this well.
+email: Paul Belt
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/smarter_dates.rb
+- smarter_dates.gemspec
+- test/smarter_dates_test.rb
+has_rdoc: true
+homepage: http://github.com/belt/smarter_dates
+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: smarter_dates
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: machina to automatically parse date/datetime attributes upon assignment.
+test_files: 
+- test/smarter_dates_test.rb