Question

在IRB或其他交互式解释器（如pry）中，如何获取有关对象和方法的内联文档？例如，我可以做到这一点：

[1] pry(main)> x = 'hello world'
=> "hello world"
[2] pry(main)> x.st
x.start_with?  x.strip        x.strip!   
[2] pry(main)> x.st

但现在我想阅读用法/接口/ rdoc对这些方法及其接口的说法。顺便说一句，那条中间线是制表完成的。

我正在寻找类似于ipython的东西，其中?可以附加到属性名称以查看文档字符串，甚至可以??来查看源代码：

In [1]: x = 'potato'

In [2]: x.st
x.startswith  x.strip       

In [2]: x.strip?
Type:       builtin_function_or_method
String Form:<built-in method strip of str object at 0x15e1b10>
Docstring:
S.strip([chars]) -> string or unicode

Return a copy of the string S with leading and trailing
whitespace removed.
If chars is given and not None, remove characters in chars instead.
If chars is unicode, S will be converted to unicode before stripping

Answer 1

首先你需要安装

gem install pry-doc

然后您可以使用show-doc [method]命令获取文档（别名为? [method]）

pry> x = 'potato'
=> "potato"
pry> show-doc x.strip

From: string.c (C Method):
Owner: String
Visibility: public
Signature: strip()
Number of lines: 4

Returns a copy of str with leading and trailing whitespace removed.

   "    hello    ".strip   #=> "hello"
   "\tgoodbye\r\n".strip   #=> "goodbye"

您甚至可以使用show-source [method]命令查看源代码（别名为$ [method]）

pry> show-source x.strip

From: string.c (C Method):
Owner: String
Visibility: public
Number of lines: 7

static VALUE
rb_str_strip(VALUE str)
{
    str = rb_str_dup(str);
    rb_str_strip_bang(str);
    return str;
}

此示例显示了C源代码，但它会显示实际的Ruby源代码（如果有）。考虑这个简单的类：

pry> class Foo
pry*   def bar
pry*     puts 'hello'
pry*   end
pry* end
=> nil

你可以看一下全班：

pry> show-source Foo

From: (pry) @ line 2:
Class name: Foo
Number of lines: 5

class Foo
  def bar
    puts 'hello'
  end
end

但也只是一种特定的方法：

pry> show-source Foo#bar

From: (pry) @ line 3:
Owner: Foo
Visibility: public
Number of lines: 3

def bar
  puts 'hello'
end

正如@banister建议的那样，您可以通过Pry.commands.command添加自定义命令。这样您就可以在?中定义??和~/.pryrc这样的命令：

Pry.commands.command /(.+) \?\z/ do |a|
  run "show-doc", a
end

Pry.commands.command /(.+) \?\?\z/ do |a|
  run "show-source", a
end

请注意，我们需要方法与?之间的空格，因为Ruby方法可能以?结尾（例如Fixnum#zero?），并且这些方法会中断。一些例子：

pry> puts ?

From: io.c (C Method):
Owner: Kernel
Visibility: private
Signature: puts(*arg1)
Number of lines: 3

Equivalent to

    $stdout.puts(obj, ...)

pry> puts ??

From: io.c (C Method):
Owner: Kernel
Visibility: private
Number of lines: 8

static VALUE
rb_f_puts(int argc, VALUE *argv, VALUE recv)
{
    if (recv == rb_stdout) {
        return rb_io_puts(argc, argv, recv);
    }
    return rb_funcall2(rb_stdout, rb_intern("puts"), argc, argv);
}

pry> 0.zero?     # still works!
=> true

pry> 0.zero? ?

From: numeric.c (C Method):
Owner: Fixnum
Visibility: public
Signature: zero?()
Number of lines: 1

Returns true if fix is zero.

Ruby内联文档

1 个答案: