Python type annotation existence checker
Project description
PyLeft
Python type annotation existence checker
pyleft
is a complement to Microsoft's pyright
tool. While pyright
does an excellent job at type checking your Python code,
it doesn't check to make sure type hints exist. If you forget to add type hints
to a function, pyright
will usually see no problems with it. This tool checks
to make sure all of your code has type hints, while leaving it to pyright
to make
sure they are actually correct.
Installation
PyLeft requires Python 3.6.2+.
pip install pyleft
Usage
PyLeft is a Python module that can be run via python -m
. Just provide the directories
or files to recursively check.
python -m pyleft .
The module will exit with an exit code of 0 if all type hints are present, or 1 if there are any issues.
Options
files
: List of filenames and directories to recursively check.--exclude
: (optional) List of glob patterns to exclude.--no-gitignore
: (optional) Don't use the exclusions from the .gitignore from the current working directory.--quiet
: (optional) Don't print any output to the console.
Configuration
Configuration is done through the pyproject.toml
file.
[tool.pyleft]
# "files" in the configuration file are added to the option given on the command line
# This can either be a list, or a space separated string
files = ["extra/directory/**"]
# This can either be a list, or a space separated string
exclude = ["**/*_pb2.py"]
no-gitignore = true
quiet = true
Design Decisions
Only files with a .py
extension are checked.
The __init__
and __new__
methods of a class are not required to
have return type hints. pyright
automatically assumes this to be None
.
The first (self
) argument of any class method is not required to have a type hint.
The first (cls
) argument of any class @property
or @classmethod
or __new__
method is not required to have a type hint.
Any variable argument list (*arg
) or keyword argument dict (**kwarg
)
is not required to have a type hint.
Disclaimer
This project is not affiliated in any way with Microsoft.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.