Add create uuid command (facebookincubator#566)

Summary:

This exposes the existing UUID generation mechanism used internally by `ttpforge create ttp` as a standalone command for user convenience. While TTPs created with `create ttp` already include an automatically generated UUID, users sometimes need to manually generate UUIDs when manually creating or editing TTP files.

Reviewed By: RoboticPrism

Differential Revision: D85156307

Author: isaac-fletcher

cmd/create.go

@@ -31,5 +31,6 @@ func buildCreateCommand() *cobra.Command {
 		TraverseChildren: true,
 	}
 	createCmd.AddCommand(buildCreateTTPCommand())
+	createCmd.AddCommand(buildCreateUUIDCommand())
 	return createCmd
 }

cmd/createuuid.go

@@ -0,0 +1,41 @@
+/*
+Copyright © 2023-present, Meta Platforms, Inc. and affiliates
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/google/uuid"
+	"github.com/spf13/cobra"
+)
+
+func buildCreateUUIDCommand() *cobra.Command {
+	createUUIDCmd := &cobra.Command{
+		Use:   "uuid",
+		Short: "Generate and print a new UUID",
+		Long:  "Generate a new UUID and print it to the console",
+		RunE: func(cmd *cobra.Command, args []string) error {
+			newUUID := uuid.New()
+			fmt.Println(newUUID.String())
+			return nil
+		},
+	}
+	return createUUIDCmd
+}

docs/foundations/create.md

@@ -15,6 +15,20 @@ execute your new TTP.
 TTPForge will create the specified file and populate it with a skeleton TTP YAML
 configuration containing important metadata.
 
+## Generating UUIDs
+
+TTPs created with `create ttp` already include an automatically generated UUID.
+However, if you need to manually generate a UUID (for example, when manually
+creating or editing TTP files), TTPForge exposes the same UUID generation
+mechanism for convenience:
+
+```bash
+ttpforge create uuid
+```
+
+This will generate and print a new UUID to the console that you can copy and use
+in your TTP configuration files.
+
 ## Next Steps
 
 Open your new YAML file in your favorite code editor and then check out our