trackd

A rewrite of the command-line ReinH-track (voxdolo/track) as a skinny daemon + command-line client.

Usage

# start server daemon
trackd -d start
# start time => POST /1/projects/my-project/logs?task=config%20dbase
track start my-project config dbase
# or simply
track my-project config dbase
# stop time on current => PUT /1/current/logs
track stop
# stop time with message => PUT /1/current/logs?message=I%20did%20some%20work
track stop "I did some work"
# restart last => POST /1/last/logs
track restart
# print report of times by project and task => GET /1/projects
track cat
# print summary report by project => GET /1/status
track status
# print summary report for project by task => GET /1/projects/my-project/status
track status my-project
# print summary report by project and task => GET /1/projects/my-project/status?task=config%20dbase
track status my-project config dbase
# add time to named task => PUT /1/projects/my-project/logs?task=config%20dbase&time=30
track add 00:30 my-project config dbase
# subtract time from last => PUT /1/last/logs?time=-60
track sub 01:00
# add shortcut
track shortcut add mp my-project

REST API

(v1 draft - not fully implemented)

Command	Verb	URL	Params	Redirect to
start x y	POST	/1/projects/x/logs	task=y	/1/logs/:id (1)
restart	POST	/1/last/logs	-	/1/logs/:id
stop	PUT	/1/current/logs	-	/1/logs/:id
stop m	PUT	/1/current/logs/?message=m	-	/1/logs/:id
add t x y	PUT	/1/projects/x/logs	task=y&time=t	/1/logs/:id
add t	PUT	/1/last/logs	time=t	/1/logs/:id
sub t x y	PUT	/1/projects/x/logs	task=y&time=-t	/1/logs/:id
sub t	PUT	/1/last/logs	time=-t	/1/logs/:id
cat	GET	/1/logs (2)	-	-
status	GET	/1/status (3)	-	-
status x	GET	/1/projects/x/status (4)	-	-
status x y	GET	/1/projects/x/status (5)	task=y	-

All messages are in JSON format.

(1) log message:

id: <int>
task : <string>
started_at : <time>
stopped_at : <time>
adjusted : <int>
duration : <int>
message : <string>
project :
id: <int>
name: <string>

(2) logs message (order by started_at desc)

-
id: <int>
task : <string>
started_at : <time>
stopped_at : <time>
adjusted : <int>
duration : <int>
message : <string>
project :
id: <int>
name: <string>
-
# ...

project-logs message -- not currently used, GET /1/projects

-
name : <string>
logs :
- task : <string>
started_at : <time>
stopped_at : <time>
adjusted : <int>
duration : <int>
message : <string>
-
# ...
name : <string>
logs :
- # ...
# ...

(3) server status message (note projects are ordered by last_started_at desc, project name)

server_uptime : <int>
total_duration : <int>
current_log:
id: <int>
task : <string>
started_at : <time>
stopped_at : <time>
adjusted : <int>
duration : <int>
message : <string>
project :
id: <int>
name: <string>
projects :
-
name : <string>
last_task : <string>
last_started_at : <time>
last_stopped_at : <time>
last_duration : <int>
total_duration : <int>
-
# ...

(4) project status message: (not yet implemented)

name : <string>
total_duration : <int>
tasks :
-
task : <string>
last_started_at : <time>
last_stopped_at : <time>
last_duration : <int>
total_duration : <int>
-
# ...

(5) project-task status message: (not yet implemented)

task : <string>
last_started_at : <time>
last_stopped_at : <time>
last_duration : <int>
total_duration : <int>
project :
id: <int>
name: <string>