"""Cheap and simple API helper
 
This program is part of "Dive Into Python", a free Python book for
experienced programmers.  Visit http://d...content-available-to-author-only...n.org/ for the
latest version.
"""
__author__ = "Mark Pilgrim (mark@diveintopython.org)"
__version__ = "$Revision: 1.3 $"
__date__ = "$Date: 2004/05/05 21:57:19 $"
__copyright__ = "Copyright (c) 2001 Mark Pilgrim"
__license__ = "Python"
 
# While this is a good example script to teach about introspection,
# in real life it has been superceded by PyDoc, which is part of the
# standard library in Python 2.1 and later.
# 
# Your IDE may already import the "help" function from pydoc
# automatically on startup; if not, do this:
# 
# >>> from pydoc import help
# 
# The help function in this module takes the object itself to get
# help on, but PyDoc can also take a string, like this:
# 
# >>> help("string") # gets help on the string module
# >>> help("apihelper.help") # gets help on the function below
# >>> help() # enters an interactive help mode
# 
# PyDoc can also act as an HTTP server to dynamically produce
# HTML-formatted documentation of any module in your path.
# That's wicked cool.  Read more about PyDoc here:
#   http://w...content-available-to-author-only...p.com/pub/a/python/2001/04/18/pydoc.html
 
def info(object, spacing=10, collapse=1):
	"""Print methods and doc strings.
 
	Takes module, class, list, dictionary, or string."""
	methodList = [e for e in dir(object) if callable(getattr(object, e))]
	processFunc = collapse and (lambda s: " ".join(s.split())) or (lambda s: s)
	print "\n".join(["%s %s" %
					 (method.ljust(spacing),
					  processFunc(str(getattr(object, method).__doc__)))
					 for method in methodList])
 
if __name__ == "__main__":
	print help.__doc__
 

IiIiQ2hlYXAgYW5kIHNpbXBsZSBBUEkgaGVscGVyCgpUaGlzIHByb2dyYW0gaXMgcGFydCBvZiAiRGl2ZSBJbnRvIFB5dGhvbiIsIGEgZnJlZSBQeXRob24gYm9vayBmb3IKZXhwZXJpZW5jZWQgcHJvZ3JhbW1lcnMuICBWaXNpdCBodHRwOi8vZC4uLmNvbnRlbnQtYXZhaWxhYmxlLXRvLWF1dGhvci1vbmx5Li4ubi5vcmcvIGZvciB0aGUKbGF0ZXN0IHZlcnNpb24uCiIiIgpfX2F1dGhvcl9fID0gIk1hcmsgUGlsZ3JpbSAobWFya0BkaXZlaW50b3B5dGhvbi5vcmcpIgpfX3ZlcnNpb25fXyA9ICIkUmV2aXNpb246IDEuMyAkIgpfX2RhdGVfXyA9ICIkRGF0ZTogMjAwNC8wNS8wNSAyMTo1NzoxOSAkIgpfX2NvcHlyaWdodF9fID0gIkNvcHlyaWdodCAoYykgMjAwMSBNYXJrIFBpbGdyaW0iCl9fbGljZW5zZV9fID0gIlB5dGhvbiIKCiMgV2hpbGUgdGhpcyBpcyBhIGdvb2QgZXhhbXBsZSBzY3JpcHQgdG8gdGVhY2ggYWJvdXQgaW50cm9zcGVjdGlvbiwKIyBpbiByZWFsIGxpZmUgaXQgaGFzIGJlZW4gc3VwZXJjZWRlZCBieSBQeURvYywgd2hpY2ggaXMgcGFydCBvZiB0aGUKIyBzdGFuZGFyZCBsaWJyYXJ5IGluIFB5dGhvbiAyLjEgYW5kIGxhdGVyLgojIAojIFlvdXIgSURFIG1heSBhbHJlYWR5IGltcG9ydCB0aGUgImhlbHAiIGZ1bmN0aW9uIGZyb20gcHlkb2MKIyBhdXRvbWF0aWNhbGx5IG9uIHN0YXJ0dXA7IGlmIG5vdCwgZG8gdGhpczoKIyAKIyA+Pj4gZnJvbSBweWRvYyBpbXBvcnQgaGVscAojIAojIFRoZSBoZWxwIGZ1bmN0aW9uIGluIHRoaXMgbW9kdWxlIHRha2VzIHRoZSBvYmplY3QgaXRzZWxmIHRvIGdldAojIGhlbHAgb24sIGJ1dCBQeURvYyBjYW4gYWxzbyB0YWtlIGEgc3RyaW5nLCBsaWtlIHRoaXM6CiMgCiMgPj4+IGhlbHAoInN0cmluZyIpICMgZ2V0cyBoZWxwIG9uIHRoZSBzdHJpbmcgbW9kdWxlCiMgPj4+IGhlbHAoImFwaWhlbHBlci5oZWxwIikgIyBnZXRzIGhlbHAgb24gdGhlIGZ1bmN0aW9uIGJlbG93CiMgPj4+IGhlbHAoKSAjIGVudGVycyBhbiBpbnRlcmFjdGl2ZSBoZWxwIG1vZGUKIyAKIyBQeURvYyBjYW4gYWxzbyBhY3QgYXMgYW4gSFRUUCBzZXJ2ZXIgdG8gZHluYW1pY2FsbHkgcHJvZHVjZQojIEhUTUwtZm9ybWF0dGVkIGRvY3VtZW50YXRpb24gb2YgYW55IG1vZHVsZSBpbiB5b3VyIHBhdGguCiMgVGhhdCdzIHdpY2tlZCBjb29sLiAgUmVhZCBtb3JlIGFib3V0IFB5RG9jIGhlcmU6CiMgICBodHRwOi8vdy4uLmNvbnRlbnQtYXZhaWxhYmxlLXRvLWF1dGhvci1vbmx5Li4ucC5jb20vcHViL2EvcHl0aG9uLzIwMDEvMDQvMTgvcHlkb2MuaHRtbAoKZGVmIGluZm8ob2JqZWN0LCBzcGFjaW5nPTEwLCBjb2xsYXBzZT0xKToKCSIiIlByaW50IG1ldGhvZHMgYW5kIGRvYyBzdHJpbmdzLgoKCVRha2VzIG1vZHVsZSwgY2xhc3MsIGxpc3QsIGRpY3Rpb25hcnksIG9yIHN0cmluZy4iIiIKCW1ldGhvZExpc3QgPSBbZSBmb3IgZSBpbiBkaXIob2JqZWN0KSBpZiBjYWxsYWJsZShnZXRhdHRyKG9iamVjdCwgZSkpXQoJcHJvY2Vzc0Z1bmMgPSBjb2xsYXBzZSBhbmQgKGxhbWJkYSBzOiAiICIuam9pbihzLnNwbGl0KCkpKSBvciAobGFtYmRhIHM6IHMpCglwcmludCAiXG4iLmpvaW4oWyIlcyAlcyIgJQoJCQkJCSAobWV0aG9kLmxqdXN0KHNwYWNpbmcpLAoJCQkJCSAgcHJvY2Vzc0Z1bmMoc3RyKGdldGF0dHIob2JqZWN0LCBtZXRob2QpLl9fZG9jX18pKSkKCQkJCQkgZm9yIG1ldGhvZCBpbiBtZXRob2RMaXN0XSkKCmlmIF9fbmFtZV9fID09ICJfX21haW5fXyI6CglwcmludCBoZWxwLl9fZG9jX18K