chronic-mmlac 0.6.4.2 → 0.10.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9e20903b5e5e074b8d546e3bf1b61c8f8d0c0544
-  data.tar.gz: ed722dfbd01535a516d80b8e97e9afb353f12b11
+  metadata.gz: 64794a6186c6495e6c7e10a36f6a144314e989c4
+  data.tar.gz: dea5dd4fa693f047fe6be705ec6d42371d4231e1
 SHA512:
-  metadata.gz: 6c88b96d1239245f3162ad1dfe5b618e206b331300a69cb0457200be0ef84669cc8d0c199c189bee6e4b74c1f6fd5ae2a11618149de4a0d7d210f02be1570308
-  data.tar.gz: 81105ef5ab26321e3e4350fb9f8342eea33c172462c4610d1d3d49959761cb12aabba471b12b903a1d3538bb4f97957636c61073f73382d0928640368c9a215a
+  metadata.gz: 3134feb1bee6ff0a14244742e39a30c309755e54b871c5ec11c8405fbded5f3c086f005f2f16707e82050ecfa6090fd3300a6565e2e0d5fb198a47cbd48d8c7c
+  data.tar.gz: b4c753fe1c44c66dd7d56f4f943cdb71e7ba19f410db75f1bd035f5e383a4499d633fc6fc562f22921b8e297dbc2234509a6122db0388adeef077b1ce1d05178

data/.gitignore

@@ -1,5 +1,6 @@
-pkg
 *.rbc
-rdoc
 .yardoc
-doc
+/pkg/
+/coverage/
+/doc/
+/tags/

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 1.9.2
+  - 1.8.7
+  - jruby-19mode
+  - jruby-18mode
+  - rbx-19mode

data/HISTORY.md

