tastic.workspace.workspace (class) ∞

class tastic.workspace.workspace(log, fileOrWorkspacePath, settings=False)[source] ∞

tools for sorting, archiving and indexing tasks and maintaining the contents of all taskpaper files within a given workspace

Key Arguments:
  • log – logger
  • fileOrWorkspacePath – the root path of the workspace you wish to sort the taskpaper docs within, or the path to a single taskpaper file
  • settings – the settings dictionary

Usage:

To setup your logger, settings and database connections, please use the fundamentals package (see tutorial here).

To initiate a taskpaper workspace object, use the following:

from tastic.workspace import workspace
ws = workspace(
    log=log,
    settings=settings,
    fileOrWorkspacePath="/path/to/root/of/workspace"
)

or to target a single taskpaper document use instead the path to the file:

from tastic.workspace import workspace
ws = workspace(
    log=log,
    settings=settings,
    fileOrWorkspacePath="/path/to/doc.taskpaper"
)
__init__(log, fileOrWorkspacePath, settings=False)[source] ∞

Methods

__init__(log, fileOrWorkspacePath[, settings])
archive_done() move done tasks from the document’s ‘Archive’ project into an adjacent markdown tasklog file
sort() sort the workspace or individual taskpaper document via the workflow tags found in the settings file