UnitTestフレームワーク-アサーション

Pythonテストフレームワークは、特定の条件をテストするPythonの組み込みassert()関数を使用します。アサーションが失敗した場合、AssertionErrorが発生します。次に、テストフレームワークはテストを失敗として識別します。その他の例外はエラーとして扱われます。

次の3セットのアサーション関数がunittestモジュールで定義されています-

  • 基本的なブールアサート
  • 比較アサート
  • コレクションのアサート

基本的なアサート関数は、操作の結果がTrueかFalseかを評価します。すべてのassertメソッドはmsg 指定されている場合、失敗時のエラーメッセージとして使用される引数。

シニア番号 方法と説明
1

assertEqual(arg1, arg2, msg = None)

arg1arg2が等しいことをテストします。値が等しく比較されない場合、テストは失敗します。

2

assertNotEqual(arg1, arg2, msg = None)

arg1arg2が等しくないことをテストします。値が等しく比較される場合、テストは失敗します。

3

assertTrue(expr, msg = None)

exprが真であることをテストします。falseの場合、テストは失敗します

4

assertFalse(expr, msg = None)

exprがfalseであることをテストします。trueの場合、テストは失敗します

5

assertIs(arg1, arg2, msg = None)

arg1arg2が同じオブジェクトに評価されることをテストします。

6

assertIsNot(arg1, arg2, msg = None)

arg1arg2が同じオブジェクトに評価されないことをテストします。

7

assertIsNone(expr, msg = None)

exprがNoneであることをテストします。なしでない場合、テストは失敗します

8

assertIsNotNone(expr, msg = None)

exprがNoneではないことをテストします。なしの場合、テストは失敗します

9

assertIn(arg1, arg2, msg = None)

arg1arg2にあることをテストします。

10

assertNotIn(arg1, arg2, msg = None)

arg1arg2にないことをテストします。

11

assertIsInstance(obj, cls, msg = None)

objclsのインスタンスであることをテストします

12

assertNotIsInstance(obj, cls, msg = None)

objclsのインスタンスではないことをテストします

上記のアサーション関数の一部は、次のコードで実装されています。

import unittest

class SimpleTest(unittest.TestCase):
   def test1(self):
      self.assertEqual(4 + 5,9)
   def test2(self):
      self.assertNotEqual(5 * 2,10)
   def test3(self):
      self.assertTrue(4 + 5 == 9,"The result is False")
   def test4(self):
      self.assertTrue(4 + 5 == 10,"assertion fails")
   def test5(self):
      self.assertIn(3,[1,2,3])
   def test6(self):
      self.assertNotIn(3, range(5))

if __name__ == '__main__':
   unittest.main()

上記のスクリプトを実行すると、test2、test4、test6に失敗が表示され、その他は正常に実行されます。

FAIL: test2 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "C:\Python27\SimpleTest.py", line 9, in test2
      self.assertNotEqual(5*2,10)
AssertionError: 10 == 10

FAIL: test4 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "C:\Python27\SimpleTest.py", line 13, in test4
      self.assertTrue(4+5==10,"assertion fails")
AssertionError: assertion fails

FAIL: test6 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "C:\Python27\SimpleTest.py", line 17, in test6
      self.assertNotIn(3, range(5))
AssertionError: 3 unexpectedly found in [0, 1, 2, 3, 4]

----------------------------------------------------------------------            
Ran 6 tests in 0.001s                                                             
                                                                                  
FAILED (failures = 3)

アサーション関数の2番目のセットは comparative asserts −

  • assertAlmostEqual (1番目、2番目、場所= 7、msg =なし、delta =なし)

    テストことを第一及び第二の約(またはしない略)は、小数点以下の所定数に丸める、差を計算することによって等しく場所(デフォルト7)、

  • assertNotAlmostEqual (1番目、2番目、場所、メッセージ、デルタ)

    差を計算し、指定された小数点以下の桁数(デフォルトは7)に丸め、ゼロと比較して、1番目と2番目がほぼ等しくないことをテストします。

    上記の両方の関数で、場所の代わりにデルタが指定されている場合、1番目と2番目の差はデルタ以下(またはそれより大きい)である必要があります。

    デルタと場所の両方を指定すると、TypeErrorが発生します。

  • assertGreater (最初、2番目、msg =なし)

    メソッド名に応じて、最初2番目より大きいことをテストします。そうでない場合、テストは失敗します。

  • assertGreaterEqual (最初、2番目、msg =なし)

    メソッド名に応じて、firstsecond以上であることをテストします。そうでない場合、テストは失敗します

  • assertLess (最初、2番目、msg =なし)

    メソッド名に応じて、最初2番目未満であることをテストします。そうでない場合、テストは失敗します

  • assertLessEqual (最初、2番目、msg =なし)

    メソッド名に応じて、最初2番目以下であることをテストします。そうでない場合、テストは失敗します。

  • assertRegexpMatches (テキスト、正規表現、メッセージ=なし)

    正規表現検索がテキストと一致することをテストします。失敗した場合、エラーメッセージにはパターンとテキストが含まれます。regexpは、正規表現オブジェクト、またはでの使用に適した正規表現を含む文字列です。re.search()

  • assertNotRegexpMatches (テキスト、正規表現、メッセージ=なし)

    正規表現検索がテキストと一致しないことを確認します。パターンと一致するテキストの部分を含むエラーメッセージで失敗します。regexpは、正規表現オブジェクト、またはre.search()での使用に適した正規表現を含む文字列です。

