taskwarrior

README

go-taskwarrior

Golang API for taskwarrior database.

Features

• Custom parser for .taskrc configuration files
• Read access to taskwarrior database
• Adding/modifying existing tasks

Quickstart

Example program to read the current user's tasks:

package main

import (
	"github.com/jubnzv/go-taskwarrior"
)

func main() {

	tw, _ := taskwarrior.NewTaskWarrior("~/.taskrc")
	tw.FetchAllTasks()
	tw.PrintTasks()
}

To add new task initialize Task object with desired values and use:

tw.Add(newTask)
tw.Commit() // Save changes

For more samples see examples directory and package tests.

Documentation

Index

• Variables
• func GetAvailableKeys() []string
• func PathExpandTilda(path string) string
• func StripComments(line string) string
• type Task
• type TaskRC
  • func ParseTaskRC(configPath string) (*TaskRC, error)
  • func (c *TaskRC) MapTaskRC(buf string) error
• type TaskWarrior
  • func NewTaskWarrior(configPath string) (*TaskWarrior, error)
  • func (tw *TaskWarrior) AddTask(task *Task)
  • func (tw *TaskWarrior) Commit() error
  • func (tw *TaskWarrior) FetchAllTasks() error
  • func (tw *TaskWarrior) PrintTasks()

Variables

var TASKRC = PathExpandTilda("~/.taskrc")

Default configuration path.

Functions

func GetAvailableKeys

func GetAvailableKeys() []string

Return list of available configuration options represented by TaskRC structure fields.

func PathExpandTilda

func PathExpandTilda(path string) string

Expand tilda in filepath as $HOME of current user.

func StripComments

func StripComments(line string) string

Remove commented part of input string.

Types

type Task

type Task struct {
	Description string  `json:"description"`
	Project     string  `json:"project,omitempty"`
	Status      string  `json:"status,omitempty"`
	Uuid        string  `json:"uuid,omitempty"`
	Urgency     float32 `json:"urgency,omitempty"`
	Priority    string  `json:"priority,omitempty"`
	Due         string  `json:"due,omitempty"`
	End         string  `json:"end,omitempty"`
	Entry       string  `json:"entry,omitempty"`
	Modified    string  `json:"modified,omitempty"`
}

Task representation.

type TaskRC

type TaskRC struct {
	ConfigPath   string // Location of this .taskrc
	DataLocation string `taskwarrior:"data.location"`
}

Describes configuration file entries that currently supported by this library.

func ParseTaskRC

func ParseTaskRC(configPath string) (*TaskRC, error)

Return new TaskRC struct instance that contains fields with given configuration file values.

func (*TaskRC) MapTaskRC

func (c *TaskRC) MapTaskRC(buf string) error

Map buffer values to given TaskRC struct.

type TaskWarrior

type TaskWarrior struct {
	Config *TaskRC // Configuration options
	Tasks  []Task  // Task JSON entries
}

Represents a single taskwarrior instance.

func NewTaskWarrior

func NewTaskWarrior(configPath string) (*TaskWarrior, error)

Create new empty TaskWarrior instance.

func (*TaskWarrior) AddTask

func (tw *TaskWarrior) AddTask(task *Task)

Add new Task entry to given TaskWarrior.

func (*TaskWarrior) Commit

func (tw *TaskWarrior) Commit() error

Save current changes of given TaskWarrior instance.

func (*TaskWarrior) FetchAllTasks

func (tw *TaskWarrior) FetchAllTasks() error

Fetch all tasks for given TaskWarrior with system `taskwarrior` command call.

func (*TaskWarrior) PrintTasks

func (tw *TaskWarrior) PrintTasks()

Pretty print for all tasks represented in given TaskWarrior.