应该如何编写 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.
请您参考如下方法:
查看 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,我们得到 ( ...) 在输出中。
