tl.testing

tl.testing提供了各種實用工具，可以編寫測試時使用＆NBSP;它是兼容的Python版本2.6和2.7。
目錄和文件的沙箱
當測試獲得修改的目錄和文件的代碼，它是能夠容易地創建和檢查的目錄和文件的樣本樹是有用的。該tl.testing.fs模塊，提供了從文字描述創建一棵樹，它列出了相同的格式和後自行清理的支持。
在一個文檔的測試，這些設施可用於這樣的創建和列出目錄，文件和符號鏈接：
>>>從tl.testing.fs進口new_sandbox，LS
>>> new_sandbox（“”“
.... D FOO
... F FOO /條ASDF
... L巴茲 - >富/酒吧
......“”“）
>>> LS（）
升巴茲 - >富/酒吧
ðFOO
˚F富/酒吧ASDF
看到進一步的建議，包括如何設置和拆除使用文件系統沙箱測試的源代碼中找到的文件fs.txt。
安裝腳本調用
有些功能人們可能希望測試利用外部程序，如尋呼機或文本編輯器。該tl.testing.script模塊提供了在代碼進行測試會發現他們的地方安裝簡單的模擬腳本實用程序。他們採取的Python代碼字符串，並創建設置python路徑以匹配測試和運行代碼的包裝腳本。
這是怎麼這麼模擬腳本可能在文檔測試中使用：
>>>從tl.testing.script進口安裝
>>> script_path =安裝（“打印”一個簡單的腳本。“）
>>>打印開（script_path）.read（）
＃！...

進口SYS
的sys.path [：] = [...]

打印“一個簡單的腳本。”
>>>導入子
>>>分= subprocess.Popen（script_path，殼=真正的，標準輸出= subprocess.PIPE）
>>>標準輸出，標準錯誤= sub.communicate（）
>>>打印標準輸出
一個簡單的腳本。
看到並使用模擬腳本進一步的可能性如何安裝接入模擬腳本以及如何推倒測試的源代碼中找到的文件script.txt。
DOC-測試開羅表面的圖形內容
雖然它是直著比較在Python代碼的兩個開羅表面的內容，處理圖形超出文檔測試。然而，曼努埃爾包可用於從一個文本文檔，同時允許將它們混合使用文檔測試以自然的方式來提取更一般的測試用例。
該tl.testing.cairo模塊提供了一個使用曼努埃爾執行制定的重組文本數字圖形測試一個測試套件工廠。這樣一個數字的標題應該是它的值是一個開羅表面文字Python表達式，它的形象被用作測試的期望。
這是怎樣一個表面可能會比在文檔測試預期圖像：
>>>進口開羅
>>>從通過pkg_resources進口resource_filename
>>>圖像= resource_filename（'tl.testing'，'testimages / correct.png'）
。圖:: TL /測試/ testimages / correct.png
＆NBSP;``cairo.ImageSurface.create_from_png（圖片）``
看到進一步的建議和可能的測試輸出文檔的源代碼中找到的文件cairo.txt。
與線程工作在測試代碼
該標準的TestCase類沒有收集發生在其他線程不是主要的一個錯誤和失敗。該tl.testing.thread模塊提供了線程類和ThreadAwareTestCase類，允許這一點，還有一些其他的便利為處理的線程測試：防止螺紋預計未處理的異常被打印的測試輸出，報告主題留下經測試，在一個守護線程中運行的代碼，連接螺紋和計數測試期間的運行時間線程開始：
>>>導入時間
>>>進口tl.testing.thread
>>>類SampleTest（tl.testing.thread.ThreadAwareTestCase）：
...
...高清test_error_in_thread_should_be_reported（個體經營）：
...與tl.testing.thread.ThreadJoiner（1）：
... self.run_in_thread（拉姆達：1/0）
...
...高清test_active_count_should_count_only_new_threads（個體經營）：
...與tl.testing.thread.ThreadJoiner（1）：
... self.run_in_thread（拉姆達：time.sleep（0.1））
... self.assertEqual（1，self.active_count（））
... self.assertEqual（0，self.active_count（））
>>>導入單元測試
>>>運行（unittest.makeSuite（SampleTest））
================================================== ====================
ERROR：test_error_in_thread_should_be_reported（__builtin __ SampleTest。）
-------------------------------------------------- --------------------
回溯（最近通話最後一個）：
＆NBSP; ...
ZeroDivisionError：整數除法或者模零
-------------------------------------------------- --------------------
跑了2測試，N.NNNs
失敗（錯誤= 1）
見thread.txt與用於ThreadAwareTestCase類的更多詳細信息的源代碼中找到的文件。
構造使用曼努埃爾測試套件
由於曼努埃爾提供除標準的文檔測試了一些強大的功能，曼努埃爾測試套件都設置略有不同標準的。該tl.testing.doctest模塊實現DocFileSuite工廠可以像標準之一，但創建一個使用曼努埃爾測試套件，並允許相關曼努埃爾一些額外的配置，其中解釋了腳註習慣使用過時的完成能力zope.testing.doctest：
>>> sample_txt =寫（“sample.txt的”“，”“
... [#footnote] _
... >>> X
1 ...
...
...... [#footnote]
... >>> X = 1
......“”“）
>>>從tl.testing.doctest進口DocFileSuite
>>>運行（DocFileSuite（sample_txt，腳註= TRUE））
-------------------------------------------------- --------------------
跑了1測試N.NNNs
行
>>> sample_txt =寫（“sample.txt的”“，”“
... ..代碼塊::蟒蛇
... X = 1
...
... >>> X
1 ...
......“”“）
>>>進口manuel.codeblock
>>>運行（DocFileSuite（sample_txt，曼努埃爾= manuel.codeblock.Manuel（）））
-------------------------------------------------- --------------------
跑了1測試N.NNNs
OK

要求：

• 在Python中