maca-eventual 0.4

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2009-06-03
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,12 @@
+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,91 @@
+= eventual
+
+* http://github.com/maca/eventual
+
+== DESCRIPCIÓN:
+
+Reconocimiento de fechas y periodos en lenguaje natural.
+
+== 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
+* martes y miércoles del 1 al 20 de junio del 2009 a las 16:00 y 18:00 horas
+  
+Se puede extender _Date_ y _DateTime_ con Eventual pero en principio no extienden Eventual.
+Para activar el parche:
+  
+  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>]
+
+
+== ETC:
+
+* No estoy seguro de que Iconv funcione en windows
+
+Formatos a reconocer
+
+* todos los lunes de junio
+* domingos de septiembre
+* martes y miércoles de agosto
+* todo el año
+* todo junio
+
+== 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,21 @@
+require 'rubygems' unless ENV['NO_RUBYGEMS']
+%w[rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/eventual'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$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]
+  # path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  # p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  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/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,92 @@
+require 'date'
+require 'iconv'
+
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+
+module Eventual
+  VERSION = '0.4'
+  extend self
+
+  WDAY_LIST       = ["domingo", "lunes", "martes", "miercoles", "jueves", "viernes", "sabado"]
+  MNAMES          = [nil, "enero", "febrero", "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"]
+  OPT_YEAR        = %r{(?:(?:(?:\s+(?:del|de)\s+)|\s+)(\d{4}))?}i
+  OPT_TIME24      = %r{(?:\s+a\s+las\s+(.*))?}i
+  LIST_SEPARATOR  = %r{(?:\s+|,\s+|\s+y\s+)}i
+  OPT_WDAYS       = %r{((?:(?:#{ WDAY_LIST.join('|') })#{ LIST_SEPARATOR })*)}i
+  DAY_LIST        = %r{((?:\d{1,2}#{ LIST_SEPARATOR })+)de (#{ MNAMES.compact.join('|') })#{ OPT_YEAR }#{ OPT_TIME24 }}i
+  DAY_PERIOD      = %r{#{ OPT_WDAYS }del\s+(\d{1,2})\s+(?:de\s+(#{ MNAMES.compact.join('|') })#{ OPT_YEAR }\s+)?al\s+(\d{1,2})\s+de\s+(#{ MNAMES.compact.join('|') })#{ OPT_YEAR }#{ OPT_TIME24 }}i
+
+  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
+    
+    while true
+      case string
+        
+      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
+        first_year  ||= last_year
+        first_month ||= last_month
+        last_month    = MNAMES.index last_month
+        first_month   = MNAMES.index first_month
+        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
+          if wdays.empty?
+            (first..last).map
+          else
+            (first..last).select{ |day| wdays.include? day.wday }
+          end
+        end
+      
+      when DAY_LIST
+        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
+        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, '' )
+      
+      results +=
+      if times
+        times.scan( /(\d{2}):(\d{2})/ ).map do |hour, minute| 
+          make_days.call hour, minute
+        end.flatten
+      else
+        make_days.call nil, nil 
+      end
+    end
+    
+    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
+  end
+  
+  
+
+  protected
+  def make_day *args 
+    args.shift.civil *args.compact.collect{ |a| a.to_i }
+  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' ).should map_times( '2009-1-1' )
+  end
+  
+  it 'should monkey patch Date' do
+    Date.event_parse( '1 de enero del 2009' ).should map_dates( '2009-1-1' )
+  end
+end
+

data/spec/es_eventual_spec.rb

@@ -0,0 +1,91 @@
+require File.expand_path( File.dirname(__FILE__) + '/spec_helper' )
+
+describe 'event parsing' 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 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 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 all tuesdays and thursdays of the year" do
+    e = Eventual.event_parse( 'martes y jueves del 1 de enero al 30 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 30 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 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) }
+    e.should map_times( *r )
+  end
+  
+  it "should parse a long period with multiple times" do
+    e = Eventual.event_parse( 'martes y jueves del 1 de enero del 2000 al 31 de diciembre del 2010 a las 16:00 y 18:00 horas' )
+    r = (DateTime.parse('2000-1-1T16:00')...DateTime.parse('2010-12-31T16:00') ).reject{ |day| not [2,4].include?(day.wday) } +
+        (DateTime.parse('2000-1-1T18:00')...DateTime.parse('2010-12-31T18:00') ).reject{ |day| not [2,4].include?(day.wday) }
+    e.should map_times( *r.sort )
+  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', 'sabado', '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
+  
+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,75 @@
+--- !ruby/object:Gem::Specification 
+name: maca-eventual
+version: !ruby/object:Gem::Version 
+  version: "0.4"
+platform: ruby
+authors: 
+- Macario Ortega
+autorequire: 
+bindir: bin
+cert_chain: 
+- /Users/sistemasinteractivos/.gem/gem-public_cert.pem
+date: 2009-06-05 00:00:00 -07: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
+has_rdoc: true
+homepage: http://github.com/maca/eventual
+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.2.0
+signing_key: 
+specification_version: 2
+summary: ""
+test_files: []
+