第十八章：语言工具-inspect:检查现场对象-示例模块

18.4 inspect:检查现场对象
inspect模块提供了一些函数来了解现场对象，包括模块、类、实例、函数和方法。这个模块中的函数可以用来获取一个函数的原始源代码，查看栈中一个方法的参数，以及抽取对生成源代码库文档有用的信息。

18.4.1 示例模块
这一节余下的例子都会使用这个示例文件example.py。

# This comment appears first
# and spans 2 lines.

# This comment does not show up in the output of getcomments().

"""Sample file to serve as the basis for inspect examples.
"""


def module_level_function(arg1,arg2='default',*args,**kwargs):
    """This function is declared in the module."""
    local_variable = arg1 * 2
    return local_variable


class A(object):
    """The A class."""

    def __init__(self,name):
        self.name = name

    def get_name(self):
        "Returns the name of the instance."
        return self.name

instance_of_a = A('sample_instance')


class B(A):
    """This is the B class.
    It is derived from A.
    """

    # This method is not part of A.
    def do_something(self):
        """Does some work"""

    def get_name(self):
        "Overrides version from A"
        return 'B(' + self.name + ')'