Complete time tracker API access

.gitignore

@@ -1,2 +1,2 @@
-# Added by goreleaser init:
 dist/
+.DS_Store

README.md

@@ -0,0 +1,23 @@
+# charmite
+
+Charmite is a simple TUI to add/view time entries in the [Mite](https://mite.de/en/)
+time tracking tool.
+
+## Installation
+
+Download the appropriate binary from https://code.ppl.town/justin/charmite/releases
+
+Or compile from the source code with:
+
+    go build .
+
+## Using
+
+You'll need to set the environment variables:
+
+* MITE_API
+* MITE_DOMAIN
+
+To appropriate values.
+
+See the [Mite FAQ](https://mite.de/en/faq.html) under "How do I allow API access for my account? Where can I get an API key?" for details on how to obtain your API key.

build.sh

@@ -1,10 +0,0 @@
-#!/bin/sh
-
-GOOS=linux GOARCH=amd64 go build -o cal_linux_amd64
-GOOS=darwin GOARCH=arm64 go build -o cal_darwin_arm64
-GOOS=windows GOARCH=amd64 go build -o cal_windows_lol_amd64
-
-zip cal.zip cal_linux_amd64 cal_darwin_arm64 cal_windows_lol_amd64
-
-
-open .

mite/mite.go

@@ -3,6 +3,7 @@ package mite
 import (
 	"bytes"
 	"encoding/json"
+	"errors"
 	"fmt"
 	"net/http"
 	"time"
@@ -56,7 +57,7 @@ func (p Project) GetName() string { return p.Name + " (" + p.CustomerName + ")"
 func (a APIClient) GetProjects() (Projects, error) {
 	// GET /projects.json
 	p := APIProjects{}
-	err := get(a.domain, a.apiKey, "/projects.json", &p)
+	err := a.get("/projects.json", &p)
 	if err != nil {
 		return nil, err
 	}
@@ -98,7 +99,7 @@ func (c Customer) GetName() string { return c.Name }
 func (a APIClient) GetCustomers() (Customers, error) {
 	// GET /customers.json
 	p := apiCustomers{}
-	err := get(a.domain, a.apiKey, "/customers.json", &p)
+	err := a.get("/customers.json", &p)
 	if err != nil {
 		return nil, err
 	}
@@ -142,7 +143,7 @@ func (s Service) GetName() string {
 func (a APIClient) GetServices() (Services, error) {
 	// GET /services.json
 	p := apiServices{}
-	err := get(a.domain, a.apiKey, "/services.json", &p)
+	err := a.get("/services.json", &p)
 	if err != nil {
 		return nil, err
 	}
@@ -215,7 +216,7 @@ func (a APIClient) GetTimeEntries(from, to time.Time) (TimeEntries, error) {
 	p := apiTimeEntry{}
 	u := fmt.Sprintf("/time_entries.json?from=%s&to=%s", from.Format(time.DateOnly), to.Format(time.DateOnly))
 
-	err := get(a.domain, a.apiKey, u, &p)
+	err := a.get(u, &p)
 	if err != nil {
 		return nil, err
 	}
@@ -253,23 +254,162 @@ func (a APIClient) AddTimeEntry(date string, minutes int, notes string, projectI
 	req.RequestTimeEntryHolder.ProjectID = projectId
 	req.RequestTimeEntryHolder.ServiceID = serviceId
 
-	err := post(a.domain, a.apiKey, "/time_entries.json", req)
+	err := a.post("/time_entries.json", req)
 	return err
-
 }
 
-func post(domain, apiKey, path string, data any) error {
+type apiTimeTrackerEntry struct {
+	TimeTrackerHolder timeTrackerHolder `json:"tracker"`
+}
+
+type timeTrackerHolder struct {
+	TrackingTimeEntry *TrackingTimeEntry `json:"tracking_time_entry"`
+	StoppedTimeEntry  *StoppedTimeEntry  `json:"stopped_time_entry"`
+}
+
+type TrackingTimeEntry struct {
+	ID      int       `json:"id"`
+	Minutes int       `json:"minutes"`
+	Since   time.Time `json:"since"`
+}
+
+type StoppedTimeEntry struct {
+	ID      int `json:"id"`
+	Minutes int `json:"minutes"`
+}
+
+// {
+// 	"tracker": {
+// 	  "tracking_time_entry": {
+// 		"id": 36135322,
+// 		"minutes": 0,
+// 		"since": "2015-10-15T17:33:52+02:00"
+// 	  },
+// 	 "stopped_time_entry": {
+// 		"id": 36134329,
+// 		"minutes": 46
+// 	  }
+// 	}
+//   }
+
+// {
+// 	"tracker": {
+// 	  "tracking_time_entry": {
+// 		"id": 36135321,
+// 		"minutes": 247,
+// 		"since": "2015-10-15T17:05:04+02:00"
+// 	  }
+// 	}
+//   }
+
+var ErrNoTracker = errors.New("no time tracker running")
+
+// GetTimeTracker gets the current running time tracker. If no tracker is
+// running, the error returned will be ErrNoTracker
+func (a APIClient) GetTimeTracker() (TrackingTimeEntry, error) {
+	r := apiTimeTrackerEntry{}
+	err := a.get("/tracker.json", &r)
+	if err != nil {
+		return TrackingTimeEntry{}, err
+	}
+	if r.TimeTrackerHolder.TrackingTimeEntry == nil {
+		return TrackingTimeEntry{}, ErrNoTracker
+	}
+	return *r.TimeTrackerHolder.TrackingTimeEntry, nil
+}
+
+func (a APIClient) StartTimeTracker(id int) (TrackingTimeEntry, *StoppedTimeEntry, error) {
+	url := fmt.Sprintf("/tracker/%d.json", id)
+	r := apiTimeTrackerEntry{}
+
+	err := a.patch(url, &r)
+
+	if err != nil {
+		return TrackingTimeEntry{}, nil, err
+	}
+	if r.TimeTrackerHolder.TrackingTimeEntry == nil {
+		// I don't think this should happen, the patch should have been a 404?
+
+		panic(fmt.Sprintf("unexpected failure to find a tracking entry in a successful PATCH\n%#v", r.TimeTrackerHolder))
+	}
+	return *r.TimeTrackerHolder.TrackingTimeEntry, r.TimeTrackerHolder.StoppedTimeEntry, nil
+}
+
+func (a APIClient) StopTimeTracker(id int) (StoppedTimeEntry, error) {
+	url := fmt.Sprintf("/tracker/%d.json", id)
+	r := apiTimeTrackerEntry{}
+
+	err := a.delete(url, &r)
+
+	if err != nil {
+		return StoppedTimeEntry{}, err
+	}
+	if r.TimeTrackerHolder.StoppedTimeEntry == nil {
+		// I don't think this should happen, the patch should have been a 404?
+
+		panic(fmt.Sprintf("unexpected failure to find a tracking entry in a successful DELETE\n%#v", r.TimeTrackerHolder))
+	}
+	return *r.TimeTrackerHolder.StoppedTimeEntry, nil
+}
+
+func (a APIClient) delete(path string, data any) error {
+
+	req, err := http.NewRequest("DELETE", baseurl(a.domain, path), nil)
+	if err != nil {
+		return err
+	}
+	req.Header.Add("X-MiteApiKey", a.apiKey)
+	resp, err := http.DefaultClient.Do(req)
+
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode >= 300 {
+		return fmt.Errorf("expected 2XX, got %d", resp.StatusCode)
+	}
+	err = json.NewDecoder(resp.Body).Decode(&data)
+	if err != nil {
+		return err
+	}
+	return nil
+}
+
+func (a APIClient) patch(path string, data any) error {
+
+	req, err := http.NewRequest("PATCH", baseurl(a.domain, path), nil)
+	if err != nil {
+		return err
+	}
+	req.Header.Add("X-MiteApiKey", a.apiKey)
+	resp, err := http.DefaultClient.Do(req)
+
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode >= 300 {
+		return fmt.Errorf("expected 2XX, got %d", resp.StatusCode)
+	}
+	err = json.NewDecoder(resp.Body).Decode(&data)
+	if err != nil {
+		return err
+	}
+	return nil
+}
+
+func (a APIClient) post(path string, data any) error {
 
 	b, err := json.Marshal(data)
 	if err != nil {
 		return err
 	}
 
-	req, err := http.NewRequest("POST", baseurl(domain, path), bytes.NewBuffer(b))
+	req, err := http.NewRequest("POST", baseurl(a.domain, path), bytes.NewBuffer(b))
 	if err != nil {
 		return err
 	}
-	req.Header.Add("X-MiteApiKey", apiKey)
+	req.Header.Add("X-MiteApiKey", a.apiKey)
 	req.Header.Add("Content-Type", "application/json")
 	resp, err := http.DefaultClient.Do(req)
 
@@ -285,12 +425,12 @@ func post(domain, apiKey, path string, data any) error {
 
 }
 
-func get(domain, apiKey, path string, data any) error {
+func (a APIClient) get(path string, data any) error {
-	req, err := http.NewRequest("GET", baseurl(domain, path), nil)
+	req, err := http.NewRequest("GET", baseurl(a.domain, path), nil)
 	if err != nil {
 		return err
 	}
-	req.Header.Add("X-MiteApiKey", apiKey)
+	req.Header.Add("X-MiteApiKey", a.apiKey)
 	resp, err := http.DefaultClient.Do(req)
 
 	if err != nil {
@@ -305,7 +445,6 @@ func get(domain, apiKey, path string, data any) error {
 		return err
 	}
 	return nil
-
 }
 
 func baseurl(domain, path string) string {

mite/mite_test.go

@@ -0,0 +1,82 @@
+package mite
+
+import (
+	"encoding/json"
+	"testing"
+)
+
+func TestUnmarshalTimeTracking(t *testing.T) {
+
+	trackerOff := []byte(`{
+	"tracker": {}
+  }`)
+	off := apiTimeTrackerEntry{}
+	err := json.Unmarshal(trackerOff, &off)
+	if err != nil {
+		t.Error(err)
+	} else {
+		if off.TimeTrackerHolder.TrackingTimeEntry != nil {
+			t.Error("expected nil, but is not")
+		}
+	}
+	trackerOn := []byte(`
+	{
+		"tracker": {
+		  "tracking_time_entry": {
+			"id": 36135321,
+			"minutes": 247,
+			"since": "2015-10-15T17:05:04+02:00"
+		  }
+		}
+	  }`)
+	on := apiTimeTrackerEntry{}
+	err = json.Unmarshal(trackerOn, &on)
+	if err != nil {
+		t.Error(err)
+	} else {
+		if on.TimeTrackerHolder.TrackingTimeEntry == nil {
+			t.Error("expected not nil, but is not")
+		} else {
+			if on.TimeTrackerHolder.TrackingTimeEntry.ID != 36135321 {
+				t.Error("bad unmarshal?")
+			}
+		}
+	}
+
+	trackerStart := []byte(`{
+  "tracker": {
+    "tracking_time_entry": {
+      "id": 36135322,
+      "minutes": 0,
+      "since": "2015-10-15T17:33:52+02:00"
+    },
+   "stopped_time_entry": {
+      "id": 36134329,
+      "minutes": 46
+    }
+  }
+}`)
+	start := apiTimeTrackerEntry{}
+	err = json.Unmarshal(trackerStart, &start)
+	if err != nil {
+		t.Error(err)
+	} else {
+		if start.TimeTrackerHolder.TrackingTimeEntry == nil {
+			t.Error("expected not nil, but is not")
+		} else {
+			if start.TimeTrackerHolder.TrackingTimeEntry.ID != 36135322 {
+				t.Error("bad unmarshal?")
+			}
+		}
+
+		if start.TimeTrackerHolder.StoppedTimeEntry == nil {
+			t.Error("expected not nil, but is nil")
+		} else {
+			if start.TimeTrackerHolder.StoppedTimeEntry.ID != 36134329 {
+				t.Error("bad unmarshal")
+			}
+		}
+
+	}
+
+}