Class: Utils::IRB::Shell::WrapperBase

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/utils/irb.rb

Overview

Base class for wrapping objects with descriptive metadata.

This class provides a foundation for creating wrapper objects that associate descriptive information with underlying objects. It handles name conversion and provides common methods for accessing and comparing wrapped objects.

Direct Known Subclasses

ConstantWrapper, MethodWrapper

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name) ⇒ WrapperBase

The initialize method sets up the instance name by converting the input to a string representation.

This method handles different input types by converting them to a string, prioritizing to_str over to_sym and falling back to to_s if neither is available.

Parameters:

  • name (Object) —

    the input name to be converted to a string



298
299
300
301
302
303
304
305
306
307
308
 
# File 'lib/utils/irb.rb', line 298

def initialize(name)
  @name =
    case
    when name.respond_to?(:to_str)
      name.to_str
    when name.respond_to?(:to_sym)
      name.to_sym.to_s
    else
      name.to_s
    end
end

Instance Attribute Details

#description ⇒ String? (readonly) Also known as: to_str, inspect, to_s

The description reader method provides access to the description attribute.

Returns:

  • (String, nil) —

    the description value or nil if not set



320
321
322
 
# File 'lib/utils/irb.rb', line 320

def description
  @description
end

#name ⇒ String (readonly)

The name reader method returns the value of the name instance variable.

Returns:

  • (String) —

    the value stored in the name instance variable



314
315
316
 
# File 'lib/utils/irb.rb', line 314

def name
  @name
end

Instance Method Details

#<=>(other) ⇒ Integer

The <=> method compares the names of two objects for sorting purposes.

Parameters:

  • other (Object) —

    the other object to compare against

Returns:

  • (Integer) —

    -1 if this object’s name is less than the other’s, 0 if they are equal, or 1 if this object’s name is greater than the other’s



352
353
354
 
# File 'lib/utils/irb.rb', line 352

def <=>(other)
  @name <=> other.name
end

#==(name) ⇒ Object Also known as: eql?

The == method assigns a new name value to the instance variable.

Parameters:

  • name (Object) —

    the name value to be assigned

Returns:

  • (Object) —

    returns the assigned name value



333
334
335
 
# File 'lib/utils/irb.rb', line 333

def ==(name)
  @name = name
end

#hash ⇒ Integer

The hash method returns the hash value of the name attribute.

Returns:

  • (Integer) —

    the hash value used for object identification



342
343
344
 
# File 'lib/utils/irb.rb', line 342

def hash
  @name.hash
end