作者：廖飛

全文約 7778 字，讀完可能需要 15 分鐘。

原文鏈接：http://www.cnblogs.com/liaofeifight/

一、為什么使用 nose ?

1. 編寫測試更容易。

   nose 可以自動識別繼承于 unittest.TestCase 的測試單元，并執(zhí)行測試，而且， nose 也可以測試非繼承于 unittest.TestCase 的測試單元。 nose 提供了豐富的 API 便于編寫測試代碼。

   
   

2. 執(zhí)行測試更容易。

   只要遵循一些簡單的規(guī)則去組織你的類庫和測試代碼， nose 是可以自動識別單元測試的。執(zhí)行測試是非常耗資源的，但是，一段第一個測試模塊被加載后， nose 就開始執(zhí)行測試。

   
   

3. 建立測試環(huán)境更容易。

4. 做你想做的事情更容易。

   
   

   nose 擁有很多內(nèi)置的插件幫助進(jìn)行輸出抓取、錯誤查找、代碼覆蓋、文檔測試（ doctest ）等等。同樣，如果你不喜歡這些內(nèi)置插件提供的功能或者這些插件不能滿足你的項目結(jié)構(gòu)，你可以自定義開發(fā)插件來完成你想要做的事情。

二、基本使用

安裝： pip install ?nose

腳本命令：

nosetests [options] ?[( optional) test files ?or directories]

除了使用命令行這種方式之外，還可以在根目錄下放置配置文件，配置文件的類型為 .noserc 或 nose.cfg 文件。配置文件都是標(biāo)準(zhǔn)的 ini 內(nèi)容格式。例如：

三、擴展使用

nose 自動收集單元測試，收集它當(dāng)前工作目錄下的源代碼文件、目錄以及包。任何的源代碼文件、目錄或者包只要匹配正則表達(dá)式，他們就會被自動收集。包的測試收集按照樹的層級級別一級一級進(jìn)行，因此 package.tests 、 package.sub.tests 、 package.sub.sub2.tests 將會被收集。

匹配成功的包、任何 python 的源文件都會當(dāng)做測試用例。

3.1 選擇測試用例

將需要測試的名稱傳遞給 nose 的命令行。格式如下：

nosetests only_test_this.py

測試的名稱可以是腳本文件的名稱或者模塊的名稱，也可以使用 colon 表達(dá)式表達(dá)的測試名稱。路徑可以是相對的路徑也可以是絕對的路徑。如下所示：

同樣可以使用—— w 開關(guān)來切換當(dāng)前的工作路徑，從而改變 nose 查找測試用例的根路徑。用法如下：

nosetests -w /path/to/tests

更多關(guān)于自定義測試用例的收集與加載方式，可以使用插件的方式做到。

3.2 配置

除了3.1通過腳本命令傳遞參數(shù)的方式外，你還可以在根目錄下通過設(shè)置 setup.cfg 或者 .noserc 或者 nose.cfg 等配置文件達(dá)到同樣的目的。例如：

所有查找到的配置文件將會被加載，而且配置項的值會合并。如果想覆蓋標(biāo)準(zhǔn)的配置文件，使用—— c 選項。

3.3 使用插件

使用 pip 安裝所需要的插件，然后通過 nosetests 命令行配置插件。執(zhí)行如下命令驗證所安裝的插件:

nosetests - plugins

在命令行中添加 -v 或者 -vv 選項可以顯示每一個插件的更多信息。?如果通過 nose.main() 或者 nose.run() 執(zhí)行測試，可以將要使用的插件關(guān)鍵字參數(shù)的列表傳遞進(jìn)去。

3.4 配置選項

• V ,— version

輸出 nose 的版本

• p ,— plugins

輸出可獲取的插件列表。

• v = DEFUALT ,— verbose = DEFAULT

使用更多的 verbose

— verbosity = VERBOSITY

設(shè)置 verbosity ;— verbosity =2與—— v 設(shè)置一致

• q ,— quiet = DEFAULT

使用更少的 verbose

• c = FILES ,— config = FILES

設(shè)置配置文件?？梢栽O(shè)置很多次，然后將所有的配置文件合并。

• w = WHERE ,— where = WHERE

設(shè)置查找的根目錄。

• py 3 where = WHERE

顧名思義，針對 python 3. x 以上設(shè)置查找路徑。

• m = REGEX ,— match = REGEX ,— testmatch = REGEX

設(shè)置用于自動化收集用例的正則表達(dá)式。

