何时以及为何应使用 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()
我什么时候应该使用 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()