python函数注释 参数 省略号_python – make函数在help()函数中有参数的省略号

你有(至少)两种选择来实现你想要的.

最好的替代方法是覆盖inspect.Signature类的__str__方法.但是,由于它是用C语言编写的,因此它是只读的.

所以要做到这一点,你需要扩展类如下：

class MySignature(inspect.Signature):

def __str__(self):

return '(...)'

然后在定义函数后执行：

func_signature = inspect.signature(func)

func.__signature__ = MySignature(func_signature.parameters.values(),

return_annotation=func_signature.return_annotation)

然后将返回以下内容以获取帮助(func)：

Help on function func in module __main__:

func(...)

(END)

使用这种方法,inspect.signature仍然有效：

In [1]: inspect.signature(func)

Out[1]:

或者,如果您并不真正关心能够正确地内省您的函数(可能还有其他一些用例),那么您可以将函数__signature__的值定义为不是Signature实例的对象：

def func(x, y):

pass

func.__signature__ = object()

help(func)

生成结果：

Help on function func in module __main__:

func(...)

(END)

但是现在inspect.signature(func)将引发TypeError：意外对象在__signature__属性中.

注意：这最后一个版本非常hacky,我不推荐它.

有关这两种技术以及签名如何工作的更多信息,请参阅PEP 0362.

更新：

对于python 2.7,您可以执行以下操作(可能更好地使用模拟框架)：

In [1]: import inspect

In [2]: def myformatargspec(*args, **kwargs):

...: return '(...)'

...:

In [3]: def func(x, y):

...: pass

...:

In [6]: inspect.formatargspec = myformatargspec

In [7]: help(func)

Help on function func in module __main__:

func(...)

(END)