pangel-chronic 0.3.0.3 → 0.3.10

data/{README.rdoc → README.txt}

@@ -1,22 +1,7 @@
-= Chronic
-
+Chronic
 http://chronic.rubyforge.org/
-
 by Tom Preston-Werner
 
-= WARNING:
-
-If you haven't noticed already, this is a fork of mojombo's (Tom's) stable
-chronic. I decided on my own volition that the 40-some (as reported by Github)
-network should be merged together. I got it to run, but quite haphazardly. There
-are a lot of new features (mostly undocumented except the git logs) so be a
-little flexible in your language passed to Chronic.
-
-Given that, if there is a bug, more than likely it's my own fault, not
-mojombo's and therefore bug reports should be sent to my fork, not his.
-
-Enjoy 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.
@@ -25,17 +10,17 @@ Chronic is a natural language date/time parser written in pure Ruby. See below f
 
 Chronic can be installed via RubyGems:
 
-  $ sudo gem install evaryont-chronic
-
+  $ sudo gem install chronic
+  
 == CODE:
 
 Browse the code and get an RSS feed of the commit log at:
 
-  http://github.com/evaryont/chronic.git
+  http://github.com/mojombo/chronic.git
 
 You can grab the code (and help with development) via git:
 
-  $ git clone git://github.com/evaryont/chronic.git
+  $ git clone git://github.com/mojombo/chronic.git
 
 == USAGE:
 
@@ -48,7 +33,7 @@ You can parse strings containing a natural language date using the Chronic.parse
 
   #---
 
-  Chronic.parse('tomorrow')
+  Chronic.parse('tomorrow')       
     #=> Mon Aug 28 12:00:00 PDT 2006
 
   Chronic.parse('monday', :context => :past)
@@ -153,7 +138,7 @@ local time zone.  You can set this to something like ActiveSupport's TimeZone cl
   => 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.
 
 == LICENSE:

data/lib/chronic.rb

@@ -7,10 +7,9 @@
 #
 #=============================================================================
 
-# $:.unshift File.dirname(__FILE__)     # For use/testing when no gem is installed
+$:.unshift File.dirname(__FILE__)     # For use/testing when no gem is installed
 
-require 'core_ext/object'
-require 'core_ext/time'
+require 'time'
 
 require 'chronic/chronic'
 require 'chronic/handlers'
@@ -28,7 +27,6 @@ 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_decade'
 require 'chronic/repeaters/repeater_hour'
 require 'chronic/repeaters/repeater_minute'
 require 'chronic/repeaters/repeater_second'
@@ -40,18 +38,97 @@ require 'chronic/scalar'
 require 'chronic/ordinal'
 require 'chronic/separator'
 require 'chronic/time_zone'
-require 'chronic/blunt.rb'
 
 require 'numerizer/numerizer'
 
 module Chronic
-	VERSION = "0.3.0.2"
+  VERSION = "0.3.9"
+  
+  class << self
+    attr_accessor :debug
 
-	class << self
-		attr_accessor :debug
-		attr_accessor :time_class
-	end
+    def time_class
+      Thread.current[:chronic_time_class] ||= Time
+    end
 
-	self.debug = false
-	self.time_class = Time
+    def time_class=(klass)
+      Thread.current[:chronic_time_class] = klass
+    end
+  end
+
+  self.debug = false
+end
+
+# class Time
+#   def self.construct(year, month = 1, day = 1, hour = 0, minute = 0, second = 0)
+#     # extra_seconds = second > 60 ? second - 60 : 0
+#     # extra_minutes = minute > 59 ? minute - 59 : 0
+#     # extra_hours = hour > 23 ? hour - 23 : 0
+#     # extra_days = day > 
+#     
+#     if month > 12
+#       if month % 12 == 0
+#         year += (month - 12) / 12
+#         month = 12
+#       else
+#         year += month / 12
+#         month = month % 12
+#       end
+#     end
+#     
+#     base = Time.local(year, month)
+#     puts base
+#     offset = ((day - 1) * 24 * 60 * 60) + (hour * 60 * 60) + (minute * 60) + second
+#     puts offset.to_s
+#     date = base + offset
+#     puts date
+#     date
+#   end
+# end
+
+class Time
+  def self.construct(year, month = 1, day = 1, hour = 0, minute = 0, second = 0)
+    
+    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
+      leap_year = (year % 4 == 0) && !(year % 100 == 0)
+      leap_year_month_days = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+      common_year_month_days = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+      days_this_month = leap_year ? leap_year_month_days[month - 1] : common_year_month_days[month - 1]
+      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
+    
+    Chronic.time_class.local(year, month, day, hour, minute, second)
+  end
 end

data/lib/chronic/chronic.rb

@@ -1,303 +1,262 @@
 module Chronic
-	class << self
-
-		# 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 <tt>:guess</tt>). If no date or time can be found,
-		# +nil+ will be returned.
-		#
-		# Options are:
-		#
-		# [<tt>:context</tt>]
-		#     <tt>:past</tt> or <tt>:future</tt> (defaults to <tt>:future</tt>)
-		#
-		#     If your string represents a birthday, you can set <tt>:context</tt> to <tt>:past</tt>
-		#     and if an ambiguous string is given, it will assume it is in the
-		#     past. Specify <tt>:future</tt> or omit to set a future context.
-		#
-		# [<tt>:now</tt>]
-		#     Time (defaults to Time.now)
-		#
-		#     By setting <tt>:now</tt> to a Time, all computations will be based off
-		#     of that time instead of Time.now. If set to nil, Chronic will use Time.now.
-		#
-		# [<tt>:guess</tt>]
-		#     +true+, +false+, +"start"+, +"middle"+, and +"end"+ (defaults to +true+)
-		#
-		#     By default, the parser will guess a single point in time for the
-		#     given date or time.  +:guess+ => +true+ or +"middle"+ will return the middle
-		#     value of the range.  If +"start"+ is specified, Chronic::Span will return the
-		#     beginning of the range.  If +"end"+ is specified, the last value in
-		#     Chronic::Span will be returned. If you'd rather have the entire time span returned,
-		#     set <tt>:guess</tt> to +false+ and a Chronic::Span will be returned.
-		#
-		# [<tt>:ambiguous_time_range</tt>]
-		#     Integer or <tt>:none</tt> (defaults to <tt>6</tt> (6am-6pm))
-		#
-		#     If an Integer is given, ambiguous times (like 5:00) will be
-		#     assumed to be within the range of that time in the AM to that time
-		#     in the PM. For example, if you set it to <tt>7</tt>, then the parser will
-		#     look for the time between 7am and 7pm. In the case of 5:00, it would
-		#     assume that means 5:00pm. If <tt>:none</tt> is given, no assumption
-		#     will be made, and the first matching instance of that time will
-		#     be used.
-		def parse(text, specified_options = {})
-			# strip any non-tagged tokens
-			@tokens = tokenize(text, specified_options).select { |token| token.tagged? }
-
-			if Chronic.debug
-				puts "+---------------------------------------------------"
-				puts "| " + @tokens.to_s
-				puts "+---------------------------------------------------"
-			end
-
-			options = default_options(specified_options)
-
-			# do the heavy lifting
-			begin
-				span = self.tokens_to_span(@tokens, options)
-			rescue
-				raise
-				return nil
-			end
-
-			# guess a time within a span if required
-			if options[:guess]
-				return self.guess(span, options[:guess])
-			else
-				return span
-			end
-		end
-
-		def strip_tokens(text, specified_options = {})
-			# strip any tagged tokens
-			return tokenize(text, specified_options).select { |token| !token.tagged? }.map { |token| token.word }.join(' ')
-		end
-
-		# Returns an array with text tokenized by the respective classes
-		def tokenize(text, specified_options = {})
-			@text = text
-
-			options = default_options(specified_options)
-			# store now for later =)
-			@now = options[:now]
-
-			# put the text into a normal format to ease scanning
-			puts "+++ text = #{text}" if Chronic.debug
-			text = self.pre_normalize(text)
-			puts "--- text = #{text}" if Chronic.debug
-
-			# get base tokens for each word
-			@tokens = self.base_tokenize(text)
-			puts @tokens if Chronic.debug
-
-			# scan the tokens with each token scanner
-			[Repeater].each do |tokenizer|
-				@tokens = tokenizer.scan(@tokens, options)
-			end
-
-			[Grabber, Pointer, Scalar, Ordinal, Separator, TimeZone].each do |tokenizer|
-				@tokens = tokenizer.scan(@tokens)
-			end
-
-			return @tokens
-		end
-
-		def default_options(specified_options)
-			# get options and set defaults if necessary
-			default_options = {:context => :future,
-				:now => Chronic.time_class.now,
-				:guess => true,
-				:guess_how => :middle,
-				:ambiguous_time_range => 6,
-				:endian_precedence => nil}
-			options = default_options.merge specified_options
-
-			# handle options that were set to nil
-			options[:context] = :future unless options[:context]
-			options[:now] = Chronic.time_class.now unless options[:context]
-			options[:ambiguous_time_range] = 6 unless options[:ambiguous_time_range]
-
-			# ensure the specified options are valid
-			specified_options.keys.each do |key|
-				default_options.keys.include?(key) || raise(InvalidArgumentException, "#{key} is not a valid option key.")
-			end
-			[:past, :future, :none].include?(options[:context]) || raise(InvalidArgumentException, "Invalid value ':#{options[:context]}' for :context specified. Valid values are :past and :future.")
-			["start", "middle", "end", true, false].include?(options[:guess]) || validate_percentness_of(options[:guess]) || raise(InvalidArgumentException, "Invalid value ':#{options[:guess]}' for :guess how specified. Valid values are true, false, \"start\", \"middle\", and \"end\".  true will default to \"middle\". :guess can also be a percent(0.60)")
-
-			return options
-		end
-
-		# Clean up the specified input text by stripping unwanted characters,
-		# converting idioms to their canonical form, converting number words
-		# to numbers (three => 3), and converting ordinal words to numeric
-		# ordinals (third => 3rd)
-		def pre_normalize(text) #:nodoc:
-			normalized_text = text.to_s
-			normalized_text = numericize_numbers(normalized_text)
-			normalized_text.gsub!(/['",]/, '')
-			normalized_text.gsub!(/(\d+\:\d+)\.(\d+)/, '\1\2')
-			normalized_text.gsub!(/ \-(\d{4})\b/, ' tzminus\1')
-			normalized_text.gsub!(/([\/\-\,\@])/) { ' ' + $1 + ' ' }
-			normalized_text.gsub!(/\btoday\b/i, 'this day')
-			normalized_text.gsub!(/\btomm?orr?ow\b/i, 'next day')
-			normalized_text.gsub!(/\byesterday\b/i, 'last day')
-			normalized_text.gsub!(/\bnoon\b/i, '12:00')
-			normalized_text.gsub!(/\bmidnight\b/i, '24:00')
-			normalized_text.gsub!(/\bbefore now\b/i, 'past')
-			normalized_text.gsub!(/\bnow\b/i, 'this second')
-			normalized_text.gsub!(/\b(ago|before)\b/i, 'past')
-			normalized_text.gsub!(/\bthis past\b/i, 'last')
-			normalized_text.gsub!(/\bthis last\b/i, 'last')
-			normalized_text.gsub!(/\b(?:in|during) the (morning)\b/i, '\1')
-			normalized_text.gsub!(/\b(?:in the|during the|at) (afternoon|evening|night)\b/i, '\1')
-			normalized_text.gsub!(/\btonight\b/i, 'this night')
-			normalized_text.gsub!(/\b\d+:?\d*[ap]\b/i,'\0m')
-			normalized_text.gsub!(/(\d)([ap]m|oclock)\b/i, '\1 \2')
-			normalized_text.gsub!(/\b(hence|after|from)\b/i, 'future')
-			normalized_text.gsub!(/\bh[ou]{0,2}rs?\b/i, 'hour')
-			#not needed - see test_parse_before_now (test_parsing.rb +726)
-			#normalized_text.gsub!(/\bbefore now\b/, 'past')
-
-			normalized_text = numericize_ordinals(normalized_text)
-		end
-
-		# Convert number words to numbers (three => 3)
-		def numericize_numbers(text) #:nodoc:
-			Numerizer.numerize(text)
-		end
-
-		# Convert ordinal words to numeric ordinals (third => 3rd)
-		def numericize_ordinals(text) #:nodoc:
-			text
-		end
-
-		# Split the text on spaces and convert each word into
-		# a Token
-		def base_tokenize(text) #:nodoc:
-			text.split(' ').map { |word| Token.new(word) }
-		end
-
-		# Guess a specific time within the given span
-		def guess(span, guess=true) #:nodoc:
-			return nil if span.nil?
-			if span.width > 1
-				# Account for a timezone difference between the start and end of the range.
-				# This most likely will happen when dealing with a Daylight Saving Time start
-				# or end day.
-				gmt_offset_diff = span.begin.gmt_offset - span.end.gmt_offset
-				case guess
-				when "start"
-					span.begin
-				when true, "middle"
-					span.begin + ((span.width - gmt_offset_diff) / 2)
-				when "end"
-					span.begin + (span.width - gmt_offset_diff)
-				else
-					span.begin + ((span.width - gmt_offset_diff) * guess)
-				end
-			else
-				span.begin
-			end
-		end
-
-		# Validates numericality of something
-		def validate_percentness_of(number) #:nodoc:
-			number.to_s.to_f == number && number >= 0 && number <= 1
-		end
-	end
-
-	class Token #:nodoc:
-		attr_accessor :word, :tags
-
-		def initialize(word)
-			@word = word
-			@tags = []
-		end
-
-		# Tag this token with the specified tag
-		def tag(new_tag)
-			@tags << new_tag
-		end
-
-		# Remove all tags of the given class
-		def untag(tag_class)
-			@tags = @tags.select { |m| !m.kind_of? tag_class }
-		end
-
-		# Return true if this token has any tags
-		def tagged?
-			@tags.size > 0
-		end
-
-		# Return the Tag that matches the given class
-		def get_tag(tag_class)
-			matches = @tags.select { |m| m.kind_of? tag_class }
-			#matches.size < 2 || raise("Multiple identical tags found")
-			return matches.first
-		end
-
-		# Print this Token in a pretty way
-		def to_s
-			"#{@word}(#{@tags.join(', ')})"
-		end
-	end
-
-	# A Span represents a range of time. Since this class extends
-	# Range, you can use #begin and #end to get the beginning and
-	# ending times of the span (they will be of class Time)
-	class Span < Range
-
-		def initialize(range_begin, range_end)
-			# Use exclusive range.
-			super(range_begin, range_end, true)
-		end
-
-		# Returns the width of this span in seconds
-		def width
-			(self.end - self.begin).to_i
-		end
-
-		# Add a number of seconds to this span, returning the
-		# resulting Span
-		def +(seconds)
-			Span.new(self.begin + seconds, self.end + seconds)
-		end
-
-		# Subtract a number of seconds to this span, returning the
-		# resulting Span
-		def -(seconds)
-			self + -seconds
-		end
-
-		# Prints this span in a nice fashion
-		def to_s
-			'(' << self.begin.to_s << '...' << self.end.to_s << ')'
-		end
-	end
-
-	# Tokens are tagged with subclassed instances of this class when
-	# they match specific criteria
-	class Tag #:nodoc:
-		attr_accessor :type
-
-		def initialize(type)
-			@type = type
-		end
-
-		def start=(s)
-			@now = s
-		end
-	end
-
-	# Internal exception
-	class ChronicPain < Exception #:nodoc:
-
-	end
-
-	# This exception is raised if an invalid argument is provided to
-	# any of Chronic's methods
-	class InvalidArgumentException < Exception
-
-	end
+  class << self
+    
+    # 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 <tt>:guess</tt>). If no date or time can be found,
+    # +nil+ will be returned.
+    #
+    # Options are:
+    #
+    # [<tt>:context</tt>]
+    #     <tt>:past</tt> or <tt>:future</tt> (defaults to <tt>:future</tt>)
+    #
+    #     If your string represents a birthday, you can set <tt>:context</tt> to <tt>:past</tt> 
+    #     and if an ambiguous string is given, it will assume it is in the 
+    #     past. Specify <tt>:future</tt> or omit to set a future context.
+    #
+    # [<tt>:now</tt>]
+    #     Time (defaults to Time.now)
+    #
+    #     By setting <tt>:now</tt> to a Time, all computations will be based off
+    #     of that time instead of Time.now. If set to nil, Chronic will use Time.now.
+    #
+    # [<tt>:guess</tt>]
+    #     +true+ or +false+ (defaults to +true+)
+    #
+    #     By default, the parser will guess a single point in time for the
+    #     given date or time. If you'd rather have the entire time span returned,
+    #     set <tt>:guess</tt> to +false+ and a Chronic::Span will be returned.
+    #     
+    # [<tt>:ambiguous_time_range</tt>]
+    #     Integer or <tt>:none</tt> (defaults to <tt>6</tt> (6am-6pm))
+    #
+    #     If an Integer is given, ambiguous times (like 5:00) will be 
+    #     assumed to be within the range of that time in the AM to that time
+    #     in the PM. For example, if you set it to <tt>7</tt>, then the parser will
+    #     look for the time between 7am and 7pm. In the case of 5:00, it would
+    #     assume that means 5:00pm. If <tt>:none</tt> is given, no assumption
+    #     will be made, and the first matching instance of that time will 
+    #     be used.
+    def parse(text, specified_options = {})
+      @text = text
+      
+      # get options and set defaults if necessary
+      default_options = {:context => :future,
+                         :now => Chronic.time_class.now,
+                         :guess => true,
+                         :ambiguous_time_range => 6,
+                         :endian_precedence => nil}
+      options = default_options.merge specified_options
+      
+      # handle options that were set to nil
+      options[:context] = :future unless options[:context]
+      options[:now] = Chronic.time_class.now unless options[:context]
+      options[:ambiguous_time_range] = 6 unless options[:ambiguous_time_range]
+            
+      # ensure the specified options are valid
+      specified_options.keys.each do |key|
+        default_options.keys.include?(key) || raise(InvalidArgumentException, "#{key} is not a valid option key.")
+      end
+      [:past, :future, :none].include?(options[:context]) || raise(InvalidArgumentException, "Invalid value ':#{options[:context]}' for :context specified. Valid values are :past and :future.")
+      
+      # store now for later =)
+      @now = options[:now]
+      
+      # put the text into a normal format to ease scanning
+      text = self.pre_normalize(text)
+          
+      # get base tokens for each word
+      @tokens = self.base_tokenize(text)
+    
+      # scan the tokens with each token scanner
+      [Repeater].each do |tokenizer|
+        @tokens = tokenizer.scan(@tokens, options)
+      end
+      
+      [Grabber, Pointer, Scalar, Ordinal, Separator, TimeZone].each do |tokenizer|
+        @tokens = tokenizer.scan(@tokens)
+      end
+      
+      # strip any non-tagged tokens
+      @tokens = @tokens.select { |token| token.tagged? }
+      
+      if Chronic.debug
+        puts "+---------------------------------------------------"
+        puts "| " + @tokens.to_s
+        puts "+---------------------------------------------------"
+      end
+      
+      # do the heavy lifting
+      begin
+        span = self.tokens_to_span(@tokens, options)
+      rescue
+        raise
+        return nil
+      end
+      
+      # guess a time within a span if required
+      if options[:guess]
+        return self.guess(span)
+      else
+        return span
+      end
+    end
+    
+    # Clean up the specified input text by stripping unwanted characters,
+    # converting idioms to their canonical form, converting number words
+    # to numbers (three => 3), and converting ordinal words to numeric
+    # ordinals (third => 3rd)
+    def pre_normalize(text) #:nodoc:
+      normalized_text = text.to_s.downcase
+      normalized_text = numericize_numbers(normalized_text)
+      # completely removing periods breaks decimal minutes, etc.
+      # tests indicate a period should really act as a : in time
+      # and a - in the date.  Not exactly sure what to do with that.
+      # If between numbers, assume time and make it a colon.
+      # Will not work for a date like 10.15.2010
+      normalized_text.gsub!(/([0-9])[\.]([0-9])/, '\1:\2')
+  
+      # probably not time now, so let's make the rest a space
+      normalized_text.gsub!(/['"\.,]/, ' ')
+      normalized_text.gsub!(/ \-(\d{4})\b/, ' tzminus\1')
+      normalized_text.gsub!(/([\/\-\,\@])/) { ' ' + $1 + ' ' }
+      normalized_text.gsub!(/\btoday\b/, 'this day')
+      normalized_text.gsub!(/\btomm?orr?ow\b/, 'next day')
+      normalized_text.gsub!(/\byesterday\b/, 'last day')
+      normalized_text.gsub!(/\bnoon\b/, '12:00')
+      normalized_text.gsub!(/\bmidnight\b/, '24:00')
+      normalized_text.gsub!(/\bbefore now\b/, 'past')
+      normalized_text.gsub!(/\bnow\b/, 'this second')
+      normalized_text.gsub!(/\b(ago|before)\b/, 'past')
+      normalized_text.gsub!(/\bthis past\b/, 'last')
+      normalized_text.gsub!(/\bthis last\b/, 'last')
+      normalized_text.gsub!(/\b(?:in|during) the (morning)\b/, '\1')
+      normalized_text.gsub!(/\b(?:in the|during the|at) (afternoon|evening|night)\b/, '\1')
+      normalized_text.gsub!(/\btonight\b/, 'this night')
+      normalized_text.gsub!(/\b\d+:?\d*[ap]\b/,'\0m')
+      normalized_text.gsub!(/(\d)([ap]m|oclock)\b/, '\1 \2')
+      normalized_text.gsub!(/\b(hence|after|from)\b/, 'future')
+      normalized_text = numericize_ordinals(normalized_text)
+    end
+  
+    # Convert number words to numbers (three => 3)
+    def numericize_numbers(text) #:nodoc:
+      Numerizer.numerize(text)
+    end
+  
+    # Convert ordinal words to numeric ordinals (third => 3rd)
+    def numericize_ordinals(text) #:nodoc:
+      text
+    end
+  
+    # Split the text on spaces and convert each word into
+    # a Token
+    def base_tokenize(text) #:nodoc:
+      text.split(' ').map { |word| Token.new(word) }
+    end
+    
+    # Guess a specific time within the given span
+    def guess(span) #:nodoc:
+      return nil if span.nil?
+      if span.width > 1
+        span.begin + (span.width / 2)
+      else
+        span.begin
+      end
+    end
+  end
+  
+  class Token #:nodoc:
+    attr_accessor :word, :tags
+    
+    def initialize(word)
+      @word = word
+      @tags = []
+    end
+    
+    # Tag this token with the specified tag
+    def tag(new_tag)
+      @tags << new_tag
+    end
+    
+    # Remove all tags of the given class
+    def untag(tag_class)
+      @tags = @tags.select { |m| !m.kind_of? tag_class }
+    end
+    
+    # Return true if this token has any tags
+    def tagged?
+      @tags.size > 0
+    end
+    
+    # Return the Tag that matches the given class
+    def get_tag(tag_class)
+      matches = @tags.select { |m| m.kind_of? tag_class }
+      #matches.size < 2 || raise("Multiple identical tags found")
+      return matches.first
+    end
+    
+    # Print this Token in a pretty way
+    def to_s
+      @word << '(' << @tags.join(', ') << ') '
+    end
+  end
+  
+  # A Span represents a range of time. Since this class extends
+  # Range, you can use #begin and #end to get the beginning and
+  # ending times of the span (they will be of class Time)
+  class Span < Range
+    # Returns the width of this span in seconds
+    def width
+      (self.end - self.begin).to_i
+    end
+
+    # Add a number of seconds to this span, returning the
+    # resulting Span
+    def +(seconds)
+      Span.new(self.begin + seconds, self.end + seconds)
+    end
+
+    # Subtract a number of seconds to this span, returning the
+    # resulting Span
+    def -(seconds)
+      self + -seconds
+    end
+
+    # Prints this span in a nice fashion
+    def to_s
+      '(' << self.begin.to_s << '..' << self.end.to_s << ')'
+    end
+    
+    unless RUBY_VERSION =~ /1\.9\./
+      alias :cover? :include?
+    end
+    
+  end
+
+  # Tokens are tagged with subclassed instances of this class when
+  # they match specific criteria
+  class Tag #:nodoc:
+    attr_accessor :type
+    
+    def initialize(type)
+      @type = type
+    end
+    
+    def start=(s)
+      @now = s
+    end
+  end
+  
+  # Internal exception
+  class ChronicPain < Exception #:nodoc:
+    
+  end
+  
+  # This exception is raised if an invalid argument is provided to
+  # any of Chronic's methods
+  class InvalidArgumentException < Exception
+    
+  end
 end