Maintenance of Ruby 2.0.0 ended on February 24, 2016. Read more

In Files

  • irb/notifier.rb


A class that can be used to create a group of notifier objects with the intent of representing a leveled notification system for irb.

This class will allow you to generate other notifiers, and assign them the appropriate level for output.

The Notifier class provides a class-method IRB::Notifier.def_notifier to create a new composite notifier. Using the first composite notifier object you create, sibling notifiers can be initialized with def_notifier.



Returns the leveled notifier for this object


Returns the leveled notifier for this object


List of notifiers in the group

Public Class Methods

new(prefix, base_notifier) click to toggle source

Create a new composite notifier object with the given prefix, and base_notifier to use for output.

               # File irb/notifier.rb, line 118
def initialize(prefix, base_notifier)

  @notifiers = [D_NOMSG]
  @level_notifier = D_NOMSG

Public Instance Methods

def_notifier(level, prefix = "") click to toggle source

Creates a new LeveledNotifier in the composite notifiers group.

The given prefix will be assigned to the notifier, and level will be used as the index of the notifiers Array.

This method returns the newly created instance.

               # File irb/notifier.rb, line 134
def def_notifier(level, prefix = "")
  notifier =, level, prefix)
  @notifiers[level] = notifier
level=(value) click to toggle source
Alias for: level_notifier=
level_notifier=(value) click to toggle source

Sets the leveled notifier for this object.

When the given value is an instance of AbstractNotifier, level_notifier is set to the given object.

When an Integer is given, level_notifier is set to the notifier at the index value in the notifiers Array.

If no notifier exists at the index value in the notifiers Array, an ErrUndefinedNotifier exception is raised.

An ErrUnrecognizedLevel exception is raised if the given value is not found in the existing notifiers Array, or an instance of AbstractNotifier

               # File irb/notifier.rb, line 158
def level_notifier=(value)
  case value
  when AbstractNotifier
    @level_notifier = value
  when Integer
    l = @notifiers[value]
    Notifier.Raise ErrUndefinedNotifer, value unless l
    @level_notifier = l
    Notifier.Raise ErrUnrecognizedLevel, value unless l
Also aliased as: level=