maca-eventual 0.4.3 → 0.4.5

data/README.rdoc

@@ -4,7 +4,7 @@
 
 == DESCRIPCIÓN:
 
-Reconocimiento de fechas y periodos en lenguaje natural.
+Reconocimiento de fechas y periodos en lenguaje natural. Útil para crear interfaces de usuario basadas en texto.
 
 == SINOPSIS:
 
@@ -49,9 +49,17 @@ Para activar el parche:
   => [#<Date: 4909975/2,0,2299161>, #<Date: 4909977/2,0,2299161>, #<Date: 4909979/2,0,2299161>]
 
 
-== ETC:
+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_:
 
-* No estoy seguro de que Iconv funcione en windows
+  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
 

data/eventual.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{eventual}
-  s.version = "0.4.3"
+  s.version = "0.4.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Macario Ortega"]

data/lib/eventual.rb

@@ -1,60 +1,63 @@
 require 'date'
 require 'iconv'
+require 'strscan'
 
 $:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 
 module Eventual
-  VERSION = '0.4.3'
+  VERSION = '0.4.5'
   extend self
 
   WDAY_LIST       = %w(domingo lunes martes miercoles jueves viernes sabado)
   MNAMES          = %w(enero febrero marzo abril mayo junio julio agosto septiembre octubre noviembre diciembre).unshift(nil)
