Class: Farce::Local::TimerQueue

Inherits:
Abstract::TimerQueue show all
Includes:
Scoped, Shareable::Unfreezable
Defined in:
lib/farce/local/timer_queue.rb

Overview

A shareable timer queue with independent mutable storage in each scope.

Instance Attribute Summary

Attributes included from Scoped

#scope

Attributes inherited from Abstract::Queue

#capacity, #num_waiting, #size

Instance Method Summary collapse

Methods included from Shareable

#ractor_shareable?

Methods inherited from Abstract::TimerQueue

#delete, #first_timestamp, #last_timestamp, #overdue?, #overdue_by, #peek, #pop, #push, #try_pop, #try_push, #wait_pop

Methods inherited from Abstract::Queue

#age_tracking?, #clear, #close, #closed?, #deq, #duplicable?, #empty?, #enq, #full?, #generation, #length, #max, #oldest_age, #oldest_enqueued_at, #pop, #push, #seal, #sealed?, #try_pop, #try_push, #wait_pop, #wait_push

Constructor Details

#initialize(capacity: nil, track_age: false, scope: :ractor) ⇒ TimerQueue

Returns a new instance of TimerQueue.

Valid scopes are:

  • :ractor - The value is shared by all threads within the same Ractor.
  • :thread_group - The value is shared by all threads within the same thread group.
  • :thread - The value is shared by all fibers within the same thread.
  • :fiber_storage - The value is shared by all fibers using the same storage. Unless explicitly specified, storage is inherited from the parent fiber for blocking fibers, but not for non-blocking fibers (such as those created by Scheduler#schedule).
  • :fiber - Each fiber has its own independent value.

Parameters:

  • capacity (Integer, nil) (defaults to: nil) —

    the maximum number of values, or nil for an unbounded queue

  • track_age (Boolean) (defaults to: false) —

    whether to track enqueue age and queue generations

  • scope (Symbol) (defaults to: :ractor) —

    the scope of the queue

  • fiber_wait (:auto, :io, :block) —

    how scheduled fibers wait on CRuby



19
20
21
 
# File 'lib/farce/local/timer_queue.rb', line 19

def initialize(capacity: nil, track_age: false, scope: :ractor, fiber_wait: :auto)
  super
end

Instance Method Details

#mode ⇒ Symbol

Returns always returns :local.

Returns:

  • (Symbol) —

    always returns :local



24
 
# File 'lib/farce/local/timer_queue.rb', line 24

def mode = :local