# 命名规则 + assert 断言
# pytest 不需要配置，只有两条规则记住：
# ① 测试文件命名：test_xxx.py 或 xxx_test.py
# ② 测试函数命名：以 test_ 开头
# math_utils.py
# 数学工具模块：封装加减、除法基础运算函数

def add(a: int, b: int) -> int:
    """
    两个整数相加
    :param a: 第一个整数
    :param b: 第二个整数
    :return: 两数相加的结果
    """
    return a + b


def divide(a: float, b: float) -> float:
    """
    两数除法运算
    :param a: 被除数
    :param b: 除数
    :return: 除法计算结果
    :raises ValueError: 当除数 b 为 0 时，抛出数值异常
    """
    # 判断除数是否为0，除零属于非法运算
    if b == 0:
        raise ValueError("除数不能为零")
    return a / b

# test_math_utils.py
# 单元测试文件：针对 math_utils 数学工具函数编写测试用例
from math_utils import add, divide
import pytest


def test_add_normal():
    """测试加法函数：正常正整数相加场景"""
    # 断言：预期 add(1, 2) 的结果等于 3
    assert add(1, 2) == 3


def test_add_negative():
    """测试加法函数：负数相加场景"""
    # 断言：两个负数相加结果是否符合预期
    assert add(-1, -2) == -3


def test_divide_normal():
    """测试除法函数：正常合法除法场景"""
    assert divide(10, 2) == 5.0


def test_divide_by_zero():
    """测试除法函数：除数为0的异常场景"""
    # pytest.raises：断言代码块内会抛出指定类型异常（ValueError）
    # 若执行 divide(10, 0) 没有抛异常，测试直接失败
    with pytest.raises(ValueError):
        divide(10, 0)

# 运行指定测试文件，-v 表示输出详细执行日志（展示每个用例的执行结果）
# pytest test_math_utils.py -v