[New-bugs-announce] [issue18532] hashlib.HASH objects should officially expose the hash name

[Jason R. Coombs]

New submission from Jason R. Coombs:

In hashlib, the HASH objects currently supply a 'name' attribute, reflecting the name used to initialize the hash object, and they have since Python 2.5. However, this interface is not published so isn't honored by other platforms (namely pypy).

I propose the '.name' attribute be formally added to the documentation to reflect the actual implementation.

I suggest this change be considered as a bugfix release if the original intention was for the '.name' attribute to be public (as it's a bug in the documentation if the intended and implemented interface isn't fully documented).

I plan to do some research to ascertain the intention of this attribute (as can be inferred from tests and the source). For now, I'll assume Python 3.4 only.

Any comments or suggestions welcome.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 193563
nosy: docs at python, jason.coombs
priority: normal
severity: normal
status: open
title: hashlib.HASH objects should officially expose the hash name
versions: Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue18532>
_______________________________________