Почему python требует, чтобы docstrings были отступом?

Question

Почему питон принимает этот код:

def is_right_triangle(leg1,leg2,hypotenuse): 
    """function for checking whether or not set of points makes a right triangle""" 
    return leg1 ** 2 + leg2 ** 2 == hypotenuse ** 2 

, но в этом коде, где строка документация не отступ

def is_right_triangle(leg1,leg2,hypotenuse): 
"""function for checking whether or not set of points makes a right triangle""" 
    return leg1 ** 2 + leg2 ** 2 == hypotenuse ** 2 

он бросает «ожидаемый отступ блок» ошибку.

Почему python заботится, если docstring с отступом или нет?

Answer 1

Потому что docstring - это еще одно выражение в функции. Его обрабатывают только особым образом, потому что это строка и первое выражение.

Вы также можете видеть, что, получая функцию AST:

> a=ast.parse('def f(x):\n "docstring"\n return 0') 
> a.body[0].body 
[<_ast.Expr at 0x7f18bb3e6a20>, <_ast.Return at 0x7f18bb3e6550>] 
> a.body[0].body[0].value.s 
'docstring' 

Answer 2

Потому что в самом начале питона в 1990-е годы, Гвидо Ван Россум постановил, что все утверждения в определении функции должны быть отступы и что string - выражение.

Только GvR может действительно ответить на этот вопрос. Python происходит от игрушечного языка с именем ABC. Докшлинк уже может быть отступом в ABC ...