Hooks

Chandler aims to offer a high level of customization using Hooks, thin wrappers around setuptools’ entry points.

Chandler features that rely on Hooks can be extended or changed by adding or removing entry points.

Main hooks

Below are Chandler’s most frequently used Hooks. See “hook” in the index for a complete list.

Item Add-on

Registered AddOn classes will be added to all items.

addon_class(item) -> return value ignored

See also

Adding attributes to all Items

Triage Status

Reminders

Keywords on Items

Dashboard Entry Add-on

Registered AddOn classes will be added to all DashboardEntries.

addon_class(entry) -> return value ignored

See also

Adding cells to all DashboardEntries

The Chandler Dashboard

Triage

triage_callable(item) -> iterable of (timestamp, triage_status) pairs

Return an empty tuple if triage can’t be calculated for the item, otherwise a timestamp when the triage_status should be applied, and a triage value.

See also

Automatically determined triage status

Events and Triage Status

Reminders and Triage Status