アサーション関数は次の例で実装されています-

import unittest
import math
import re

class SimpleTest(unittest.TestCase):
   def test1(self):
      self.assertAlmostEqual(22.0/7,3.14)
   def test2(self):
      self.assertNotAlmostEqual(10.0/3,3)
   def test3(self):
      self.assertGreater(math.pi,3)
   def test4(self):
      self.assertNotRegexpMatches("Tutorials Point (I) Private Limited","Point")

if __name__ == '__main__':
   unittest.main()

上記のスクリプトは、test1とtest4を失敗として報告します。test1では、22/7の除算は3.14の小数点以下7桁以内ではありません。同様に、2番目の引数は最初の引数のテキストと一致するため、test4はAssertionErrorになります。

=====================================================FAIL: test1 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "asserttest.py", line 7, in test1
      self.assertAlmostEqual(22.0/7,3.14)
AssertionError: 3.142857142857143 != 3.14 within 7 places
================================================================
FAIL: test4 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "asserttest.py", line 13, in test4
      self.assertNotRegexpMatches("Tutorials Point (I) Private Limited","Point")
AssertionError: Regexp matched: 'Point' matches 'Point' in 'Tutorials Point (I)
Private Limited'
----------------------------------------------------------------------

Ran 4 tests in 0.001s                                                             
                                                                                  
FAILED (failures = 2)

コレクションのアサート

この一連のassert関数は、List、Tuple、Dictionary、SetなどのPythonのコレクションデータ型で使用することを目的としています。

シニア番号 方法と説明
1

assertListEqual (list1, list2, msg = None)

2つのリストが等しいことをテストします。そうでない場合は、2つの違いのみを示すエラーメッセージが作成されます。

2

assertTupleEqual (tuple1, tuple2, msg = None)

2つのタプルが等しいことをテストします。そうでない場合は、2つの違いのみを示すエラーメッセージが作成されます。

3

assertSetEqual (set1, set2, msg = None)

2つのセットが等しいことをテストします。そうでない場合は、セット間の違いをリストするエラーメッセージが作成されます。

4

assertDictEqual (expected, actual, msg = None)

2つの辞書が等しいことをテストします。そうでない場合は、辞書の違いを示すエラーメッセージが作成されます。

次の例では、上記のメソッドを実装しています-

import unittest

class SimpleTest(unittest.TestCase):
   def test1(self):
      self.assertListEqual([2,3,4], [1,2,3,4,5])
   def test2(self):
      self.assertTupleEqual((1*2,2*2,3*2), (2,4,6))
   def test3(self):
      self.assertDictEqual({1:11,2:22},{3:33,2:22,1:11})

if __name__ == '__main__':
   unittest.main()

上記の例では、test1とtest3はAssertionErrorを示しています。エラーメッセージには、リストオブジェクトとディクショナリオブジェクトの違いが表示されます。

FAIL: test1 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "asserttest.py", line 5, in test1
      self.assertListEqual([2,3,4], [1,2,3,4,5])
AssertionError: Lists differ: [2, 3, 4] != [1, 2, 3, 4, 5]

First differing element 0:
2
1

Second list contains 2 additional elements.
First extra element 3:
4

- [2, 3, 4]
+ [1, 2, 3, 4, 5]
? +++       +++

FAIL: test3 (__main__.SimpleTest)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "asserttest.py", line 9, in test3
      self.assertDictEqual({1:11,2:22},{3:33,2:22,1:11})
AssertionError: {1: 11, 2: 22} != {1: 11, 2: 22, 3: 33}
- {1: 11, 2: 22}
+ {1: 11, 2: 22, 3: 33}
?              +++++++
                                                                                  
----------------------------------------------------------------------            
Ran 3 tests in 0.001s                                                             
                                                                                  
FAILED (failures = 2)