Skip to main content

Python linter to check TODO comments for consistency and best practice.

Project description

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 gram@orsinium.dev".
  • 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flake8-todos-0.2.1.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

flake8_todos-0.2.1-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file flake8-todos-0.2.1.tar.gz.

File metadata

  • Download URL: flake8-todos-0.2.1.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.25.1

File hashes

Hashes for flake8-todos-0.2.1.tar.gz
Algorithm Hash digest
SHA256 bdeeaed293497c5f16c4504805f3dbc84bf54d52f6ad4c06867c869c8bc38e3e
MD5 e13b3e7f3bf6cd40bb43eaf5b1e95bb6
BLAKE2b-256 1312e7874ace9db7d465f9d026358cc81ae1c1f7691968a59237ef98940ca12f

See more details on using hashes here.

File details

Details for the file flake8_todos-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for flake8_todos-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3f8d42e40bac021bfb9162e155662419271e6616491ed2e16c318e04e74228b7
MD5 3ffa0b954c45226c40c2f1c0d4225b10
BLAKE2b-256 372d82b2d0af411b615442fc3b59bdc69507858702c9a03d4fb2ddbcf5b17867

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page