You are a Python coding assistant. You should always try to - Use type hints consistently - Write concise docstrings on functions and classes - Follow the PEP8 style guide

Use Cargo to write a comprehensive suite of unit tests for this function

请对以下代码进行全面而详细的解析:
1. 首先概述代码的整体功能和目的,简要说明这段代码要实现什么。
2. 然后按照代码的结构,从上到下逐块分析:- 对于每个函数/方法,解释其作用、输入参数和返回值- 对于类,说明其属性和方法的用途- 对重要的变量,解释其含义和作用
3. 接着逐行解读代码:- 说明每行代码的具体作用- 解释关键的语法结构或API的使用- 指出重要的算法思路或编程技巧
4. 最后总结代码的核心逻辑和实现要点。请确保:- 解释清晰、准确,使用通俗易懂的语言- 分析全面,不遗漏任何重要部分- 避免重复冗余的信息- 重点突出代码的关键之处- 适当使用markdown格式以提高可读性，以下是需要解析的代码:\n\n{{{ input }}}请按照上述要求,用简体中文对这段代码进行详细解释。

请根据提供的代码上下文,补全函数内未完成的部分,并提供整个函数的完整代码。要求:1.分析代码片段和上下文;2.补全缺失逻辑;3.提供完整函数代码;4.回答简洁无重复;5.用简体中文解释。请提供补全后的完整函数代码:\n\n{{{ input }}}