eventual 0.4.9

data/History.txt

@@ -0,0 +1,6 @@
+== 0.4.9 2009-11-10
+
+* Nuevos formatos reconocidos:
+  
+  
+

data/Manifest.txt

@@ -0,0 +1,11 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+lib/eventual.rb
+lib/eventual/date.rb
+lib/eventual/date_time.rb
+spec/date_time_spec.rb
+spec/es_eventual_spec.rb
+spec/spec_helper.rb
+eventual.gemspec

data/README.rdoc

@@ -0,0 +1,105 @@
+= eventual
+
+* http://github.com/maca/eventual
+
+== DESCRIPCIÓN:
+
+Reconocimiento de fechas y periodos en lenguaje natural. Útil para crear interfaces de usuario basadas en texto.
+
+== SINOPSIS:
+
+El método event_parse del modulo Eventual reconoce y convierte una fecha o periodo expresado en lenguaje natural en objetos _Date_ o _DateTime_
+Ejemplos:
+
+  require 'rubygems'
+  require 'eventual'
+
+  Eventual.event_parse( 'del 5 al 7 de junio' )
+  => [#<DateTime: 4909975/2,0,2299161>, #<DateTime: 4909977/2,0,2299161>, #<DateTime: 4909979/2,0,2299161>]
+  
+  Eventual.event_parse( 'del 5 al 7 de junio 2009', Date )
+  => [#<Date: 4909975/2,0,2299161>, #<Date: 4909977/2,0,2299161>, #<Date: 4909979/2,0,2299161>]
+  
+  Eventual.event_parse( 'del 5 al 7 de junio del 2009 a las 16:00 y 18:00 horas' ){ |d| d.to_s }
+  => ["2009-06-05T16:00:00+00:00", "2009-06-05T18:00:00+00:00", "2009-06-06T16:00:00+00:00", "2009-06-06T18:00:00+00:00", "2009-06-07T16:00:00+00:00", "2009-06-07T18:00:00+00:00"]
+  
+  Eventual.event_parse( 'del 5 al 7 de junio 2009' ){ |d| Eventual::WDAY_LIST[ d.wday ] }
+  => ['viernes', 'sabado', 'domingo']
+  
+Ejemplos de formatos reconocidos:
+
+* 1 de enero
+* 21, 22 y 23 de enero del 2009
+* 21, 22 y 23 de enero a las 20:00 horas
+* 21, 22 y 23 de enero a las 20:00 y 22:00 horas
+* viernes 1, sábado 2, domingo 3 y lunes 4 de enero del 2010
+* martes y miércoles del 1 al 20 de junio del 2009 a las 16:00 y 18:00 horas
+* sábados y domingos del 1 de enero al 31 de diciembre del 2008 a las 16:00
+* sábado y domingo del 1 de enero al 31 de diciembre
+* lunes a viernes del 1 de enero al 31 de diciembre del 2008 a las 16:00
+* todos los sábados de diciembre del 2009
+* lunes a viernes de enero a abril
+* del viernes 1 al domingo 3 de enero del 2010
+  
+Se puede extender _Date_ y _DateTime_ con Eventual requiriendo 'eventual/date_time' y 'eventual/date':
+  
+  require 'rubygems'
+  require 'eventual'
+  require 'eventual/date_time'
+  require 'eventual/date'
+
+  DateTime.event_parse( 'del 5 al 7 de junio' )
+  => [#<DateTime: 4909975/2,0,2299161>, #<DateTime: 4909977/2,0,2299161>, #<DateTime: 4909979/2,0,2299161>]
+  
+  Date.event_parse( 'del 5 al 7 de junio 2009' )
+  => [#<Date: 4909975/2,0,2299161>, #<Date: 4909977/2,0,2299161>, #<Date: 4909979/2,0,2299161>]
+
+
+Si se pasa un bloque se puede especificar si se desea usar el texto que sigue a la definición de fechas mediante pasando la opción _use_trailing_ => _true_:
+
+  str = "1 de enero del 2009\nSede:El tercer lugar\n2 de enero del 2009\nSede:El tercer lugar"
+  Eventual.event_parse( str, :use_trailing => true ) do |dia, texto_extra|
+    [dia.to_s, texto_extra]
+  end
+  => [["2009-01-01T00:00:00+00:00", "Sede:El tercer lugar"], ["2009-01-02T00:00:00+00:00", "Sede:El tercer lugar"]]
+
+== TODO:
+
+* No estoy seguro de que Iconv funcione en windows, lo arreglaré pronto
+
+Formatos a reconocer
+
+* todos los lunes de junio
+* todo junio
+* domingos de septiembre
+* martes y miércoles de agosto
+* todo el año
+
+== INSTALACIÓN:
+
+  sudo gem install maca-eventual -s http://gems.github.com
+
+== LICENCIA:
+
+(The MIT License)
+
+Copyright (c) 2009 Macario Ortega
+
+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/Rakefile

@@ -0,0 +1,18 @@
+require 'rubygems' unless ENV['NO_RUBYGEMS']
+%w[rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/eventual'
+
+
+$hoe = Hoe.new('eventual', Eventual::VERSION) do |p|
+  p.developer('Macario Ortega', 'macarui@gmail.com')
+  p.changes        = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.rubyforge_name = p.name
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  p.rsync_args   = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+task :default => :spec

data/eventual.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{eventual}
+  s.version = "0.4.9"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Macario Ortega"]
+  s.date = %q{2009-11-10}
+  s.description = %q{}
+  s.email = ["macarui@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.rdoc"]
+  s.files = ["History.txt", "Manifest.txt", "README.rdoc", "Rakefile", "lib/eventual.rb", "lib/eventual/date.rb", "lib/eventual/date_time.rb", "spec/date_time_spec.rb", "spec/es_eventual_spec.rb", "spec/spec_helper.rb", "eventual.gemspec"]
+  s.homepage = %q{http://github.com/maca/eventual}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{eventual}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
+    else
+      s.add_dependency(%q<hoe>, [">= 1.8.0"])
+    end
+  else
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/lib/eventual/date.rb

@@ -0,0 +1 @@
+Date.send :extend, Eventual

data/lib/eventual/date_time.rb

@@ -0,0 +1 @@
+DateTime.send :extend, Eventual

data/lib/eventual.rb

@@ -0,0 +1,193 @@
+require 'date'
+require 'iconv'
+require 'strscan'
+
+module Eventual
+  class WdayMatchError < StandardError; end
+  
+  
+  VERSION = '0.4.9'
+  extend self
+
+  WDAY_LIST    = %w(domingo lunes martes miércoles jueves viernes sábado).freeze
+  MESES        = %w(enero febrero marzo abril mayo junio julio agosto septiembre octubre noviembre diciembre).unshift(nil).freeze
+  DIAS_DE_LA_SEMANA  = WDAY_LIST.map{ |d| d.match(/s$/) ? d : "#{d}s?" }
+  
+  def rango_de a, b = nil
+    a = a.join('|') if Array === a
+    b ||= a
+    /(?:de |del )?(?:#{ a }) (?:a|al) (?:#{ b })/
+  end
+
+  def lista_de elementos
+    elementos = elementos.join('|') if Array === elementos
+    /(?:#{ elementos })  # Primer elemento -requerido-
+    (?:                           # Cualquier número de 
+      (?-x:, | y )                  # concatenador
+      (?:#{ elementos })            # y elemento.
+     )*/ix
+  end
+  
+  def plural_opcional elementos
+    elementos.map{ |d| d.match(/s$/) ? d : "#{d}s?" }
+  end
+
+  year         = /(?-x:del |de )?(\d{4})/i
+  horarios     = /a las (#{ lista_de '\d{1,2}:\d{2}' })(?: horas| hrs)?/i
+  
+
+  DAY_LIST = /
+               (#{ lista_de %r"(?:(?:#{ DIAS_DE_LA_SEMANA.join('|') }) )?\d{1,2}" })\s
+               de\s(#{ MESES.compact.join('|') })         # Mes
+               (?:\s#{ year })?                           # Año opcional
+               (\s#{ horarios })?                         # Hora opcional
+             /ixo
+
+  DAY_PERIOD =  /
+                  (?:
+                    (
+                      (?:#{ rango_de DIAS_DE_LA_SEMANA })\s
+                      |
+                      (?:#{ lista_de DIAS_DE_LA_SEMANA })\s
+                    )
+                    (?-x:de |del )
+                  )?
+                  (?-x:(?:de |del )?(?:(#{ DIAS_DE_LA_SEMANA.join('|') }) )?(\d{1,2})(?: de (#{ MESES.compact.join('|') })(?: #{ year })?)?)                                                   
+                  (?-x: (?:a|al) (?:(#{ DIAS_DE_LA_SEMANA.join('|') }) )?(\d{1,2}) de (#{ MESES.compact.join('|') })(?: #{ year })?)
+                  (?:\s#{ horarios })?
+                /ixo 
+                 
+  WHOLE_MONTH = / 
+                 ( # Dias de la semana opcionales
+                   (?-x:los |todos los )?
+                   (?:
+                     (?:#{ rango_de DIAS_DE_LA_SEMANA })
+                     |
+                     (?:#{ lista_de DIAS_DE_LA_SEMANA })
+                   )\s
+                   (?-x:de|durante|durante todo)\s
+                 )?
+                (?:
+                   (?:#{ rango_de %r"(#{ MESES.compact.join('|') })(?:\s#{ year })?" })
+                   |
+                   (#{ lista_de MESES.compact })(?:\s#{ year })?
+                )
+                (?:\s#{ horarios })?  # Hora opcional
+               /ixo
+  
+  def event_parse string, opts = {}, &block
+    parser       = opts.delete(:parser) || (self == Eventual ? DateTime : self)
+    use_trailing = opts.delete(:use_trailing)
+    string       = string.gsub('miercoles', 'miércoles').gsub('sabado', 'sábado').gsub(/'/, '').gsub(/(\s)+/, '\1')
+    results      = []
+    scanner      = StringScanner.new string
+    
+    map_months = lambda{ |months| months.scan(/#{ MESES.compact.join('|') }/).map{ |m| MESES.index(m.downcase) } }
+    make_range = lambda{ |first, last, min, max| first > last ? (first..max).map + (min..last).map : (first..last).map }
+    
+    extract_wdays  = lambda do |wdays|
+      wdays_array  = wdays ? wdays.scan( /#{ WDAY_LIST.join('|') }/ ).map{ |d| WDAY_LIST.index d.downcase } : []
+      next wdays_array unless rango_de(DIAS_DE_LA_SEMANA) === wdays
+      make_range[wdays_array.first, wdays_array.last, 0, 6]
+    end
+    
+    until scanner.eos?
+      case match = scanner.scan(/.*?(?:#{ DAY_LIST }|#{ DAY_PERIOD }|#{ WHOLE_MONTH })/m)
+        
+      when DAY_PERIOD
+        wdays, first_wday, first_day, first_month, first_year, last_wday, last_day, last_month, last_year, times = $1, $2, $3, $4, $5, $6, $7, $8, $9, $10
+       
+        wdays_array   = extract_wdays[wdays]
+        last_year   ||= string.match(/\d{4}/) ? $& : Date.today.year
+        first_year  ||= last_year
+        first_month ||= last_month
+        last_month    = MESES.index last_month.downcase
+        first_month   = MESES.index first_month.downcase
+        
+        make_days     = lambda do |hour, minute|
+          first       = make_day parser, first_year, first_month, first_day, hour, minute
+          last        = make_day parser, last_year,  last_month,  last_day,  hour, minute
+          
+          [first, last].zip([first_wday, last_wday]).each do |day, wday|
+            raise WdayMatchError.new("El día #{ day } cae en #{ DIAS_DE_LA_SEMANA[day.wday] }, no en #{ wday.downcase }") unless day.wday == WDAY_LIST.index(wday.downcase) if wday
+          end
+          
+          next (first..last).map if wdays_array.empty?
+          (first..last).select{ |day| wdays_array.include? day.wday }
+        end
+      
+      when DAY_LIST
+        daynums, month, year, times = $1, MESES.index($2.downcase), $3, $4
+
+        year    ||= string.match(/\d{4}/) ? $& : Date.today.year
+        make_days = lambda do |hour, minute|
+          daynums.scan(/(?:(#{ DIAS_DE_LA_SEMANA.join('|') }) )?(\d{1,2})/).collect do |wday, daynum|
+            day   = make_day(parser, year, month, daynum, hour, minute)
+            raise WdayMatchError.new("El día #{ day } cae en #{ DIAS_DE_LA_SEMANA[day.wday] }, no en #{ wday.downcase }") unless day.wday == WDAY_LIST.index(wday.downcase) if wday
+            day
+          end
+        end
+
+      when WHOLE_MONTH
+        wdays, month_range_start, starting_year, month_range_end, ending_year, months, year, times = $1, $2, $3, $4, $5, $6, $7, $8
+        wdays_array = extract_wdays[wdays]
+
+        month_array =
+        if month_range_start
+          ending_year ||= Date.today.year
+          first = Date.civil( (starting_year || ending_year).to_i, MESES.index(month_range_start.downcase) )
+          last  = Date.civil ending_year.to_i, MESES.index(month_range_end.downcase)
+          (first..last)
+        else  
+          year ||= Date.today.year
+          months.scan(/#{ MESES.compact.join('|') }/).map do |m|
+            Date.civil year.to_i, MESES.index(m.downcase)
+          end
+        end
+
+        make_days = lambda do |hour, minute|
+          months  = month_array.map do |date|
+            first = make_day(parser, date.year, date.month, 1, hour, minute)
+            last  = (first >> 1) - 1
+            next (first..last).map if wdays_array.empty?
+            (first..last).select{ |day| wdays_array.include? day.wday }
+          end.flatten
+        end
+        
+      else
+        break
+      end
+      
+      extra = scanner.scan(/.*?(?=#{ DAY_LIST }|#{ DAY_PERIOD }|\z)/m).to_s.chomp
+      extra.gsub!(/^(,|\n|\.)/, '')
+      
+      days  =
+      if times
+        times.scan( /(\d{2}):(\d{2})/ ).map{ |hour, minute| make_days.call hour, minute }.flatten
+      else
+        make_days.call nil, nil 
+      end
+      
+      days.each { |day| day.instance_variable_set('@extra', extra) } 
+      results += days
+    end
+    
+    raise ArgumentError.new( 'El formato de las fechas parece ser incorrecto' ) if results.empty?
+    results.uniq!
+    results.sort!
+    
+    use_trailing ? results.map!{ |day| yield day, day.instance_variable_get('@extra') } : results.map!{ |day| yield day } if block_given?
+    results
+  end
+
+  protected
+  def make_day *args 
+    maker = args.shift
+    if maker == Date
+      maker.civil *args.compact.collect{ |a| a.to_i }[0...4]
+    else
+      maker.civil *args.compact.collect{ |a| a.to_i }
+    end
+  end
+end
+

data/spec/date_time_spec.rb

@@ -0,0 +1,15 @@
+require File.expand_path( File.dirname(__FILE__) + '/spec_helper' )
+require File.dirname(__FILE__) + '/../lib/eventual/date_time'
+require File.dirname(__FILE__) + '/../lib/eventual/date'
+
+
+describe 'Monkeypatches' do
+  it 'should monkey patch DateTime' do
+    DateTime.event_parse( '1 de enero del 2009 a las 16:00' ).should map_times( '2009-1-1T16:00:00+00:00' )
+  end
+  
+  it 'should monkey patch Date' do
+    Date.event_parse( '1 de enero del 2009 a las 16:00 horas' ).should map_dates( '2009-1-1' )
+  end
+end
+

data/spec/es_eventual_spec.rb

@@ -0,0 +1,222 @@
+require File.expand_path( File.dirname(__FILE__) + '/spec_helper' )
+
+describe 'event parsing' do
+
+  describe 'lista de número dia' do
+    it "should event_parse one day" do
+      Eventual.event_parse( '1 de enero del 2009' ).should map_times( '2009-1-1' )
+    end
+  
+    it "should event_parse several days" do
+      Eventual.event_parse( '1, 2 y 3 de enero' ).should map_times( "2009-1-1", "2009-1-2", "2009-1-3" )
+    end
+  
+    it "should match several days with year" do
+      Eventual.event_parse( '1, 2 y 3 de enero del 2010' ).should map_times( "2010-1-1", "2010-1-2", "2010-1-3" )
+    end
+  
+    it "should event_parse one day with one time" do
+      Eventual.event_parse( '1 de enero del 2009 a las 16:00 horas' ).should map_times( '2009-1-1T16:00' )
+    end
+    
+    it "should parse one day with wday" do
+      Eventual.event_parse( 'viernes 1 de enero del 2010' ).should map_times( '2010-1-1' )
+    end
+    
+    it "should parse list with wday" do
+      Eventual.event_parse( 'viernes 1, sábado 2, domingo 3 y lunes 4 de enero del 2010' ).should map_times( '2010-1-1', '2010-1-2', '2010-1-3', '2010-1-4' )
+    end
+    
+    it "should blow if wday doesn't correspond" do
+      lambda{ Eventual.event_parse('sábado 1 de enero del 2010') }.should raise_error(Eventual::WdayMatchError)
+    end
+  end
+
+  describe 'lista de rango de número de día' do
+    it "should event_parse a period" do
+      Eventual.event_parse( 'del 1 al 3 de enero' ).should map_times( '2009-1-1', '2009-1-2', '2009-1-3' )
+    end
+  
+    it "should event_parse a period with year" do
+      Eventual.event_parse( 'del 1 al 3 de enero 2010' ).should map_times( '2010-1-1', '2010-1-2', '2010-1-3' )
+    end
+  
+    it "should event_parse a period with time" do
+      Eventual.event_parse( 'miércoles del 1 al 3 de junio' ).should map_times( '2009-6-3' )
+    end
+  
+    it "should event_parse a period with time" do
+      Eventual.event_parse( 'miércoles del 1 al 3 de junio a las 16:00 horas' ).should map_times( '2009-6-3T16:00' )
+    end
+  
+    it "should event_parse one day with several times" do
+      Eventual.event_parse( '1 de enero del 2009 a las 16:00 y 17:00' ).should map_times( '2009-1-1T16:00', '2009-1-1T:17:00' )
+    end
+  
+    it "should event_parse period spanning more than one month" do
+      Eventual.event_parse( 'del 29 de enero al 3 de febrero' ).should map_times( '2009-1-29', '2009-1-30', '2009-1-31', '2009-2-1', '2009-2-2', '2009-2-3' )
+    end
+  
+    it "should parse period spanning across year" do
+      Eventual.event_parse( 'del 28 de diciembre del 2009 al 2 de enero del 2010').should map_times( '2009-12-28', '2009-12-29', '2009-12-30', '2009-12-31', '2010-1-1', '2010-1-2')
+    end
+    
+    it "should parse range with wday" do
+      Eventual.event_parse( 'viernes 1 al domingo 3 de enero del 2010' ).should map_times( '2010-1-1', '2010-1-2', '2010-1-3' )
+    end
+    
+    it "should blow if wday doesn't correspond" do
+      lambda{ Eventual.event_parse('viernes 2 a domingo 4 de enero del 2010') }.should raise_error(Eventual::WdayMatchError)
+    end
+    
+    describe 'restringido por dia de la semana' do
+      it "should parse all tuesdays and thursdays of the year" do
+        e = Eventual.event_parse( 'martes y jueves del 1 de enero al 31 de diciembre del 2008')
+        r = ( DateTime.parse('2008-1-1')..DateTime.parse('2008-12-31') ).reject{ |day| not [2,4].include?(day.wday) }
+        e.should map_times( *r )
+      end
+
+      it "should parse all tuesdays and thursdays of the year with time" do
+        e = Eventual.event_parse( 'martes y jueves del 1 de enero al 31 de diciembre del 2008 a las 16:00')
+        r = ( DateTime.parse('2008-1-1T16:00')..DateTime.parse('2008-12-31T16:00') ).reject{ |day| not [2,4].include?(day.wday) }
+        e.should map_times( *r )
+      end
+
+      it "should parse all saturdays and sundays of the year with time" do
+        e = Eventual.event_parse( 'sábado y domingo del 1 de enero al 31 de diciembre del 2008 a las 16:00')
+        r = ( DateTime.parse('2008-1-1T16:00')..DateTime.parse('2008-12-31T16:00') ).reject{ |day| not [0,6].include?(day.wday) }
+        e.should map_times( *r )
+      end
+
+      it "should parse all pluralized saturdays and sundays of the year with time" do
+        e = Eventual.event_parse( 'sábados y domingos del 1 de enero al 31 de diciembre del 2008 a las 16:00')
+        r = ( DateTime.parse('2008-1-1T16:00')..DateTime.parse('2008-12-31T16:00') ).reject{ |day| not [0,6].include?(day.wday) }
+        e.should map_times( *r )
+      end
+
+      it "should parse week day period" do
+        e = Eventual.event_parse( 'lunes a viernes del 1 de enero al 31 de diciembre del 2008 a las 16:00')
+        r = ( DateTime.parse('2008-1-1T16:00')..DateTime.parse('2008-12-31T16:00') ).reject{ |day| not (1..5).map.include?(day.wday) }
+        e.should map_times( *r )
+      end
+
+      it "should parse week day period across week" do
+        e = Eventual.event_parse( 'viernes a lunes del 1 de enero al 31 de diciembre del 2008 a las 16:00')
+        r = ( DateTime.parse('2008-1-1T16:00')..DateTime.parse('2008-12-31T16:00') ).reject{ |day| not [5,6,0,1].map.include?(day.wday) }
+        e.should map_times( *r )
+      end
+    end
+  end
+  
+  describe 'Meses completos' do
+    it "should parse a single month" do
+      ['diciembre del 2008', 'durante diciembre del 2008', 'durante todo diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2008-12-31T00:00')).map )
+      end
+    end
+  
+    it "should parse two full months" do
+      ['noviembre y diciembre del 2008', 'durante noviembre y diciembre del 2008', 'durante todo noviembre y diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-11-1T00:00')..DateTime.parse('2008-12-31T00:00')).map )
+      end
+    end
+  
+    it "should parse severals full months" do
+      ['octubre, noviembre y diciembre del 2008', 'durante octubre, noviembre y diciembre del 2008', 'durante todo octubre, noviembre y diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-10-1T00:00')..DateTime.parse('2008-12-31T00:00')).map )
+      end
+    end
+  
+    it "should parse a full month with time" do
+      Eventual.event_parse('diciembre del 2008 a las 16:00 horas').should map_times( *(DateTime.parse('2008-12-1T16:00')..DateTime.parse('2008-12-31T16:00')).map )
+    end
+  
+    it "should parse a full month with time with days" do
+      Eventual.event_parse('domingos de diciembre del 2008').should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2008-12-31T00:00')).reject{ |day| not [0].include?(day.wday) } )
+    end
+    
+    it "should parse a full month with time with days and sugar" do
+      ['todos los domingos de diciembre del 2008', 'los domingos durante todo diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2008-12-31T00:00')).reject{ |day| not [0].include?(day.wday) } )
+      end
+    end
+    
+    it "should parse a full month with time with days" do
+      ['sábados y domingos de diciembre del 2008', 'todos los sábados y domingos de diciembre del 2008', 'sábados y domingos durante todo diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2008-12-31T00:00')).reject{ |day| not [0, 6].include?(day.wday) } )
+      end
+    end
+    
+    it "should parse a full month with time with days" do
+      ['todos los sábados a lunes de diciembre del 2008', 'sábado a lunes de diciembre del 2008', 'sábados a lunes durante todo diciembre del 2008'].each do |e|
+        Eventual.event_parse(e).should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2008-12-31T00:00')).reject{ |day| not [0, 1, 6].include?(day.wday) } )
+      end
+    end
+    
+    it "should parse without year" do
+      Eventual.event_parse('sábados de diciembre').should map_times( *(DateTime.parse("#{ y = Date.today.year }-12-1T00:00")..DateTime.parse("#{ y }-12-31T00:00")).reject{ |day| not [6].include?(day.wday) } )
+    end
+    
+    it "should parse month range" do
+      Eventual.event_parse('octubre a diciembre del 2008').should map_times( *(DateTime.parse('2008-10-1T00:00')..DateTime.parse('2008-12-31T00:00')).map )
+    end
+    
+    it "should parse month range" do
+      Eventual.event_parse('diciembre del 2008 a enero del 2009').should map_times( *(DateTime.parse('2008-12-1T00:00')..DateTime.parse('2009-1-31T00:00')).map )
+    end
+  end
+
+  it "should event_parse a period with block" do
+    Eventual.event_parse( 'del 5 al 7 de junio 2009' ){ |d| Eventual::WDAY_LIST[ d.wday ] }.should == ['viernes', 'sábado', 'domingo']
+  end
+  
+  it "should parse several expressions" do
+    Eventual.event_parse( '1 de enero y 2 de febrero del 2008' ).should map_times( '2008-1-1', '2008-2-2' )
+  end
+  
+  it "should event_parse period spanning more than one month" do
+    Eventual.event_parse( '1 de enero, del 29 de enero al 3 de febrero y 2 de febrero del 2008' ).should map_times( '2008-1-1', '2008-1-29', '2008-1-30', '2008-1-31', '2008-2-1', '2008-2-2', '2008-2-3' )
+  end
+  
+  it "should event_parse a several dates separated by \\n" do |d, extra|
+    Eventual.event_parse( "1 de enero del 2009\n2 de enero del 2009" ) do |d|
+      d.to_s
+    end.should == ["2009-01-01T00:00:00+00:00", "2009-01-02T00:00:00+00:00"]
+  end
+  
+  describe 'With extra data' do
+    it "should event_parse one day with one time" do
+      Eventual.event_parse( "1 de enero del 2009 a las 16:00 horas\nSede:Áreas verdes\nCupo: limitado", :use_trailing => true ) do |day, extra|
+        day.to_s.should == "2009-01-01T16:00:00+00:00"
+        extra.should == "Sede:Áreas verdes\nCupo: limitado"
+      end
+    end
+
+    it "should event_parse a period with block" do
+      Eventual.event_parse( "del 5 al 7 de junio 2009\nSede:El tercer lugar\nCupo: limitado", :use_trailing => true ) do |d, extra|
+        extra.should == "Sede:El tercer lugar\nCupo: limitado"
+        Eventual::WDAY_LIST[ d.wday ]
+      end.should == ['viernes', 'sábado', 'domingo']
+    end
+    
+    it "should event_parse a several dates" do
+      Eventual.event_parse( "1 de enero del 2009\nSede:El tercer lugar\nCupo: limitado\n2 de enero del 2009\nSede:El tercer lugar\nCupo: limitado", :use_trailing => true ) do |d, extra|
+        extra.should == "Sede:El tercer lugar\nCupo: limitado"
+        d.to_s
+      end.should == ["2009-01-01T00:00:00+00:00", "2009-01-02T00:00:00+00:00"]
+    end
+  
+    it "should event_parse a several dates" do
+      Eventual.event_parse( "1 de enero del 2009\nSede 1\n\n2 de enero del 2009\nSede 2", :use_trailing => true ) do |d, extra|
+        [d.to_s, extra]
+      end.should == [["2009-01-01T00:00:00+00:00", "Sede 1"], ["2009-01-02T00:00:00+00:00", "Sede 2"]]
+    end
+  end
+  
+  describe 'Case sensitivity' do
+    it "should ignore case" do
+      Eventual.event_parse( 'DeL 1 al 3 de ENeRO' ).should map_times( '2009-1-1', '2009-1-2', '2009-1-3' )
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'spec'
+
+require File.dirname(__FILE__) + '/../lib/eventual'
+
+
+class MapDates
+  def initialize expected, klass
+    @expected = expected.collect do |d| 
+      d = d.is_a?(String) ? klass.parse(d) : d
+      d.to_s
+    end.sort
+  end
+  
+  def matches? actual
+    @actual =  actual.collect{ |d| d.to_s }
+    @actual == @expected
+  end
+  
+  def failure_message
+    "expected #{ @expected.inspect }, got #{ @actual.inspect }"
+  end
+
+end
+
+def map_times *times
+  MapDates.new times, DateTime
+end
+
+def map_dates *times
+  MapDates.new times, Date
+end
+

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: eventual
+version: !ruby/object:Gem::Version 
+  version: 0.4.9
+platform: ruby
+authors: 
+- Macario Ortega
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-10 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: ""
+email: 
+- macarui@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- lib/eventual.rb
+- lib/eventual/date.rb
+- lib/eventual/date_time.rb
+- spec/date_time_spec.rb
+- spec/es_eventual_spec.rb
+- spec/spec_helper.rb
+- eventual.gemspec
+has_rdoc: true
+homepage: http://github.com/maca/eventual
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: eventual
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: ""
+test_files: []
+