具有长参数的函数的 Python 类型注释样式

Question

用长类型注解设置函数定义样式的规范（基于一些 PEP）方法是什么？

我能想到的一些替代方案：

• 选项 1：

def my_long_function_name_super_important(
   first_long_argument_to_my_function: Union[int, str],
   second: Dict[int, str],
   third_arg: int = 0 ) -> (bool, int):
   
   return (True, 1)

• 选项 2：

def my_long_function_name_super_important(
   first_long_argument_to_my_function: Union[int, str],
   second: Dict[int, str],
   third_arg: int = 0
) -> (bool, int):
   
   return (True, 1)

• 选项 3：

def my_long_function_name_super_important(
   first_long_argument_to_my_function: Union[int, str],
   second: Dict[int, str],  third_arg: int = 0
) -> (bool, int):
   
   return (True, 1)

• 选项 4：

def my_long_function_name_super_important(
   first_long_argument_to_my_function: Union[int, str],
   second: Dict[int, str],
   third_arg: int = 0,
   ) -> (bool, int):
   
   return (True, 1)

注意：以 Python 3.8+ 为目标以获得最新答案。

Answer 1

正如@MisterMiyagi 所暗示的，对于函数中的这些类型注释，没有基于 PEP 的官方编码风格。

话虽如此，在尝试了一些不同的选项之后，我意识到选项 2 和 3 在一些 python 代码格式化程序中会产生一些小问题（例如：jupyter notebook 中函数中的代码折叠），因为缺少缩进关闭)。因此，为了寻求最高的可读性，我最终使用了类似于选项 2 的东西，但在函数定义的最后一行有一个小缩进（更容易发现），并且每行有一个参数（更容易阅读):

def my_long_function_name_super_important(
   first_long_argument_to_my_function: Union[int, str],
   second: Dict[int, str],
   third_arg: int = 0
  ) -> (bool, int):
   
   return (True, 1)

仅供参考，@MisterMiyagi 的 black 格式化程序似乎正是选项 2（可以试用 here）