__slots__
2021 年更新: python 3.10 添加了对的直接支持。我将这个答案留给后代,不会更新它。
这个问题并不是数据类独有的。任何有冲突的类属性都会在一个插槽上踩踏:
>>> class Failure:
... __slots__ = tuple("xyz")
... x=1
...
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ValueError: 'x' in __slots__ conflicts with class variable
这就是插槽的工作方式。发生错误是因为__slots__
为每个插槽名称创建了一个类级描述符对象:
>>> class Success:
... __slots__ = tuple("xyz")
...
>>>
>>> type(Success.x)
<class 'member_descriptor'>
为了防止这种冲突的变量名错误,必须在实例化类对象之前更改类命名空间,以使类中没有两个对象竞争相同的成员名:
出于这个原因,__init_subclass__
父类上的方法是不够的,类装饰器也不足够,因为在这两种情况下,类对象在这些函数接收到类以对其进行更改时已经创建。
当前选项:编写元类
直到插槽机制被更改以允许更大的灵活性,或者语言本身提供了在类对象实例化之前更改类名称空间的机会,我们唯一的选择是使用元类。
为解决此问题而编写的任何元类必须至少:
- 从命名空间中删除冲突的类属性/成员
- 实例化类对象以创建插槽描述符
- 保存对插槽描述符的引用
- 将先前删除的成员及其值放回类中
__dict__
(以便dataclass
机器可以找到它们)
- 将类对象传递给
dataclass
装饰器
- 将插槽描述符恢复到各自的位置
- 还要考虑很多极端情况(例如如果有
__dict__
插槽怎么办)
至少可以说,这是一项极其复杂的工作。像下面这样定义类会更容易——没有默认值,这样就不会发生冲突——然后再添加一个默认值。
当前选项:在类对象实例化后进行更改
未更改的数据类如下所示:
@dataclass
class C:
__slots__ = "x"
x: int
改动很简单。更改__init__
签名以反映所需的默认值,然后更改__dataclass_fields__
以反映默认值的存在。
from functools import wraps
def change_init_signature(init):
@wraps(init)
def __init__(self, x=1):
init(self,x)
return __init__
C.__init__ = change_init_signature(C.__init__)
C.__dataclass_fields__["x"].default = 1
测试:
>>> C()
C(x=1)
>>> C(2)
C(x=2)
>>> C.x
<member 'x' of 'C' objects>
>>> vars(C())
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: vars() argument must have __dict__ attribute
有用!
当前选项:setmember
装饰器
通过一些努力,可以使用所谓的setmember
装饰器以上述方式自动更改类。这将需要偏离数据类 API,以便在类主体内部以外的位置定义默认值,可能类似于:
@setmember(x=field(default=1))
@dataclass
class C:
__slots__="x"
x: int
同样的事情也可以通过__init_subclass__
父类上的方法来完成:
class SlottedDataclass:
def __init_subclass__(cls, **kwargs):
cls.__init_subclass__()
# make the class changes here
class C(SlottedDataclass, x=field(default=1)):
__slots__ = "x"
x: int
未来的可能性:改变老虎机机制
如上所述,另一种可能性是让 python 语言改变插槽机制以提供更大的灵活性。这样做的一种方法可能是更改槽描述符本身以在类定义时存储类级别数据。
这可以通过提供 adict
作为__slots__
参数来完成(见下文)。类级数据(x 为 1,y 为 2)可以只存储在描述符本身上,以便以后检索:
class C:
__slots__ = {"x": 1, "y": 2}
assert C.x.value == 1
assert C.y.value == y
一个困难:可能希望只slot_member.value
在某些插槽上放礼物,而在其他插槽上不放。这可以通过从新slottools
库中导入空槽工厂来解决:
from slottools import nullslot
class C:
__slots__ = {"x": 1, "y": 2, "z": nullslot()}
assert not hasattr(C.z, "value")
上面建议的代码风格会偏离数据类 API。然而,slots 机器本身甚至可以被改变以允许这种风格的代码,特别考虑到数据类 API 的适应:
class C:
__slots__ = "x", "y", "z"
x = 1 # 1 is stored on C.x.value
y = 2 # 2 is stored on C.y.value
assert C.x.value == 1
assert C.y.value == y
assert not hasattr(C.z, "value")
未来的可能性:“准备”类体内的类命名空间
另一种可能性是更改/准备(与元类的方法同义__prepare__
)类名称空间。
目前,没有机会(除了编写元类)在类对象实例化之前编写更改类名称空间的代码,并且插槽机制开始工作。这可以通过创建一个用于预先准备类名称空间的钩子来更改,并使其仅在该钩子运行后才产生抱怨名称冲突的错误。
这个所谓的__prepare_slots__
钩子可能看起来像这样,我认为这还不错:
from dataclasses import dataclass, prepare_slots
@dataclass
class C:
__slots__ = ('x',)
__prepare_slots__ = prepare_slots
x: int = field(default=1)
该dataclasses.prepare_slots
函数将只是一个函数——类似于__prepare__
方法——它接收类名称空间并在创建类之前对其进行更改。特别是在这种情况下,默认数据类字段值将存储在其他方便的位置,以便在创建槽描述符对象后可以检索它们。
dataclasses.field
* 请注意,如果正在使用与插槽冲突的默认字段值,也可能由数据类机制创建。