@@ -1,3 +1,72 @@
+# 0.10.2 / 2013-09-09
+
+* Fix 1.8.7 support (due to be dropped in 0.11.0)
+* Bugfix for times with negative zones
+
+# 0.10.1 / 2013-08-27
+
+* Support `ActiveSupport::TimeZone` (#209, #208)
+
+# 0.10.0 / 2013-08-25
+
+* Chronic will parse subseconds correctly
+  for all supported date/time formats (#195, #198 and #200)
+* Support for date format: dd.mm.yyyy (#197)
+* Option `:hours24` to parse as 24 hour clock (#201 and #202)
+* `:guess` option allows to specify which part of Span to return.
+  (accepted values `false`,`true`,`:begin`, `:middle`, `:end`)
+* Replace `rcov` with `SimpleCov` for coverage generation
+* Add more tests
+* Various changes in codebase (#202 and #206)
+
+# 0.9.1 / 2013-02-25
+
+* Ensure Chronic strips periods from day portions (#173)
+* Properly numerize "twelfth", "twentieth" etc. (#172, James McKinney)
+* Ensure Chronic is compatible with Ruby 2.0.0 (#165, Ravil Bayramgalin)
+
+# 0.9.0 / 2012-12-21
+
+* Implement Chronic::Parser class and create an instance of this class
+  instead of leaving all data in the class level of Chronic
+* Various bug fixes
+* Add support for excel date formats (#149, @jmondo)
+* Added support for time expressions such as '10 till' or 'half
+  past two' (#146, @chicagogrooves)
+* Add support for RepeaterDayName, RepeaterMonthName,
+  Ordinal/ScalarDay and Time (#153, @kareemk)
+
+# 0.8.0 / 2012-09-16
+
+* Support parsing "<ordinal> of this month" (#109)
+* Support parsing ISO 8601 format (#115)
+* Support parsing "on <day>" without a timestamp (#117)
+* Fix time parsing regexp (#125)
+* Support time when parsing dd-mm-yyy <time> (#126)
+* Allow anchor handler to accept any separators (at, on) (#128)
+* Support parsing EXIF date format (#112)
+* Start using minitest for testing
+* Ensure periods are interpreted as colons (#81).
+* Support month/day and day/month parsing (#59).
+* Support day(scalar)-month(name)-year(scalar) (#99).
+* Handle text starting with 'a' or 'an' (#101, @steveburkett).
+* Ensure post medium timestamps are correctly formatted (#89)
+
+# 0.6.7 / 2012-01-31
+
+* Handle day, month names with scalar day and year (Joe Fiorini)
+* Ensure 31st parses correctly with day names (Joe Fiorini)
+
+# 0.6.6 / 2011-11-23
+
+* `Chronic.parse('thur')` no longer returns `nil` (@harold)
+
+# 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

data/README.md

@@ -1,56 +1,54 @@
 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
 
-## INSTALLATION
-
-### RubyGems
-
-    $ [sudo] gem install chronic
+```
+$ gem install chronic
+```
 
-### GitHub
+## Usage
 
-    $ git clone git://github.com/mojombo/chronic.git
-    $ cd chronic && gem build chronic.gemspec
-    $ gem install chronic-<version>.gem
+```ruby
+require 'chronic'
 
+Time.now   #=> Sun Aug 27 23:18:25 PDT 2006
 
-## USAGE
+Chronic.parse('tomorrow')
+  #=> Mon Aug 28 12:00:00 PDT 2006
 
-You can parse strings containing a natural language date using the
-`Chronic.parse` method.
+Chronic.parse('monday', :context => :past)
+  #=> Mon Aug 21 12:00:00 PDT 2006
 
-    require 'chronic'
+Chronic.parse('this tuesday 5:00')
+  #=> Tue Aug 29 17:00:00 PDT 2006
 
-    Time.now   #=> Sun Aug 27 23:18:25 PDT 2006
+Chronic.parse('this tuesday 5:00', :ambiguous_time_range => :none)
+  #=> Tue Aug 29 05:00:00 PDT 2006
 
-    Chronic.parse('tomorrow')
-      #=> Mon Aug 28 12:00:00 PDT 2006
+Chronic.parse('may 27th', :now => Time.local(2000, 1, 1))
+  #=> Sat May 27 12:00:00 PDT 2000
 
-    Chronic.parse('monday', :context => :past)
-      #=> Mon Aug 21 12:00:00 PDT 2006
+Chronic.parse('may 27th', :guess => false)
+  #=> Sun May 27 00:00:00 PDT 2007..Mon May 28 00:00:00 PDT 2007
 
-    Chronic.parse('this tuesday 5:00')
-      #=> Tue Aug 29 17:00:00 PDT 2006
+Chronic.parse('6/4/2012', :endian_precedence => :little)
+  #=> Fri Apr 06 00:00:00 PDT 2012
 
-    Chronic.parse('this tuesday 5:00', :ambiguous_time_range => :none)
-      #=> Tue Aug 29 05:00:00 PDT 2006
+Chronic.parse('INVALID DATE')
+  #=> nil
+```
 
-    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
+If the parser can find a date or time, either a Time or Chronic::Span
+will be returned (depending on the value of `:guess`). If no
+date or time can be found, `nil` will be returned.
 
 See `Chronic.parse` for detailed usage instructions.
 
-
-## EXAMPLES
+## 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
@@ -64,12 +62,17 @@ Simple
 * friday 13:00
 * mon 2:35
 * 4pm
+* 10 to 8
+* 10 past 2
+* half past 2
 * 6 in the morning
 * friday 1pm
 * sat 7 in the evening
 * yesterday
 * today
 * tomorrow
+* last week
+* next week
 * this tuesday
 * next month
 * last winter
@@ -86,6 +89,7 @@ Simple
 Complex
 
 * 3 years ago
+* a year ago
 * 5 months before now
 * 7 hours ago
 * 7 days from now
@@ -131,10 +135,11 @@ 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
+* 03/01/2012 07:25:09.234567
 * etc
 
 
-## TIME ZONES
+## 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
@@ -142,13 +147,14 @@ 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
-
+```
+>> 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
+## 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
@@ -156,20 +162,19 @@ 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
+## Contribute
 
 If you'd like to hack on Chronic, start by forking the repo on GitHub:
 
 https://github.com/mojombo/chronic
 
-To get all of the dependencies, install the gem first. The best way to get
-your changes merged back into core is as follows:
+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
+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

data/Rakefile

@@ -5,17 +5,37 @@ def version
   contents[/VERSION = "([^"]+)"/, 1]
 end
 
-task :test do
+def do_test
   $:.unshift './test'
   Dir.glob('test/test_*.rb').each { |t| require File.basename(t) }
 end
 
-desc "Generate RCov test coverage and open in your browser"
+def open_command
+  case RUBY_PLATFORM
+  when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+    'start'
+  when /darwin|mac os/
+    'open'
+  else
+    'xdg-open'
+  end
+end
+
+task :test do
+  do_test
+end
+
+desc "Generate SimpleCov 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"
+  require 'simplecov'
+  FileUtils.rm_rf("./coverage")
+  SimpleCov.command_name 'Unit Tests'
+  SimpleCov.at_exit do
+    SimpleCov.result.format!
+    sh "#{open_command} #{SimpleCov.coverage_path}/index.html"
+  end
+  SimpleCov.start
+  do_test
 end
 
 desc "Open an irb session preloaded with this library"
@@ -38,9 +58,9 @@ end
 
 desc "Build a gem from the gemspec"
 task :build do
-  sh "mkdir -p pkg"
+  FileUtils.mkdir_p "pkg"
   sh "gem build chronic.gemspec"
-  sh "mv chronic-#{version}.gem pkg"
+  FileUtils.mv("./chronic-#{version}.gem", "pkg")
 end
 
 task :default => :test

data/chronic.gemspec

@@ -8,10 +8,16 @@ Gem::Specification.new do |s|
   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.email    = ['tom@mojombo.com', 'ljjarvis@gmail.com']
   s.homepage = 'http://github.com/mojombo/chronic'
+  s.license = 'MIT'
   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")
+  s.files = `git ls-files`.split($/)
+  s.test_files = `git ls-files -- test`.split($/)
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'minitest', '~> 5.0'
+  s.add_development_dependency 'activesupport'
 end

data/lib/chronic.rb

@@ -1,9 +1,48 @@
 require 'time'
 require 'date'
 
-# Parse natural language dates and times into Time or {Chronic::Span} objects
+require 'chronic/parser'
+require 'chronic/date'
+require 'chronic/time'
+
+require 'chronic/handler'
+require 'chronic/handlers'
+require 'chronic/mini_date'
+require 'chronic/tag'
+require 'chronic/span'
+require 'chronic/token'
+require 'chronic/grabber'
+require 'chronic/pointer'
+require 'chronic/scalar'
+require 'chronic/ordinal'
+require 'chronic/separator'
+require 'chronic/sign'
+require 'chronic/time_zone'
+require 'chronic/numerizer'
+require 'chronic/season'
+
+require 'chronic/repeater'
+require 'chronic/repeaters/repeater_year'
+require 'chronic/repeaters/repeater_season'
+require 'chronic/repeaters/repeater_season_name'
+require 'chronic/repeaters/repeater_month'
+require 'chronic/repeaters/repeater_month_name'
+require 'chronic/repeaters/repeater_fortnight'
+require 'chronic/repeaters/repeater_week'
+require 'chronic/repeaters/repeater_weekend'
+require 'chronic/repeaters/repeater_weekday'
+require 'chronic/repeaters/repeater_day'
+require 'chronic/repeaters/repeater_day_name'
+require 'chronic/repeaters/repeater_day_portion'
+require 'chronic/repeaters/repeater_hour'
+require 'chronic/repeaters/repeater_minute'
+require 'chronic/repeaters/repeater_second'
+require 'chronic/repeaters/repeater_time'
+
+# Parse natural language dates and times into Time or Chronic::Span objects.
+#
+# Examples:
 #
-# @example
 #   require 'chronic'
 #
 #   Time.now   #=> Sun Aug 27 23:18:25 PDT 2006
@@ -13,29 +52,16 @@ require 'date'
 #
 #   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
-#
-# @author Tom Preston-Werner, Lee Jarvis
 module Chronic
-  VERSION = "0.6.4.2"
+  VERSION = "0.10.2.1"
 
   class << self
 
-    # @return [Boolean] true when debug mode is enabled
+    # Returns true when debug mode is enabled.
     attr_accessor :debug
 
-    # @example
+    # Examples:
+    #
     #   require 'chronic'
     #   require 'active_support/time'
     #
@@ -44,20 +70,7 @@ module Chronic
     #   Chronic.parse('June 15 2006 at 5:54 AM')
     #     # => Thu, 15 Jun 2006 05:45:00 UTC +00:00
     #
-    # @return [Time] The time class Chronic uses internally
-    attr_accessor :time_class
-
-    # The current Time Chronic is using to base from
-    #
-    # @example
-    #   Time.now #=> 2011-06-06 14:13:43 +0100
-    #   Chronic.parse('yesterday') #=> 2011-06-05 12:00:00 +0100
-    #
-    #   now = Time.local(2025, 12, 24)
-    #   Chronic.parse('tomorrow', :now => now) #=> 2025-12-25 12:00:00 +0000
-    #
-    # @return [Time, nil]
-    attr_accessor :now
+    # Returns The Time class Chronic uses internally.
 
     # To ensure thread safety, this value is thread-local.
     def time_class
@@ -69,50 +82,76 @@ module Chronic
   end
 
   self.debug = false
-end
-
-require 'chronic/chronic'
-require 'chronic/handler'
-require 'chronic/handlers'
-require 'chronic/mini_date'
-require 'chronic/tag'
-require 'chronic/span'
-require 'chronic/token'
-require 'chronic/grabber'
-require 'chronic/pointer'
-require 'chronic/scalar'
-require 'chronic/ordinal'
-require 'chronic/separator'
-require 'chronic/time_zone'
-require 'chronic/numerizer'
-require 'chronic/season'
+  self.time_class = ::Time
 
-require 'chronic/repeater'
-require 'chronic/repeaters/repeater_year'
-require 'chronic/repeaters/repeater_season'
-require 'chronic/repeaters/repeater_season_name'
-require 'chronic/repeaters/repeater_month'
-require 'chronic/repeaters/repeater_month_name'
-require 'chronic/repeaters/repeater_fortnight'
-require 'chronic/repeaters/repeater_week'
-require 'chronic/repeaters/repeater_weekend'
-require 'chronic/repeaters/repeater_weekday'
-require 'chronic/repeaters/repeater_day'
-require 'chronic/repeaters/repeater_day_name'
-require 'chronic/repeaters/repeater_day_portion'
-require 'chronic/repeaters/repeater_hour'
-require 'chronic/repeaters/repeater_minute'
-require 'chronic/repeaters/repeater_second'
-require 'chronic/repeaters/repeater_time'
 
-class Time
-  def self.construct(year, month = 1, day = 1, hour = 0, minute = 0, second = 0)
-    warn "Chronic.construct will be deprecated in version 0.7.0. Please use Chronic.construct instead"
-    Chronic.construct(year, month, day, hour, minute, second)
+  # Parses a string containing a natural language date or time.
+  #
+  # If the parser can find a date or time, either a Time or Chronic::Span
+  # will be returned (depending on the value of `:guess`). If no
+  # date or time can be found, `nil` will be returned.
+  #
+  # text - The String text to parse.
+  # opts - An optional Hash of configuration options passed to Parser::new.
+  def self.parse(text, options = {})
+    Parser.new(options).parse(text)
   end
 
-  def to_minidate
-    warn "Time.to_minidate will be deprecated in version 0.7.0. Please use Chronic::MiniDate.from_time(time) instead"
-    Chronic::MiniDate.from_time(self)
+  # Construct a new time object determining possible month overflows
+  # and leap years.
+  #
+  # year   - Integer year.
+  # month  - Integer month.
+  # day    - Integer day.
+  # hour   - Integer hour.
+  # minute - Integer minute.
+  # second - Integer second.
+  #
+  # Returns a new Time object constructed from these params.
+  def self.construct(year, month = 1, day = 1, hour = 0, minute = 0, second = 0, offset = nil)
+    if second >= 60
+      minute += second / 60
+      second = second % 60
+    end
+
+    if minute >= 60
+      hour += minute / 60
+      minute = minute % 60
+    end
+
+    if hour >= 24
+      day += hour / 24
+      hour = hour % 24
+    end
+
+    # determine if there is a day overflow. this is complicated by our crappy calendar
+    # system (non-constant number of days per month)
+    day <= 56 || raise("day must be no more than 56 (makes month resolution easier)")
+    if day > 28 # no month ever has fewer than 28 days, so only do this if necessary
+      days_this_month = ::Date.leap?(year) ? Date::MONTH_DAYS_LEAP[month] : Date::MONTH_DAYS[month]
+      if day > days_this_month
+        month += day / days_this_month
+        day = day % days_this_month
+      end
+    end
+
+    if month > 12
+      if month % 12 == 0
+        year += (month - 12) / 12
+        month = 12
+      else
+        year += month / 12
+        month = month % 12
+      end
+    end
+    if Chronic.time_class.name == "Date"
+      Chronic.time_class.new(year, month, day)
+    elsif not Chronic.time_class.respond_to?(:new) or (RUBY_VERSION.to_f < 1.9 and Chronic.time_class.name == "Time")
+      Chronic.time_class.local(year, month, day, hour, minute, second)
+    else
+      offset = Time::normalize_offset(offset) if Chronic.time_class.name == "DateTime"
+      Chronic.time_class.new(year, month, day, hour, minute, second, offset)
+    end
   end
+
 end