chrono 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6a6bc0e19633446a8b89579f6cbd93c75bfde77d
+  data.tar.gz: e4b5d84609564d00fc9f7a052a36a9911780c494
+SHA512:
+  metadata.gz: c942eeb72f2817153a52a33b25d4a4eee2e51bf6d94f937366bfa319f0075f23b9787c2a6a1f74a9e128a7f2b71b9fc22b2a4fe70a840e01234645cfe5634706
+  data.tar.gz: af90e4f872ad91502de4e0aea4c62702437d720b22afd4350e2088dd5da36923f543f028db948e636659c3fafd8da96e33c5f2f2adb80343338845cb257fd140

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in chrono.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ryo Nakamura
+
+MIT License
+
+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/README.md

@@ -0,0 +1,33 @@
+# Chrono
+Provides a chain of logics about chronology.
+
+## Chrono::Iterator
+Parse cron syntax and determine next scheduled run.
+
+```ruby
+require "chrono"
+
+iterator = Chrono::Iterator.new("30 * * * *")
+iterator.next #=> 2000-01-01 00:30:00
+iterator.next #=> 2000-01-02 00:30:00
+iterator.next #=> 2000-01-03 00:30:00
+```
+
+The following syntax is supported.
+See [examples](https://github.com/r7kamura/chrono/blob/master/spec/chrono/iterator_spec.rb)
+for more details.
+
+* (*) Asterisk
+* (,) Comma
+* (-) Hyphen
+* (/) Slash
+
+```
+* * * * *
+T T T T T
+| | | | `- wday --- 0 ..  6
+| | | `--- month -- 1 .. 12
+| | `----- day ---- 1 .. 31
+| `------- hour --- 0 .. 23
+`--------- minute - 0 .. 59
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/chrono.gemspec

@@ -0,0 +1,23 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "chrono/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "chrono"
+  spec.version       = Chrono::VERSION
+  spec.authors       = ["Ryo Nakamura"]
+  spec.email         = ["r7kamura@gmail.com"]
+  spec.summary       = "Provides a chain of logics about chronology."
+  spec.homepage      = "https://github.com/r7kamura/chrono"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport"
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", "2.14.1"
+end

data/lib/chrono.rb

@@ -0,0 +1,10 @@
+require "chrono/fields/base"
+require "chrono/fields/day"
+require "chrono/fields/hour"
+require "chrono/fields/minute"
+require "chrono/fields/month"
+require "chrono/fields/wday"
+require "chrono/iterator"
+require "chrono/next_time"
+require "chrono/schedule"
+require "chrono/version"

data/lib/chrono/fields/base.rb

@@ -0,0 +1,69 @@
+module Chrono
+  module Fields
+    class Base
+      attr_reader :source
+
+      def initialize(source)
+        @source = source
+      end
+
+      def to_a
+        if has_multiple_elements?
+          fields.map(&:to_a).flatten.uniq.sort
+        else
+          lower.step(upper, step).to_a.sort
+        end
+      end
+
+      private
+
+      def range
+        raise NotImplementedError
+      end
+
+      def interpolated
+        source.gsub("*", "#{range.first}-#{range.last}")
+      end
+
+      def lower
+        @lower ||= match_data[1].to_i
+      end
+
+      def upper
+        if match_data[2]
+          match_data[2].to_i
+        else
+          lower
+        end
+      end
+
+      def step
+        if match_data[3]
+          match_data[3].to_i
+        else
+          1
+        end
+      end
+
+      def pattern
+        %r<\A(\d+)(?:-(\d+))?(?:/(\d+))?\z>
+      end
+
+      def match_data
+        @match_data ||= interpolated.match(pattern)
+      end
+
+      def elements
+        @elements ||= source.split(",")
+      end
+
+      def has_multiple_elements?
+        elements.size >= 2
+      end
+
+      def fields
+        elements.map {|element| self.class.new(element) }
+      end
+    end
+  end
+end

data/lib/chrono/fields/day.rb

@@ -0,0 +1,11 @@
+module Chrono
+  module Fields
+    class Day < Base
+      private
+
+      def range
+        1..31
+      end
+    end
+  end
+end

data/lib/chrono/fields/hour.rb

@@ -0,0 +1,11 @@
+module Chrono
+  module Fields
+    class Hour < Base
+      private
+
+      def range
+        0..23
+      end
+    end
+  end
+end

data/lib/chrono/fields/minute.rb

@@ -0,0 +1,11 @@
+module Chrono
+  module Fields
+    class Minute < Base
+      private
+
+      def range
+        0..59
+      end
+    end
+  end
+end

data/lib/chrono/fields/month.rb

@@ -0,0 +1,11 @@
+module Chrono
+  module Fields
+    class Month < Base
+      private
+
+      def range
+        1..12
+      end
+    end
+  end
+end

data/lib/chrono/fields/wday.rb

@@ -0,0 +1,11 @@
+module Chrono
+  module Fields
+    class Wday < Base
+      private
+
+      def range
+        0..6
+      end
+    end
+  end
+end

data/lib/chrono/iterator.rb

@@ -0,0 +1,16 @@
+module Chrono
+  class Iterator
+    attr_accessor :now
+
+    attr_reader :source
+
+    def initialize(source, options = {})
+      @source = source
+      @now = options[:now] || Time.now
+    end
+
+    def next
+      self.now = NextTime.new(now: now, source: source).to_time
+    end
+  end
+end

data/lib/chrono/next_time.rb

@@ -0,0 +1,89 @@
+require "active_support/core_ext/date"
+require "active_support/core_ext/time"
+require "active_support/core_ext/numeric/time"
+
+module Chrono
+  class NextTime
+    attr_reader :now, :source
+
+    attr_writer :time
+
+    def initialize(options)
+      @now = options[:now]
+      @source = options[:source]
+    end
+
+    def to_time
+      loop do
+        case
+        when !scheduled_in_this_month?
+          carry_month
+        when !scheduled_in_this_day?
+          carry_day
+        when !scheduled_in_this_wday?
+          carry_day
+        when !scheduled_in_this_hour?
+          carry_hour
+        when !scheduled_in_this_minute?
+          carry_minute
+        else
+          break time
+        end
+      end
+    end
+
+    private
+
+    def time
+      @time ||= now + 1.minute
+    end
+
+    def fields
+      @fields ||= source.split(" ")
+    end
+
+    def schedule
+      @schedule ||= Schedule.new(source)
+    end
+
+    def scheduled_in_this_month?
+      schedule.months.include?(time.month)
+    end
+
+    def scheduled_in_this_day?
+      schedule.days.include?(time.day)
+    end
+
+    def scheduled_in_this_wday?
+      schedule.wdays.include?(time.wday)
+    end
+
+    def scheduled_in_this_hour?
+      schedule.hours.include?(time.hour)
+    end
+
+    def scheduled_in_this_minute?
+      schedule.minutes.include?(time.min)
+    end
+
+    def carry_month
+      self.time = time.next_month.at_beginning_of_month
+    end
+
+    def carry_day
+      self.time = time.tomorrow.at_beginning_of_day
+    end
+
+    def carry_wday
+      self.time = time.next_week.at_beginning_of_week
+    end
+
+    def carry_hour
+      self.time = (time + 1.hour).at_beginning_of_hour
+    end
+
+    def carry_minute
+      self.time = (time + 1.minute).at_beginning_of_minute
+    end
+  end
+end

data/lib/chrono/schedule.rb

@@ -0,0 +1,35 @@
+module Chrono
+  class Schedule
+    attr_reader :source
+
+    def initialize(source)
+      @source = source
+    end
+
+    def minutes
+      Fields::Minute.new(fields[0]).to_a
+    end
+
+    def hours
+      Fields::Hour.new(fields[1]).to_a
+    end
+
+    def days
+      Fields::Day.new(fields[2]).to_a
+    end
+
+    def months
+      Fields::Month.new(fields[3]).to_a
+    end
+
+    def wdays
+      Fields::Wday.new(fields[4]).to_a
+    end
+
+    private
+
+    def fields
+      @fields ||= source.split(" ")
+    end
+  end
+end

data/lib/chrono/version.rb

@@ -0,0 +1,3 @@
+module Chrono
+  VERSION = "0.0.1"
+end

data/spec/chrono/iterator_spec.rb

@@ -0,0 +1,29 @@
+require "spec_helper"
+
+describe Chrono::Iterator do
+  describe "#next" do
+    [
+      "2000-01-01 00:00:00", "2000-01-01 00:01:00", "* * * * *",
+      "2000-01-01 00:59:00", "2000-01-01 01:00:00", "* * * * *",
+      "2000-01-01 23:59:00", "2000-01-02 00:00:00", "* * * * *",
+      "2000-01-31 23:59:00", "2000-02-01 00:00:00", "* * * * *",
+      "2000-12-31 23:59:00", "2001-01-01 00:00:00", "* * * * *",
+      "2000-01-01 00:00:00", "2000-01-01 00:15:00", "*/15 * * * *",
+      "2000-01-01 00:01:00", "2000-01-01 00:15:00", "*/15 * * * *",
+      "2000-01-01 00:00:00", "2000-01-01 00:31:00", "*/31 * * * *",
+      "2000-01-01 00:31:00", "2000-01-01 01:00:00", "*/31 * * * *",
+      "2000-01-01 00:15:00", "2000-01-01 00:25:00", "*/15,25 * * * *",
+      "2000-01-01 00:15:00", "2000-01-01 00:25:00", "25,*/15 * * * *",
+      "2000-01-01 00:00:00", "2000-01-01 03:30:00", "30 3,6,9 * * *",
+      "2000-01-01 00:00:00", "2000-01-04 00:00:00", "* * * * 2,3",
+      "2000-01-04 00:00:00", "2000-01-04 00:01:00", "* * * * 2,3",
+      "2000-01-01 00:01:00", "2000-01-01 00:04:00", "1-20/3 * * * *",
+      "2000-01-01 00:20:00", "2000-01-01 01:01:00", "1-20/3 * * * *",
+    ].each_slice(3) do |from, to, source|
+      it "ticks #{from} to #{to} by #{source}" do
+        now = Time.parse(from)
+        described_class.new(source, now: now).next.should == Time.parse(to)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+require "chrono"
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: chrono
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Ryo Nakamura
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+description: 
+email:
+- r7kamura@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- chrono.gemspec
+- lib/chrono.rb
+- lib/chrono/fields/base.rb
+- lib/chrono/fields/day.rb
+- lib/chrono/fields/hour.rb
+- lib/chrono/fields/minute.rb
+- lib/chrono/fields/month.rb
+- lib/chrono/fields/wday.rb
+- lib/chrono/iterator.rb
+- lib/chrono/next_time.rb
+- lib/chrono/schedule.rb
+- lib/chrono/version.rb
+- spec/chrono/iterator_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/r7kamura/chrono
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Provides a chain of logics about chronology.
+test_files:
+- spec/chrono/iterator_spec.rb
+- spec/spec_helper.rb