td is a non-offensive, per project ToDo manager.

Heavily inspired by devtodo, but with some nasty features, like:

• Shorter commands for most used actions.
• Sorting/Filtering specific levels only.
• Persistent sort/filter/view options.
• Written in pure Python (it even has docstrings).
• Tests ().

Oh, and it will automagically pick up your existing devtodo lists!

• python >= 3.2
• distribute (for setup)
• nosetests (for test-suite)

Through PyPI

$ pip install td

or from sources

$ python setup.py install

To show your complete ToDo list, just run td without any parameters.

$ td

Typing

$ td a(dd) [<parent_index>]

will start an interactive item adding session.

Optional parent_index parameter specifies item, under which the new one will be nested.

Instead of using interactive session, one can also specify them in command line, like below.

$ td a(dd) [<parent_index>] --<field_name> <field_value>
$ td a(dd) [<parent_index>] -<field_name's_first_letter> <field_value>

Typing

$ td e(dit) <index>

where index is an item's index, will start an interactive item editing session.

Similarly to a(dd), one can also specify new values in command line.

$ td e(dit) <index> --<field_name> <field_value>
$ td e(dit) <index> -<field_name's_first_letter> <field_value>

One special cause here is reparenting, done like below.

$ td e(dit) <index> --parent <parent_index>

Typing

$ td r(emove) <index>

will remove item under index.

Typing

$ td d(one) <index>

will mark item under index as done, while typing

$ td D <index>
$ td undone <index>

will mark it as not done.

All view, modify and options commands have exactly the same interface, but:

• v(iew) is temporary, which means that changes affect only one session and are then gone,
• m(odify) is permanent, which means that the changes made are saved to disk,
• o(ptions) sets persistent modifiers, which will be applied on every future change. Also has a -g switch, which stores options globally (in ~/.tdrc). They are then used if there are no local options.

sort

General syntax is

$ td (v|m|o) -s [+|-]{,}[[<level>]{:}[<field_name>](+|-)]
$ td (v|m|o) --sort [+|-]{,}[[<level>]{:}[<field_name>](+|-)]

but it looks cryptic, so lets split it into some more specific use cases.

To sort everything asceding by name, type

$ td (v|m|o) -s
$ td (v|m|o) -s +

To sort everything desceding by name, type

$ td (v|m|o) -s -

To sort specific level by name, type (as before, + goes for asceding and - for desceding)

$ td (v|m|o) -s <level>(+|-)

To sort everything by a field other than name, type

$ td (v|m|o) -s <field_name>(+|-)

To sort specific level by a field other than name, type

$ td (v|m|o) -s <level>:<field_name>(+|-)

And to specify muliple rules, use a comma (,). For example this

$ td (v|m|o) -s +,1-,2:priority+

will sort items at the second level asceding by priority, item at the first level desceding by name, and all other levels asceding by name.

Note that to sort by multiple conditions, just supply them one by one and they'll be applied in order of appearance.

purge

Typing

$ td (v|m|o) -p
$ td (v|m|o) --purge

will remove all completed items.

done/undone

This command is used to batch mark items as done or not.

General syntax is

$ td (v|m|o) -d [[<level>]{:}[[<field_name>=]<regexp>]]
$ td (v|m|o) --done [[<level>]{:}[[<field_name>=]<regexp>]]

$ td (v|m|o) -D [[<level>]{:}[[<field_name>=]<regexp>]]
$ td (v|m|o) --undone [[<level>]{:}[[<field_name>=]<regexp>]]

As with sort, we'll split it into use cases.

To mark all items, type

$ td (v|m|o) -(d|D)

To mark all items at specific level, type

$ td (v|m|o) -(d|D) <level>

To mark items matching regexp at any field and level, type

$ td (v|m|o) -(d|D) <regexp>

To mark items matching regexp at specific field and any level, type

$ td (v|m|o) -(d|D) <field_name>=<regexp>

To mark items matching regexp at any field and specific level, type

$ td (v|m|o) -(d|D) <level>:<regexp>

To mark items matching regexp at specific field and level, type

$ td (v|m|o) -(d|D) <level>:<field_name>=<regexp>

Of course, these rules can also be chained using comma (,).