nose.tools を使う¶

はじめに¶

nose には、簡単にテストするための機能が用意されています。

機能は、 nose.tools パッケージにまとまっています。

nose.tools を一通り使えば、ある程度のテストはこなせるようになります。

いくつかの機能は、前回までに出ていますが、あらためて書いてあります。

ok_(expr, msg=None)

expr が True かどうかを評価します。 msg がある場合は、テスト結果に出力します。

eq_(a, b, msg=None)

a と b が等しいかどうかを評価します。 msg がある場合は、テスト結果に出力します。

@raises(TypeError)
def raise_test():
  raise TypeError("This test passes")

@raises(TypeError, ValueError)
def raise_test():
  pass

テスト関数に期待する値が、例外の場合に使用します。

raises デコレータは、値を複数持てます。

@timed(.1)
def time_test():
  import time
  time.sleep(.5)

テスト実行に制限時間を持たせる場合に使用します。

timed で指定した時間を越えた場合は、テスト失敗になります。

@with_setup(setup=x_setup, teardown=x_teardown)
def x_test():
  pass

テストごとに setup と teardown を実行させる場合に使用します。

パッケージレベル、モジュールレベルの setup/teardown は実行されます。

@istest
def skip():
  pass

テストと見なされない関数をテストとして実行させる場合に使用します。

@nottest
def skip_test():
  pass

テストをスキップさせたい場合に使用します。

動作確認用のモジュール

例題3 nose.tools を使う。

ex3_test.ex3_test()[source]¶: nose.tools.with_setup : テストごとに、setup/teardown を実行します。

ex3_test.except_test(*arg, **kw)[source]¶: nose.tools.raises : テスト関数に期待する値が、例外の場合に使用します。

ex3_test.run_test()[source]¶: nose.tools.nottest : 通常は実行されますが、テストしません。 ** run_test は、表示されません。**

ex3_test.time_test(*arg, **kw)[source]¶: nose.tools.timed : テスト実行の制限時間を設定します。このテストは失敗します。