何时以及为何应使用 attr.Factory?

When and why should I use attr.Factory?

我什么时候应该使用 attr.ib(default=attr.Factory(list)) 而不是 attr.ib(default=[])

docs 我看到工厂用于生成新值,如果您使用带有输入的 lambda 表达式,这是有意义的;但是,我不明白如果您只是生成一个空列表,为什么要使用它。

我在这里错过了什么?

您想避免使用可变对象作为默认值。如果您使用 attr.ib(default=[]),生成的是一个 __init__ 方法,使用该列表对象作为关键字参数 default:

def __init__(self, foo=[]):
    self.foo = foo

参数的默认值在定义时创建一次。每次调用该方法时都不会重新评估它们。然后,对该对象的任何突变 在所有实例中共享 。参见 "Least Astonishment" and the Mutable Default Argument

然而,使用 attr.Factory() 方法,默认设置为标记,当参数保留为标记值时,在函数本身中是然后将值替换为调用工厂的结果。这相当于:

def __init__(self, foo=None):
    if foo is None:
        foo = []
    self.foo = foo

现在每个实例都创建了一个新的列表对象。

一个演示差异的快速演示:

>>> import attr
>>> @attr.s
... class Demo:
...     foo = attr.ib(default=[])
...     bar = attr.ib(default=attr.Factory(list))
...
>>> d1 = Demo()
>>> d1.foo, d1.bar
([], [])
>>> d1.foo.append('d1'), d1.bar.append('d1')
(None, None)
>>> d1.foo, d1.bar
(['d1'], ['d1'])
>>> d2 = Demo()
>>> d2.foo, d2.bar
(['d1'], [])

因为 demo.foo 使用共享列表对象,通过 d1.foo 对其所做的更改在任何其他实例下立即可见。

当我们用inspect.getargspec()看一看Demo.__init__方法,我们就明白为什么了:

>>> import inspect
>>> inspect.getargspec(Demo.__init__)
ArgSpec(args=['self', 'foo', 'bar'], varargs=None, keywords=None, defaults=(['d1'], NOTHING))

foo 的默认值是完全相同的列表对象,附加的 'd1' 字符串仍然存在。 bar 设置为哨兵对象(此处使用 attr.NOTHING;该值使得可以使用 Demo(bar=None) 而不会变成列表对象):

>>> print(inspect.getsource(Demo.__init__))
def __init__(self, foo=attr_dict['foo'].default, bar=NOTHING):
    self.foo = foo
    if bar is not NOTHING:
        self.bar = bar
    else:
        self.bar = __attr_factory_bar()