[New-bugs-announce] [issue10357] ** and "mapping" are poorly defined in python docs
report at bugs.python.org
Mon Nov 8 14:16:27 CET 2010
New submission from Fergal Daly <fergald at gmail.com>:
According to the index, the only place that mentions ** in argument lists is
and gives no indication of what an object must support to allow **.
When you attempt to ** an object the real attribute exception is suppressed and you get a message
"argument after ** must be a mapping"
"mapping" is quite loosely defined. There are 3 definitions, the glossary entry seems the most complete
But even the glossary entry doesn't tell you what you need for **.
Only by reading the C source code did I discover that to be usable in **, an object must implement .keys() and .__getitem__().
The docs either should add .keys() to the definition of mapping or the code should use some other term or simply allow the original exception to reach the user.
assignee: docs at python
nosy: Fergal.Daly, docs at python
title: ** and "mapping" are poorly defined in python docs
versions: Python 2.7
Python tracker <report at bugs.python.org>
More information about the New-bugs-announce