american_date 1.0.0

data/CHANGELOG

@@ -0,0 +1,3 @@
+=== 1.0.0 (2011-12-12)
+
+* Initial public release

data/MIT-LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2011 Jeremy Evans
+
+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 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,55 @@
+= ruby-american_date
+
+ruby-american_date exists to make ruby versions greater than 1.8
+parse american-style month/day/year dates correctly, just like
+ruby 1.8.  It can also be used on ruby 1.8, but it is basically a
+noop there.
+
+As far as I know, there isn't a gem that already handles this. You
+can find many snippets on the web that partially solve the issue, but
+most won't be compatible with ruby 1.9.3, because Date.parse and
+DateTime.parse no longer call Date._parse directly on 1.9.3. Also
+most don't handle cases where an american date format is used in
+addition to a time format.
+
+== Design
+
+The general idea is fairly simple.  We just check the beginning of
+the input string for an american date format, and transform it into
+a year-month-day ISO format before passing it to the standard date
+parsing methods.  This is probably the least invasive way that works
+correctly on both the pure-ruby date parser (<1.9.3) and the C
+extension date parser (>=1.9.3).
+
+To reduce the possibility of problems, only the beginning of the
+input string is checked.  So if you have an american date format
+embedded in the middle of the input string, it won't be translated.
+That may change in the future if it is determined to be safe.
+
+== Tested ruby versions
+
+* ruby 1.8.6, 1.8.7, 1.9.2, 1.9.3
+* rubinius 1.2.4
+* jruby 1.6.5 (both --1.8 and --1.9 modes)
+
+== Installation
+   
+ruby-american_date is distributed as a gem, and can be installed with:
+
+  gem install american_date
+
+== Source
+
+ruby-american_date is hosted on GitHub:
+
+  https://github.com/jeremyevans/ruby-american_date
+
+== Issues
+
+ruby-american_date uses GitHub Issues for issue tracking:
+
+  https://github.com/jeremyevans/ruby-american_date/issues
+
+== Author
+
+Jeremy Evans <code@jeremyevans.net>

data/Rakefile

@@ -0,0 +1,43 @@
+require "rake"
+require "rake/clean"
+
+CLEAN.include ["*.gem", "rdoc"]
+RDOC_OPTS = ['--inline-source', '--line-numbers', '--title', '', '--main', 'README.rdoc']
+
+rdoc_task_class = begin
+  require "rdoc/task"
+  RDOC_OPTS.concat(['-f', 'hanna'])
+  RDoc::Task
+rescue LoadError
+  require "rake/rdoctask"
+  Rake::RDocTask
+end
+
+rdoc_task_class.new do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.options += RDOC_OPTS
+  rdoc.rdoc_files.add %w"lib/american_date.rb MIT-LICENSE CHANGELOG README.rdoc"
+end
+
+begin
+  require "spec/rake/spectask"
+  spec_class = Spec::Rake::SpecTask
+  spec_files_meth = :spec_files=
+rescue LoadError
+  # RSpec 2
+  require "rspec/core/rake_task"
+  spec_class = RSpec::Core::RakeTask
+  spec_files_meth = :pattern=
+end
+
+desc "Run specs"
+spec_class.new("spec") do |t|
+  t.send(spec_files_meth, ["spec/american_date_spec.rb"])
+end
+task :default=>[:spec]
+
+desc "Package american_date"
+task :gem=>[:clean] do
+  load './american_date.gemspec'
+  Gem::Builder.new(AMERICAN_DATE_GEMSPEC).build
+end

data/lib/american_date.rb

@@ -0,0 +1,47 @@
+require 'date'
+
+if RUBY_VERSION >= '1.9'
+  # Modify parsing methods to handle american date format correctly.
+  class << Date
+    # American date format detected by the library.
+    AMERICAN_DATE_RE = %r_\A\s*(\d{1,2})/(\d{1,2})/(\d{4}|\d{2})_.freeze
+
+    # Alias for stdlib Date._parse
+    alias _parse_without_american_date _parse
+
+    # Transform american dates into ISO dates before parsing.
+    def _parse(string, comp=true)
+      _parse_without_american_date(convert_american_to_iso(string), comp)
+    end
+
+    if RUBY_VERSION >= '1.9.3'
+      # Alias for stdlib Date.parse
+      alias parse_without_american_date parse
+
+      # Transform american dates into ISO dates before parsing.
+      def parse(string, comp=true)
+        parse_without_american_date(convert_american_to_iso(string), comp)
+      end
+    end
+
+    private
+
+    # Transform american date fromat into ISO format.
+    def convert_american_to_iso(string)
+      string.sub(AMERICAN_DATE_RE){|m| "#$3-#$1-#$2"}
+    end
+  end
+
+  if RUBY_VERSION >= '1.9.3'
+    # Modify parsing methods to handle american date format correctly.
+    class << DateTime
+      # Alias for stdlib Date.parse
+      alias parse_without_american_date parse
+
+      # Transform american dates into ISO dates before parsing.
+      def parse(string, comp=true)
+        parse_without_american_date(convert_american_to_iso(string), comp)
+      end
+    end
+  end
+end

data/spec/american_date_spec.rb

