Pythonにおけるユニットテスト：ドキュメントとコメントの効果的な活用

import unittest

# テスト対象の関数
def add(a, b):
    """引数aとbを足して返す"""
    return a + b

# テストケースのクラス
class TestAdd(unittest.TestCase):
    """add関数のテストケース"""

    def test_add_positive_numbers(self):
        """正の数を足すケース"""
        self.assertEqual(add(2, 3), 5)

    def test_add_negative_numbers(self):
        """負の数を足すケース"""
        self.assertEqual(add(-1, -1), -2)

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

# テスト対象の関数
def divide(a, b):
    """引数aをbで割る。bが0の場合はNoneを返す"""
    if b == 0:
        return None
    return a / b

# テストケースのクラス
class TestDivide(unittest.TestCase):
    """divide関数のテストケース"""

    def test_divide_by_non_zero(self):
        """0以外で割るケース"""
        self.assertEqual(divide(4, 2), 2)

    def test_divide_by_zero(self):
        """0で割るケース"""
        self.assertIsNone(divide(4, 0))

# テスト対象の関数
def sqrt(x):
    """引数xの平方根を求める。xが負の場合はValueErrorを投げる"""
    if x < 0:
        raise ValueError("x must be non-negative")
    return x ** 0.5
# テストケースのクラス
class TestSqrt(unittest.TestCase):
    """sqrt関数のテストケース"""
    def test_sqrt_positive(self):
        """正の数の平方根を求めるケース"""
        self.assertEqual(sqrt(4), 2)
    def test_sqrt_negative(self):
        """負の数の平方根を求めるケース"""
        with self.assertRaises(ValueError):
            sqrt(-1)