Merge branch 'master' into v1.3598.0

Author: Codelax

internal/namespaces/secret/v1alpha1/secret_cli.go

@@ -349,44 +349,9 @@ func secretVersionCreate() *core.Command {
 				Deprecated: false,
 				Positional: false,
 			},
-			{
-				Name:       "password-generation.length",
-				Short:      `Length of the password to generate (between 1 and 1024)`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
-			{
-				Name:       "password-generation.no-lowercase-letters",
-				Short:      `Do not include lower case letters by default in the alphabet`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
-			{
-				Name:       "password-generation.no-uppercase-letters",
-				Short:      `Do not include upper case letters by default in the alphabet`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
-			{
-				Name:       "password-generation.no-digits",
-				Short:      `Do not include digits by default in the alphabet`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
-			{
-				Name:       "password-generation.additional-chars",
-				Short:      `Additional ascii characters to be included in the alphabet`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
 			{
 				Name:       "data-crc32",
-				Short:      `The CRC32 checksum of the data as a base-10 integer`,
+				Short:      `(Optional.) The CRC32 checksum of the data as a base-10 integer`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,

internal/namespaces/tem/v1alpha1/tem_cli.go

@@ -221,8 +221,15 @@ func temEmailGet() *core.Command {
 
 func temEmailList() *core.Command {
 	return &core.Command{
-		Short:     `List emails`,
-		Long:      `Retrieve the list of emails sent from a specific domain or for a specific Project or Organization. You must specify the ` + "`" + `region` + "`" + `.`,
+		Short: `List emails`,
+		Long: `Retrieve the list of emails sent from a specific domain or for a specific Project or Organization. You must specify the ` + "`" + `region` + "`" + `.
+You can filter your emails in ascending or descending order using:
+  - created_at
+  - updated_at
+  - status
+  - mail_from
+  - mail_rcpt
+  - subject.`,
 		Namespace: "tem",
 		Resource:  "email",
 		Verb:      "list",
@@ -231,68 +238,83 @@ func temEmailList() *core.Command {
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "project-id",
-				Short:      `ID of the Project in which to list the emails (optional)`,
+				Short:      `(Optional) ID of the Project in which to list the emails`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "domain-id",
-				Short:      `ID of the domain for which to list the emails (optional)`,
+				Short:      `(Optional) ID of the domain for which to list the emails`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "message-id",
-				Short:      `ID of the message for which to list the emails (optional)`,
-				Required:   false,
-				Deprecated: false,
-				Positional: false,
-			},
-			{
-				Name:       "subject",
-				Short:      `Subject of the email`,
+				Short:      `(Optional) ID of the message for which to list the emails`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "since",
-				Short:      `List emails created after this date (optional)`,
+				Short:      `(Optional) List emails created after this date`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "until",
-				Short:      `List emails created before this date (optional)`,
+				Short:      `(Optional) List emails created before this date`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "mail-from",
-				Short:      `List emails sent with this ` + "`" + `mail_from` + "`" + ` sender's address (optional)`,
+				Short:      `(Optional) List emails sent with this sender's email address`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "mail-to",
-				Short:      `List emails sent with this ` + "`" + `mail_to` + "`" + ` recipient's address (optional)`,
+				Short:      `(Deprecated) List emails sent to this recipient's email address`,
+				Required:   false,
+				Deprecated: true,
+				Positional: false,
+			},
+			{
+				Name:       "mail-rcpt",
+				Short:      `(Optional) List emails sent to this recipient's email address`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "statuses.{index}",
-				Short:      `List emails having any of this status (optional)`,
+				Short:      `(Optional) List emails with any of these statuses`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 				EnumValues: []string{"unknown", "new", "sending", "sent", "failed", "canceled"},
 			},
+			{
+				Name:       "subject",
+				Short:      `(Optional) List emails with this subject`,
+				Required:   false,
+				Deprecated: false,
+				Positional: false,
+			},
+			{
+				Name:       "order-by",
+				Short:      `(Optional) List emails corresponding to specific criteria`,
+				Required:   false,
+				Deprecated: false,
+				Positional: false,
+				EnumValues: []string{"created_at_desc", "created_at_asc", "updated_at_desc", "updated_at_asc", "status_desc", "status_asc", "mail_from_desc", "mail_from_asc", "mail_rcpt_desc", "mail_rcpt_asc", "subject_desc", "subject_asc"},
+			},
 			core.RegionArgSpec(scw.RegionFrPar, scw.Region(core.AllLocalities)),
 		},
 		Run: func(ctx context.Context, args interface{}) (i interface{}, e error) {
@@ -327,35 +349,35 @@ func temEmailGetStatistics() *core.Command {
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "project-id",
-				Short:      `Number of emails for this Project (optional)`,
+				Short:      `(Optional) Number of emails for this Project`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "domain-id",
-				Short:      `Number of emails sent from this domain (must be coherent with the ` + "`" + `project_id` + "`" + ` and the ` + "`" + `organization_id` + "`" + `) (optional)`,
+				Short:      `(Optional) Number of emails sent from this domain (must be coherent with the ` + "`" + `project_id` + "`" + ` and the ` + "`" + `organization_id` + "`" + `)`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "since",
-				Short:      `Number of emails created after this date (optional)`,
+				Short:      `(Optional) Number of emails created after this date`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "until",
-				Short:      `Number of emails created before this date (optional)`,
+				Short:      `(Optional) Number of emails created before this date`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "mail-from",
-				Short:      `Number of emails sent with this ` + "`" + `mail_from` + "`" + ` sender's address (optional)`,
+				Short:      `(Optional) Number of emails sent with this sender's email address`,
 				Required:   false,
 				Deprecated: false,
 				Positional: false,