为Python测试框架添加更多测试案例：深入理解parameterized的expand()函数

parameterized是Python测试框架中的一个模块，它允许我们使用参数化的方法来编写测试用例。其中，expand()函数是parameterized模块中的一个重要函数，它用于返回参数化的测试数据。

expand()函数的主要作用是将测试数据展开成多个测试用例，这样可以通过一次编写测试函数，同时执行多个相似的测试用例。接下来，我们将深入了解expand()函数，并给出一些使用例子。

expand()函数的基本语法如下：

parameterized.expand(iterable, name_func=None, doc_func=None)

其中，参数iterable是一个可迭代对象，它包含了一系列的参数集合。name_func和doc_func是可选参数，可以用于自定义生成测试用例的名称和文档字符串。接下来，我们将分别介绍这三个参数的用法，并给出实际的使用例子。

1. iterable参数：表示一系列的参数集合。它可以是列表、元组、集合或生成器等可迭代对象。每个元素都是一个参数集合，可以是单个值或一个列表。

# 使用列表作为参数集合
parameterized.expand([
    (1, 2, 3),
    (4, 5, 9),
    (7, 8, 15)
])

# 使用元组作为参数集合
parameterized.expand((
    (1, 2, 3),
    (4, 5, 9),
    (7, 8, 15)
))

# 使用集合作为参数集合
parameterized.expand({
    (1, 2, 3),
    (4, 5, 9),
    (7, 8, 15)
})

# 使用生成器作为参数集合
def generate_test_data():
    for i in range(1, 5):
        yield (i, i+1, 2*i+1)
        
parameterized.expand(generate_test_data())

2. name_func参数：用于自定义生成测试用例的名称。name_func是一个函数，它接受一个参数元组，并返回一个字符串作为测试用例的名称。

# 使用默认的名称生成函数
@parameterized.expand([(1, 2, 3), (4, 5, 9), (7, 8, 15)])
def test_addition(a, b, result):
    assert a + b == result

# 使用自定义的名称生成函数
def custom_name_func(param):
    return f"test_addition_{param[0]}_{param[1]}"

@parameterized.expand([(1, 2, 3), (4, 5, 9), (7, 8, 15)], name_func=custom_name_func)
def test_addition(a, b, result):
    assert a + b == result

3. doc_func参数：用于自定义生成测试用例的文档字符串。doc_func是一个函数，它接受一个参数元组，并返回一个字符串作为测试用例的文档字符串。

# 使用默认的文档字符串生成函数
@parameterized.expand([(1, 2, 3), (4, 5, 9), (7, 8, 15)])
def test_addition(a, b, result):
    """
    Test case for addition.
    """
    assert a + b == result

# 使用自定义的文档字符串生成函数
def custom_doc_func(param):
    return f"Test case for addition: {param[0]} + {param[1]} = {param[2]}"

@parameterized.expand([(1, 2, 3), (4, 5, 9), (7, 8, 15)], doc_func=custom_doc_func)
def test_addition(a, b, result):
    """
    Test case for addition.
    """
    assert a + b == result

通过深入理解expand()函数并给出使用例子，我们可以更好地掌握parameterized模块在Python测试框架中的应用。在编写测试用例时，我们可以通过参数化的方法来减少代码冗余，同时执行多个相似的测试用例，提高测试的覆盖率和效率。