一鲫寄、為什么使用nose?
- 編寫測試更容易。nose可以自動識別繼承于unittest.TestCase的測試單元,并執(zhí)行測試叁扫,而且,nose也可以測試非繼承于unittest.TestCase的測試單元畜埋。nose提供了豐富的API便于編寫測試代碼莫绣。
- 執(zhí)行測試更容易。 只要遵循一些簡單的規(guī)則去組織你的類庫和測試代碼悠鞍,nose是可以自動識別單元測試的对室。執(zhí)行測試是非常耗資源的,但是咖祭,一段第一個測試模塊被加載后掩宜,nose就開始執(zhí)行測試。
- **建立測試環(huán)境更容易么翰。 **
- 做你想做的事情更容易牺汤。 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)容格式每瞒。例如:
<pre>[nosetests] verbosity=3 with-doctest=1</pre>
三、擴(kuò)展使用
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á)的測試名稱掷酗。路徑可以是相對的路徑也可以是絕對的路徑。如下所示:
<pre>nosetests test.module
nosetests another.test:TestCase.test_method
nosetests a.test:TestCase
nosetests /path/to/test/file.py:test_function</pre>
同樣可以使用-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á)到同樣的目的。例如:
<pre>[nosetests] verbosity=3 with-doctest=1</pre>
所有查找到的配置文件將會被加載殖告,而且配置項的值會合并。如果想覆蓋標(biāo)準(zhǔn)的配置文件雳锋,使用-c選項黄绩。
3.3 使用插件
使用pip安裝所需要的插件,然后通過nosetests命令行配置插件玷过。執(zhí)行如下命令驗證所安裝的插件爽丹,
nosetests –plugins
<pre> 在命令行中添加</pre>
-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è)置配置文件庶弃∑轿可以設(shè)置很多次摹蘑,然后將所有的配置文件合并腰涧。
-w=WHERE,--where=WHERE
設(shè)置查找的根目錄梅鹦。
-py3where=WHERE
顧名思義梗肝,針對python3.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)為:
[圖片上傳中...(image-cd293d-1556365810616-7)]
為項目單獨建一個test包,里面按項目模塊分子包讼载,最后以及為 “test_”開頭的測試用例源文件轿秧。
4.2 測試結(jié)果
[圖片上傳中...(image-5cfdf9-1556365810616-6)]
4.3測試代碼
test_mymath.py中的代碼如下:
[](javascript:void(0); "復(fù)制代碼")
<pre># -- 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))</pre>
](javascript:void(0); "復(fù)制代碼")
test_logicOper.py 中的代碼如下:
[](javascript:void(0); "復(fù)制代碼")
<pre># -- coding: utf-8 --
author = 'Administrator'
from nose.tools import assert_equal from logicOperator.localOperator import *
def test_logicOper_isGreaterThan(): print("=================test_logicOper_isGreaterThan============")
result=isGreaterThan(4,3)
assert_equal(True,result)</pre>
](javascript:void(0); "復(fù)制代碼")
4.4 測試分析
(1)測試用例的收集
由于nose是按照正則表達(dá)式自動收集匹配的測試用例。我們這里收集了5個測試用例咨堤。分別了
- test_mymath.py模塊里的test_math_add函數(shù)菇篡。
- test_mymath.py模塊里的test_math3類下面的test_math_square、test_math_sub兩個函數(shù)一喘。
- test_mymath.py模塊里的test_math2類下面的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.
<pre>大體可以得出如下結(jié)論:</pre>
<pre>1)測試的順序總體上按照包—>模塊—>類的順序進(jìn)行;</pre>
<pre>2) 然后按照測試用例名稱的升序排序進(jìn)行触徐,比如test_math_multipy比test_math_square先執(zhí)行咪鲜;</pre>
<pre>3)當(dāng)測試模塊中既包含測試函數(shù),又包含測試類時撞鹉,都一定是先執(zhí)行setup(如果定義了),模塊測試執(zhí)行完畢后執(zhí)行teardown(如果定義了)疟丙。而且模塊的setup颖侄、setdown只執(zhí)行一次。</pre>
<pre>4)測試類中的每個測試方法執(zhí)行前先執(zhí)行setup(如果定義了),執(zhí)行完畢后執(zhí)行teardown(如果定義了)享郊。而且每個測試方法的執(zhí)行過程都是如此览祖,新的方法重新按setup—>執(zhí)行方法—>teardown的順序執(zhí)行。</pre>
(3)關(guān)于setup 炊琉、teardown
package展蒂、module、class都可以設(shè)置setup苔咪、teardown锰悼。
1)package的setup 、teardown的設(shè)置
放在__init__.py文件中团赏,在整個測試的運行期間只運行一次箕般。
setup函數(shù)的取名可以是 <cite>setup</cite>, <cite>setup_package</cite>, <cite>setUp</cite>, <cite>setUpPackage**中的一個。 **</cite>
<cite> teardown 函數(shù)取名可以是t<cite>eardown</cite>, <cite>teardown_package</cite>, <cite>tearDown</cite> or <cite>tearDownPackage中的一個舔清。</cite></cite>
2) module的setup 丝里、teardown的設(shè)置
在整個測試的運行期間只運行一次。
setup函數(shù)的取名可以是 <cite><cite>setup</cite>, <cite>setup_module</cite>, <cite>setUp</cite> or <cite>setUpModule</cite></cite><cite>**中的一個体谒。 **</cite>
<cite> teardown 函數(shù)取名可以是<cite>teardown_module</cite>, or <cite>tearDownModule</cite><cite>中的一個杯聚。</cite></cite>
3)class的setup 、teardown的設(shè)置
每個測試方法執(zhí)行時都會調(diào)用抒痒。
setup函數(shù)的取名可以是<cite>setup_class</cite>, <cite>setupClass</cite>, <cite>setUpClass</cite>, <cite>setupAll</cite> ,<cite>setUpAll</cite><cite>**中的一個幌绍。 **</cite>
teardown 函數(shù)取名可以是<cite>teardown_class</cite>, <cite>teardownClass</cite>, <cite>tearDownClass</cite>, <cite>teardownAll</cite> ,<cite>tearDownAll</cite><cite>中的一個。</cite>
<cite> 測試類可以繼承unittest.TestCase 评汰,也可以不繼承纷捞,nose都能識別痢虹。</cite>
4)測試方法的setup被去、teardown
可以通過with_setup裝飾器進(jìn)行設(shè)置,比如
[圖片上傳中...(image-fbc60d-1556365810615-4)]
總之奖唯,nose的口號是:nose extends unittest to make testing easier(測試更簡單).