@@ -0,0 +1,121 @@
+require File.join(File.dirname(File.dirname(File.expand_path(__FILE__))), 'lib', 'american_date')
+require 'time'
+
+describe "Date.parse" do
+  specify "should use american date format for dd/mm/yy" do
+    Date.parse('01/02/03', true).should == Date.new(2003, 1, 2)
+  end
+
+  specify "should use american date format for d/m/yy" do
+    Date.parse('1/2/03', true).should == Date.new(2003, 1, 2)
+    Date.parse('1/2/03', false).should == Date.new(3, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm/yyyy" do
+    Date.parse('01/02/2003').should == Date.new(2003, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm" do
+    Date.parse('01/02').should == Date.new(Time.now.year, 1, 2)
+  end
+
+  specify "should use american date format for d/m" do
+    Date.parse('1/2').should == Date.new(Time.now.year, 1, 2)
+  end
+
+  specify "should ignore preceding whitespace" do
+    Date.parse('  01/02/2003').should == Date.new(2003, 1, 2)
+  end
+end
+
+describe "DateTime.parse" do
+  specify "should use american date format for dd/mm/yy" do
+    DateTime.parse('01/02/03', true).should == DateTime.new(2003, 1, 2)
+  end
+
+  specify "should use american date format for d/m/yy" do
+    DateTime.parse('1/2/03', true).should == DateTime.new(2003, 1, 2)
+    DateTime.parse('1/2/03', false).should == DateTime.new(3, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm/yyyy" do
+    DateTime.parse('01/02/2003').should == DateTime.new(2003, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm" do
+    DateTime.parse('01/02').should == DateTime.new(Time.now.year, 1, 2)
+  end
+
+  specify "should use american date format for d/m" do
+    DateTime.parse('1/2').should == DateTime.new(Time.now.year, 1, 2)
+  end
+
+  specify "should ignore preceding whitespace" do
+    DateTime.parse('  01/02/2003').should == DateTime.new(2003, 1, 2)
+  end
+
+  specify "should work with times" do
+    DateTime.parse('01/02/2003 10:20:30').should == DateTime.new(2003, 1, 2, 10, 20, 30)
+  end
+end
+
+describe "Time.parse" do
+  specify "should use american date format for dd/mm/yy" do
+    Time.parse('01/02/03', true).should == Time.local(2003, 1, 2)
+  end
+
+  specify "should use american date format for d/m/yy" do
+    Time.parse('1/2/03', true).should == Time.local(2003, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm/yyyy" do
+    Time.parse('01/02/2003').should == Time.local(2003, 1, 2)
+  end
+
+  specify "should use american date format for dd/mm" do
+    Time.parse('01/02').should == Time.local(Time.now.year, 1, 2)
+  end
+
+  specify "should use american date format for d/m" do
+    Time.parse('1/2').should == Time.local(Time.now.year, 1, 2)
+  end
+
+  specify "should ignore preceding whitespace" do
+    Time.parse('  01/02/2003').should == Time.local(2003, 1, 2)
+  end
+
+  specify "should work with times" do
+    Time.parse('01/02/2003 10:20:30').should == Time.local(2003, 1, 2, 10, 20, 30)
+  end
+end
+
+describe "Date._parse" do
+  specify "should use american date format for dd/mm/yy" do
+    Date._parse('01/02/03', true).should == {:year=>2003, :mon=>1, :mday=>2}
+  end
+
+  specify "should use american date format for d/m/yy" do
+    Date._parse('1/2/03', true).should == {:year=>2003, :mon=>1, :mday=>2}
+    Date._parse('1/2/03', false).should == {:year=>3, :mon=>1, :mday=>2}
+  end
+
+  specify "should use american date format for dd/mm/yyyy" do
+    Date._parse('01/02/2003').should == {:year=>2003, :mon=>1, :mday=>2}
+  end
+
+  specify "should use american date format for dd/mm" do
+    Date._parse('01/02').should == {:mon=>1, :mday=>2}
+  end
+
+  specify "should use american date format for d/m" do
+    Date._parse('1/2').should == {:mon=>1, :mday=>2}
+  end
+
+  specify "should ignore preceding whitespace" do
+    Date._parse('  01/02/2003').should == {:year=>2003, :mon=>1, :mday=>2}
+  end
+
+  specify "should work with times" do
+    DateTime._parse('01/02/2003 10:20:30').should == {:year=>2003, :mon=>1, :mday=>2, :hour=>10, :min=>20, :sec=>30}
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: american_date
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jeremy Evans
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-12 00:00:00.000000000 Z
+dependencies: []
+description: American style month/day/year date parsing for ruby 1.9
+email: code@jeremyevans.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+- CHANGELOG
+- MIT-LICENSE
+files:
+- MIT-LICENSE
+- CHANGELOG
+- README.rdoc
+- Rakefile
+- spec/american_date_spec.rb
+- lib/american_date.rb
+homepage: https://github.com/jeremyevans/ruby-american_date
+licenses: []
+post_install_message: 
+rdoc_options:
+- --quiet
+- --inline-source
+- --line-numbers
+- --title
+- ! 'american_date: American style month/day/year date parsing for ruby 1.9'
+- --main
+- README.rdoc
+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: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: American style month/day/year date parsing for ruby 1.9
+test_files: []