MIT_LICENSE @@ -1 +1,44 @@ -initial commit += Autochronic +<b>Version 0.2.0 (7 Feb, 2008)</b> + +Author:: Yossef Mendelssohn (ymendel@pobox.com) +Copyright:: Copyright (c) 2008, Flawed Logic, OG Consulting, Yossef Mendelssohn +License:: MIT License. See MIT-LICENSE file for more details. + +Autochronic is a Ruby on Rails that will automatically make any date or datetime attribute in any model automatically handle natural-language strings. There is no effort on your part, no creation of before_save callbacks or writing your own accessors to handle the special input. + +== Installation + +Unpack the autochronic directory into vendor/rails/ in your rails project. +A definitive public revision control access point is forthcoming that will make it possible to install the plugin via script/plugin install. + +== Using Autochronic + +Just use your models normally. They'll do the work for you automatically. Automatic Chronic. Auto Chronic. Autochronic. + +== Version history: + + 0.2.0 - Initial release + Developed under Rails 2.0.2 using chronic 0.2.3. That worked for me, and I'm not making any guarantees for anything else. + +== Known issues: + + Chronic's parsing of 'today' is time-dependent in a bad way. See the following irb dump. + + >> Chronic.parse('today') + => Fri Feb 08 00:00:00 -0600 2008 + >> Date.today.to_s + => "2008-02-07" + >> Time.now + => Thu Feb 07 23:13:28 -0600 2008 + More info: + >> Time.local(2008, 2, 7, 22, 59, 59) + => Thu Feb 07 22:59:59 -0600 2008 + >> time1 = _ + => Thu Feb 07 22:59:59 -0600 2008 + >> time2 = Time.local(2008, 2, 7, 23, 0, 0) + => Thu Feb 07 23:00:00 -0600 2008 + >> Chronic.parse('today', :now => time1) + => Thu Feb 07 23:30:00 -0600 2008 + >> Chronic.parse('today', :now => time2) + => Fri Feb 08 00:00:00 -0600 2008 README @@ -28,12 +28,6 @@ describe SpaceCowboy do end # WTF: this is presently giving me the next day - # >> Chronic.parse('today') - # => Fri Feb 08 00:00:00 -0600 2008 - # >> Date.today.to_s - # => "2008-02-07" - # >> Time.now - # => Thu Feb 07 23:13:28 -0600 2008 it 'should accept a natural language date string' do date = Date.today date_input = 'today' spec/autochronic_spec.rb 52bdad5cd599979d5a0d867f527357aa8aa60870 Yossef Mendelssohn ymendel@pobox.com http://github.com/flogic/autochronic/commit/c1e111595bc0032831a97f6f3a94eeaffc9e110a c1e111595bc0032831a97f6f3a94eeaffc9e110a 2008-02-07T21:39:41-08:00 2008-02-07T21:39:41-08:00 Added license file and filled out readme. This may be premature, but I wanted a good place to record my Chronic.parse('today') adventures. 2e24cb5fd678184381a36bc19769e53a47029d44 Yossef Mendelssohn ymendel@pobox.com