[Python-Dev] Issue10403 - using 'attributes' instead of members in documentation
Terry Reedy
tjreedy at udel.edu
Tue Jun 28 00:18:29 CEST 2011
On 6/27/2011 2:33 PM, Terry Reedy wrote:
> Let me repeat that that is historically wrong for Python, and illustrate
> why the term 'members' should not be used. From the 1.5 Language
> Reference, 3.2 Standard type hierarchy: "There are also some 'generic'
> special attributes, not listed with the individual objects: __methods__
> is a list of the method names of a built-in object, if it has any;
> __members__ is a list of the data attribute names of a built-in object,
> if it has any."
This sentence was left untouched until 2.2. What's new 2.2 has "In
previous versions of Python, there was no consistent way to discover
what attributes and methods were supported by an object. There were some
informal conventions, such as defining __members__ and __methods__
attributes that were lists of names, but often the author of an
extension type or a class wouldn't bother to define them."
This is a section on descriptors, but the real replacement is, I
believe, dir().
--
Terry Jan Reedy
More information about the Python-Dev
mailing list