tickle 1.0.2 → 2.0.0rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2e7c98a6545c1b7e583d69309c0d76be4f91266c
-  data.tar.gz: 0039b3ba223bf9082d7a290dd71b16395c5fe023
+SHA256:
+  metadata.gz: 1f47be53e642fa9fd7cd412b7d76768807ed9398de11df69a77855f6d2b26b44
+  data.tar.gz: bc3a4d7d5c9048444ef7dfa47e6e55318c3e3577f7ec70145d4500bf441b5c4e
 SHA512:
-  metadata.gz: a9dc27b51edc3cc4d3cd5d9df5dfbcbdbd6f249317a0bc3771238caa852fa079ed0f4873fd9bb1820f5bf0baabb535c0463b71c6b2cf52788d956661b46938ed
-  data.tar.gz: 11697818c4cfa90fd2ee9fd539c34e3d8e813129e277effd4376a6c3179a9ead45a939eedb73fd6d44068ba05c724be333221d1ac073e53c16642f4b53fea238
+  metadata.gz: 6852b109c5091c3abee0bef6c8bf8ea804e9b2a7ff7b7ffd0d995b237f2dc799e3504ef10740a44e320dcd55544e1895e48235bbc745fde25394fc3b315f0121
+  data.tar.gz: 790b5b8790873c0e9a99c882cfe57628fd52ea756738e9c503ff76b38bd664b8ec469a6cc2fe313e823b26a498d6416f39d1986dda1236a3fa62c41c3dc057a3

data/.gitignore

@@ -14,8 +14,10 @@ rdoc
 pkg
 bin/
 vendor/
+vendor.noindex/
 Gemfile.lock
-spec/
 .yardoc/
 .bundle/
 .rspec
+*.gem
+.ruby-version

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+  - 2.7
+  - jruby
+  - truffleruby
+
+# whitelist
+branches:
+  only:
+    - master
+    - develop
+    - v1-branch

data/CHANGES.md

@@ -1,14 +1,36 @@
 # CH CH CH CH CHANGES! #
 
+## Friday the 18th of September 2002, v2.0.0rc3
 
-## Monday the 11th of November, v1.0.2 ##
+* Changed the dependency from chronic to gitlab-chronic, thanks to @bjonord
+
+----
+
+## v2.0.0.rc2, Friday the 8th of December 2017 ##
+
+* Fixed issue #20 https://github.com/yb66/tickle/pull/20, thanks to [@antogon](https://github.com/antogon)
+
+----
+
+
+## Saturday the 7th of November 2015, 2.0.0.rc1 ##
+
+* Rewrite of the internals.
+* API should be pretty much the same from the outside, but enough things on the inside change to warrant the major version bump.
+* Chronic updated to 0.10.2.
+
+----
+
+
+## Monday the 11th of November 2013, v1.0.2 ##
 
 * Shoulda and simplecov aren't runtime dependencies, fixed that in the gemfile.
 * Got the version number right this time ;-)
 
 ----
 
