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.

1.0.0 2015-11-10 00:04 UTC

Requires

• php: >=5.4
• symfony/console: ~2.2
• symfony/yaml: ^2.7

Requires (Dev)

• fabpot/php-cs-fixer: 1.4.2

MIT

• Nil Portugués Calderó

• php
• git
• function
• HOOK
• functions
• fixer
• checker
• forbidden

README

Why

Keep the @todo count for each commit.

Do not allow commits if the total amount of @todo increased or is above a user-defined threshold.

Purpose is to keep the @todo list low and forcing cleaning the code or resolving them.

Based on the ideas of:

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

Installation

Use Composer to install the package:

$ composer require --dev nilportugues/php_todo

Usage

It is really this simple:

$ 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.

A configuration for instance, should formatted as follows:

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:

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

Contribute

Contributions to the package are always welcome!

• 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:

• Emailing me at [e-mail]
• Opening an Issue

Authors

• Nil Portugués Calderó
• The Community Contributors

License

The code base is licensed under the MIT license.