]> granicus.if.org Git - python/commit
Make dir() wordier (see the new docstring). The new behavior is a mixed
authorTim Peters <tim.peters@gmail.com>
Mon, 3 Sep 2001 05:47:38 +0000 (05:47 +0000)
committerTim Peters <tim.peters@gmail.com>
Mon, 3 Sep 2001 05:47:38 +0000 (05:47 +0000)
commit5d2b77cf31c5a3cbabc74936831480b9caea3a12
treedabb2f29553f94a18e3c5ae96d6f232196415f50
parent95c99e57b37ede725af1fdd1ff914c91284e3048
Make dir() wordier (see the new docstring).  The new behavior is a mixed
bag.  It's clearly wrong for classic classes, at heart because a classic
class doesn't have a __class__ attribute, and I'm unclear on whether
that's feature or bug.  I'll repair this once I find out (in the
meantime, dir() applied to classic classes won't find the base classes,
while dir() applied to a classic-class instance *will* find the base
classes but not *their* base classes).

Please give the new dir() a try and see whether you love it or hate it.
The new dir([]) behavior is something I could come to love.  Here's
something to hate:

>>> class C:
...     pass
...
>>> c = C()
>>> dir(c)
['__doc__', '__module__']
>>>

The idea that an instance has a __doc__ attribute is jarring (of course
it's really c.__class__.__doc__ == C.__doc__; likewise for __module__).

OTOH, the code already has too many special cases, and dir(x) doesn't
have a compelling or clear purpose when x isn't a module.
Lib/test/test_descr.py
Lib/test/test_descrtut.py
Lib/test/test_generators.py
Misc/NEWS
Python/bltinmodule.c