用 Eclipse 和 Ant 进行 Python 开发

8:　　
9:　　　
10:　　　　
11:　　　
12:　　 字串2
13:　

　　从对上述 pydoc 目标的解析可看出，第 7 行声明了目标名称，并指出它依赖于 init 和 compile 目标。这意味着在运行 pydoc 目标之前，Ant 必须保证 init 和 compile 目标已经运行，如果没有，则首先运行这两个目标。

　　pydoc 目标所依赖的 init 目标在第 3 至第 5 行定义。 init 目标仅仅创建了一个存放 PyDoc API 文档文件的目录。如前所述，要为所生成文档的保存位置定义一个属性，名为 pydoc.dir。

　　第 8 行开始是 py-doc 任务。如前所述，您传入生成 pydoc 过程中所使用的 PYTHONPATH 。 destdir 属性告诉 py-doc 任务将生成的 HTML 文档输出到何处。

字串4

　　第 9 至第 11 行定义了在生成文档的过程中应该处理哪些 Python 源文件。文件集是 Ant 脚本中通用的结构，可用于定义所操作的一组文件。这是一种很强大的特性，它使您能够通过名字模式、布尔逻辑和文件属性来选择所要操作的文件。Ant 文档中有这方面的完整描述。本例中递归选择了“src”目录下的所有文件。

字串7

　　Python 单元测试任务 字串4

　　Python 中具有标准的单元测试框架（从 Python 2.3 开始。在 Python 2.2 中这只是可选模块），与 Java jUnit 框架十分类似。测试用例的结构与 jUnit 采用相同的方式。每一个待测试的类和模块通常都具有自己的测试类。测试类中包含测试装置（fixture），它们在 setUp 函数中初始化。每一个测试都编写为测试类中的一个独立的测试函数。unittest 框架会在测试函数之间循环往复，先调用 setUp 、再测试函数、然后清除（ tearDown ）测试函数。请参阅清单 4 中的样例。

字串4

　　清单 4. Python 单元测试模块 字串3

import unittest
from pprint import pprint
import feedparser
class FeedparserTest(unittest.TestCase):
　　"""
　　A test class for the feedparser module.
　　"""
　　
　　def setUp(self):
　　　　"""
　　　　set up data used in the tests.
　　　　setUp is called before each test function execution.
　　　　"""
　　　　self.developerWorksUrl = "testData/developerworks.rss"　　　
　　def testParse09Rss(self):
　　　　"""
　　　　Test a successful run of the parse function for a
　　　　0.91 RSS feed.
　　　　"""
　　　　print "FeedparserTest.testParse09RSS()"
　　　　
　　　　result = feedparser.parse(self.developerWorksUrl)
　　　　pprint(result)
　　　　self.assertEqual(0, result['bozo'])
　　　　
　　　　self.assert_(result is not None)
　　　　channel = result['channel']
　　　　self.assert_(channel is not None)

字串2

　　　　chanDesc = channel['description']
　　　　self.assertEqual(u'The latest content from IBM developerWorks',
　　　　　　chanDesc)
　　　　
　　　　items = result['items']
　　　　self.assert_(items is not None)
　　　　self.assert_(len(items)> 3)
　　　　firstItem = items[0]
　　　　title = firstItem['title']
　　　　self.assertEqual(u'Build installation packages with
　　　　　　solution installation and deployment technologies',
　　　　　　title)
　
　　def tearDown(self):
　　　　"""
　　　　tear down any data used in tests
　　　　tearDown is called after each test function execution.
　　　　"""
　　　　pass
　　　　　　　　
if __name__ == '__main__':
　　unittest.main()

　　上述清单是实现 feedparser 模块基本测试功能的测试类。完整的测试类见 feedParserTest 项目下的 src/feedparserTest/FeedparserTest.py。 setUp 函数负责准备整个测试过程中需要使用的测试装置，在本例中只有测试用的 RSS 文件的目录，测试函数将对其进行解析。 testParse09Rss 是真正的测试函数。这个函数调用 feedparser.parse 函数，传递测试用的 RSS 文件，输出解析结果，并通过 TestCase 类的 assert 函数执行基本的检查统作。如果任何 assert 的求值结果不是真，或是在执行过程中抛出任何异常，unittest 就会报告一次测试失败或错误。最后的两行负责在这个测试类内部运行测试，方法是直接运行该模块即可。 字串9

　　要独立运行该测试类，可以按前面所说的相同方式运行 FeedparserTest.py 模块。在 Eclipse Navigator 视图中选择 FeedparserTest.py，然后通过 Python > Run 运行。此时显示启动配置窗口。除 Base 目录之外，其他都保持缺省值即可。Base 目录必须是 feedParserTest 项目的目录，这样才能在当前目录下找到 RSS 文件（testData/developerworks.rss）。修改 base 目录的设置，然后点击“Run”。输出信息显示在 Console 上。

字串5

　　您也许希望我们编写的所有单元测试都能够作为构建的一部分自动执行。将下面清单 5 所示的构建片断加入构建脚本便可实现。

　　清单 5. 执行单元测试的构建脚本片断 字串1

1:　
2:　　
3:　　　　
4:　　　　
5:　　　
6:　　　 字串2
7:　

字串7

字串2

　　第一行是目标声明，这与其他的脚本相同。第 2 至第 6 行调用 py-test 任务。这部分代码将在“src”目录下查找所有以“Test.py”结尾的所有文件，并运行所有测试。 PYTHONPATH 设置为“src”，测试执行的当前工作目录就是当前目录（‘.’）。