Jim Fasarakis-Hilliard added the comment:
I believe the docs defined that, usually using a bold "CPython implementation
detail" sentence.
It seems like it's something that would be considered an implementation detail,
though, according to Raymond's answer here:
Martin Panter added the comment:
I don’t know if it is an implementation detail or not. Maybe it is the
documentation itself which defines that. Anyway, I think your wording would
have been fine for my original problem.
I wonder if we should clarify that only reading the mapping is supported,
Jim Fasarakis-Hilliard added the comment:
Isn't the fact that it's read-only a CPython implementation detail? That is,
shouldn't that just read:
"gives a :term:`mapping` object representing the class's namespace"
so as to not enforce anything on any other implementations?
--
nosy:
New submission from Martin Panter:
The __dict__ attribute of class objects is documented as being a (standard)
dictionary, but implemented with a proxy object. I propose to clarify the
documentation in “Custom classes” under