rufus-scheduler 2.0.24 → 3.1.0

data/spec/error_spec.rb

@@ -0,0 +1,139 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Fri Aug  9 07:10:18 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler do
+
+  before :each do
+
+    @taoe = Thread.abort_on_exception
+    Thread.abort_on_exception = false
+
+    @ose = $stderr
+    $stderr = StringIO.new
+
+    @scheduler = Rufus::Scheduler.new
+  end
+
+  after :each do
+
+    @scheduler.shutdown
+
+    Thread.abort_on_exception = @taoe
+
+    $stderr = @ose
+  end
+
+  context 'error in block' do
+
+    it 'intercepts the error and describes it on $stderr' do
+
+      counter = 0
+
+      @scheduler.every('0.5s') do
+        counter += 1
+        fail 'argh'
+      end
+
+      sleep 2
+
+      expect(counter).to be > 2
+      expect($stderr.string).to match(/argh/)
+    end
+  end
+
+  context 'error in callable' do
+
+    class MyFailingHandler
+      attr_reader :counter
+      def initialize
+        @counter = 0
+      end
+      def call(job, time)
+        @counter = @counter + 1
+        fail 'ouch'
+      end
+    end
+
+    it 'intercepts the error and describes it on $stderr' do
+
+      mfh = MyFailingHandler.new
+
+      @scheduler.every('0.5s', mfh)
+
+      sleep 2
+
+      expect(mfh.counter).to be > 2
+      expect($stderr.string).to match(/ouch/)
+    end
+  end
+
+  context 'Rufus::Scheduler#stderr=' do
+
+    it 'lets divert error information to custom files' do
+
+      @scheduler.stderr = StringIO.new
+
+      @scheduler.in('0s') do
+        fail 'miserably'
+      end
+
+      sleep 0.5
+
+      expect(@scheduler.stderr.string).to match(/intercepted an error/)
+      expect(@scheduler.stderr.string).to match(/miserably/)
+    end
+  end
+
+  context 'error information' do
+
+    it 'contains information about the error, the job and the scheduler' do
+
+      @scheduler.stderr = StringIO.new
+
+      @scheduler.in('0s') do
+        fail 'miserably'
+      end
+
+      sleep 0.5
+
+      s = @scheduler.stderr.string
+      #puts s
+
+      expect(s).to match(/ENV\['TZ'\]:/)
+      expect(s).to match(/down\?: false/)
+      expect(s).to match(/work_threads: 1/)
+      expect(s).to match(/running_jobs: 1/)
+      expect(s).to match(/uptime: \d/)
+    end
+  end
+
+  context 'Rufus::Scheduler#on_error(&block)' do
+
+    it 'intercepts all StandardError instances' do
+
+      $message = nil
+
+      def @scheduler.on_error(job, err)
+        $message = "#{job.class} #{job.original} #{err.message}"
+      rescue
+        p $!
+      end
+
+      @scheduler.in('0s') do
+        fail 'miserably'
+      end
+
+      sleep 0.5
+
+      expect($message).to eq('Rufus::Scheduler::InJob 0s miserably')
+    end
+  end
+end
+

data/spec/job_array_spec.rb

@@ -0,0 +1,39 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::JobArray do
+
+  class DummyJob < Struct.new(:id, :next_time); end
+
+  before(:each) do
+    @array = Rufus::Scheduler::JobArray.new
+  end
+
+  describe '#push' do
+
+    it 'pushes jobs' do
+
+      @array.push(DummyJob.new('a', Time.local(0)))
+
+      expect(@array.to_a.collect(&:id)).to eq(%w[ a ])
+    end
+
+    it 'pushes and remove duplicates' do
+
+      j = DummyJob.new('a', Time.local(0))
+
+      @array.push(j)
+      @array.push(j)
+
+      expect(@array.to_a.collect(&:id)).to eq(%w[ a ])
+    end
+  end
+end
+

data/spec/job_at_spec.rb

