python - CPython 扩展的基于关键字的文档

Question

应该如何编写 CPython 扩展，以便 pydoc 提及参数名称而不是 (...)？

我关注了 official python tutorial about extending Python ，甚至对于 keywdarg.parrot 过程，我得到:

$> pydoc kewdarg.parrot

parrot(...)
   Print a lovely skit to standard output.

而我希望

parrot(voltage, state="a stiff", action="voom", type="Norwegian Blue")
   Print a lovely skit to standard output.

Answer 1

查看 sources of pydoc ，如果我没记错的话，产生 '...' 的节是:

if inspect.isfunction(object):
    args, varargs, varkw, defaults = inspect.getargspec(object)
    argspec = inspect.formatargspec(
        args, varargs, varkw, defaults, formatvalue=self.formatvalue)
    if realname == '<lambda>':
        title = '<strong>%s</strong> <em>lambda</em> ' % name
        argspec = argspec[1:-1] # remove parentheses
else:
    argspec = '(...)'

因此，inspect.isfunction(object) 在 CPython 扩展的情况下返回 False。由于 inspect.isfunction() 检查对象是 Python 函数，而 C 扩展函数被认为是 builtins，那么上面的代码将返回 False，我们得到 ( ...) 在输出中。