Back to directory
orsinium-labs avatar
orsinium-labs / flake8-todos

flake8-todos

Lint TODO comments in a Python code

30

Stars

4

Forks

1

Watchers

BSD-3-Clause

License

flake8-todos

Plugin for flake8 linter to check TODOs in the project.

Good:

# TODO(gram): check performance
# https://github.com/orsinium-labs/flake8-todos/issues/1337

Bad:

# FIXME idk how it works lol

Checks:

  • T001: use TODO instead of FIXME (or BUG) for consistency.
  • T002: add author into TODO (motivation).
  • T003: add link on issue into TODO.
  • T004: missed colon in TODO.
  • T005: missed text in TODO.
  • T006: write TODO instead of ToDo (use upper case).
  • T007: missed space after colon in TODO.

Installation

python3 -m pip install --user flake8-todos

Usage

Check that plugin was added in your flake8:

$ python3 -m flake8 --version
3.7.7 (flake8-todos: 1.0.0, mccabe: 0.6.1, pycodestyle: 2.5.0, pyflakes: 2.1.1) CPython 3.6.7 on Linux

If you don't see flake8-todos in the previous command output, check that flake8 and flake8-todos is installed in the same interpreter.

If everything is OK, run flake8:

python -m flake8 example.py

License

  • The content of this repository contains a public fork of flake8-todos developed by EclecticIQ B.V.. Release 0.1.2 of the package was licensed under BSD 3-Clause License. File LICENSE contains the original license file.
  • The fork is distributed under the same license and conditions.
  • Release 0.1.2, all earlier releases, and corresponding source code are licensed under copyright "2019 EclecticIQ".
  • All the later changes and distributions starting from 0.1.4 inclusively are licensed under copyright "2020 Gram [email protected]".
  • Both copyrights are included in releases of the fork since it contains changes from both parties.

The fork was created to provide source code, distributions, and maintenance for the project.

Releases

What's Changed

Fixing MissedColonRule zero len issue by @fossum in #6

New Contributors

@fossum made their first contribution in #6

Full Changelog: 0.3.0...0.3.1

May 31, 2023

Download .zip

What's Changed

Allow alternative author format using "@" by @mayrholu in #5

New Contributors

@mayrholu made their first contribution in #5

Full Changelog: 0.2.1...0.3.0

Nov 19, 2022

Download .zip

What's Changed

Fix no space rule when no author is present by @calumy in #3

Full Changelog: 0.2.0...0.2.1

Nov 10, 2022

Download .zip

What's Changed

Add rule to check for space after colon by @calumy in #1 Modernize the code by @orsinium in #2

New Contributors

@calumy made their first contribution in #1

Full Changelog: v.0.1.5.....