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 为声明函数形参和传入实参所提供的
强大句法。