[docs] [issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

Raymond Hettinger report at bugs.python.org
Mon Jun 3 13:16:22 EDT 2019


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

The _mapping attribute is a private implementation detail and should remain undocumented.  A user of mapping views creates that attribute via the __init__() method.

In contrast, _from_iterable is explicitly meant to be overridden because it is the only way to control object creation.

Thank you for the suggestion.

----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue37145>
_______________________________________


More information about the docs mailing list