class Puma::Events

This is an event sink used by ‘Puma::Server` to handle lifecycle events such as :after_booted, :before_restart, and :after_stopped. Using `Puma::DSL` it is possible to register callback hooks for each event type.

Public Class Methods

new() click to toggle source

# File lib/puma/events.rb, line 11
def initialize
  @hooks = Hash.new { |h,k| h[k] = [] }
end

Public Instance Methods

after_booted(&block) click to toggle source

# File lib/puma/events.rb, line 33
def after_booted(&block)
  register(:after_booted, &block)
end

after_stopped(&block) click to toggle source

# File lib/puma/events.rb, line 41
def after_stopped(&block)
  register(:after_stopped, &block)
end

before_restart(&block) click to toggle source

# File lib/puma/events.rb, line 37
def before_restart(&block)
  register(:before_restart, &block)
end

fire(hook, *args) click to toggle source

Fire callbacks for the named hook

# File lib/puma/events.rb, line 16
def fire(hook, *args)
  @hooks[hook].each { |t| t.call(*args) }
end

fire_after_booted!() click to toggle source

# File lib/puma/events.rb, line 60
def fire_after_booted!
  fire(:after_booted)
end

fire_after_stopped!() click to toggle source

# File lib/puma/events.rb, line 68
def fire_after_stopped!
  fire(:after_stopped)
end

fire_before_restart!() click to toggle source

# File lib/puma/events.rb, line 64
def fire_before_restart!
  fire(:before_restart)
end

on_booted(&block) click to toggle source

# File lib/puma/events.rb, line 45
def on_booted(&block)
  Puma.deprecate_method_change :on_booted, __callee__, :after_booted
  after_booted(&block)
end

on_restart(&block) click to toggle source

# File lib/puma/events.rb, line 50
def on_restart(&block)
  Puma.deprecate_method_change :on_restart, __callee__, :before_restart
  before_restart(&block)
end

on_stopped(&block) click to toggle source

# File lib/puma/events.rb, line 55
def on_stopped(&block)
  Puma.deprecate_method_change :on_stopped, __callee__, :after_stopped
  after_stopped(&block)
end

# File lib/puma/events.rb, line 21
def register(hook, obj=nil, &blk)
  if obj and blk
    raise "Specify either an object or a block, not both"
  end

  h = obj || blk

  @hooks[hook] << h

  h
end