@@ -0,0 +1,58 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::AtJob do
+
+  before :each do
+    @scheduler = Rufus::Scheduler.new
+  end
+  after :each do
+    @scheduler.shutdown
+  end
+
+  describe '#unschedule' do
+
+    it 'unschedules the job' do
+
+      job = @scheduler.at(Time.now + 3600, :job => true) do
+      end
+
+      job.unschedule
+
+      sleep 0.4
+
+      expect(@scheduler.jobs.size).to eq(0)
+    end
+  end
+
+  describe '#scheduled_at' do
+
+    it 'returns the Time at which the job got scheduled' do
+
+      job = @scheduler.schedule_at((t = Time.now) + 3600) {}
+
+      expect(job.scheduled_at.to_i).to be >= t.to_i - 1
+      expect(job.scheduled_at.to_i).to be <= t.to_i + 1
+    end
+  end
+
+  describe '#time' do
+
+    it 'returns the time at which the job will trigger' do
+
+      t = Time.now + 3600
+
+      job = @scheduler.schedule_at t do; end
+
+      expect(job.time).to eq(t)
+    end
+  end
+end
+

data/spec/job_cron_spec.rb

@@ -0,0 +1,128 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::CronJob do
+
+  before :each do
+    @scheduler = Rufus::Scheduler.new
+  end
+  after :each do
+    @scheduler.shutdown
+  end
+
+  context 'normal' do
+
+    it 'triggers near the zero second' do
+
+      job = @scheduler.schedule_cron '* * * * *' do; end
+
+      sleep_until_next_minute
+
+      expect(job.last_time.to_i % 10).to eq(0)
+    end
+  end
+
+  #context 'sub-minute' do
+  #
+  #  it 'triggers near the zero second' do
+  #
+  #    job = @scheduler.schedule_cron '* * * * * *' do; end
+  #
+  #    sleep 1.5
+  #
+  #    p job.last_time
+  #    p job.last_time.to_f
+  #  end
+  #end
+
+  context 'first_at/in' do
+
+    it 'does not trigger before first_at is reached' do
+
+      t = Time.now
+
+      job =
+        @scheduler.schedule_cron '* * * * * *', :first_in => '3s' do
+          triggered = Time.now
+        end
+
+      sleep 1
+
+      #p [ t, t.to_f ]
+      #p [ job.last_time, job.last_time.to_f ]
+      #p [ job.first_at, job.first_at.to_f ]
+
+      expect(job.first_at).to be_within_1s_of(t + 3)
+      expect(job.last_time).to eq(nil)
+    end
+
+    it 'triggers for the first time at first_at' do
+
+      first_time = nil
+      t = Time.now
+
+      job = @scheduler.schedule_cron '* * * * * *', :first_in => '3s' do
+        first_time ||= Time.now
+      end
+      sleep 4.5
+
+      expect(job.first_at).to be_within_1s_of(t + 3)
+      expect(first_time).to be_within_1s_of(job.first_at)
+    end
+  end
+
+  context 'scheduling the cron itself' do
+
+    # for https://github.com/jmettraux/rufus-scheduler/issues/95
+    #
+    # schedule_cron takes more than 30 seconds, blocking...
+    #
+    it 'does not sit scheduling and blocking...' do
+
+      n = Time.now
+      first = nil
+
+      job = @scheduler.schedule_cron '*/2 * * * * *' do
+        first ||= Time.now
+      end
+
+      expect(Time.now - n).to be < 1.0
+
+      loop do
+        next unless first
+        expect(first - n).to be < 4.0
+        break
+      end
+    end
+  end
+
+  describe '.next_time' do
+
+    it 'returns the next trigger time' do
+
+      n = Time.now
+      nt = Time.parse("#{n.year}-#{n.month + 1}-01")
+
+      expect(
+        @scheduler.schedule_cron('* * 1 * *', lambda {}).next_time
+      ).to eq(nt)
+    end
+
+    it 'returns the next trigger time (first_at => Time)' do
+
+      ft = Time.parse('2100-12-31')
+
+      job = @scheduler.schedule_cron('* * 1 * *', :first_at => ft) {}
+
+      expect(job.next_time).to eq(ft)
+    end
+  end
+end
+

data/spec/job_every_spec.rb

