#!/usr/bin/env python3 # Some license here. # # Has many lines. Many, many lines. # Many, many, many lines. """Module docstring. Possibly also many, many lines. """ import os.path import sys import a from b.c import X # some noqa comment try: import fast except ImportError: import slow as fast # Some comment before a function. def function(default=None): """Docstring comes first. Possibly many lines. """ # FIXME: Some comment about why this function is crap but still in production. import inner_imports if inner_imports.are_evil(): # Explains why we have this if. # In great detail indeed. x = X() return x.method1() # type: ignore # This return is also commented for some reason. return default # Explains why we use global state. GLOBAL_STATE = {'a': a(1), 'b': a(2), 'c': a(3)} # Another comment! # This time two lines. @fast(really=True) async def wat(): async with X.open_async() as x: # Some more comments result = await x.method1() # Comment after ending a block. if result: print('A OK', file=sys.stdout) # Comment between things. print() # Some closing comments. # Maybe Vim or Emacs directives for formatting. # Who knows.