new_tag: update the description flag usage and add test setup

Author: Sazon, John Bryan J

cmd/new_tag.go

@@ -29,7 +29,12 @@ var newTagCmd = &cobra.Command{
 	Aliases: []string{"t"},
 	Short:   "Create a new tag for a specified project",
 	Example: `# create tag from master branch for project groupx/myapp
-gitlabctl new tag v2.0 --project=groupx/myapp --ref=master`,
+gitlabctl new tag v2.0 --project=groupx/myapp --ref=master
+
+# create a tag and create a release from it
+gitlabctl new tag v2.1 --project=groupx/myapp --ref=master --description="Released!"
+
+# NOTE: You can also use 'gitlabctl new release' to create a release separately.`,
 	SilenceErrors:     true,
 	SilenceUsage:      true,
 	DisableAutoGenTag: true,
@@ -49,7 +54,7 @@ func init() {
 	newTagCmd.Flags().StringP("message", "m", "",
 		"Creates annotated tag")
 	newTagCmd.Flags().StringP("description", "d", "",
-		"Add release notes to the git tag")
+		"Create a release from the git tag with the description as the release note")
 }
 
 func runNewTag(cmd *cobra.Command, tag string) error {
@@ -66,7 +71,7 @@ func runNewTag(cmd *cobra.Command, tag string) error {
 	return nil
 }
 
-func newTag(project string, opts *gitlab.CreateTagOptions ) (*gitlab.Tag, error) {
+func newTag(project string, opts *gitlab.CreateTagOptions) (*gitlab.Tag, error) {
 	git, err := newGitlabClient()
 	if err != nil {
 		return nil, err

cmd/new_tag_test.go

@@ -38,18 +38,18 @@ func TestNewTag(t *testing.T) {
 				"project": "Group1/project1",
 				"ref":     "master",
 			},
-			args:   []string{"v2.0"},
+			args:   []string{"v2.0-newtag"},
 			expect: pass,
 		},
 		{
 			name: "create a new tag with release note",
 			flagsMap: map[string]string{
 				"project":     "Group1/project1",
 				"ref":         "master",
-				"message":     "v2.0",
+				"message":     "v2.0-newtag",
 				"description": "Sample Release Note",
 			},
-			args:   []string{"v2.0"},
+			args:   []string{"v2.0-newtag"},
 			expect: pass,
 		},
 		{
@@ -60,6 +60,12 @@ func TestNewTag(t *testing.T) {
 	}
 
 	for _, tc := range tt {
+		// SETUP
+		// Ensure that the tag to create is deleted
+		if tc.expect == pass {
+			err := deleteTag(tc.flagsMap["project"], tc.args[0])
+			tInfo(err)
+		}
 		t.Run(tc.name, func(t *testing.T) {
 			execT := execTestCmdFlags{
 				t:        t,