可爱的 Python: pydoc 和 distutils 模块

核心提示： pydoc 模块利用了 Python 文档的约定，又使用了一些有关 Python 导入、继承和其它类似的实用知识，可爱的 Python: pydoc 和 distutils 模块(3)，此外， pydoc 有绝对的天赋可以使自己在不同的操作模式下被使用（马上就能看到更多有关这个论点的资料）

pydoc 模块利用了 Python 文档的约定，又使用了一些有关 Python 导入、继承和其它类似的实用知识。此外， pydoc 有绝对的天赋可以使自己在不同的操作模式下被使用（马上就能看到更多有关这个论点的资料）。让我们用一些时间，看看通过 OS 命令行调用的 manpage 风格的用法。

假设您已将上述模块 mymod 安装在您的系统上，但不知道它有什么用处（在示例中并不多）。您可以阅读源代码，不过更简单的方法可能是：

清单 2：获取‘manpage’风格的文档

% pydoc.py mymod
Python Library Documentation: module mymod
NAME
　　mymod - Show off features of [pydoc] module
FILE
　　/articles/scratch/cp18/mymod.py
DESCRIPTION
　　This is a silly module to
　　demonstrate docstrings
CLASSES
　　MyClass
　　class MyClass
　　 |　Demonstrate class docstrings
　　 |
　　 |　__init__(self, spam=1, eggs=2)
　　 |　　　Set default attribute values only
　　 |
　　 |　　　Keyword arguments:
　　 |　　　spam ― a processed meat product
　　 |　　　eggs ― a fine breakfast for lumberjacks
DATA
　　__author__ = 'David Mertz'
　　__file__ = './mymod.pyc'
　　__name__ = 'mymod'
　　__nonsense__ = 'jabberwocky'
　　__version__ = '1.0'
VERSION
　　1.0
AUTHOR
　　David Mertz

根据特定的平台和安装过程，上述样本可能会显示在一个允许滚屏、搜索等功能并突出显示某些关键字的文本查看器中。对于像这样简单的示例，只是比纯粹的阅读源代码好一点。但请考虑一下像下面这样简单的示例：