Usage

Install lintel and learn about its usage:

pip install lintel

lintel --help

Configuration Files

lintel supports ini-like and toml configuration files. In order for lintel to use a configuration file automatically, it must be named one of the following options.

setup.cfg
tox.ini
pyproject.toml

When searching for a configuration file, lintel looks for one of the file specified above in that exact order in the current working directory. A configuration file can also be provided via the --config CLI option. ini-like configuration files must have a [lintel] section while toml configuration files must have a [tool.lintel] section.

Available Options

Get available configuration options by running:

lintel --help

Example

[lintel]
ignore = D100,D203,D405

Ignore error codes in-file

lintel supports module-level or inline commenting to skip specific checks on specific modules, classes, or functions/methods. The supported comments that can be added are:

# lintel: noqa on the module level deactivates lintel for a module.
# noqa: D100 on the module level deactivates the D100 check for a module.
# noqa inline skips all checks for the function or class on that line.
# noqa: D102,D203 inline can be used to skip specific checks for a specific class or function.

For example, this will skip the check for a period at the end of a function docstring:

>>> def bad_function():  # noqa: D400
...     """Omit a period in the docstring as an exception"""
...     pass

Usage with pre-commit 

lintel can be included as a hook for pre-commit. The easiest way to get started is to add this configuration to your .pre-commit-config.yaml:

-   repo: https://github.com/Mr-Pepe/lintel
    rev: 0.1.0  # pick a git hash / tag to point to
    hooks:
    -   id: lintel

See the pre-commit docs for how to customize this configuration.