Onboard Intake (1/3): introduce intake runner command

Author: Yago Carlos Fernandez Gou

docs/stackit.md

@@ -34,6 +34,7 @@ stackit [flags]
 * [stackit dns](./stackit_dns.md)	 - Provides functionality for DNS
 * [stackit git](./stackit_git.md)	 - Provides functionality for STACKIT Git
 * [stackit image](./stackit_image.md)	 - Manage server images
+* [stackit intake](./stackit_intake.md)	 - Provides functionality for STACKIT Intake
 * [stackit key-pair](./stackit_key-pair.md)	 - Provides functionality for SSH key pairs
 * [stackit load-balancer](./stackit_load-balancer.md)	 - Provides functionality for Load Balancer
 * [stackit logme](./stackit_logme.md)	 - Provides functionality for LogMe

docs/stackit_intake.md

@@ -0,0 +1,41 @@
+## stackit intake
+
+Provides functionality for STACKIT Intake
+
+### Synopsis
+
+Provides functionality for STACKIT Intake.
+
+```
+stackit intake [flags]
+```
+
+### Examples
+
+```
+  
+  $ stackit intake
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit intake"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit](./stackit.md)	 - Manage STACKIT resources using the command line
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

docs/stackit_intake_runner.md

@@ -0,0 +1,38 @@
+## stackit intake runner
+
+Provides functionality for Intake Runners
+
+### Synopsis
+
+Provides functionality for Intake Runners.
+
+```
+stackit intake runner [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit intake runner"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake](./stackit_intake.md)	 - Provides functionality for STACKIT Intake
+* [stackit intake runner create](./stackit_intake_runner_create.md)	 - Creates a new Intake Runner
+* [stackit intake runner delete](./stackit_intake_runner_delete.md)	 - Deletes an Intake Runner
+* [stackit intake runner describe](./stackit_intake_runner_describe.md)	 - Shows details of an Intake Runner
+* [stackit intake runner list](./stackit_intake_runner_list.md)	 - Lists all Intake Runners
+* [stackit intake runner update](./stackit_intake_runner_update.md)	 - Updates an Intake Runner
+

docs/stackit_intake_runner_create.md

@@ -0,0 +1,48 @@
+## stackit intake runner create
+
+Creates a new Intake Runner
+
+### Synopsis
+
+Creates a new Intake Runner.
+
+```
+stackit intake runner create [flags]
+```
+
+### Examples
+
+```
+  Create a new Intake Runner with a display name and message capacity limits
+  $ stackit intake runner create --display-name my-runner --max-message-size-kib 1000 --max-messages-per-hour 5000
+
+  Create a new Intake Runner with a description and labels
+  $ stackit intake runner create --display-name my-runner --max-message-size-kib 1000 --max-messages-per-hour 5000 --description "Main runner for production" --labels="env=prod,team=billing"
+```
+
+### Options
+
+```
+      --description string          Description
+      --display-name string         Display name
+  -h, --help                        Help for "stackit intake runner create"
+      --labels stringToString       Labels in key=value format, separated by commas. Example: --labels "key1=value1,key2=value2" (default [])
+      --max-message-size-kib int    Maximum message size in KiB
+      --max-messages-per-hour int   Maximum number of messages per hour
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

docs/stackit_intake_runner_delete.md

@@ -0,0 +1,40 @@
+## stackit intake runner delete
+
+Deletes an Intake Runner
+
+### Synopsis
+
+Deletes an Intake Runner.
+
+```
+stackit intake runner delete RUNNER_ID [flags]
+```
+
+### Examples
+
+```
+  Delete an Intake Runner with ID "xxx"
+  $ stackit intake runner delete xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit intake runner delete"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

docs/stackit_intake_runner_describe.md

@@ -0,0 +1,43 @@
+## stackit intake runner describe
+
+Shows details of an Intake Runner
+
+### Synopsis
+
+Shows details of an Intake Runner.
+
+```
+stackit intake runner describe RUNNER_ID [flags]
+```
+
+### Examples
+
+```
+  Get details of an Intake Runner with ID "xxx"
+  $ stackit intake runner describe xxx
+
+  Get details of an Intake Runner with ID "xxx" in JSON format
+  $ stackit intake runner describe xxx --output-format json
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit intake runner describe"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

docs/stackit_intake_runner_list.md

@@ -0,0 +1,47 @@
+## stackit intake runner list
+
+Lists all Intake Runners
+
+### Synopsis
+
+Lists all Intake Runners for the current project.
+
+```
+stackit intake runner list [flags]
+```
+
+### Examples
+
+```
+  List all Intake Runners
+  $ stackit intake runner list
+
+  List all Intake Runners in JSON format
+  $ stackit intake runner list --output-format json
+
+  List up to 5 Intake Runners
+  $ stackit intake runner list --limit 5
+```
+
+### Options
+
+```
+  -h, --help        Help for "stackit intake runner list"
+      --limit int   Maximum number of entries to list
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

docs/stackit_intake_runner_update.md

@@ -0,0 +1,51 @@
+## stackit intake runner update
+
+Updates an Intake Runner
+
+### Synopsis
+
+Updates an Intake Runner. Only the specified fields are updated.
+
+```
+stackit intake runner update RUNNER_ID [flags]
+```
+
+### Examples
+
+```
+  Update the display name of an Intake Runner with ID "xxx"
+  $ stackit intake runner update xxx --display-name "new-runner-name"
+
+  Update the message capacity limits for an Intake Runner with ID "xxx"
+  $ stackit intake runner update xxx --max-message-size-kib 2000 --max-messages-per-hour 10000
+
+  Clear the labels of an Intake Runner with ID "xxx" by providing an empty value
+  $ stackit intake runner update xxx --labels ""
+```
+
+### Options
+
+```
+      --description string          Description
+      --display-name string         Display name
+  -h, --help                        Help for "stackit intake runner update"
+      --labels string               Labels in key=value format. To clear all labels, provide an empty string, e.g. --labels ""
+      --max-message-size-kib int    Maximum message size in KiB. Note: Overall message capacity cannot be decreased.
+      --max-messages-per-hour int   Maximum number of messages per hour. Note: Overall message capacity cannot be decreased.
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit intake runner](./stackit_intake_runner.md)	 - Provides functionality for Intake Runners
+

go.mod

@@ -181,6 +181,7 @@ require (
 	github.com/sonatard/noctx v0.1.0 // indirect
 	github.com/sourcegraph/go-diff v0.7.0 // indirect
 	github.com/ssgreg/nlreturn/v2 v2.2.1 // indirect
+	github.com/stackitcloud/stackit-sdk-go/services/intake v0.1.0 // indirect
 	github.com/stbenjam/no-sprintf-host-port v0.2.0 // indirect
 	github.com/stretchr/objx v0.5.2 // indirect
 	github.com/stretchr/testify v1.11.1 // indirect

internal/cmd/intake/common/util.go

@@ -0,0 +1,27 @@
+package common
+
+import (
+	"fmt"
+	"strings"
+)
+
+// ParseLabels parses the labels flag value into a map.
+// An empty string clears the labels, returning a pointer to an empty map.
+func ParseLabels(labelsVal string) (map[string]string, error) {
+	if labelsVal == "" {
+		// User wants to clear labels
+		return map[string]string{}, nil
+	}
+
+	// User provided labels, parse them
+	parsedLabels := make(map[string]string)
+	pairs := strings.Split(labelsVal, ",")
+	for _, pair := range pairs {
+		kv := strings.SplitN(pair, "=", 2)
+		if len(kv) != 2 || kv[0] == "" {
+			return nil, fmt.Errorf("invalid label format, expected key=value: %q", pair)
+		}
+		parsedLabels[kv[0]] = kv[1]
+	}
+	return parsedLabels, nil
+}