SublimeText PlainTasks Modification: Adding pastdue / overdue and upcoming stats for date tracking


I started using the PlainTasks plugin for SublimeText as my daily todo and work tracking list.  What a great plugin!

The one thing it was lacking in the default Stats to show in the bottom bar was the ability to track overdue, and upcoming dates.  With a simple modification to the Python script I have added just that.

Just edit the file and add the following code right after line 897 and then 926 in the file.  This will create new counters called $v (overdue), $t (due today), and $u (upcoming).

[code language=”python”]
#Custom code (use this value to add to tags with @today to the due today counter), line 897
if i == "{{@today}}":
tagToday = len(pend)

[code language=”python”]
#Overdue and due today tasks, line 926
tasks_dates = []
overdue = 0
duetoday = 0
upcoming = 0
view.find_all(‘(^\s*[^\n]*?\s\@(?:due)\s*(\([\d\w,\.:\-\/ ]*\))[^@]*$)’, 0, "\\2", tasks_dates)
date_format = view.settings().get(‘date_format’, ‘(%y-%m-%d %H:%M)’)
tasks_dates = [PlainTasksCompleteCommand.check_parentheses(date_format, t, is_date=True) for t in tasks_dates]
present ="%y-%m-%d %H:%M")
#print ("Now:" + str(present))
for pastdue in tasks_dates:
pastdue = pastdue.replace(‘(‘,”).replace(‘)’,”)
#print ("Time Found:" + str(pastdue))
if len(pastdue) > 0:
if datetime.strptime(pastdue, ‘%y-%m-%d %H:%M’) < datetime.strptime(present, ‘%y-%m-%d %H:%M’): overdue = overdue + 1 elif datetime.strptime(pastdue[:-6], ‘%y-%m-%d’) == datetime.strptime(present[:-6], ‘%y-%m-%d’): duetoday = duetoday + 1 elif datetime.strptime(pastdue[:-6], ‘%y-%m-%d’) > datetime.strptime(present[:-6], ‘%y-%m-%d’):
upcoming = upcoming + 1

msg = (msgf.replace(‘$o’, str(pend))
.replace(‘$d’, str(done))
.replace(‘$c’, str(canc))
.replace(‘$n’, str(done+canc))
.replace(‘$a’, str(allt))
.replace(‘$percent’, str(int(percent)))
.replace(‘$progress’, progress)
.replace(‘$last’, last)
.replace(‘$v’, str(overdue)) #New value for overdue
.replace(‘$t’, str(duetoday + tagToday)) #New value for due today (include both dates and items with @today tags)
.replace(‘$u’, str(upcoming)) #New value for upcoming
return msg

Now just edit your PlainTasks.sublime-settings User file and add the new variables.  Mine looks like this:

“stats_format”: “$n/$a done, $v overdue, $t due today, $u upcoming: ☐$o ✔$d ✘$c, ($percent%) $progress: (Pend/Done/Canc) @critical {{@critical}}, @high {{@high}}, @low {{@low}}, @today {{@today}}”,
// if you want the statistics do not include the archived tasks:
“stats_ignore_archive”: true

Finally you can open your TODO list and you will see the following at the bottom:

Screen Shot 2015-08-03 at 10.31.13 PM


If you want to see what is upcoming you can install the “Filter Lines” plugin and then fold the list (from the Edit menu) by a regular expression.  I use the following to show due, critical and today tags.


You can also add a custom keyboard shortcut in your sublime.keymap user settings, I added this one for command K, command L:

{ “keys”: [“super+k”, “super+l”], “command”: “fold_to_lines”, “args”: { “search_type”: “regex”, “needle”: “(@+\\bcritical*)|(@+\\btoday*)|(@+\\bdue*)” } }

Happy coding!