Metadata-Version: 2.1
Name: flake8-todos
Version: 0.2.0
Summary: Python linter to check TODO comments for consistency and best practice.
Home-page: https://github.com/orsinium-labs/flake8-todos
License: BSD 3-Clause
Keywords: flake8 flake8-plugin linter styleguide code quality
Author: Gram
Author-email: gram@orsinium.dev
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: Flake8
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: License :: OSI Approved :: BSD License
Requires-Dist: flake8
Requires-Dist: pycodestyle
Requires-Dist: isort[pyproject] ; extra == "dev"
Requires-Dist: pytest ; extra == "dev"
Provides-Extra: dev

# flake8-todos

Plugin for [flake8](http://flake8.pycqa.org/en/latest/) linter to check TODOs in the project.

Good:

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

Bad:

```python
# FIXME idk how it works lol
```

Checks:

+ **T001**: use TODO instead of FIXME (or BUG) for consistency.
+ **T002**: add author into TODO ([motivation](https://dave.cheney.net/practical-go/presentations/qcon-china.html#_dont_comment_bad_code_rewrite_it)).
+ **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

```bash
python3 -m pip install --user flake8-todos
```

## Usage

Check that plugin was added in your flake8:

```bash
$ 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`:

```bash
python -m flake8 example.py
```

## License

+ The content of this repository contains a public fork of flake8-todos developed by [EclecticIQ B.V.](https://github.com/eclecticiq). Release 0.1.2 of the package was licensed under BSD 3-Clause License. File [LICENSE](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.

