According to the Python language documentation:
__slots__
allow us to explicitly declare data members (like properties) and deny the creation of__dict__
and__weakref__
(unless explicitly declared in__slots__
or available in a parent.)
So I am wondering if this class
>>> class A: __slots__ = ('__dict__', '__weakref__')
...
>>> del A.__slots__
>>> vars(A)
mappingproxy({
'__module__': '__main__',
'__dict__': <attribute '__dict__' of 'A' objects>,
'__weakref__': <attribute '__weakref__' of 'A' objects>,
'__doc__': None
})
is equivalent to this one:
>>> class A: pass
...
>>> vars(A)
mappingproxy({
'__module__': '__main__',
'__dict__': <attribute '__dict__' of 'A' objects>,
'__weakref__': <attribute '__weakref__' of 'A' objects>,
'__doc__': None
})
If you don’t set a __slots__
attribute, the default is to create the __weakref__
and __dict__
slots in certain conditions.
This happens in type.__new__()
; a class is given descriptors to access memory slots for each instance:
First, a check is made if the type can have these slots by testing for the tp_dictoffset
, tp_weaklistoffset
and tp_itemsize
values in the type object struct.
__dict__
slot if the base class doesn’t already define one (base->tp_dictoffset
is 0).__weakref__
slot if the base type doesn’t define one (base->tp_weaklistoffset
is 0) and the base has fixed-length instances (base->tp_itemsize
is 0).Then, if there is no __slots__
, flag variables are set to actually enable the slots being added.
The type.__new__()
implementation is long, but the relevant section looks like this:
slots = _PyDict_GetItemIdWithError(dict, &PyId___slots__);
nslots = 0;
add_dict = 0;
add_weak = 0;
may_add_dict = base->tp_dictoffset == 0;
may_add_weak = base->tp_weaklistoffset == 0 && base->tp_itemsize == 0;
if (slots == NULL) {
if (PyErr_Occurred()) {
goto error;
}
if (may_add_dict) {
add_dict++;
}
if (may_add_weak) {
add_weak++;
}
}
else {
/* Have slots */
...
}
Then, some 400 lines lower down, you'll find the code that actually creates the slots:
if (add_dict) {
if (base->tp_itemsize)
type->tp_dictoffset = -(long)sizeof(PyObject *);
else
type->tp_dictoffset = slotoffset;
slotoffset += sizeof(PyObject *);
}
if (add_weak) {
assert(!base->tp_itemsize);
type->tp_weaklistoffset = slotoffset;
slotoffset += sizeof(PyObject *);
}
When extending certain native types (such as int
or bytes
) you don’t get a __weakref__
slot as they have variable-length instances (handled by tp_itemsize
).