GothenburgBitFactory/taskwarrior
1
0
Fork 0
mirror of https://github.com/GothenburgBitFactory/taskwarrior.git synced 2025-07-07 20:06:36 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

entry and wait time support

Browse source
This commit is contained in:
Dustin J. Mitchell 2022-02-01 02:45:28 +00:00
parent f2b3e5fd0a
commit e5625e1597
8 changed files with 190 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

33
lib/taskchampion.h
View file

@ -1,5 +1,6 @@
#include <stdbool.h>
#include <stdint.h>
#include <time.h>
/**
* Length, in bytes, of the string representation of a UUID (without NUL terminator)
@ -74,8 +75,9 @@ typedef struct TCString TCString;
* to make any changes, and doing so requires exclusive access to the replica
* until the task is freed or converted back to immutable mode.
*
* A task carries no reference to the replica that created it, and can
* be used until it is freed or converted to a TaskMut.
* An immutable task carries no reference to the replica that created it, and can be used until it
* is freed or converted to a TaskMut. A mutable task carries a reference to the replica and
* must be freed or made immutable before the replica is freed.
*
* All `tc_task_..` functions taking a task as an argument require that it not be NULL.
*
@ -264,6 +266,21 @@ enum TCStatus tc_task_get_status(struct TCTask *task);
*/
struct TCString *tc_task_get_description(struct TCTask *task);
/**
* Get the entry timestamp for a task (when it was created), or 0 if not set.
*/
time_t tc_task_get_entry(struct TCTask *task);
/**
* Get the wait timestamp for a task, or 0 if not set.
*/
time_t tc_task_get_wait(struct TCTask *task);
/**
* Check if a task is waiting.
*/
bool tc_task_is_waiting(struct TCTask *task);
/**
* Check if a task is active (started and not stopped).
*/
@ -285,6 +302,18 @@ TCResult tc_task_set_status(struct TCTask *task, enum TCStatus status);
*/
TCResult tc_task_set_description(struct TCTask *task, struct TCString *description);
/**
* Set a mutable task's entry (creation time). Pass entry=0 to unset
* the entry field.
*/
TCResult tc_task_set_entry(struct TCTask *task, time_t entry);
/**
* Set a mutable task's wait (creation time). Pass wait=0 to unset the
* wait field.
*/
TCResult tc_task_set_wait(struct TCTask *task, time_t wait);
/**
* Start a task.
*/