首页 > 解决方案 > 根据 PEP-8,如何正确编写函数签名?

问题描述

我偶然发现了这个函数头:

# version 1
def schedule_single_scoring(submission: Submission,
                            scoring_specification: ScoringSpecification
                            ) -> SubmissionScore:

我不喜欢最后一行以右括号开头,但我在PEP-8中没有找到反对它的论点,也许我已经监督了它。

我的问题是:按照版本 1编写代码是否合法?或者应该是这样的:

# version 2
def schedule_single_scoring(
    submission: Submission,
    scoring_specification: ScoringSpecification) -> SubmissionScore:
    """multiline docstrings are present"""

# version 3
def schedule_single_scoring(submission: Submission, scoring_specification:
        ScoringSpecification) -> SubmissionScore:

我更喜欢版本 3,但如果它根本不违反编码准则,我不想重写代码。

标签: pythonpep8type-hinting

解决方案


推荐阅读