如何正確認識Python 源文件
使用Python 源文件在構建腳本的底部,可以定義 compile 目標,Python 源文件內在元素是 compile 運行期間執(zhí)行的任務,特別的是 py-compile 任務,它負責從 src 目錄開始,編譯所有的 Python 代碼。
該任務會遞歸遍歷所有的子目錄,并編譯所有的 Python 模塊。腳本中沒有采用將 src 目錄硬編碼到調用之處的方式,而是在構建腳本中定義了稱為 src.dir 的屬性。然后,在需要使用這個目錄名的時候。
就可以通過 ${src.dir} 來引用。 要運行構建腳本,可從 Eclipse 中打開它。Eclipse 具有內置的 Ant 構建腳本編輯和瀏覽功能。Outline 視圖可以顯示出構建腳本的結構。在 Navigator 視圖中。
選擇該構建腳本,用右鍵點擊,然后選擇“Run Ant...”。選擇 compile 目標,然后點擊“Run”。構建腳本執(zhí)行過程中的輸出信息應該顯示在 Console 視圖中,表示運行成功。 從對上述 pydoc 目標的解析可看出。#t#
第 7 行聲明了目標名稱,并指出它依賴于 init 和 compile 目標。這意味著在運行 pydoc 目標之前,Ant 必須保證 init 和 compile 目標已經運行,如果沒有,則首先運行這兩個目標。
pydoc 目標所依賴的 init 目標在第 3 至第 5 行定義。 init 目標僅僅創(chuàng)建了一個存放 PyDoc API 文檔文件的目錄。如前所述,要為所生成文檔的保存位置定義一個屬性,名為 pydoc.dir。
第 8 行開始是 py-doc 任務。如前所述,您傳入生成 pydoc 過程中所使用的 PYTHONPATH 。 destdir 屬性告訴 py-doc 任務將生成的 HTML 文檔輸出到何處。 第 9 至第 11 行定義了在生成文檔的過程中應該處理哪些 Python 源文件。文件集是 Ant 腳本中通用的結構。
可用于定義所操作的一組文件。這是一種很強大的特性,它使您能夠通過名字模式、布爾邏輯和文件屬性來選擇所要操作的文件。Ant 文檔中有這方面的完整描述。本例中遞歸選擇了“src”目錄下的所有文件。
Python 源文件中具有標準的單元測試框架(從 Python 2.3 開始。在 Python 2.2 中這只是可選模塊),與 Java jUnit 框架十分類似。測試用例的結構與 jUnit 采用相同的方式。每一個待測試的類和模塊通常都具有自己的測試類。測試類中包含測試裝置(fixture)。
它們在 setUp 函數中初始化。每一個測試都編寫為測試類中的一個獨立的測試函數。unittest 框架會在測試函數之間循環(huán)往復,先調用 setUp 、再測試函數、然后清除( tearDown )測試函數。請參閱清單 4 中的樣例。
- 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)
- 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。step 函數負責準備整個測試過程中需要使用的測試裝置,在本例中只有測試用的 RSS 文件的目錄。
測試函數將對其進行解析。testParse09Rss 是真正的測試函數。Python 源文件這個函數調用 feedparser.parse 函數,傳遞測試用的 RSS 文件,輸出解析結果,并通過 TestCase 類的 assert 函數執(zhí)行基本的檢查統(tǒng)作。
如果任何 assert 的求值結果不是真,或是在執(zhí)行過程中拋出任何異常,unittest 就會報告一次測試失敗或錯誤。***的兩行負責在這個測試類內部運行測試,方法是直接運行該模塊即可。