— tests = NAMES

執(zhí)行這些測試。

— debug - log = FILE

設(shè)置調(diào)試的日志文件路徑。

— logging - config = FILE ,— log - config = FILE

設(shè)置日志文件的配置文件。

• I = REGEX ，— ignore - files = REGEX

設(shè)置自動收集測試用例時忽略的正則表達(dá)式。

• e = REGEX ,— exclude = REGEX

排除要執(zhí)行的測試用例的正則表達(dá)式

• i = REGEX ,— include = REGEX

包含要執(zhí)行的測試用例的正則表達(dá)式

• x ,— stop

執(zhí)行測試發(fā)生錯誤后，停止執(zhí)行測試。

— noexe

不查找可以執(zhí)行文件。

• a = ATTR ,— attr = ATTR

只執(zhí)行包含 ATTR 屬性的測試用例。

• A = EXPR ,— eval - attr = EXPR

只執(zhí)行屬性與 EXPR 匹配的測試用例。

• s ,— nocapture

不抓取標(biāo)準(zhǔn)輸出 \ ( stdout\ )

— nologcapture

禁止使用日志插件

— logging - format = FORMAT

打印語句的自定義格式

— logging - datefmt = FORMAT

日志的日期時間格式

— logging - filter = FILTER

日志語句的過濾器。

— logging - clear - handlers

清除日志的其他 handlers

— logging - level = DEFUALT

設(shè)置日志的等級

— with - coverage

開啟 coverage 插件

— cover - package = PACKAGE

限定 coverage 所在包

— cover - erase

在執(zhí)行之前 清除上次 coverage 統(tǒng)計結(jié)果

— cover - testes

在 coverage 報告中包含測試模塊

— cover - html

產(chǎn)生 html 的 coverage 報告

— cover - html - dir = DIR

設(shè)置存儲 html 的目錄

— cover - xml

產(chǎn)生 xml 的 coverage 報告

— cover - xml - file = FILE

設(shè)置存儲 coverage 報告的 xml 文件

— cover - config - file = DEFUALT

設(shè)置 coverage 的配置文件

• pdb

當(dāng)測試失敗或產(chǎn)生錯誤是進(jìn)入調(diào)試模式

— pdb - failures

當(dāng)測試失敗時進(jìn)入調(diào)試模式

— pdb - errors

當(dāng)測試產(chǎn)生錯誤時進(jìn)入調(diào)試模式

— with - doctest

開啟 doctest 插件

— doctest - tests

在測試模塊中查詢 doctests

— with - profile

開啟 profile 插件

— profile - sort = SORT

設(shè)置 profiler 輸出排序

— profile - stats - file = FILE

設(shè)置統(tǒng)計所在的文件地址

— with - id

開啟 TestId 插件

— processes = NUM

開始測試處理器的個數(shù)

— processes - timeout = SECONDS

設(shè)置超時時間。

— with - xuint

開始 Xunit 插件

— xuint - file = FILE

設(shè)置 XUnit 報告所在的 xml 文件

— all - modules

開啟 AllModules 插件

— collect - only

開啟只收集測試功能。只收集測試用例及輸出測試名字，而不執(zhí)行測試

四、編寫測試用例

4.1 項目組織結(jié)構(gòu)

由于 nose 是自動收集測試用例的，只有 nose 執(zhí)行的測試目錄下的源代碼文件、包名、子目錄名跟正則表達(dá)式匹配成功后，才能被收集。而且代碼是樹級層次顯示的話， nose 會逐級向下查找子目錄下的匹配的測試用例。

