Module: MaintenanceTasks

Defined in:
lib/maintenance_tasks.rb,
lib/maintenance_tasks/cli.rb,
lib/maintenance_tasks/engine.rb,
app/models/maintenance_tasks/run.rb,
app/models/maintenance_tasks/task.rb,
app/jobs/maintenance_tasks/task_job.rb,
app/models/maintenance_tasks/runner.rb,
app/models/maintenance_tasks/ticker.rb,
app/models/maintenance_tasks/progress.rb,
app/models/maintenance_tasks/runs_page.rb,
app/helpers/maintenance_tasks/tasks_helper.rb,
app/models/maintenance_tasks/task_data_show.rb,
app/models/maintenance_tasks/task_data_index.rb,
app/models/maintenance_tasks/application_record.rb,
lib/generators/maintenance_tasks/task_generator.rb,
app/helpers/maintenance_tasks/application_helper.rb,
app/controllers/maintenance_tasks/runs_controller.rb,
app/controllers/maintenance_tasks/tasks_controller.rb,
app/models/maintenance_tasks/no_collection_builder.rb,
lib/generators/maintenance_tasks/install_generator.rb,
app/models/maintenance_tasks/csv_collection_builder.rb,
app/jobs/concerns/maintenance_tasks/task_job_concern.rb,
app/models/maintenance_tasks/null_collection_builder.rb,
app/validators/maintenance_tasks/run_status_validator.rb,
app/controllers/maintenance_tasks/application_controller.rb,
app/models/maintenance_tasks/batch_csv_collection_builder.rb

Overview

The engine’s namespace module. It provides isolation between the host application’s code and the engine-specific code. Top-level engine constants and variables are defined under this module.

Defined Under Namespace

Modules: ApplicationHelper, Runner, TaskJobConcern, TasksHelper Classes: ApplicationController, ApplicationRecord, BatchCsvCollectionBuilder, CLI, CsvCollectionBuilder, Engine, InstallGenerator, NoCollectionBuilder, NullCollectionBuilder, Progress, Run, RunStatusValidator, RunsController, RunsPage, Task, TaskDataIndex, TaskDataShow, TaskGenerator, TaskJob, TasksController, Ticker

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.active_storage_service ⇒ Symbol

The Active Storage service to use for uploading CSV file blobs.

Returns:

  • (Symbol) —

    the key for the storage service, as specified in the app’s config/storage.yml.



52
 
# File 'lib/maintenance_tasks.rb', line 52

mattr_accessor :active_storage_service

.backtrace_cleaner ⇒ ActiveSupport::BacktraceCleaner?

The Active Support backtrace cleaner that will be used to clean the backtrace of a Task that errors.

Returns:

  • (ActiveSupport::BacktraceCleaner, nil) —

    the backtrace cleaner to use when cleaning a Run’s backtrace.



62
 
# File 'lib/maintenance_tasks.rb', line 62

mattr_accessor :backtrace_cleaner

.job ⇒ String

The name of the job to be used to perform Tasks. Defaults to ‘“MaintenanceTasks::TaskJob”`. This job must be either a class that inherits from TaskJob or a class that includes TaskJobConcern.

Returns:

  • (String) —

    the name of the job class.



30
 
# File 'lib/maintenance_tasks.rb', line 30

mattr_accessor :job, default: "MaintenanceTasks::TaskJob"

.parent_controller ⇒ String

The parent controller all web UI controllers will inherit from. Must be a class that inherits from ‘ActionController::Base`. Defaults to `“ActionController::Base”`

Returns:

  • (String) —

    the name of the parent controller for web UI.



72
 
# File 'lib/maintenance_tasks.rb', line 72

mattr_accessor :parent_controller, default: "ActionController::Base"

.stuck_task_duration ⇒ ActiveSupport::Duration

The duration after which a task is considered stuck and can be force cancelled.

Returns:

  • (ActiveSupport::Duration) —

    the threshold in seconds after which a task is considered stuck.



86
 
# File 'lib/maintenance_tasks.rb', line 86

mattr_accessor :stuck_task_duration, default: 5.minutes

.tasks_module ⇒ String

The module to namespace Tasks in, as a String. Defaults to ‘Maintenance’.

Returns:

  • (String) —

    the name of the module.



20
 
# File 'lib/maintenance_tasks.rb', line 20

mattr_accessor :tasks_module, default: "Maintenance"

.ticker_delay ⇒ ActiveSupport::Duration, Numeric

The delay between updates to the tick count. After each iteration, the progress of the Task may be updated. This duration in seconds limits these updates, skipping if the duration since the last update is lower than this value, except if the job is interrupted, in which case the progress will always be recorded.

Returns:

  • (ActiveSupport::Duration, Numeric) —

    duration of the delay between updates to the tick count during Task iterations.



43
 
# File 'lib/maintenance_tasks.rb', line 43

mattr_accessor :ticker_delay, default: 1.second

Instance Attribute Details

#metadata ⇒ Object 



79
 
# File 'lib/maintenance_tasks.rb', line 79

mattr_accessor :metadata, default: nil

Class Method Details

.deprecator ⇒ Object

@api-private



109
110
111
 
# File 'lib/maintenance_tasks.rb', line 109

def deprecator
  @deprecator ||= ActiveSupport::Deprecation.new("3.0", "MaintenanceTasks")
end

.error_handler ⇒ Object

Deprecated. 


95
96
97
98
99
 
# File 'lib/maintenance_tasks.rb', line 95

def error_handler
  deprecator.warn(DEPRECATION_MESSAGE)

  @error_handler
end

.error_handler=(proc) ⇒ Object

Deprecated. 


102
103
104
105
106
 
# File 'lib/maintenance_tasks.rb', line 102

def error_handler=(proc)
  deprecator.warn(DEPRECATION_MESSAGE)

  @error_handler = proc
end