feat: add grpc flash command

Author: MatteoPologruto

rpc/cc/arduino/flasher/v1/commands.pb.go

@@ -24,6 +24,7 @@ option go_package = "github.com/arduino/arduino-flasher-cli/rpc/cc/arduino/flash
 service Flasher {
     rpc List(ListRequest) returns (ListResponse) {};
     rpc Download(DownloadRequest) returns (stream DownloadResponse);
+    rpc Flash(FlashRequest) returns (stream FlashResponse);
 }
 
 message ListRequest {}
@@ -55,3 +56,28 @@ message DownloadResponse {
     Result result = 2;
   }
 }
+
+message FlashRequest {
+  // The version of the Debian image to download.
+  string version = 1;
+  // The path in which the image will be downloaded and extracted.
+  string temp_path = 2;
+  // Preserve user partition if possible.
+  bool preserve_user = 3;
+}
+
+message FlashResponse {
+  message Result {
+    // Empty message, reserved for future expansion.
+  }
+  oneof message {
+    // Progress of the download.
+    DownloadProgress download_progress = 1;
+    // Progress of the extraction.
+    TaskProgress extraction_progress = 2;
+    // Progress of qdl flashing.
+    TaskProgress flash_progress = 3;
+    // Download result.
+    Result result = 4;
+  }
+}

rpc/cc/arduino/flasher/v1/commands.proto

@@ -53,3 +53,6 @@ func (d DownloadProgressCB) End(success bool, message string) {
 		},
 	})
 }
+
+// TaskProgressCB is a callback to receive progress messages
+type TaskProgressCB func(msg *TaskProgress)

rpc/cc/arduino/flasher/v1/commands_grpc.pb.go

@@ -51,3 +51,14 @@ message DownloadProgressEnd {
   // "File xxx already downloaded" or "Connection timeout".
   string message = 2;
 }
+
+message TaskProgress {
+  // Description of the task.
+  string name = 1;
+  // Additional information about the task.
+  string message = 2;
+  // Whether the task is complete.
+  bool completed = 3;
+  // Amount in percent of the task completion (optional).
+  float percent = 4;
+}