To-Do List Automator

Author: paulpls
License: FSF

About

Use this utility to automatically generate a to-do list by searching for patterns in the provided file paths. In return, you'll get a nicely formatted markdown file with direct links to your code, enabling you to pick up right where you left off.

Dependencies

• python >= 3.6
• GNU grep
• GNU rm

Instructions

• Copy todo.py to your project's top-level directory (or elsewhere if you're feeling brave)
• Edit the file to customize the output:
  • files: List of file or directory paths to search (allows * globs)
  • patterns: List of search keyords
  • header: Output file header
  • outpath: Output file path
• Run the program: python todo.py

Example

Given the file example.py:

01  def do_something():
02      # TODO make this do some stuff
03  ...

With TODO included in the search terms, the output file will look something like this:

# Todo List

### TODO
- [example.py](example.py#L2) make this do some stuff

...

Wontfix

• Currently only outputs a single line matching each pattern. Additional functionality to include entire multiline commments is not planned at this time.