在Python解释器上运行help(list)的输出。
帮助功能实际上是使用 pydoc 模块生成其输出，它也可以从命令行运行，以产生您路径中任何可导入模块的文本或 html 表示。
不久以前，我需要编写更细致，更正式的设计文档。而作为一个 Markdown 的粉丝，我决定玩一玩mkdocs，看看是否能获得我想要的结果。这个模块可以很容易地将你的 markdown 文档转化为一个样式美观的页面，并且，在发布为官方文档之前，允许你对其做更改。它提供了一个 readthedocs 模板，深圳还提供了一个简单的命令行界面，来把你的修改推送到 GitHub Pages 里面。
在完成了我最初的描述设计决策和注意事项的文本后，我想加上一些细节，描述我正在开发的实际接口方法。因为我已经为大部分的功能写了定义，我想从源代码自动生成参考页面，还希望这个能在 markdown 里面。这样的话，只要我想跑 mkdocs，它就可以连同我文档的其余部分，一起渲染成 html。
然而，事实上还没有一种从源码生成 markdown 的默认方式，除了一些插件。后来，我不断在谷歌上查询，我还是不满意我发现的插件——很多东西都过时了，没有人维护了，或者输出的东西不是我需要的——因此，我决定写一个我自己的项目。我认为这很有意思，这也让我学到了更多关于构建和调试一个模块的知识，更多内容可以查看我之前的文章（ 设计一个简单的图形 Python 调试器 ）：inspect 模块。
“inspect 模块提供了几个有用的函数来帮助我们获取生存着的对象信息... ” — Python 文档
检查！
Inspect，源自于标准程序库，它不仅允许你查看较低级别的 python 框架和代码对象，它还提供很多方法来检查模块和类，帮你发现可能感兴趣的的项目。这个也就是之前提到的用来生成帮助文件的 pydoc。
浏览一下在线文档，你会发现许多跟我们所做的尝试相关的方法。最重要的几个是getmembers()，getdoc() 和 signature()，还有许多给 getmembers 做滤波器的 is... 功能。拥有这些，我们可以轻易地循环访问很多功能，包括区分生成器和协同程序，并可以按需要递归到任何一个类以及内部。
导入编码
如果我们要去检查一个对象，不管它是什么，第一步要做的是提供一个导入进我们的命名空间的原理。为何要讨论导入呢？这取决于你想要做什么，还有很多需要担心的，包括虚拟环境，自定义代码，标准模块和重命名。情况会容易混淆，搞错的话会需要一些时间去整理清楚。