@@ -0,0 +1,104 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::EveryJob do
+
+  before :each do
+    @scheduler = Rufus::Scheduler.new
+  end
+  after :each do
+    @scheduler.shutdown
+  end
+
+  it 'triggers as expected' do
+
+    counter = 0
+
+    @scheduler.every '1s' do
+      counter = counter + 1
+    end
+
+    sleep 3.5
+
+    expect([ 2, 3 ]).to include(counter)
+  end
+
+  it 'lets its @next_time change in-flight' do
+
+    times = []
+
+    @scheduler.every '1s' do |job|
+      times << Time.now
+      job.next_time = Time.now + 3 if times.count == 2
+    end
+
+    sleep 0.3 while times.count < 3
+
+    #p [ times[1] - times[0], times[2] - times[1] ]
+
+    expect(times[1] - times[0]).to be > 1.0
+    expect(times[1] - times[0]).to be < 1.4
+    expect(times[2] - times[1]).to be > 3.0
+    expect(times[2] - times[1]).to be < 3.4
+  end
+
+  context 'summer time' do
+
+    it 'triggers correctly through a DST transition' do
+
+      job = Rufus::Scheduler::EveryJob.new(@scheduler, '1m', {}, lambda {})
+      t1 = ltz('America/Los_Angeles', 2015, 3, 8, 1, 55)
+      t2 = ltz('America/Los_Angeles', 2015, 3, 8, 3, 05)
+      job.next_time = t1
+      occurrences = job.occurrences(t1, t2)
+
+      expect(occurrences.length).to eq(11)
+    end
+  end
+
+  context 'first_at/in' do
+
+    it 'triggers for the first time at first_at' do
+
+      t = Time.now
+
+      job = @scheduler.schedule_every '3s', :first_in => '1s' do; end
+
+      sleep 2
+
+      #p [ t, t.to_f ]
+      #p [ job.last_time, job.last_time.to_f ]
+      #p [ job.first_at, job.first_at.to_f ]
+
+      expect(job.first_at).to be_within_1s_of(t + 2)
+      expect(job.last_time).to be_within_1s_of(job.first_at)
+    end
+
+    describe '#first_at=' do
+
+      it 'alters @next_time' do
+
+        job = @scheduler.schedule_every '3s', :first_in => '10s' do; end
+
+        fa0 = job.first_at
+        nt0 = job.next_time
+
+        job.first_at = Time.now + 3
+
+        fa1 = job.first_at
+        nt1 = job.next_time
+
+        expect(nt0).to eq(fa0)
+        expect(nt1).to eq(fa1)
+      end
+    end
+  end
+end
+

data/spec/job_in_spec.rb

@@ -0,0 +1,20 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::InJob do
+
+  before :each do
+    @scheduler = Rufus::Scheduler.new
+  end
+  after :each do
+    @scheduler.shutdown
+  end
+end
+

data/spec/job_interval_spec.rb

@@ -0,0 +1,68 @@
+
+#
+# Specifying rufus-scheduler
+#
+# Wed Apr 17 06:00:59 JST 2013
+#
+
+require 'spec_helper'
+
+
+describe Rufus::Scheduler::IntervalJob do
+
+  before :each do
+    @scheduler = Rufus::Scheduler.new
+  end
+  after :each do
+    @scheduler.shutdown
+  end
+
+  describe '#interval' do
+
+    it 'returns the scheduled interval' do
+
+      job = @scheduler.schedule_interval('1h') do; end
+
+      expect(job.interval).to eq(3600)
+    end
+  end
+
+  context 'first_at/in' do
+
+    it 'triggers for the first time at first_at' do
+
+      t = Time.now
+
+      job = @scheduler.schedule_interval '3s', :first_in => '1s' do; end
+
+      sleep 2
+
+      #p [ t, t.to_f ]
+      #p [ job.last_time, job.last_time.to_f ]
+      #p [ job.first_at, job.first_at.to_f ]
+
+      expect(job.first_at).to be_within_1s_of(t + 2)
+      expect(job.last_time).to be_within_1s_of(job.first_at)
+    end
+
+    describe '#first_at=' do
+
+      it 'alters @next_time' do
+
+        job = @scheduler.schedule_interval '3s', :first_in => '10s' do; end
+
+        fa0 = job.first_at
+        nt0 = job.next_time
+
+        job.first_at = Time.now + 3
+
+        fa1 = job.first_at
+        nt1 = job.next_time
+
+        expect(nt0).to eq(fa0)
+        expect(nt1).to eq(fa1)
+      end
+    end
+  end
+end
+