Added apply template

Author: rjtokenring

command/template/apply.go

@@ -20,6 +20,7 @@ package template
 import (
 	"context"
 	"fmt"
+	"strings"
 
 	"github.com/arduino/arduino-cli/cli/feedback"
 	"github.com/arduino/arduino-cloud-cli/config"
@@ -92,7 +93,7 @@ func resolveDeviceNetworkConfigurations(ctx context.Context, cl *iot.Client, dev
 		discoveredCredentials[credential.GetSecretName()] = credential
 		if credential.Required {
 			if _, ok := networkCredentials[credential.GetSecretName()]; !ok {
-				return nil, fmt.Errorf("missing mandatory network credential: %s", credential.GetSecretName())
+				return nil, fmt.Errorf("missing mandatory network credential: %s. Available: %s", credential.GetSecretName(), humanReadableCredentials(credentials))
 			}
 		}
 	}
@@ -105,3 +106,15 @@ func resolveDeviceNetworkConfigurations(ctx context.Context, cl *iot.Client, dev
 
 	return networkCredentials, nil
 }
+
+func humanReadableCredentials(cred []iotclient.ArduinoCredentialsv1) string {
+	var buf strings.Builder
+	for _, c := range cred {
+		if c.Required {
+			buf.WriteString(fmt.Sprintf("  - %s (required)", c.GetSecretName()))
+		} else {
+			buf.WriteString(fmt.Sprintf("  - %s", c.GetSecretName()))
+		}
+	}
+	return buf.String()
+}

internal/iot/client.go

@@ -533,6 +533,29 @@ func (cl *Client) DashboardDelete(ctx context.Context, id string) error {
 	return nil
 }
 
+// TemplateApply apply a given template, creating associated resources like things and dashboards.
+func (cl *Client) TemplateApply(ctx context.Context, id, thingId, prefix string, credentials map[string]string) (*iotclient.ArduinoTemplate, error) {
+	ctx, err := ctxWithToken(ctx, cl.token)
+	if err != nil {
+		return nil, err
+	}
+
+	req := cl.api.TemplatesApi.TemplatesApply(ctx)
+	req = req.Template(iotclient.Template{
+		PrefixName:       toStringPointer(prefix),
+		CustomTemplateId: toStringPointer(id),
+		ThingsOptions: map[string]interface{}{
+			thingId: credentials,
+		},
+	})
+	dev, _, err := cl.api.TemplatesApi.TemplatesApplyExecute(req)
+	if err != nil {
+		err = fmt.Errorf("retrieving device, %w", errorDetail(err))
+		return nil, err
+	}
+	return dev, nil
+}
+
 func (cl *Client) setup(client, secret, organization string) error {
 	baseURL := GetArduinoAPIBaseURL()