This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author xitop
Recipients docs@python, methane, rhettinger, xitop
Date 2018-02-22.06:56:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1519282584.9.0.467229070634.issue32899@psf.upfronthosting.co.za>
In-reply-to
Content
While I do fully agree with not documenting all exceptions, I'd like to point out a major difference in the case of "unhashable in dict". 

It differs from the general case where an exception means the function is unable to return a meaningful result, beacuse it easily COULD return False as its documentation states. The exception is raised by a design decision, not by necessity. That makes it special.

A single sentence like "A hashable key is precondition of all dict operations." would explain the behaviour well. 

That's all I wanted to say. Thank you.
History
Date User Action Args
2018-02-22 06:56:24xitopsetrecipients: + xitop, rhettinger, methane, docs@python
2018-02-22 06:56:24xitopsetmessageid: <1519282584.9.0.467229070634.issue32899@psf.upfronthosting.co.za>
2018-02-22 06:56:24xitoplinkissue32899 messages
2018-02-22 06:56:24xitopcreate