Skip to main content
 首页 » 编程设计

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

2025年05月04日9小虾米

应该如何编写 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,我们得到 ( ...) 在输出中。