chore: add use examples for secrets commands (#111)

Author: inessebz

cmd/okms/secrets/secrets.go

@@ -64,9 +64,10 @@ func kvPutCmd() *cobra.Command {
 	)
 
 	cmd := &cobra.Command{
-		Use:   "put PATH [DATA]",
-		Short: "Writes the data to the given path in the key-value store. (DATA format: bar=baz)",
-		Args:  cobra.MinimumNArgs(2),
+		Use:     "put PATH DATA...",
+		Short:   "Writes the data to the given path in the key-value store. (DATA format: bar=baz [email protected])",
+		Args:    cobra.MinimumNArgs(2),
+		Example: "put foo/bar zip=zap [email protected] | put foo/bar @data.json",
 		Run: func(cmd *cobra.Command, args []string) {
 			in := io.Reader(os.Stdin)
 
@@ -108,9 +109,10 @@ func kvPatchCmd() *cobra.Command {
 	)
 
 	cmd := &cobra.Command{
-		Use:   "patch PATH [DATA]",
-		Short: "Writes the data to the given path in the key-value store. (DATA format: bar=baz)",
-		Args:  cobra.MinimumNArgs(2),
+		Use:     "patch PATH DATA...",
+		Short:   "Writes the data to the given path in the key-value store. (DATA format: bar=baz [email protected])",
+		Args:    cobra.MinimumNArgs(2),
+		Example: "patch foo/bar zip=zap [email protected] | patch foo/bar @data.json",
 		Run: func(cmd *cobra.Command, args []string) {
 			in := io.Reader(os.Stdin)
 

cmd/okms/secretsV2/secrets.go

@@ -16,8 +16,6 @@ import (
 )
 
 func secretListCmd() *cobra.Command {
-	// TODO: Fix
-	// It generate a 500 in the CCM currently
 	var (
 		page_size   uint32
 		page_number uint32
@@ -53,9 +51,10 @@ func secretPostCmd() *cobra.Command {
 		customMetadata         map[string]string
 	)
 	cmd := &cobra.Command{
-		Use:   "create PATH [DATA]",
-		Short: "Create a secret",
-		Args:  cobra.MinimumNArgs(2),
+		Use:     "create PATH DATA...",
+		Short:   "Create a secret. Data is in key value format, a json file can also be used by adding the prefix '@' (exp: bar=baz [email protected])",
+		Args:    cobra.MinimumNArgs(2),
+		Example: "create foo/bar zip=zap [email protected] | create foo/bar @data.json",
 		Run: func(cmd *cobra.Command, args []string) {
 			in := io.Reader(os.Stdin)
 			body := types.PostSecretV2Request{
@@ -144,9 +143,10 @@ func secretPutCmd() *cobra.Command {
 		customMetadata         map[string]string
 	)
 	cmd := &cobra.Command{
-		Use:   "update  PATH [DATA]",
-		Short: "Update a secret",
-		Args:  cobra.MinimumNArgs(1),
+		Use:     "update PATH [DATA]...",
+		Short:   "Update a secret",
+		Args:    cobra.MinimumNArgs(1),
+		Example: "update foo/bar zip=zap [email protected] | update --cas-required foo/bar @data.json",
 		Run: func(cmd *cobra.Command, args []string) {
 			in := io.Reader(os.Stdin)
 			body := types.PutSecretV2Request{