用None和文档字符串来描述具有动态默认值的参数

有时我们想采用一种非静态的类型，来做关键字参数的默认值。例如，在打印日志消息时，要把相关事件的记录时间也标注在这条消息中。默认情况下，消息里面所包含的时间，应该是调用log函数那一刻的时候。如果我们以为参数的默认值会在每次执行函数时得到评估，那可能就会写出下面这种代码。

from datetime import datetime
import time
def log(message, when=datetime.now()):
	print('%s: %s' % (when, message))

log('Hi there!')
time.sleep(0.1)
log('Hi again!')

输出：

输出的时间是一样的，这是因为datetime.now只在函数定义时运行了一次。

要想正确实现动态默认值，习惯上把默认值设为None，并在文档字符串（docstring）里面把None所对应的实际行为描述出来。编写函数代码时，如果发现该参数的值是None，那将其设为实际的默认值。

from datetime import datetime
import time
def log(message, when=None):
	#如果when默认值为None，则执行此条语句
	when = datetime.now() if when is None else when
	
	print('%s: %s' % (when, message))

log('Hi there!')
time.sleep(0.1)
log('Hi again!')

输出：

-------------搬运自《Effective Python》