123456789_123456789_123456789_123456789_123456789_

Class: ActiveSupport::Reloader

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: ActiveSupport::ExecutionWrapper
Defined in: activesupport/lib/active_support/reloader.rb

Overview

This class defines several callbacks:

to_prepare -- Run once at application startup, and also from
{to_run}.

to_run -- Run before a work run that is reloading. If
{reload_classes_only_on_change} is true (the default), the class
unload will have already occurred.

to_complete -- Run after a work run that has reloaded. If
{reload_classes_only_on_change} is false, the class unload will
have occurred after the work run, but before this callback.

before_class_unload -- Run immediately before the classes are
unloaded.

after_class_unload -- Run immediately after the classes are
unloaded.

Constant Summary

Callbacks - Included

CALLBACK_FILTER_TYPES

Class Attribute Summary

Class Method Summary

ExecutionWrapper - Inherited

.register_hook

Register an object to be invoked during both the run and complete steps.

.run!

Run this execution.

.to_complete, .to_run,
.wrap

Perform the work in the supplied block as an execution.

DescendantsTracker - Inherited

descendants

See additional method definition at line 104.

subclasses

See additional method definition at line 100.

Instance Attribute Summary

Instance Method Summary

ExecutionWrapper - Inherited

#complete!

Complete this in-flight execution.

Callbacks - Included

#run_callbacks

Runs the callbacks for the given event.

Constructor Details

.newReloader

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 99

def initialize
  super
  @locked = false
end

Class Attribute Details

.check (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 85

class_attribute :check, default: lambda { false }

.check?Boolean (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 85

class_attribute :check, default: lambda { false }

.executor (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 84

class_attribute :executor, default: Executor

.executor?Boolean (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 84

class_attribute :executor, default: Executor

Class Method Details

.after_class_unload(*args, &block)

Registers a callback that will run immediately after the classes are unloaded.

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 44

def self.after_class_unload(*args, &block)
  set_callback(:class_unload, :after, *args, &block)
end

.before_class_unload(*args, &block)

Registers a callback that will run immediately before the classes are unloaded.

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 39

def self.before_class_unload(*args, &block)
  set_callback(:class_unload, *args, &block)
end

.reload!

Initiate a manual reload

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 51

def self.reload!
  executor.wrap do
    new.tap do |instance|
      instance.run!
    ensure
      instance.complete!
    end
  end
  prepare!
end

.to_prepare(*args, &block)

Registers a callback that will run once at application startup and every time the code is reloaded.

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 34

def self.to_prepare(*args, &block)
  set_callback(:prepare, *args, &block)
end

.wrap(**kwargs)

Run the supplied block as a work unit, reloading code as needed

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 71

def self.wrap(**kwargs)
  return yield if active?

  executor.wrap(**kwargs) do
    instance = run!
    begin
      yield
    ensure
      instance.complete!
    end
  end
end

Instance Attribute Details

#check (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 85

class_attribute :check, default: lambda { false }

#check?Boolean (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 85

class_attribute :check, default: lambda { false }

#executor (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 84

class_attribute :executor, default: Executor

#executor?Boolean (rw)

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 84

class_attribute :executor, default: Executor

Instance Method Details

#release_unload_lock!

Release the unload lock if it has been previously obtained

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 114

def release_unload_lock!
  if @locked
    @locked = false
    ActiveSupport::Dependencies.interlock.done_unloading
  end
end

#require_unload_lock!

Acquire the Dependencies::Interlock unload lock, ensuring it will be released automatically

[ GitHub ]

  
# File 'activesupport/lib/active_support/reloader.rb', line 106

def require_unload_lock!
  unless @locked
    ActiveSupport::Dependencies.interlock.start_unloading
    @locked = true
  end
end