你有(至少)两种选择来实现你想要的.
最好的替代方法是覆盖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)