匹配的正則表達(dá)式默認(rèn)值為： ( (?: ^ | [\b_\. - ] ) [Tt]est. 所以最好是以 Test 開頭，或者 test 開頭。當(dāng)然也可以修改默認(rèn)的匹配的正則表達(dá)式。

所以，推薦的項目結(jié)構(gòu)為：

為項目單獨建一個 test 包，里面按項目模塊分子包，最后以及為 "test_" 開頭的測試用例源文件。

4.2 測試結(jié)果

4.3測試代碼

test_mymath.py 中的代碼如下：

# -*- coding: utf-8 -*-
__author__ = 'Administrator'
from nose.tools import assert_equal
from nose.tools import with_setup
 
import ?unittest
import mymath.math as mmath

def setUp(): ? ?
????print("============test math module setup==============")

def teardown(): ? ?
? ? print("============test math module teardown==============")

def test_math_add():
? ? result=mmath.add(4, 5) ? ?
? ? print("================test_math_add============")
 ? ?assert_equal(10, result)

class test_math3(): ? ?
? ? def setUp(self): ? ? ? ?
? ? ? ? print("============test math class setup==============")
? ??def teardown(self): ? ? ? ?
????????print("============test math class teardown==============") ? ?
????def test_math_square(self): ? ? ? ?
????????print("=============== test_math_square================ ")
 ? ? ? ?assert_equal(9, mmath.square(3)) ? ?
????def test_math_sub(self): ? ? ? ?
????????print("=============== test_math_sub================ ")
 ? ? ? ?assert_equal(1, mmath.sub(3, 2))

class test_math2(unittest.TestCase): ? ?
????def test_math_multipy(self): ? ? ? ?
????????print("=============== test_math_multipy================ ")
 ? ? ? ?assert_equal(8, mmath.multiply(2, 4))

test_logicOper.py 中的代碼如下：

4.4 測試分析

（1）測試用例的收集

由于 nose 是按照正則表達(dá)式自動收集匹配的測試用例。我們這里收集了5個測試用例。分別了

• test_mymath.py 模塊里的 test_math_add 函數(shù)。

• test_mymath.py 模塊里的 test_math 3類下面的 test_math_square 、 test_math_sub 兩個函數(shù)。

• test_mymath.py 模塊里的 test_math 2類下面的 test_math_multipy 函數(shù)。

• test_logicOper.py 模塊里的 test_logicOper_isGreaterThan 函數(shù)。

（2）測試的運行順序。

從下圖打印輸出的結(jié)果可以看出。收集的測試用例的執(zhí)行順序：

test_logicOper_isGreaterThan—>test_mymath(模塊).setup—>test_math2(類).test_math_multipy—>test_math3(類).setup—>test_math3(類).test_math_square—>?test_math3(類).teardown—>test_math3(類).setup—>test_math3(類).test_math_sub—>test_math3(類).teardown—>test_mymath(模塊).test_math_add—>test_mymath(模塊).teardown.

大體可以得出如下結(jié)論：

1）測試的順序總體上按照包—>模塊—>類的順序進(jìn)行；

2) 然后按照測試用例名稱的升序排序進(jìn)行，比如test_math_multipy比test_math_square先執(zhí)行；

3）當(dāng)測試模塊中既包含測試函數(shù)，又包含測試類時，都一定是先執(zhí)行setup(如果定義了),模塊測試執(zhí)行完畢后執(zhí)行teardown（如果定義了)。而且模塊的setup、setdown只執(zhí)行一次。

4）測試類中的每個測試方法執(zhí)行前先執(zhí)行setup(如果定義了),執(zhí)行完畢后執(zhí)行teardown（如果定義了)。而且每個測試方法的執(zhí)行過程都是如此，新的方法重新按setup—>執(zhí)行方法—>teardown的順序執(zhí)行

（3）關(guān)于 setup 、 teardown

package 、 module 、 class 都可以設(shè)置 setup 、 teardown 。

1） package 的 setup 、 teardown 的設(shè)置

放在 __init__.py 文件中，在整個測試的運行期間只運行一次。

setup 函數(shù)的取名可以是 setup , setup_package , setUp , setUpPackage 中的一個。

teardown 函數(shù)取名可以是 teardown , teardown_package , tearDown or ?tearDownPackage 中的一個。

2） module 的 setup 、 teardown 的設(shè)置

在整個測試的運行期間只運行一次。

setup 函數(shù)的取名可以是 setup , setup_module , setUp or ?setUpModule 中的一個。

teardown 函數(shù)取名可以是 teardown_module , or tearDownModule 中的一個。

3） class 的 setup 、 teardown 的設(shè)置

每個測試方法執(zhí)行時都會調(diào)用。

setup 函數(shù)的取名可以是 setup_class , setupClass , setUpClass , setupAll , setUpAll 中的一個。

teardown 函數(shù)取名可以是 teardown_class , teardownClass , tearDownClass , teardownAll
, tearDownAll 中的一個。

測試類可以繼承 unittest.TestCase ，也可以不繼承， nose 都能識別。

4）測試方法的 setup 、 teardown

可以通過 with_setup 裝飾器進(jìn)行設(shè)置，比如

總之， nose 的口號是： nose extends ?unittest to ?make testing ?easier (測試更簡單 ?).


點擊閱讀原文，查看更多 Python 教程和資源