chronic 0.1.5 → 0.6.5

data/.gitignore

@@ -0,0 +1,5 @@
+pkg
+*.rbc
+rdoc
+.yardoc
+doc

data/.yardopts

@@ -0,0 +1,3 @@
+-m markdown
+--readme README.md
+--title "Chronic - Natural language date/time parsing"

data/HISTORY.md

@@ -0,0 +1,180 @@
+# 0.6.5 / 2011-11-04
+
+* Fix bug when parsing ordinal repeaters (#73)
+* Added handler support for day_name month_name (@imme5150)
+* Fix bug when parsing strings prefixed with PM
+
+# 0.6.4 / 2011-08-08
+
+* Fixed bug where 'noon' was parsed as 00:00 rather than 12:00
+  with :ambiguous_time_range => :none (Vladimir Chernis)
+* Add support for handling '2009 May 22nd'
+* Add the ability to handle scalar-day/repeater-month-name as well as ordinals
+
+# 0.6.3 / 2011-08-01
+
+* Ensure 'thu' is parsed as Thursday for 1.8.7 generic timestamp
+
+# 0.6.2 / 2011-07-28
+
+* Ensure specific endian handlers are prioritised over normal date handlers
+* Recognize UTC as timezone and accept HH::MM timezone offset (Jason Dusek)
+
+# 0.6.1 / 2011-07-21
+
+* Ensure Handler definitions are executed in the correct order
+
+# 0.6.0 / 2011-07-19
+
+* Attempting to parse strings with days past the last day of a month will
+  now return nil. ex: `Chronic.parse("30th February") #=> nil`
+* All deprecated methods are marked for removal in Chronic 0.7.0
+* Deprecated `Chronic.numericize_numbers` instead use
+  `Chronic::Numerizer.numerize`
+* Deprecated `Chronic::InvalidArgumentException` and instead use
+  `ArgumentError`
+* Deprecated `Time.construct` and use `Chronic.construct` in place of this
+* Deprecated `Time#to_minidate`, instead use `Chronic::MiniDate.from_time(time)`
+* Add support for handling generic timestamp for Ruby 1.9+
+
+# 0.5.0 / 2011-07-01
+
+* Replace commas with spaces instead of removing the char (Thomas Walpole)
+* Added tests for RepeaterSeason
+* Re-factored tests. Now rather than having a test_parsing method for testing
+  all handlers, break them down independent of handler method. For example
+  with handler `handle_sm_sd_sy` the subsequent test would be
+  `test_handle_sm_sd_sy`
+* Added support for parsing ordinal-dates/month-names/year, ie:
+  `2nd of May 1995`
+* Added support for parsing ordinal-dates and month names, ie:
+  `22nd of February at 6:30pm`
+* Fix `Time.construct` leap year checking. Instead use `Date.leap?(year)`
+
+# 0.4.4 / 2011-06-12
+
+* Fix RepeaterYear for fetching past year offsets when the current day is
+  later than the last day of the same month in a past year (leap years) ie
+  on 29th/feb (leap year) `last year` should (and now does) return 28th/feb
+  instead of 1st/march
+* Opt in for gem testing http://test.rubygems.org/
+
+# 0.4.3 / 2011-06-08
+
+* Fix issue with parsing 1:xxPM -- Ensure 1 is treated as ambiguous, not
+  just >1
+
+# 0.4.2 / 2011-06-07
+
+* Fix MonthRepeater for fetching past month offsets when current day is
+  later than the last day of a past month (ie on 29th of March when parsing
+  `last month` Chronic would return March instead of February. Now Chronic
+  returns the last day of the past month)
+
+# 0.4.1 / 2011-06-05
+
+* Fix MiniDate ranges for parsing seasons (Thomas Walpole)
+
+# 0.4.0 / 2011-06-04
+
+* Ensure context is being passed through grabbers. Now "Sunday at 2:18pm"
+  with `:context => :past` will return the correct date
+* Support parsing ordinal strings (eg first, twenty third => 1st, 23rd)
+* Seasons now ignore DST and return 00 as an hour
+* Support parsing 2 digit years and added `ambiguous_year_future_bias` option
+* Support parsing 'thurs' for Thursday
+* Fix pre_normalize() to remove periods before numerizing
+* Fix RepeaterDays to not add an extra hour in future tense. This meant
+  when parsing 'yesterday' after 11PM, Chronic would return today
+* Discard any prefixed 0 for time strings when using post noon portion
+* Gemspec updates for RubyGems deprecations
+* Ensure 0:10 is treated like 00:10
+* Ensure we load classes after setting Chronic class instance variables
+  so we can debug initialization and do assignments at compile time
+* Added a Tag.scan_for method for DRYing up some scanning code
+* Move some classes into their own files for maintainability
+* Numerizer.andition should be a private class method, make it so
+* Namespaced Numerizer, Season and MiniDate (Sascha Teske)
+* Support for Ruby 1.9 (Dave Lee, Aaron Hurley)
+* Fix `:context => :past` where parsed date is in current month (Marc Hedlund)
+* Fix undefined variable in RepeaterHour (Ryan Garver)
+* Added support for parsing 'Fourty' as another mis-spelling (Lee Reilly)
+* Added ordinal format support: ie 'February 14th, 2004' (Jeff Felchner)
+* Fix dates when working with daylight saving times (Mike Mangino)
+
+# 0.3.0 / 2010-10-22
+
+* Fix numerizer number combination bug (27 Oct 2006 7:30pm works now)
+* Allow numeric timezone offset (e.g -0500)
+* Disregard commas (so as to not return nil)
+* Fix parse of (am|pm|oclock) separation to handle "Ham sandwich" properly
+* Handle 'on' e.g. 5pm on Monday
+* Support seasons
+* Support weekend/weekday
+* Add endianness option
+* Update version number in the module
+* Fix/improve logic checks in Ordinal, and Scalar
+* Parse 'a' or 'p' as 'am' and 'pm' google-calendar style
+* Dates < 1 are not valid
+* Fix bugs related to timezone offset
+* Use RakeGem for build management
+* Reformat README and HISTORY to use Markdown
+* Global whitespace removal
+
+# 0.2.3
+
+* Fix 12am/12pm
+
+# 0.2.2
+
+* Add missing files (damn you manifest)
+
+# 0.2.1
+
+* Fix time overflow issue
+* Implement "next" for minute repeater
+* Generalize time dealiasing to dealias regardless of day portion and
+  time position
+* Add additional token match for cases like "friday evening at 7" and
+  "tomorrow evening at 7"
+* Add support for Time#to_s output format: "Mon Apr 02 17:00:00 PDT 2007"
+
+# 0.2.0 2007-03-20
+
+* Implement numerizer, allowing the use of number words (e.g. five weeks ago)
+
+# 0.1.6 2006-01-15
+
+* Add 'weekend' support
+
+# 0.1.5 2006-12-20
+
+* Fix 'aug 20' returning next year if current month is august
+* Modify behavior of 'from now'
+* Add support for seconds on times, and thus db timestamp format:
+  "2006-12-20 18:04:23"
+* Make Hoe compliant
+
+# 0.1.4
+
+* Remove verbose error checking code. oops. :-/
+
+# 0.1.3
+
+* improved regexes for word variations
+* Fix a bug that caused "today at 3am" to return nil if current time is
+  after 3am
+
+# 0.1.2
+
+* Remove Date dependency (now works on windows properly without fiddling)
+
+# 0.1.1
+
+* Run to_s on incoming object
+* Fix loop loading of repeaters files (out of order on some machines)
+* Fix find_within to use this instead of next (was breaking "today at 6pm")
+
+# 0.1.0
+
+* Initial release

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Tom Preston-Werner
+
+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.md

@@ -0,0 +1,176 @@
+Chronic
+=======
+
+## DESCRIPTION
+
+Chronic is a natural language date/time parser written in pure Ruby. See below
+for the wide variety of formats Chronic will parse.
+
+
+## INSTALLATION
+
+### RubyGems
+
+    $ [sudo] gem install chronic
+
+### GitHub
+
+    $ git clone git://github.com/mojombo/chronic.git
+    $ cd chronic && gem build chronic.gemspec
+    $ gem install chronic-<version>.gem
+
+
+## USAGE
+
+You can parse strings containing a natural language date using the
+`Chronic.parse` method.
+
+    require 'chronic'
+
+    Time.now   #=> Sun Aug 27 23:18:25 PDT 2006
+
+    Chronic.parse('tomorrow')
+      #=> Mon Aug 28 12:00:00 PDT 2006
+
+    Chronic.parse('monday', :context => :past)
+      #=> Mon Aug 21 12:00:00 PDT 2006
+
+    Chronic.parse('this tuesday 5:00')
+      #=> Tue Aug 29 17:00:00 PDT 2006
+
+    Chronic.parse('this tuesday 5:00', :ambiguous_time_range => :none)
+      #=> Tue Aug 29 05:00:00 PDT 2006
+
+    Chronic.parse('may 27th', :now => Time.local(2000, 1, 1))
+      #=> Sat May 27 12:00:00 PDT 2000
+
+    Chronic.parse('may 27th', :guess => false)
+      #=> Sun May 27 00:00:00 PDT 2007..Mon May 28 00:00:00 PDT 2007
+
+See `Chronic.parse` for detailed usage instructions.
+
+
+## EXAMPLES
+
+Chronic can parse a huge variety of date and time formats. Following is a
+small sample of strings that will be properly parsed. Parsing is case
+insensitive and will handle common abbreviations and misspellings.
+
+Simple
+
+* thursday
+* november
+* summer
+* friday 13:00
+* mon 2:35
+* 4pm
+* 6 in the morning
+* friday 1pm
+* sat 7 in the evening
+* yesterday
+* today
+* tomorrow
+* this tuesday
+* next month
+* last winter
+* this morning
+* last night
+* this second
+* yesterday at 4:00
+* last friday at 20:00
+* last week tuesday
+* tomorrow at 6:45pm
+* afternoon yesterday
+* thursday last week
+
+Complex
+
+* 3 years ago
+* 5 months before now
+* 7 hours ago
+* 7 days from now
+* 1 week hence
+* in 3 hours
+* 1 year ago tomorrow
+* 3 months ago saturday at 5:00 pm
+* 7 hours before tomorrow at noon
+* 3rd wednesday in november
+* 3rd month next year
+* 3rd thursday this september
+* 4th day last week
+* fourteenth of june 2010 at eleven o'clock in the evening
+* may seventh '97 at three in the morning
+
+Specific Dates
+
+* January 5
+* 22nd of june
+* 5th may 2017
+* February twenty first
+* dec 25
+* may 27th
+* October 2006
+* oct 06
+* jan 3 2010
+* february 14, 2004
+* february 14th, 2004
+* 3 jan 2000
+* 17 april 85
+* 5/27/1979
+* 27/5/1979
+* 05/06
+* 1979-05-27
+* Friday
+* 5
+* 4:00
+* 17:00
+* 0800
+
+Specific Times (many of the above with an added time)
+
+* January 5 at 7pm
+* 22nd of june at 8am
+* 1979-05-27 05:00:00
+* etc
+
+
+## TIME ZONES
+
+Chronic allows you to set which Time class to use when constructing times. By
+default, the built in Ruby time class creates times in your system's local
+time zone. You can set this to something like ActiveSupport's
+[TimeZone](http://api.rubyonrails.org/classes/ActiveSupport/TimeZone.html)
+class to get full time zone support.
+
+    >> Time.zone = "UTC"
+    >> Chronic.time_class = Time.zone
+    >> Chronic.parse("June 15 2006 at 5:45 AM")
+    => Thu, 15 Jun 2006 05:45:00 UTC +00:00
+
+
+## LIMITATIONS
+
+Chronic uses Ruby's built in Time class for all time storage and computation.
+Because of this, only times that the Time class can handle will be properly
+parsed. Parsing for times outside of this range will simply return nil.
+Support for a wider range of times is planned for a future release.
+
+
+## CONTRIBUTE
+
+If you'd like to hack on Chronic, start by forking the repo on GitHub:
+
+https://github.com/mojombo/chronic
+
+The best way to get your changes merged back into core is as follows:
+
+1. Clone down your fork
+1. Create a thoughtfully named topic branch to contain your change
+1. Hack away
+1. Add tests and make sure everything still passes by running `rake`
+1. Ensure your tests pass in multiple timezones. ie `TZ=utc rake` `TZ=BST rake`
+1. If you are adding new functionality, document it in the README
+1. Do not change the version number, we will do that on our end
+1. If necessary, rebase your commits into logical chunks, without errors
+1. Push the branch up to GitHub
+1. Send a pull request for your branch

data/Rakefile

@@ -1,39 +1,46 @@
-# -*- ruby -*-
+require 'date'
 
-require 'rubygems'
-require 'hoe'
-require './lib/chronic.rb'
-
-Hoe.new('chronic', Chronic::VERSION) do |p|
-  p.rubyforge_name = 'chronic'
-  p.summary = 'A natural language date parser'
-  p.description = p.paragraphs_of('README.txt', 2).join("\n\n")
-  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
-  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+def version
+  contents = File.read File.expand_path('../lib/chronic.rb', __FILE__)
+  contents[/VERSION = "([^"]+)"/, 1]
 end
 
-# vim: syntax=Ruby
+task :test do
+  $:.unshift './test'
+  Dir.glob('test/test_*.rb').each { |t| require File.basename(t) }
+end
 
-__END__
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
 
-require 'rubygems'
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -Ilib -rchronic"
+end
 
-SPEC = Gem::Specification.new do |s|
-  s.name = 'chronic'
-  s.version = '0.1.5'
-  s.author = 'Tom Preston-Werner'
-  s.email = 'tom@rubyisawesome.com'
-  s.homepage = 'http://chronic.rubyforge.org'
-  s.platform = Gem::Platform::RUBY
-  s.summary = "A natural language date parser"
-  candidates = Dir["{lib,test}/**/*"]
-  s.files = candidates.delete_if do |item|
-    item.include?('.svn')
+desc "Release Chronic version #{version}"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
   end
-  s.require_path = "lib"
-  s.autorequire = "chronic"
-  s.test_file = "test/suite.rb"
-  s.has_rdoc = true
-  s.extra_rdoc_files = ['README']
-  s.rdoc_options << '--main' << 'README'
-end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/chronic-#{version}.gem"
+end
+
+desc "Build a gem from the gemspec"
+task :build do
+  sh "mkdir -p pkg"
+  sh "gem build chronic.gemspec"
+  sh "mv chronic-#{version}.gem pkg"
+end
+
+task :default => :test

data/chronic.gemspec

@@ -0,0 +1,17 @@
+$:.unshift File.expand_path('../lib', __FILE__)
+require 'chronic'
+
+Gem::Specification.new do |s|
+  s.name = 'chronic'
+  s.version = Chronic::VERSION
+  s.rubyforge_project = 'chronic'
+  s.summary     = 'Natural language date/time parsing.'
+  s.description = 'Chronic is a natural language date/time parser written in pure Ruby.'
+  s.authors  = ['Tom Preston-Werner', 'Lee Jarvis']
+  s.email    = ['tom@mojombo.com', 'lee@jarvis.co']
+  s.homepage = 'http://github.com/mojombo/chronic'
+  s.rdoc_options = ['--charset=UTF-8']
+  s.extra_rdoc_files = %w[README.md HISTORY.md LICENSE]
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- test`.split("\n")
+end