finnito / tooDo

A Python GUI to visualise TODO comments in your own directories.

TooDo

Find the FIX/NOTE/TODO tasks in your source files!

This is a fun weekend project for me, but I am all for learning, so let me know if things don't work, or you have a feature request.

How to Use

1. Clone this repository
2. Install requirements (fswatch, toml)
   • python3 -m pip install -r requirements.txt
3. Open config.toml and define the directories you want to watch, like this:

[directories]
    [directories.tooDo]
        path = "/Users/finnlesueur/Git/tooDo/"
        ignore_paths = [
            "venv"
        ]
        ignore_types = [
            ".html",
            ".png",
            ".jpg",
            ".jpeg",
            ".gif",
            ".gpx",
            ".min.js",
        ]

4. Run the script!
   • python tooDo.py
   • I personally made an Automator app which simply calls this script so I can boot it from Alfred.

Customisation

You may wish to customise the FIX/TODO/NOTE/whateveryouwant patterns being searched for. You can do this in config.toml

[patterns]
    [patterns.FIX]
        regex = "FIX:\\s*(.*)"
    [patterns.TODO]
        regex = "TODO:\\s*(.*)"
    [patterns.NOTE]
        regex = "NOTE:\\s*(.*)"

You can also change the font family, font size, font colour, background colour and colour of the currently selected line.

[display]
    background = "#ecf0f1"
    text = "#1e272e"
    current_line = "#badc58"
    font_family = 'Space Mono'
    font_size = 13
    font_size_big = 16

You may also wish to crank up how often changes to the todo list are checked for. It is set by default to 1000ms which seems perfectly good to me. It will use lots more CPU if you make it excessively small.

[settings]
    tk_refresh_rate = 1000

---

Dependencies

• pyfswatch
  • MIT License
• toml
  • MIT License