Custom Reports

Task allows you to customize reports, to a limited degree. The "list", "long", and "ls" reports are all now custom reports, whereas in previous releases of task they were not mutable. This means they can be modified, renamed, or deleted.

More importantly, you can define your own. Here are the two necessary items in the .taskrc file that define a new report:

report.mine.columns=id,project,priority,description
report.mine.sort=priority-,project+

This defines a report, called "mine", that has four columns: id, project, priority and description. It will be sorted on two columns: by descending priority then ascending project. Because this report is called "mine", it can be run with the command:

% task mine

A filter can also be specified like this:

report.mine.filter=priority:H +bug

This adds a filter so that only tasks with priority "H" and with the "bug" tag are included in the report. This filter definition is optional.

Here is a list of all the possible columns that may be included in a report:

  • id
  • uuid
  • project
  • priority
  • entry
  • start
  • due
  • age
  • active
  • tags
  • description

Custom reports will show up in the task command line usage.



Copyright 2006-2009, P. Beckingham. All rights reserved.