class Task

Overview

Background task.

By default, background tasks are processed sequentially.

Included Modules

Extended Modules

Direct Known Subclasses

Defined in:

models/task.cr
models/task/backup.cr
models/task/clean_oauth.cr
models/task/collect_garbage.cr
models/task/deliver.cr
models/task/fetch/hashtag.cr
models/task/fetch/mixins/fetcher.cr
models/task/fetch/thread.cr
models/task/handle_follow_request.cr
models/task/mixins/singleton.cr
models/task/mixins/transfer.cr
models/task/monitor.cr
models/task/performance.cr
models/task/receive.cr
models/task/refresh_actor.cr
models/task/run_scripts.cr
models/task/terminate.cr
models/task/update_metrics.cr

Constant Summary

ADAPTIVE_RANDOMIZATION_PERCENTAGE_LONG = 0.025

Adaptive randomization percentage for long intervals.

This percentage represents the total randomization range (e.g., 0.025 = 2.5% total range, meaning ±1.25%). Used when adaptive randomization is enabled and the interval is greater than or equal to ADAPTIVE_RANDOMIZATION_THRESHOLD.

ADAPTIVE_RANDOMIZATION_PERCENTAGE_SHORT = 0.05

Adaptive randomization percentage for short intervals.

This percentage represents the total randomization range (e.g., 0.05 = 5% total range, meaning ±2.5%). Used when adaptive randomization is enabled and the interval is shorter than ADAPTIVE_RANDOMIZATION_THRESHOLD.

ADAPTIVE_RANDOMIZATION_THRESHOLD = 6.hours

Threshold for adaptive randomization calculation .

Intervals shorter than this use ADAPTIVE_RANDOMIZATION_PERCENTAGE_SHORT. Intervals longer than or equal to this use ADAPTIVE_RANDOMIZATION_PERCENTAGE_LONG.

MIN_RANDOMIZATION_THRESHOLD = 5.minutes

Minimum time delta threshold for applying randomization.

Task scheduling deltas below this threshold will not be randomized to maintain precision for short-interval tasks.

Class Method Summary

Instance Method Summary

Instance methods inherited from module Ktistec::Model::Polymorphic

_validate_type _validate_type, as_a(as _as : T.class) : T forall T as_a, type : String type, type=(type : String) type=

Macros inherited from module Ktistec::Model::Polymorphic

find(_id id, *, as _as)
find(*, as _as, **options) find

Instance methods inherited from module Ktistec::Model::Common

created_at : Time created_at, created_at=(created_at : Time) created_at=, updated_at : Time updated_at, updated_at=(updated_at : Time) updated_at=

Instance methods inherited from module Ktistec::Model

==(other : self)
==(other) ==, _run_validations _run_validations, _save_model(skip_validation = false) _save_model, _serialize_graph(nodes, association = nil, index = nil, skip_associated = false) _serialize_graph, assign(properties : Hash(String, Any), *, _strict : Bool = false) forall Any
assign(*, _strict : Bool = false, **properties) assign, changed!(*properties : Symbol) changed!, changed?
changed?(*properties : Symbol) changed?, clear_changed!
clear_changed!(*properties : Symbol) clear_changed!, destroy destroy, destroyed? destroyed?, errors errors, hash(hasher) hash, id : Int64 | Nil id, id=(id : Int64 | Nil) id=, inspect(io : IO) inspect, new_record? new_record?, reload! reload!, save(skip_validation = false, skip_associated = false) save, serialize_graph(skip_associated = false) serialize_graph, table_name table_name, to_h to_h, to_json(json : JSON::Builder) to_json, to_s(io : IO) to_s, update_property(property, value) update_property, valid?(skip_associated = false) valid?, validate(skip_associated = false) validate

Constructor methods inherited from module Ktistec::Model

new(properties : Hash(String, Any), *, _strict : Bool = false) forall Any
new(*, _strict : Bool = false, **properties) new

Macros inherited from module Ktistec::Model

belongs_to(name, primary_key = id, foreign_key = nil, class_name = nil, inverse_of = nil) belongs_to, derived(decl, *, aliased_to) derived, has_many(name, primary_key = id, foreign_key = nil, class_name = nil, inverse_of = nil) has_many, has_one(name, primary_key = id, foreign_key = nil, class_name = nil, inverse_of = nil) has_one, validates(property, &block) validates

Class Method Detail

def self.all_subtypes #

Returns type and all concrete (non-abstract) subtypes, including any aliases defined on the type.


[View source]
def self.clean_up_running_tasks #

[View source]
def self.destroy_old_tasks #

[View source]
def self.priority #

[View source]
def self.priority=(priority : Int32) #

[View source]
def self.scheduled(now = Time.utc, reserve = false) #

[View source]

Instance Method Detail

def backtrace : Array(String) | Nil #

[View source]
def backtrace=(backtrace : Array(String) | Nil) #

[View source]
def complete : Bool #

[View source]
def complete=(complete : Bool) #

[View source]
def gone? #

Indicates whether or not the task is gone.

Typically, this means that the task was saved but has been destroyed. Destroying a running task is a lightweight signal that the task should terminate itself.


[View source]
def last_attempt_at : Time | Nil #

[View source]
def last_attempt_at=(last_attempt_at : Time | Nil) #

[View source]
def next_attempt_at : Time | Nil #

[View source]
def next_attempt_at=(next_attempt_at : Time | Nil) #

[View source]
def past_due?(now = Time.utc) #

[View source]
def perform #

[View source]
def runnable? #

[View source]
def running : Bool #

[View source]
def running=(running : Bool) #

[View source]
def schedule(next_attempt_at = nil) #

[View source]
def source_iri : String #

[View source]
def source_iri=(source_iri : String) #

[View source]
def subject_iri : String #

[View source]
def subject_iri=(subject_iri : String) #

[View source]