WIP: Client API implementation

client_api/api/api.proto

@@ -0,0 +1,33 @@
+syntax = "proto3";
+
+package api;
+
+// Notary Interface
+service Notary {
+    // AddTarget adds a target to the TUF repository and re-signs.
+    rpc AddTarget(TargetAction) returns (BasicResponse) {}
+
+    // RemoveTarget deletes a target from the TUF repository and re-signs. It only
+    // uses the `name` field from the Target object, ignoring all other fields
+    rpc RemoveTarget(TargetAction) returns (BasicResponse) {}
+}
+
+// Target message describes a TUF target.
+message TargetAction {
+    string gun = 1;
+    string name = 2;
+    int64 length = 3;
+    map<string, bytes> hashes = 4;
+    bytes custom = 5;
+}
+
+// BasicResponse describes a response with a true/false success indicator,
+// and if false, an error type and message. See the errors.go file in this
+// package for the possible errors and a translation function between the
+// BasicResponse object and a concrete error type.
+message BasicResponse {
+    bool success = 1;
+    string message = 2;
+}
+
+

client_api/api/client.go

@@ -0,0 +1,10 @@
+package api
+
+import "google.golang.org/grpc"
+
+type Client struct {}
+
+func NewClient(conn *grpc.ClientConn) (NotaryClient, error) {
+
+	return NewNotaryClient(conn), nil
+}

client_api/api/errors.go

@@ -0,0 +1,20 @@
+package api
+
+type ErrUnknown struct {
+	msg string
+}
+
+func NewErrorUnknown(msg string) error {
+	return ErrUnknown{msg: msg}
+}
+
+func (err ErrUnknown) Error() string {
+	return err.msg
+}
+
+func translateAPIError(t string, msg string) error {
+	switch t{
+	default:
+		return NewErrorUnknown(msg)
+	}
+}

client_api/api/generator.go

@@ -0,0 +1,5 @@
+package api
+
+// this file exists solely to allow us to use `go generate` to build our
+// compiled GRPC interface for Go.
+//go:generate protoc -I ./ ./api.proto --go_out=plugins=grpc:.