可爱的 Python: pydoc 和 distutils 模块

核心提示： 接下来该做什么呢？您可以通过名字来猜测， setup.py 其实只是普通的 Python 脚本，可爱的 Python: pydoc 和 distutils 模块(7)，所以当它运行时可以做任何事，但在大多数情况下 setup.py 会有一种相当固定的格式，虽然某些新的工具还有一些需要克服的

接下来该做什么呢？您可以通过名字来猜测， setup.py 其实只是普通的 Python 脚本，所以当它运行时可以做任何事。但在大多数情况下 setup.py 会有一种相当固定的格式。可能看上去像这样：

清单 7：最小的 setup.py 安装脚本

#!/usr/bin/env python
"""Setup script for the sample #1 module distribution:
　 single top-level pure Python module, named explicitly
　 in 'py_modules'."""
from distutils.core import setup
setup (# Distribution meta-data
　　　 name = "sample",
　　　 version = "1.0",
　　　 description = "Distutils sample distribution #1",
# Description of modules and packages in the distribution
　　　 py_modules = ['sample'],
　　　)

这里真正的工作是由导入的 distutils 实现，特别是由 setup() 函数来实现。基本上， setup() 函数采用一组包含一列需要安装的东西（除 py_modules 外还可能有 packages 或 ext_modules 或其它东西）的已命名的变量。

distutils 的魔力在于 创建模块分发包时利用安装时使用的完全相同的 setup.py 文件。一旦您 ― 模块开发者 ― 创建了一个 setup.py 脚本（也可能是‘setup.cfg’或其它扩展名）指定了需要安装的东西，创建分发包所要做的全部事情就是（下面的一步或几步）：

清单 8：创建模块分发包

% python setup.py sdist
% python setup.py bdist_wininst
% python setup.py bdist_rpm

根据您指定的特定的分发包，您将创建一个标准的归档文件（tarball 或 zip 格式文件，取决于平台类型）或者一个完整的安装程序（像上面讨论过的那样）。

把两者结合在一起

虽然我们还没有完全达到目的，但是 Python 已经逐步成为最容易使用的编程语言的一种， 而且还是最容易使用的编程 社区的一种。虽然某些新的工具还有一些需要克服的缺陷，但在普遍意义上，让 Python 对用户透明这个要求已经实现了。