-## Monday the 11th of November, v1.0.1 ##
+
+## Monday the 11th of November 2013, v1.0.1 ##
 
 * Moved library to new maintainer [https://github.com/yb66/tickle](@yb66)
 * Moved library to [http://semver.org/](semver).
@@ -19,4 +41,4 @@
 * Moved library to Bundler to make it easier to set up and develop against.
 * Started using Yardoc for more niceness with documentation.
 
-----
+----

data/Gemfile

@@ -2,7 +2,20 @@ source "https://rubygems.org"
 
 gemspec
 
-gem "wirble"
+group :development do
+  gem "maruku"
+  gem "yard"
+  unless RUBY_ENGINE == 'jruby'
+    gem "pry-byebug"
+    gem "pry-state"
+    gem "rb-readline"
+  end
+end
+
 group :test do
   gem "rspec"
+  gem "rspec-its"
+  gem "timecop"
+  gem "simplecov"
+  gem "rake"
 end

data/LICENCE

@@ -1,5 +1,5 @@
 Copyright (c) 2010 Joshua Lippiner
-Copyright (c) 2013 Iain Barnett
+Copyright (c) 2015 Iain Barnett
 
 
 Permission is hereby granted, free of charge, to any person obtaining

data/README.md

@@ -11,7 +11,7 @@ Take a look at the `develop` branch where all this stuff will be happening.
 
 Tickle is a natural language parser for recurring events.
  
-Tickle is designed to be a complement to [Chronic](https://rubygems.org/gems/chronic) and can interpret things such as "every 2 days, every Sunday, Sundays, Weekly, etc."
+Tickle is designed to be a complement to [Chronic](https://rubygems.org/gems/chronic) and can interpret things such as "every 2 days", "every Sunday", “Sundays", “Weekly", etc.
 
 Tickle has one main method, `Tickle.parse`, which returns the next time the event should occur, at which point you simply call `Tickle.parse` again.   
 

data/Rakefile

@@ -1,13 +1,8 @@
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-end
+require 'rspec/core/rake_task'
 
-task :test => :check_dependencies
+RSpec::Core::RakeTask.new(:spec)
 
-task :default => :test
+task :default => :spec
 
 
 desc "(Re-) generate documentation and place it in the docs/ dir. Open the index.html file in there to read it."

data/benchmarks/main.rb

@@ -0,0 +1,71 @@
+require 'benchmark'
+require_relative "../lib/tickle.rb"
+warn Benchmark.measure {
+  Tickle.parse('day')
+#   Tickle.parse('week')
+  Tickle.parse('month')
+  Tickle.parse('year')
+  Tickle.parse('daily')
+#   Tickle.parse('weekly')
+  Tickle.parse('monthly')
+  Tickle.parse('yearly')
+  Tickle.parse('3 days')
+#   Tickle.parse('3 weeks')
+  Tickle.parse('3 months')
+  Tickle.parse('3 years')
+  Tickle.parse('other day')
+#   Tickle.parse('other week')
+  Tickle.parse('other month')
+  Tickle.parse('other year')
+  Tickle.parse('Monday')
+  Tickle.parse('Wednesday')
+  Tickle.parse('Friday')
+  Tickle.parse('February', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('May', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('june', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('beginning of the week')
+  Tickle.parse('middle of the week')
+  Tickle.parse('end of the week')
+  Tickle.parse('beginning of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('middle of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('end of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('beginning of the year', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('middle of the year', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('end of the year', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd of May', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd of February', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd of February 2022', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd of Feb 2022', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 4th of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 10th of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the tenth of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('first', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the first of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the thirtieth', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the fifth', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 1st Wednesday of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd Sunday of May', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 3rd Sunday of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the 23rd of June', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the twenty third of June', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the thirty first of July', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the twenty first', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('the twenty first of the month', {:start=>Time.parse("2020-04-01 00:00:00 +0000"), :now=>Time.parse("2020-04-01 00:00:00 +0000")})
+  Tickle.parse('starting today and ending one week from now')
+  Tickle.parse('starting tomorrow and ending one week from now')
+  Tickle.parse('starting Monday repeat every month')
+  Tickle.parse('starting May 13th repeat every week')
+  Tickle.parse('starting May 13th repeat every other day')
+  Tickle.parse('every other day starts May 13th')
+  Tickle.parse('every other day starts May 13')
+  Tickle.parse('every other day starting May 13th')
+  Tickle.parse('every other day starting May 13')
+  Tickle.parse('every week starts this wednesday')
+  Tickle.parse('every week starting this wednesday')
+  Tickle.parse('every other day starting May 1st 2021')
+  Tickle.parse('every other day starting May 1 2021')
+  Tickle.parse('every other week starting this Sunday')
+  Tickle.parse('every week starting this wednesday until May 13th')
+  Tickle.parse('every week starting this wednesday ends May 13th')
+  Tickle.parse('every week starting this wednesday ending May 13th')
+}

data/lib/ext/array.rb

@@ -0,0 +1,6 @@
+class Array
+  # compares two arrays to determine if they both contain the same elements
+  def same?(y)
+    self.sort == y.sort
+  end
+end

data/lib/ext/date_and_time.rb

@@ -0,0 +1,64 @@
+class Date
+  # returns the days in the sending month
+  def days_in_month
+    d,m,y = mday,month,year
+    d += 1 while Date.valid_civil?(y,m,d)
+    d - 1
+  end
+
+
+  # no idea what this is for
+  def bump(attr, amount=nil)
+    amount ||= 1
+    case attr
+    when :day then
+      Date.civil(self.year, self.month, self.day + amount)
+    when :wday then
+      amount = Date::ABBR_DAYNAMES.index(amount) if amount.is_a?(String)
+      raise Exception, "specified day of week invalid.  Use #{Date::ABBR_DAYNAMES}" unless amount
+      diff = (amount > self.wday) ? (amount - self.wday) : (7 - (self.wday - amount))
+      Date.civil(self.year, self.month, self.day + diff)
+    when :week then
+      Date.civil(self.year, self.month, self.day + (7*amount))
+    when :month then
+      Date.civil(self.year, self.month+amount, self.day)
+    when :year then
+      Date.civil(self.year + amount, self.month, self.day)
+    when :sec then
+      Date.civil(self.year, self.month, self.day, self.hour, self.minute, self.sec + amount)
+    else
+      raise Exception, "type \"#{attr}\" not supported."
+    end
+  end
+end
+
+class Time
+
+  # same again, no idea what this is for
+  def bump(attr, amount=nil)
+    amount ||= 1
+    case attr
+    when :sec then
+      Time.local(self.year, self.month, self.day, self.hour, self.min, self.sec + amount)
+    when :min then
+      Time.local(self.year, self.month, self.day, self.hour, self.min + amount, self.sec)
+    when :hour then
+      Time.local(self.year, self.month, self.day, self.hour + amount, self.min, self.sec)
+    when :day then
+      Time.local(self.year, self.month, self.day + amount, self.hour, self.min, self.sec)
+    when :wday then
+      amount = Time::RFC2822_DAY_NAME.index(amount) if amount.is_a?(String)
+      raise Exception, "specified day of week invalid.  Use #{Time::RFC2822_DAY_NAME}" unless amount
+      diff = (amount > self.wday) ? (amount - self.wday) : (7 - (self.wday - amount))
+      Time.local(self.year, self.month, self.day + diff, self.hour, self.min, self.sec)
+    when :week then
+      Time.local(self.year, self.month, self.day + (amount * 7), self.hour, self.min, self.sec)
+    when :month then
+      Time.local(self.year, self.month + amount, self.day, self.hour, self.min, self.sec)
+    when :year then
+      Time.local(self.year + amount, self.month, self.day, self.hour, self.min, self.sec)
+    else
+      raise Exception, "type \"#{attr}\" not supported."
+    end
+  end
+end

data/lib/ext/string.rb

@@ -0,0 +1,39 @@
+module Tickle
+  class Ordinal < ::String
+    # returns true if the sending string is a text or numeric ordinal (e.g. first or 1st)
+    def is_ordinal?
+      scanner = %w{first second third fourth fifth sixth seventh eighth ninth tenth eleventh twelfth thirteenth fourteenth fifteenth sixteenth seventeenth eighteenth nineteenth twenty thirty thirtieth}
+      regex = /\b(\d*)(st|nd|rd|th)\b/
+      !(self =~ regex).nil? || scanner.include?(self.downcase)
+    end
+
+    def ordinal_as_number
+      return self unless self.is_ordinal?
+      scanner = {/first/ => '1st',
+        /second/ => '2nd',
+        /third/ => '3rd',
+        /fourth/ => '4th',
+        /fifth/ => '5th',
+        /sixth/ => '6th',
+        /seventh/ => '7th',
+        /eighth/ => '8th',
+        /ninth/ => '9th',
+        /tenth/ => '10th',
+        /eleventh/ => '11th',
+        /twelfth/ => '12th',
+        /thirteenth/ => '13th',
+        /fourteenth/ => '14th',
+        /fifteenth/ => '15th',
+        /sixteenth/ => '16th',
+        /seventeenth/ => '17th',
+        /eighteenth/ => '18th',
+        /nineteenth/ => '19th',
+        /twentieth/ => '20th',
+        /thirtieth/ => '30th',
+      }
+      result = self
+      scanner.keys.each {|scanner_item| result = scanner[scanner_item] if scanner_item =~ self}
+      return result.gsub(/\b(\d*)(st|nd|rd|th)\b/, '\1')
+    end
+  end
+end

data/lib/tickle.rb

@@ -7,26 +7,40 @@
 #=============================================================================
 
 
-$LOAD_PATH.unshift(File.dirname(__FILE__))     # For use/testing when no gem is installed
+if ENV["DEBUG"]
+  warn "DEBUG MODE ON"
+  require 'pry-byebug'
+  require 'pry-state'
+  binding.pry
+end
 
 require 'date'
 require 'time'
-require 'chronic'
+require 'gitlab-chronic'
 
 require 'tickle/tickle'
 require 'tickle/handler'
 require 'tickle/repeater'
-require 'numerizer/numerizer'
+require_relative "tickle/tickled.rb"
+require_relative "ext/array.rb"
+require_relative "ext/date_and_time.rb"
+require_relative "ext/string.rb"
+
 
-module Tickle #:nodoc:
-  VERSION = "0.1.7"
+# Tickle is a natural language parser for recurring events.
+module Tickle
 
-  def self.debug=(val); @debug = val; end
+  def self.parse(asked, options = {})
+    # check to see if a datetime was passed
+    # if so, give it back
+    # TODO Consider converting to a Tickled
+    return asked if asked.respond_to? :day
 
-  def self.dwrite(msg, line_feed=nil)
-    (line_feed ? p(">> #{msg}") : puts(">> #{msg}")) if @debug
+    tickled = Tickled.new asked.dup, options
+    _parse tickled
   end
 
+
   def self.is_date(str)
     begin
       Date.parse(str.to_s)
@@ -35,108 +49,4 @@ module Tickle #:nodoc:
       return false
     end
   end
-end
-
-class Date #:nodoc:
-  # returns the days in the sending month
-  def days_in_month
-    d,m,y = mday,month,year
-    d += 1 while Date.valid_civil?(y,m,d)
-    d - 1
-  end
-
-  def bump(attr, amount=nil)
-    amount ||= 1
-    case attr
-    when :day then
-      Date.civil(self.year, self.month, self.day + amount)
-    when :wday then
-      amount = Date::ABBR_DAYNAMES.index(amount) if amount.is_a?(String)
-      raise Exception, "specified day of week invalid.  Use #{Date::ABBR_DAYNAMES}" unless amount
-      diff = (amount > self.wday) ? (amount - self.wday) : (7 - (self.wday - amount))
-      Date.civil(self.year, self.month, self.day + diff)
-    when :week then
-      Date.civil(self.year, self.month, self.day + (7*amount))
-    when :month then
-      Date.civil(self.year, self.month+amount, self.day)
-    when :year then
-      Date.civil(self.year + amount, self.month, self.day)
-    else
-            raise Exception, "type \"#{attr}\" not supported."
-    end
-  end
-end
-
-class Time #:nodoc:
-  def bump(attr, amount=nil)
-    amount ||= 1
-    case attr
-    when :sec then
-      Time.local(self.year, self.month, self.day, self.hour, self.min, self.sec + amount)
-    when :min then
-      Time.local(self.year, self.month, self.day, self.hour, self.min + amount, self.sec)
-    when :hour then
-      Time.local(self.year, self.month, self.day, self.hour + amount, self.min, self.sec)
-    when :day then
-      Time.local(self.year, self.month, self.day + amount, self.hour, self.min, self.sec)
-    when :wday then
-      amount = Time::RFC2822_DAY_NAME.index(amount) if amount.is_a?(String)
-      raise Exception, "specified day of week invalid.  Use #{Time::RFC2822_DAY_NAME}" unless amount
-      diff = (amount > self.wday) ? (amount - self.wday) : (7 - (self.wday - amount))
-      Time.local(self.year, self.month, self.day + diff, self.hour, self.min, self.sec)
-    when :week then
-      Time.local(self.year, self.month, self.day + (amount * 7), self.hour, self.min, self.sec)
-    when :month then
-      Time.local(self.year, self.month + amount, self.day, self.hour, self.min, self.sec)
-    when :year then
-      Time.local(self.year + amount, self.month, self.day, self.hour, self.min, self.sec)
-    else
-      raise Exception, "type \"#{attr}\" not supported."
-    end
-  end
-end
-
-class String #:nodoc:
-  # returns true if the sending string is a text or numeric ordinal (e.g. first or 1st)
-  def is_ordinal?
-    scanner = %w{first second third fourth fifth sixth seventh eighth ninth tenth eleventh twelfth thirteenth fourteenth fifteenth sixteenth seventeenth eighteenth nineteenth twenty thirty thirtieth}
-    regex = /\b(\d*)(st|nd|rd|th)\b/
-    !(self =~ regex).nil? || scanner.include?(self.downcase)
-  end
-
-  def ordinal_as_number
-    return self unless self.is_ordinal?
-    scanner = {/first/ => '1st',
-      /second/ => '2nd',
-      /third/ => '3rd',
-      /fourth/ => '4th',
-      /fifth/ => '5th',
-      /sixth/ => '6th',
-      /seventh/ => '7th',
-      /eighth/ => '8th',
-      /ninth/ => '9th',
-      /tenth/ => '10th',
-      /eleventh/ => '11th',
-      /twelfth/ => '12th',
-      /thirteenth/ => '13th',
-      /fourteenth/ => '14th',
-      /fifteenth/ => '15th',
-      /sixteenth/ => '16th',
-      /seventeenth/ => '17th',
-      /eighteenth/ => '18th',
-      /nineteenth/ => '19th',
-      /twentieth/ => '20th',
-      /thirtieth/ => '30th',
-    }
-    result = self
-    scanner.keys.each {|scanner_item| result = scanner[scanner_item] if scanner_item =~ self}
-    return result.gsub(/\b(\d*)(st|nd|rd|th)\b/, '\1')
-  end
-end
-
-class Array #:nodoc:
-  # compares two arrays to determine if they both contain the same elements
-  def same?(y)
-    self.sort == y.sort
-  end
-end
+end