module IRB::MethodExtender - Documentation for Ruby 3.2

# module IRB::MethodExtender

A convenience module for extending Ruby methods.

### Public Instance Methods

def_post_proc(base_method, extend_method) click to toggle source

Extends the given `base_method` with a postfix call to the given `extend_method`.

    # File lib/irb/extend-command.rb, line 400
    def def_post_proc(base_method, extend_method)
      base_method = base_method.to_s
      extend_method = extend_method.to_s

      alias_name = new_alias_name(base_method)
      module_eval %[
        alias_method alias_name, base_method
        def #{base_method}(*opts)
          __send__ :#{alias_name}, *opts
          __send__ :#{extend_method}, *opts
        end
      ]
    end

def_pre_proc(base_method, extend_method) click to toggle source

Extends the given `base_method` with a prefix call to the given `extend_method`.

    # File lib/irb/extend-command.rb, line 384
    def def_pre_proc(base_method, extend_method)
      base_method = base_method.to_s
      extend_method = extend_method.to_s

      alias_name = new_alias_name(base_method)
      module_eval %[
        alias_method alias_name, base_method
        def #{base_method}(*opts)
          __send__ :#{extend_method}, *opts
          __send__ :#{alias_name}, *opts
        end
      ]
    end

new_alias_name(name, prefix = "__alias_of__", postfix = "__") click to toggle source

Returns a unique method name to use as an alias for the given `name`.

Usually returns `#{prefix}#{name}#{postfix}<num>`, example:

    new_alias_name('foo') #=> __alias_of__foo__
    def bar; end
    new_alias_name('bar') #=> __alias_of__bar__2

    # File lib/irb/extend-command.rb, line 421
    def new_alias_name(name, prefix = "__alias_of__", postfix = "__")
      base_name = "#{prefix}#{name}#{postfix}"
      all_methods = instance_methods(true) + private_instance_methods(true)
      same_methods = all_methods.grep(/^#{Regexp.quote(base_name)}[0-9]*$/)
      return base_name if same_methods.empty?
      no = same_methods.size
      while !same_methods.include?(alias_name = base_name + no)
        no += 1
      end
      alias_name
    end