Python 3.4中使用的__signature__和__text_signature__是什么

Question

如果dir()对CPython
3.4上的某些内置可调用对象（类构造函数，方法等）执行操作，则会发现其中许多通常具有称为的特殊属性__text_signature__，例如：

>>> object.__text_signature__
'()'
>>> int.__text_signature__
>>> # was None

但是，此文档不存在。此外，对属性名称进行谷歌搜索表明还存在另一个可能的特殊属性__signature__，尽管我没有找到任何内置的特殊功能。

我知道它们与函数参数签名有关，但是除此之外，它们的值表示什么，它们的用途是什么？

Answer 1

使用这些属性可以对C代码中定义的Python对象进行自省。的C-API参数诊所提供数据，以协助inspect建立时模块Signature的对象。以前不支持对C-API函数的自省。

有关如何使用该值，请参见内部inspect._signature_fromstr()函数__text_signature__。

当前，该__text_signature__属性是根据C-
API中对象上的内部文档字符串集填充的；对进行了简单的文本搜索objectname(...)\n--\n\n，其中\n--\n\n典型的是Attribute
Clinic生成的文档字符串。如果要查找一些示例，请查看type对象插槽。或者，您可以查看audioop模块源代码，以了解如何使用Argument
Clinic定义签名。该参数诊所脚本正在建设时产生的文档字符串（在所附的那些运行audioop.c.h文件）。

该__signature__属性（如果存在）将是一个inspect.Signature()对象；代替提供文本版本，C-API可以提供完全解析的Signature实例。