Comments & Pragmas

Comments are normally skipped, BUT linters use them for:

• Suppressions: # noqa: E501 disables rule E501 on this line.
• File-level: # pylint: disable=missing-docstring for whole file.
• Region: # pylint: disable-next=foo, # pylint: enable=foo.
• TODO scanning: highlight # TODO, # FIXME, # HACK.

Implementation:

When emitting a diagnostic:

TODO scanner:

Suppressions are powerful but easy to abuse — every # noqa is a place where you've turned off the linter. Best practice: be specific (# noqa: E501) and add a comment WHY.