pyright/docs/comments.md

1.2 KiB

Comments

Some behaviors of pyright can be controlled through the use of comments within the source file.

Type Annotations

Versions of Python prior to 3.6 did not support type annotations for variables. Pyright honors type annotations found within a comment at the end of the same line where a variable is assigned.

offsets = [] # type: List[int]

self._target = 3 # type: Union[int, str]

File-level Type Controls

Strict type checking, where most supported type-checking switches generate errors, can be enabled for a file through the use of a special comment. Typically this comment is placed at or near the top of a code file on its own line.

# pyright: strict

Likewise, basic type checking can be enabled for a file.

# pyright: basic

Individual configuration settings can also be overridden on a per-file basis and optionally combined with “strict” or “basic” type checking. For example, if you want to enable all type checks except for “reportPrivateUsage”, you could add the following comment:

# pyright: strict, reportPrivateUsage=false

Diagnostic levels are also supported.

# pyright: reportPrivateUsage=warning, reportOptionalCall=error