Python 一等函数(函数内省)
函数内省
除了 doc,函数对象还有很多属性。使用 dir 函数可以探知
factorial 具有下述属性:
>>> dir(factorial)
['__annotations__', '__call__', '__class__', '__closure__', '__code__',
'__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__',
'__format__', '__ge__', '__get__', '__getattribute__', '__globals__',
'__gt__', '__hash__', '__init__', '__kwdefaults__', '__le__', '__lt__',
'__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__',
'__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__',
'__subclasshook__']
>>>
其中大多数属性是 Python 对象共有的。本节讨论与把函数视作对象相关
的几个属性,先从__dict__ 开始。
与用户定义的常规类一样,函数使用__dict__ 属性存储赋予它的用户
属性。这相当于一种基本形式的注解。一般来说,为函数随意赋予属性
不是很常见的做法,但是 Django 框架这么做了。参见“The Django admin
site”文档(https://docs.djangoproject.com/en/1.10/ref/contrib/admin/)中对
short_description、boolean 和 allow_tags 属性的说明。这篇
Django 文档中举了下述示例,把 short_description 属性赋予一个方
法,Django 管理后台使用这个方法时,在记录列表中会出现指定的描述
文本:
def upper_case_name(obj):return ("%s %s" % (obj.first_name, obj.last_name)).upper()
upper_case_name.short_description = 'Customer name'
下面重点说明函数专有而用户定义的一般对象没有的属性。计算两个属
性集合的差集便能得到函数专有属性列表(见示例 5-9)。
示例 5-9 列出常规对象没有而函数有的属性
>>> class C: pass # ➊
>>> obj = C() # ➋
>>> def func(): pass # ➌
>>> sorted(set(dir(func)) - set(dir(obj))) # ➍
['__annotations__', '__call__', '__closure__', '__code__', '__defaults__',
'__get__', '__globals__', '__kwdefaults__', '__name__', '__qualname__']
>>>
➊ 创建一个空的用户定义的类。
➋ 创建一个实例。
➌ 创建一个空函数。
➍ 计算差集,然后排序,得到类的实例没有而函数有的属性列表。
表 5-1 对示例 5-9 中列出的属性做了简要说明。
表5-1:用户定义的函数的属性
后面几节会讨论__defaults__、code 和__annotations__ 属
性,IDE 和框架使用它们提取关于函数签名的信息。但是,为了深入了
解这些属性,我们要先探讨 Python 为声明函数形参和传入实参所提供的
强大句法。