Metadata-Version: 2.1
Name: flake8-todos
Version: 0.1.5
Project-URL: Homepage, https://github.com/orsinium-labs/flake8-todos
Author: Gram
Author-email: gram@orsinium.dev
License: BSD 3-Clause
Requires-Python: >=3.6
Keywords: flake8,flake8-plugin,linter,styleguide,code,quality
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
Provides-Extra: dev


flake8-todos
============

Plugin for `flake8 <http://flake8.pycqa.org/en/latest/>`_ linter to check TODOs in the project.

Good:

.. code-block:: python

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

Bad:

.. code-block:: 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).

Installation
------------

.. code-block:: bash

   python3 -m pip install --user flake8-todos

Usage
-----

Check that plugin was added in your flake8:

.. code-block:: 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``\ :

.. code-block:: 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.
