Newest Python PEPs
·
PEP 821：在 Callable 类型提示中支持解包 TypedDict
内容提要
PEP 821 提议在 Callable 类型提示中支持 Unpack[TypedDict]，以简化关键词参数的定义，提升可读性和一致性，同时保持向后兼容性。
关键要点
-
PEP 821 提议在 Callable 类型提示中支持 Unpack[TypedDict]，以简化关键词参数的定义。
-
当前 Callable 假设参数为位置参数，无法直接指定关键词参数，导致定义回调协议时冗长。
-
新语法允许直接在 Callable 中重用 TypedDict 定义的关键词结构，提升可读性和一致性。
-
该提案保持向后兼容性，允许在 Callable 中使用 Unpack[TypedDict]，并支持位置参数与关键词参数的结合。
-
TypedDict 中标记为 NotRequired 的键对应于可选的关键词参数，调用者可以选择省略这些参数。
-
如果 TypedDict 指定了 extra_items 参数，Callable 必须接受额外的关键词参数，且类型需匹配。
-
该提案的目标是使得使用特定关键词参数的回调函数的定义更加简洁和一致。
延伸解读
简化关键词参数定义的意义
PEP 821 提出的 Unpack[TypedDict] 语法，旨在简化关键词参数的定义，使得回调函数的声明更加简洁。这一变化有助于提高代码的可读性，尤其是在需要频繁使用关键词参数的场景中，开发者可以更快速地理解函数的调用方式。
向后兼容性的重要性
该提案强调了向后兼容性，确保现有代码在引入新语法后不会受到影响。这对于大型项目尤为重要，因为开发者可以逐步采用新特性，而不必担心破坏现有功能，降低了升级的风险。
TypedDict 的灵活性
通过 TypedDict 中的 NotRequired 键，开发者可以定义可选的关键词参数。这种灵活性使得函数调用更加灵活，调用者可以根据需要选择性地传递参数，从而提高了代码的适应性和可维护性。
延伸问答
PEP 821 的主要目的是什么？
PEP 821 的主要目的是在 Callable 类型提示中支持 Unpack[TypedDict]，以简化关键词参数的定义，提升可读性和一致性。
PEP 821 如何改善 Callable 的使用？
PEP 821 允许在 Callable 中直接重用 TypedDict 定义的关键词结构，从而减少了定义回调协议时的冗长性。
在 PEP 821 中，如何处理可选的关键词参数？
在 PEP 821 中，TypedDict 中标记为 NotRequired 的键对应于可选的关键词参数，调用者可以选择省略这些参数。
PEP 821 是否保持向后兼容性？
是的，PEP 821 保持向后兼容性，允许在 Callable 中使用 Unpack[TypedDict]，并支持位置参数与关键词参数的结合。
PEP 821 中的 Unpack[TypedDict] 有什么语法要求？
在 PEP 821 中，可以使用 Callable[[Unpack[TD]], R] 或 Callable[Unpack[TD], R] 的形式，其中 TD 是一个 TypedDict。
PEP 821 提案中有哪些替代方案被考虑？
PEP 821 考虑了继续推荐基于 Protocol 的回调、引入新的 Callable 语法、采用回调字面量语法等替代方案，但最终选择了最小的扩展。
