Phabricator: a script to find TODO lines in a code base and generate bug reports.

Sometimes, a code base is haunted with dozens of lines like this one:

[php]
//TODO: handle relative moves
[/php]

This line doesn’t explain the current state of code as much as it offers a feature request. But this feature request isn’t really visible, you have to browse the relevant code file to see it.

So, what about transform all these todo lines into actual Phabricator tasks?

At best, you have identified an actual bug or feature request. At worst, you can identify already solved issues and clean your code files of extraneous TODO lines.

This Python script will find todo lines, and fill draft tasks with the content of the line, the name and line where it has been found. We also add a visible message to identify it as draft: here I’ve chosen “Please edit this description to describe correctly the bug or the task.”.

Continue reading “Phabricator: a script to find TODO lines in a code base and generate bug reports.”