nilportugues/php_todo

Looks into the code using a user-defined list of to-do phrases and stops commit if the total amount increased or is above a threshold.

PHP To-do Finder

, _(*1)

Why

Keep the @todo count for each commit., _(*2)

Do not allow commits if the total amount of @todo increased or is above a user-defined threshold., _(*3)

Purpose is to keep the @todo list low and forcing cleaning the code or resolving them., _(*4)

Based on the ideas of:, _(*5)

• http://jezenthomas.com/using-git-to-manage-todos/

Installation

Use Composer to install the package:, _(*6)

$ composer require --dev nilportugues/php_todo

Usage

It is really this simple:, _(*7)

$ php bin/php_todo find <path/to/directory>

Configuration file

• Define the todo annotations to look for in the code.
• Define the amount of @todo that will be tolerated.

When run the first time, if no php_todo_finder.yml file is found you will have to create it., _(*8)

A configuration for instance, should formatted as follows:, _(*9)

todo_finder:
  total_allowed: 5
  expressions:
    - @todo
    - TODO
    - refactor
    - FIX ME

You can specify an alternate location for the configuration file by passing in the -c parameter. Example:, _(*10)

$  php bin/php_todo find -c configs/php_todo_finder.yml src/

Contribute

Contributions to the package are always welcome!, _(*11)

• Report any bugs or issues you find on the issue tracker.
• You can grab the source code at the package's Git repository.

Support

Get in touch with me using one of the following means:, _(*12)

• Emailing me at contact@nilportugues.com
• Opening an Issue

Authors

• Nil Portugués Calderó
• The Community Contributors

License

The code base is licensed under the MIT license., _(*13)