- 
-  DAY_LIST        = %r{
-                        (
-                          (?:\d{1,2}(?-mix: |, | y ))+      # Lista de número de día
-                        )
-                        de\s(#{ MNAMES.compact.join('|') })   # Lista de mes
-                        (?-mix: (?:del|de) (\d{4}))?          # Año opcional
-                        (?-mix: a las (.*))?                  # Hora opcional
-                      }ixo
   
-  
-  DAY_PERIOD      = %r{
-                          (
-                            (?:                             # Dia de la semana opcional
-                              (?:#{ WDAY_LIST.join('|') })    # Nombre del día
-                              (?-mix: |, | y )                # Concatenador
-                            )*
-                          )
-                          (?-mix:del (\d{1,2}))\s            # Comienzo del periodo
-                          (?:de\s                            # Mes opcional
-                            (#{ MNAMES.compact.join('|') })   # Nombre del mes
-                            (?-mix: (?:del|de) (\d{4}))?      # Año opcional
-                          \s)?
-                          (?-mix:al (\d{1,2}) de (#{ MNAMES.compact.join('|') })) # Mes requerido
-                          (?-mix: (?:del|de) (\d{4}))?         # Año opcional
-                          (?-mix: a las (.*))?                 # Hora opcional
-                      }ixo
-                      
-                      
+  year     = /(?: (?:del|de))? (\d{4})/
+  horarios = / a las (.*)/
+  DAY_LIST = %r{
+                 (
+                   (?:
+                     \d{1,2}
+                     (?-mix: |, | y )
+                   )+                                        # Lista de número de día
+                 )
+                 de\s(#{ MNAMES.compact.join('|') })         # Lista de mes
+                 (?:#{ year })?                              # Año opcional
+                 (#{ horarios })?                            # Hora opcional
+               }ixo
+               
+  DAY_PERIOD = %r{
+                   (
+                     (?:                                     # Dia de la semana opcional
+                       (?:#{ WDAY_LIST.join('|') })            # Nombre del día
+                       (?-mix: |, | y )                        # Concatenador
+                     )*
+                   )
+                   (?-mix:del (\d{1,2}))\s                   # Comienzo del periodo
+                   (?:de\s                                   # Mes opcional
+                     (#{ MNAMES.compact.join('|') })          # Nombre del mes
+                     (?:#{ year })?                           # Año opcional
+                   \s)?
+                   (?-mix:al (\d{1,2}) de (#{ MNAMES.compact.join('|') })) # Mes requerido
+                   (?:#{ year })?                           # Año opcional
+                   (#{ horarios })?                         # Hora opcional
+                 }ixo
 
-  def event_parse string, parser = nil, &block
-    parser ||= ( self == Eventual ? DateTime : self )
-    string   = Iconv.iconv("ASCII//IGNORE//TRANSLIT", "UTF-8", string).join.gsub(/'/, '')
-    results  = []
-  
-    string = string
+  def event_parse string, opts = {}, &block
+    parser       = opts.delete(:parser) || (self == Eventual ? DateTime : self)
+    use_trailing = opts.delete(:use_trailing)
+    string       = Iconv.iconv("ASCII//IGNORE//TRANSLIT", "UTF-8", string).join.gsub(/'/, '')
+    results      = []
+    scanner      = StringScanner.new string
     
-    while true
-      case string
+    until scanner.eos?
+      case match = scanner.scan(/.*?(?:#{DAY_LIST}|#{DAY_PERIOD})/m)
         
       when DAY_PERIOD
         wdays, first_day, first_month, first_year, last_day, last_month, last_year, times = $1, $2, $3, $4, $5, $6, $7, $8
         match = $&
-        wdays = wdays.scan( Regexp.new( WDAY_LIST.join('|') ) ).collect{ |d| WDAY_LIST.index d }
-        last_year   ||= string.match(/\d{4,4}/) ? $& : Date.today.year
+        wdays = wdays.scan( Regexp.new(WDAY_LIST.join('|')) ).collect{ |d| WDAY_LIST.index d }
+        last_year   ||= string.match(/\d{4}/) ? $& : Date.today.year
         first_year  ||= last_year
         first_month ||= last_month
         last_month    = MNAMES.index last_month
@@ -70,22 +73,20 @@ module Eventual
         end
       
       when DAY_LIST
-        days, month, year, times = $1, MNAMES.index( $2 ), $3, $4
+        days, month, year, times = $1, MNAMES.index($2), $3, $4
         match     = $&
         days      = days.scan(/\d{1,2}/)
-        year    ||= string.match(/\d{4,4}/) ? $& : Date.today.year
+        year    ||= string.match(/\d{4}/) ? $& : Date.today.year
         make_days = lambda do |hour, minute|
           days.map do |day| 
             make_day parser, year, month, day, hour, minute
           end
         end
-      
       else
         break
       end
-            
-      string.gsub!( match.to_s, '' )
       
+      extra = scanner.scan(/.*?(?=#{DAY_LIST}|#{DAY_PERIOD}|\n{2}|\z)/m)
       results +=
       if times
         times.scan( /(\d{2}):(\d{2})/ ).map do |hour, minute| 
@@ -95,16 +96,21 @@ module Eventual
         make_days.call nil, nil 
       end
     end
-    
+
+    raise ArgumentError.new( 'El formato de las fechas parece ser incorrecto' ) if results.empty?
     results.uniq!
     results.sort!
-    raise ArgumentError.new( 'El formato de las fechas parece ser incorrecto' ) if results.empty?
-    results.map!{ |day| yield( day ) } if block_given?
+    
+    results.map! do |day|
+      if use_trailing
+        yield day, extra.to_s.gsub(/^[\n|.|,]*/, '')
+      else 
+        yield day
+      end
+    end if block_given?
     
     results
   end
-  
-  
 
   protected
   def make_day *args 
@@ -115,6 +121,5 @@ module Eventual
       maker.civil *args.compact.collect{ |a| a.to_i }
     end
   end
-
 end
 

data/spec/es_eventual_spec.rb

@@ -61,7 +61,7 @@ describe 'event parsing' do
     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 a long period" do
     e = Eventual.event_parse( 'martes y jueves del 1 de enero del 2000 al 31 de diciembre del 2010' )
     r = (DateTime.parse('2000-1-1T00:00')..DateTime.parse('2010-12-31T00:00') ).reject{ |day| not [2,4].include?(day.wday) }
@@ -84,7 +84,36 @@ describe 'event parsing' do
   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' )
+    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:El tercer lugar\nCupo: limitado", :use_trailing => true ) do |day, extra|
+        day.to_s.should == "2009-01-01T16:00:00+00:00"
+        extra.should == "Sede:El tercer lugar\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', 'sabado', 'domingo']
+    end
+    
+    it "should event_parse a several dates" do |d, extra|
+      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
   end
   
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: maca-eventual
 version: !ruby/object:Gem::Version 
-  version: 0.4.3
+  version: 0.4.5
 platform: ruby
 authors: 
 - Macario Ortega
@@ -47,6 +47,7 @@ files:
 - eventual.gemspec
 has_rdoc: true
 homepage: http://github.com/maca/eventual
+licenses: 
 post_install_message: 
 rdoc_options: 
 - --main
@@ -68,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: eventual
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 2
 summary: ""