Introducing ota cancel command

Author: rjtokenring

cli/ota/cancel.go

@@ -0,0 +1,64 @@
+// This file is part of arduino-cloud-cli.
+//
+// Copyright (C) 2021 ARDUINO SA (http://www.arduino.cc/)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published
+// by the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+package ota
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/arduino/arduino-cli/cli/errorcodes"
+	"github.com/arduino/arduino-cli/cli/feedback"
+	"github.com/arduino/arduino-cloud-cli/command/ota"
+	"github.com/arduino/arduino-cloud-cli/config"
+	"github.com/spf13/cobra"
+)
+
+type cancelFlags struct {
+	otaID string
+}
+
+func initOtaCancelCommand() *cobra.Command {
+	flags := &statusFlags{}
+	uploadCommand := &cobra.Command{
+		Use:   "cancel",
+		Short: "OTA cancel",
+		Long:  "Cancel OTA by OTA ID",
+		Run: func(cmd *cobra.Command, args []string) {
+			if err := runOtaCancelCommand(flags); err != nil {
+				feedback.Errorf("Error during ota cancel: %v", err)
+				os.Exit(errorcodes.ErrGeneric)
+			}
+		},
+	}
+	uploadCommand.Flags().StringVarP(&flags.otaID, "ota-id", "o", "", "OTA ID")
+
+	return uploadCommand
+}
+
+func runOtaCancelCommand(flags *statusFlags) error {
+	if flags.otaID == "" {
+		return fmt.Errorf("required flag \"ota-id\" not set")
+	}
+
+	cred, err := config.RetrieveCredentials()
+	if err != nil {
+		return fmt.Errorf("retrieving credentials: %w", err)
+	}
+
+	return ota.PrintOtaStatus(flags.otaID, flags.otaIDs, flags.deviceId, cred, int(flags.limit), flags.sort)
+}

cli/ota/ota.go

@@ -33,6 +33,7 @@ func NewCommand() *cobra.Command {
 	otaCommand.AddCommand(initOtaStatusCommand())
 	otaCommand.AddCommand(initEncodeBinaryCommand())
 	otaCommand.AddCommand(initDecodeHeaderCommand())
+	otaCommand.AddCommand(initOtaCancelCommand())
 
 	return otaCommand
 }

cli/ota/status.go

@@ -43,7 +43,7 @@ func initOtaStatusCommand() *cobra.Command {
 		Short: "OTA status",
 		Long:  "Get OTA status by OTA or device ID",
 		Run: func(cmd *cobra.Command, args []string) {
-			if err := runOtaStatusCommand(flags); err != nil {
+			if err := runOtaCancelCommand(flags); err != nil {
 				feedback.Errorf("Error during ota get status: %v", err)
 				os.Exit(errorcodes.ErrGeneric)
 			}

command/ota/cancel.go

@@ -0,0 +1,27 @@
+package ota
+
+import (
+	"fmt"
+
+	"github.com/arduino/arduino-cli/cli/feedback"
+	"github.com/arduino/arduino-cloud-cli/config"
+	otaapi "github.com/arduino/arduino-cloud-cli/internal/ota-api"
+)
+
+func CancelOta(otaid string, cred *config.Credentials) error {
+
+	if feedback.GetFormat() == feedback.JSONMini {
+		return fmt.Errorf("jsonmini format is not supported for this command")
+	}
+
+	otapi := otaapi.NewClient(cred)
+
+	if otaid != "" {
+		_, err := otapi.CancelOta(otaid)
+		if err != nil {
+			return err
+		}
+	}
+
+	return nil
+}

internal/ota-api/client.go

@@ -58,7 +58,11 @@ func NewClient(credentials *config.Credentials) *OtaApiClient {
 }
 
 func (c *OtaApiClient) performGetRequest(endpoint, token string) (*http.Response, error) {
-	req, err := http.NewRequest("GET", endpoint, nil)
+	return c.performRequest(endpoint, "GET", token)
+}
+
+func (c *OtaApiClient) performRequest(endpoint, method, token string) (*http.Response, error) {
+	req, err := http.NewRequest(method, endpoint, nil)
 	if err != nil {
 		return nil, err
 	}
@@ -205,3 +209,35 @@ func (c *OtaApiClient) GetOtaStatusByDeviceID(deviceID string, limit int, order
 
 	return nil, err
 }
+
+func (c *OtaApiClient) CancelOta(otaid string) (bool, error) {
+
+	if otaid == "" {
+		return false, fmt.Errorf("invalid ota-id: empty")
+	}
+
+	userRequestToken, err := c.src.Token()
+	if err != nil {
+		if strings.Contains(err.Error(), "401") {
+			return false, errors.New("wrong credentials")
+		}
+		return false, fmt.Errorf("cannot retrieve a valid token: %w", err)
+	}
+
+	endpoint := c.host + "/ota/v1/ota/" + otaid + "/cancel"
+	res, err := c.performRequest(endpoint, "PUT", userRequestToken.AccessToken)
+	if err != nil {
+		return false, err
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode == 200 {
+		return true, nil
+	} else if res.StatusCode == 404 || res.StatusCode == 400 {
+		return false, fmt.Errorf("ota-id %s not found", otaid)
+	} else if res.StatusCode == 409 {
+		return false, ErrAlreadyInProgress
+	}
+
+	return false, err
+}