SnoopJ @SnoopJ@hachyderm.io
Public

Relatively obscure standards question:

In PEP 257¹ and PEP 258², "attribute docstrings" are defined as:

«A string literal immediately following an assignment statement»

Python's abstract syntax trees do not represent blank lines, it is as if they were deleted in the input source.

Note that PEP 258 does also explicitly mention that using blank lines to visually separate documented attributes.

Question: how many blank lines is the specification allowing between the assignment and the string literal? Is the specification talking about abstract or concrete syntax?

¹ peps.python.org/pep-0257/#what
² peps.python.org/pep-0258/#attr

Python PEPs

PEP 257 – Docstring Conventions | peps.python.org

This PEP documents the semantics and conventions associated with Python docstrings.

peps.python.org · Python Enhancement Proposals (PEPs)

0
0
0

If you have a fediverse account, you can quote this note from your own instance. Search https://hachyderm.io/users/SnoopJ/statuses/114441713665472002 on your instance and quote it. (Note that quoting is not supported in Mastodon.)