rufus-scheduler 3.1.9 → 3.2.0

data/spec/job_spec.rb

@@ -1,671 +0,0 @@
-
-#
-# Specifying rufus-scheduler
-#
-# Wed Apr 17 06:00:59 JST 2013
-#
-
-require 'spec_helper'
-
-
-describe Rufus::Scheduler::Job do
-
-  # specify behaviours common to all job classes
-
-  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
-
-  describe '#last_time' do
-
-    it 'returns nil if the job never fired' do
-
-      job = @scheduler.schedule_in '10d' do; end
-
-      expect(job.last_time).to eq(nil)
-    end
-
-    it 'returns the last time the job fired' do
-
-      job = @scheduler.schedule_in '0s' do; end
-
-      sleep 0.4
-
-      expect(job.last_time).not_to eq(nil)
-    end
-  end
-
-  describe '#threads' do
-
-    it 'returns an empty list when the job is not running' do
-
-      job = @scheduler.in('1d', :job => true) {}
-
-      expect(job.threads.size).to eq(0)
-    end
-
-    it 'returns an empty list after the job terminated' do
-
-      job = @scheduler.in('0s', :job => true) {}
-
-      sleep 0.8
-
-      expect(job.threads.size).to eq(0)
-    end
-
-    it 'lists the threads the job currently runs in' do
-
-      job =
-        @scheduler.schedule_in('0s') do
-          sleep(1)
-        end
-
-      sleep 0.4
-
-      expect(job.threads.size).to eq(1)
-
-      t = job.threads.first
-      expect(t[:rufus_scheduler_job]).to eq(job)
-    end
-  end
-
-  describe '#kill' do
-
-    it 'has no effect if the job is not running' do
-
-      job = @scheduler.schedule_in '10d' do; end
-
-      tls = Thread.list.size
-
-      job.kill
-
-      expect(Thread.list.size).to eq(tls)
-    end
-
-    it 'makes the threads vacant' do
-
-      counter = 0
-
-      job =
-        @scheduler.schedule_in '0s' do
-          sleep 2
-          counter = counter + 1
-        end
-
-      sleep 1
-
-      v0 = @scheduler.work_threads(:vacant).size
-      a0 = @scheduler.work_threads(:active).size
-
-      job.kill
-
-      sleep 2
-
-      v1 = @scheduler.work_threads(:vacant).size
-      a1 = @scheduler.work_threads(:active).size
-
-      expect(counter).to eq(0)
-
-      expect(v0).to eq(0)
-      expect(a0).to eq(1)
-
-      expect(v1).to eq(1)
-      expect(a1).to eq(0)
-    end
-  end
-
-  describe '#running?' do
-
-    it 'returns false when the job is not running in any thread' do
-
-      job = @scheduler.in('1d', :job => true) {}
-
-      expect(job.running?).to eq(false)
-    end
-
-    it 'returns true when the job is running in at least one thread' do
-
-      job = @scheduler.in('0s', :job => true) { sleep(1) }
-
-      sleep 0.4
-
-      expect(job.running?).to eq(true)
-    end
-  end
-
-  describe '#scheduled?' do
-
-    it 'returns true when the job is scheduled' do
-
-      job = @scheduler.schedule_in('1d') {}
-
-      expect(job.scheduled?).to eq(true)
-    end
-
-    it 'returns false when the job is not scheduled' do
-
-      job = @scheduler.schedule_in('0.1s') {}
-
-      sleep 0.4
-
-      expect(job.scheduled?).to eq(false)
-    end
-
-    it 'returns true for repeat jobs that are running' do
-
-      job = @scheduler.schedule_interval('0.4s') { sleep(10) }
-
-      sleep 1
-
-      expect(job.running?).to eq(true)
-      expect(job.scheduled?).to eq(true)
-    end
-
-    it 'returns false if job is unscheduled' do
-      job = @scheduler.schedule_interval('0.1s') { sleep 0.1 }
-      job.unschedule
-
-      sleep 0.3
-
-      expect(job.running?).to eq(false)
-      expect(job.scheduled?).to eq(false)
-    end
-  end
-
-  describe '#call' do
-
-    it 'calls the job (like it were a proc)' do
-
-      counter = 0
-
-      job =
-        @scheduler.schedule_in('0.5s') do
-          counter = counter + 1
-        end
-      job.call
-
-      sleep 0.8
-
-      expect(counter).to eq(2)
-    end
-  end
-
-  describe '#call(true)' do
-
-    it 'calls the job and let the scheduler handle errors' do
-
-      $err = nil
-
-      def @scheduler.on_error(job, err)
-        $err = "#{job.class} #{job.original} #{err.message}"
-      rescue
-        p $!
-      end
-
-      job =
-        @scheduler.schedule_in('1d') do
-          fail 'again'
-        end
-
-      job.call(true)
-
-      expect($err).to eq('Rufus::Scheduler::InJob 1d again')
-    end
-  end
-
-  describe '#call(false)' do
-
-    it 'calls the job and let errors slip through' do
-
-      job =
-        @scheduler.schedule_in('1d') do
-          fail 'fast'
-        end
-
-      begin
-
-        #job.call(false)
-        job.call # false is the default
-
-        expect(false).to eq(true)
-
-      rescue => ex
-
-        expect(ex.message).to eq('fast')
-      end
-    end
-  end
-
-  context 'job-local variables' do
-
-    describe '#[]=' do
-
-      it 'sets a job-local variable' do
-
-        job =
-          @scheduler.schedule_every '1s' do |job|
-            job[:counter] ||= 0
-            job[:counter] += 1
-          end
-
-        sleep 3
-
-        expect(job[:counter]).to be > 1
-      end
-    end
-
-    describe '#[]' do
-
-      it 'returns nil if there is no such entry' do
-
-        job = @scheduler.schedule_in '1s' do; end
-
-        expect(job[:nada]).to eq(nil)
-      end
-
-      it 'returns the value of a job-local variable' do
-
-        job = @scheduler.schedule_in '1s' do; end
-        job[:x] = :y
-
-        expect(job[:x]).to eq(:y)
-      end
-    end
-
-    describe '#key?' do
-
-      it 'returns true if there is an entry with the given key' do
-
-        job = @scheduler.schedule_in '1s' do; end
-        job[:x] = :y
-
-        expect(job.key?(:x)).to eq(true)
-      end
-    end
-
-    describe '#keys' do
-
-      it 'returns the array of keys of the job-local variables' do
-
-        job = @scheduler.schedule_in '1s' do; end
-        job[:x] = :y
-        job['hello'] = :z
-        job[123] = {}
-
-        expect(job.keys.sort_by { |k| k.to_s }).to eq([ 123, 'hello', :x ])
-      end
-    end
-  end
-
-  context ':tag / :tags => [ t0, t1 ]' do
-
-    it 'accepts one tag' do
-
-      job = @scheduler.in '10d', :job => true, :tag => 't0' do; end
-
-      expect(job.tags).to eq(%w[ t0 ])
-    end
-
-    it 'accepts an array of tags' do
-
-      job = @scheduler.in '10d', :job => true, :tag => %w[ t0 t1 ] do; end
-
-      expect(job.tags).to eq(%w[ t0 t1 ])
-    end
-
-    it 'turns tags into strings' do
-
-      job = @scheduler.in '10d', :job => true, :tags => [ 1, 2 ] do; end
-
-      expect(job.tags).to eq(%w[ 1 2 ])
-    end
-  end
-
-  context ':blocking => true' do
-
-    it 'runs the job in the same thread as the scheduler thread' do
-
-      job =
-        @scheduler.in('0s', :job => true, :blocking => true) do
-          sleep(1)
-        end
-
-      sleep 0.4
-
-      expect(job.threads.first).to eq(@scheduler.thread)
-
-      sleep 1.4
-
-      expect(job.threads.size).to eq(0)
-    end
-  end
-
-  context 'default one thread per job behaviour' do
-
-    it 'runs the job in a dedicated thread' do
-
-      job =
-        @scheduler.in('0s', :job => true) do
-          sleep(1)
-        end
-
-      sleep 0.4
-
-      expect(job.threads.first).not_to eq(@scheduler.thread)
-
-      sleep 1.4
-
-      expect(job.threads.size).to eq(0)
-    end
-  end
-
-  context ':allow_overlapping / :allow_overlap / :overlap' do
-
-    context 'default (:overlap => true)' do
-
-      it 'lets a job overlap itself' do
-
-        job =
-          @scheduler.every('0.3', :job => true) do
-            sleep(5)
-          end
-
-        sleep 3
-
-        expect(job.threads.size).to be > 1
-      end
-    end
-
-    context 'when :overlap => false' do
-
-      it 'prevents a job from overlapping itself' do
-
-        job =
-          @scheduler.every('0.3', :job => true, :overlap => false) do
-            sleep(5)
-          end
-
-        sleep 3
-
-        expect(job.threads.size).to eq(1)
-      end
-    end
-  end
-
-  context ':mutex' do
-
-    context ':mutex => "mutex_name"' do
-
-      it 'prevents concurrent executions' do
-
-        j0 =
-          @scheduler.in('0s', :job => true, :mutex => 'vladivostok') do
-            sleep(3)
-          end
-        j1 =
-          @scheduler.in('0s', :job => true, :mutex => 'vladivostok') do
-            sleep(3)
-          end
-
-        sleep 0.7
-
-        if j0.threads.any?
-          expect(j0.threads.size).to eq(1)
-          expect(j1.threads.size).to eq(0)
-        else
-          expect(j0.threads.size).to eq(0)
-          expect(j1.threads.size).to eq(1)
-        end
-
-        expect(@scheduler.mutexes.keys).to eq(%w[ vladivostok ])
-      end
-    end
-
-    context ':mutex => mutex_instance' do
-
-      it 'prevents concurrent executions' do
-
-        m = Mutex.new
-
-        j0 = @scheduler.in('0s', :job => true, :mutex => m) { sleep(3) }
-        j1 = @scheduler.in('0s', :job => true, :mutex => m) { sleep(3) }
-
-        sleep 0.7
-
-        if j0.threads.any?
-          expect(j0.threads.size).to eq(1)
-          expect(j1.threads.size).to eq(0)
-        else
-          expect(j0.threads.size).to eq(0)
-          expect(j1.threads.size).to eq(1)
-        end
-
-        expect(@scheduler.mutexes.keys).to eq([])
-      end
-    end
-
-    context ':mutex => [ array_of_mutex_names_or_instances ]' do
-
-      it 'prevents concurrent executions' do
-
-        j0 =
-          @scheduler.in('0s', :job => true, :mutex => %w[ a b ]) do
-            sleep(3)
-          end
-        j1 =
-          @scheduler.in('0s', :job => true, :mutex => %w[ a b ]) do
-            sleep(3)
-          end
-
-        sleep 0.7
-
-        if j0.threads.any?
-          expect(j0.threads.size).to eq(1)
-          expect(j1.threads.size).to eq(0)
-        else
-          expect(j0.threads.size).to eq(0)
-          expect(j1.threads.size).to eq(1)
-        end
-
-        expect(@scheduler.mutexes.keys.sort).to eq(%w[ a b ])
-      end
-    end
-  end
-
-  context ':timeout => duration_or_point_in_time' do
-
-    it 'interrupts the job it is stashed to (duration)' do
-
-      counter = 0
-      toe = nil
-
-      job =
-        @scheduler.schedule_in '0s', :timeout => '1s' do
-          begin
-            counter = counter + 1
-            sleep 1.5
-            counter = counter + 1
-          rescue Rufus::Scheduler::TimeoutError => e
-            toe = e
-          end
-        end
-
-      sleep(3)
-
-      expect(counter).to eq(1)
-      expect(toe.class).to eq(Rufus::Scheduler::TimeoutError)
-    end
-
-    it 'interrupts the job it is stashed to (point in time)' do
-
-      counter = 0
-
-      job =
-        @scheduler.schedule_in '0s', :timeout => Time.now + 1 do
-          begin
-            counter = counter + 1
-            sleep 1.5
-            counter = counter + 1
-          rescue Rufus::Scheduler::TimeoutError => e
-          end
-        end
-
-      sleep(3)
-
-      expect(counter).to eq(1)
-    end
-
-    it 'starts timing when the job enters successfully all its mutexes' do
-
-      t0, t1, t2 = nil
-
-      @scheduler.schedule_in '0s', :mutex => 'a' do
-        sleep 1
-        t0 = Time.now
-      end
-
-      job =
-        @scheduler.schedule_in '0.5s', :mutex => 'a', :timeout => '1s' do
-          begin
-            t1 = Time.now
-            sleep 2
-          rescue Rufus::Scheduler::TimeoutError => e
-            t2 = Time.now
-          end
-        end
-
-      sleep 3
-
-      expect(t0).to be <= t1
-
-      d = t2 - t1
-      expect(d).to be >= 1.0
-      expect(d).to be < 1.5
-    end
-
-    it 'emits the timeout information to $stderr (default #on_error)' do
-
-      @scheduler.every('1s', :timeout => '0.5s') do
-        sleep 0.9
-      end
-
-      sleep 2
-
-      expect($stderr.string).to match(/Rufus::Scheduler::TimeoutError/)
-    end
-
-    it 'does not prevent a repeat job from recurring' do
-
-      counter = 0
-
-      @scheduler.every('1s', :timeout => '0.5s') do
-        counter = counter + 1
-        sleep 0.9
-      end
-
-      sleep 3
-
-      expect(counter).to be > 1
-    end
-  end
-
-  context 'work time' do
-
-    describe '#last_work_time' do
-
-      it 'starts at 0' do
-
-        job = @scheduler.schedule_every '5m' do; end
-
-        expect(job.last_work_time).to eq(0.0)
-      end
-
-      it 'keeps track of how long the work was upon last trigger' do
-
-        job =
-          @scheduler.schedule_in '0.5s'  do
-            sleep 0.7
-          end
-
-        sleep 2
-
-        expect(job.last_work_time).to be >= 0.7
-        expect(job.last_work_time).to be < 0.8
-      end
-    end
-
-    describe '#mean_work_time' do
-
-      it 'starts at 0' do
-
-        job = @scheduler.schedule_every '5m' do; end
-
-        expect(job.mean_work_time).to eq(0.0)
-      end
-
-      it 'gathers work times and computes the mean' do
-
-        job =
-          @scheduler.schedule_every '0.5s' do |j|
-            #p j.last_work_time
-            #p j.mean_work_time
-            sleep 0.01 * (j.count + 1)
-          end
-
-        sleep 4.6
-
-        expect(job.last_work_time).to be >= 0.08
-        expect(job.last_work_time).to be < 0.099
-        expect(job.mean_work_time).to be > 0.05
-        expect(job.mean_work_time).to be < 0.06
-      end
-    end
-  end
-
-  context 'one time job' do
-
-    describe '#determine_id' do
-
-      it 'returns unique ids' do
-
-        ids = []
-
-        10_000.times { ids << @scheduler.in('1y') {} }
-
-        expect(ids.uniq.length).to eq(ids.length)
-      end
-    end
-  end
-
-  context 'repeat job' do
-
-    describe '#determine_id' do
-
-      it 'returns unique ids' do
-
-        ids = []
-
-        10_000.times { ids << @scheduler.every('1y') {} }
-
-        expect(ids.uniq.length).to eq(ids.length)
-      end
-    end
-  end
-end
-

data/spec/lock_custom_spec.rb

@@ -1,47 +0,0 @@
-
-#
-# Specifying rufus-scheduler
-#
-# Fri Nov  1 05:56:03 JST 2013
-#
-# Ishinomaki
-#
-
-require 'spec_helper'
-
-
-describe Rufus::Scheduler do
-
-  class LosingLockScheduler < Rufus::Scheduler
-
-    attr_reader :counter
-
-    def initialize
-      super
-      @counter = 0
-    end
-
-    def confirm_lock
-      @counter = @counter + 1
-      false
-    end
-  end
-
-  context 'custom locks' do
-
-    it 'does not trigger when #confirm_lock returns false' do
-
-      s = LosingLockScheduler.new
-
-      count = 0
-
-      s.in('0s') { count = count + 1 }
-
-      sleep 0.7
-
-      expect(count).to eq(0)
-      expect(s.counter).to eq(1)
-    end
-  end
-end
-