找出两个数字的和与差

本程序旨在解决以下问题：已知两个数字的和与差，求出这两个数字是多少。

函数说明

def find_two_numbers(sum: int, diff: int) -> tuple:
    """
    已知两个数字的和sum与差diff，求出这两个数字是多少。

    Args:
        sum: 两个数字的和
        diff: 两个数字的差

    Returns:
        由两个数字组成的元组，例如(7, 3)

    Raises:
        ValueError: 相关输入参数不合法
    """

使用方法

在程序中导入该函数后，即可像下面这样调用它：

result = find_two_numbers(20, 4)
print(result)  # (12, 8)

本例中，输入的两个数字的和为20，差为4。程序返回的结果表明，这两个数字分别为12和8。

实现思路

首先根据加减法的定义式列出方程组：

\begin{cases}x+y=sum\x-y=diff\end{cases}

然后通过解方程组，得出以下公式：

\begin{cases}x=\dfrac{sum+diff}{2}\y=\dfrac{sum-diff}{2}\end{cases}

因此，我们可以根据输入的sum和diff计算出x和y，并将它们组成一个元组作为函数的返回值。

异常处理

如果输入的sum和diff不符合程序的要求，例如sum和diff均为奇数，则函数将抛出ValueError异常。在程序中，我们使用一个断言来实现这个处理逻辑：

assert (sum - diff) % 2 == 0, "sum和diff必须符合一定条件"

单元测试

我们还编写了一份单元测试，用于检验函数在各种输入情况下的输出是否符合预期。如果想要通过自己编写的测试用例来验证本程序的正确性，可以参考下面的代码片段（其中第7行和第8行为测试文件的引用路径）：

import unittest
from find_two_numbers import find_two_numbers

class TestFindTwoNumbers(unittest.TestCase):
    def test_find_two_numbers(self):
        self.assertEqual(find_two_numbers(20, 4), (12, 8))
        self.assertRaises(ValueError, find_two_numbers, 15, 1)
        self.assertRaises(ValueError, find_two_numbers, 9, 3))
        self.assertRaises(ValueError, find_two_numbers, 1, 3))
        self.assertEqual(find_two_numbers(100, 50), (75, 25))

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