Согласно PEP-8, как я могу правильно написать свою подпись функции? - PullRequest
Новая
       7

Согласно PEP-8, как я могу правильно написать свою подпись функции?

0 голосов
/ 12 сентября 2018

Я наткнулся на заголовок этой функции: 

# 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 , но я не хочу переписывать код, если он просто не противоречит правилам кодирования.

...