模組 IRB::ExtendCommandBundle

安裝預設的 irb 擴充套件指令集。

常數

NO_OVERRIDE

請參閱 install_alias_method

OVERRIDE_ALL

請參閱 install_alias_method

OVERRIDE_PRIVATE_ONLY

請參閱 install_alias_method

公開類別方法

all_commands_info() 按一下以切換來源
# File lib/irb/extend-command.rb, line 206
def self.all_commands_info
  return @@commands unless @@commands.empty?
  user_aliases = IRB.CurrentContext.command_aliases.each_with_object({}) do |(alias_name, target), result|
    result[target] ||= []
    result[target] << alias_name
  end

  @EXTEND_COMMANDS.each do |cmd_name, cmd_class, load_file, *aliases|
    if !defined?(ExtendCommand) || !ExtendCommand.const_defined?(cmd_class, false)
      require_relative load_file
    end

    klass = ExtendCommand.const_get(cmd_class, false)
    aliases = aliases.map { |a| a.first }

    if additional_aliases = user_aliases[cmd_name]
      aliases += additional_aliases
    end

    display_name = aliases.shift || cmd_name
    @@commands << { display_name: display_name, description: klass.description, category: klass.category }
  end

  @@commands
end
def_extend_command(cmd_name, cmd_class, load_file, *aliases) 按一下以切換來源

在給定的 cmd_class 類別 上評估給定的 cmd_name

也會為方法定義任何給定的 aliases

方法定義中需要選用的 load_file 參數。

# File lib/irb/extend-command.rb, line 259
def self.def_extend_command(cmd_name, cmd_class, load_file, *aliases)
  case cmd_class
  when Symbol
    cmd_class = cmd_class.id2name
  when String
  when Class
    cmd_class = cmd_class.name
  end

  line = __LINE__; eval %[
    def #{cmd_name}(*opts, **kwargs, &b)
      Kernel.require_relative "#{load_file}"
      ::IRB::ExtendCommand::#{cmd_class}.execute(irb_context, *opts, **kwargs, &b)
    end
  ], nil, __FILE__, line

  for ali, flag in aliases
    @ALIASES.push [ali, cmd_name, flag]
  end
end
extend_object(obj) 按一下以切換來源

使用 install_alias_method 在給定物件上安裝預設 irb 指令的別名方法。

呼叫超類別方法
# File lib/irb/extend-command.rb, line 308
def self.extend_object(obj)
  unless (class << obj; ancestors; end).include?(EXCB)
    super
    for ali, com, flg in @ALIASES
      obj.install_alias_method(ali, com, flg)
    end
  end
end
install_extend_commands() 按一下以切換來源

安裝預設的 irb 指令。

# File lib/irb/extend-command.rb, line 247
def self.install_extend_commands
  for args in @EXTEND_COMMANDS
    def_extend_command(*args)
  end
end
load_command(command) 按一下以切換來源

如果存在此類指令,將指令名稱轉換為其實作類別

# File lib/irb/extend-command.rb, line 233
def self.load_command(command)
  command = command.to_sym
  @EXTEND_COMMANDS.each do |cmd_name, cmd_class, load_file, *aliases|
    next if cmd_name != command && aliases.all? { |alias_name, _| alias_name != command }

    if !defined?(ExtendCommand) || !ExtendCommand.const_defined?(cmd_class, false)
      require_relative load_file
    end
    return ExtendCommand.const_get(cmd_class, false)
  end
  nil
end

公開實例方法

install_alias_method(to, from, override = NO_OVERRIDE) 按一下以切換來源

安裝預設 irb 指令的別名方法,請參閱 ::install_extend_commands

# File lib/irb/extend-command.rb, line 282
def install_alias_method(to, from, override = NO_OVERRIDE)
  to = to.id2name unless to.kind_of?(String)
  from = from.id2name unless from.kind_of?(String)

  if override == OVERRIDE_ALL or
      (override == OVERRIDE_PRIVATE_ONLY) && !respond_to?(to) or
      (override == NO_OVERRIDE) &&  !respond_to?(to, true)
    target = self
    (class << self; self; end).instance_eval{
      if target.respond_to?(to, true) &&
        !target.respond_to?(EXCB.irb_original_method_name(to), true)
        alias_method(EXCB.irb_original_method_name(to), to)
      end
      alias_method to, from
    }
  else
    Kernel.warn "irb: warn: can't alias #{to} from #{from}.\n"
  end
end
irb_context() 按一下以切換來源

顯示目前的組態。

透過傳送訊息至 IRB.conf 來修改組態。

# File lib/irb/extend-command.rb, line 31
def irb_context
  IRB.CurrentContext
end
irb_exit(ret = 0) 按一下以切換來源

退出目前的 irb 內容

ret 是傳送至 Context#exit 的選用訊號或訊息

IRB.CurrentContext.exit 相同。

# File lib/irb/extend-command.rb, line 24
def irb_exit(ret = 0)
  irb_context.exit(ret)
end
irb_load(*opts, &b) 按一下以切換來源

載入給定的檔案,類似於 Kernel#load,請參閱 IrbLoader#irb_load

# File lib/irb/ext/use-loader.rb, line 19
def irb_load(*opts, &b)
  ExtendCommand::Load.execute(irb_context, *opts, &b)
end
irb_require(*opts, &b) 按一下以切換來源

載入給定的檔案,類似於 Kernel#require

# File lib/irb/ext/use-loader.rb, line 24
def irb_require(*opts, &b)
  ExtendCommand::Require.execute(irb_context, *opts, &b)
end