Go: Update all Go snippet tags to include imports in the snippets. (#7036)

Update all Go snippet tags to include imports in the snippets.

Author: Laren-AWS

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -555,6 +555,7 @@ bedrock-runtime_InvokeModel_Ai21LabsJurassic2:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeJurassic2
     JavaScript:
       versions:
@@ -620,6 +621,7 @@ bedrock-runtime_InvokeModel_TitanText:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeTitanText
   services:
     bedrock-runtime: {InvokeModel}
@@ -669,6 +671,7 @@ bedrock-runtime_InvokeModel_AnthropicClaude:
           excerpts:
             - description: Invoke the Anthropic Claude 2 foundation model to generate text.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeClaude
     PHP:
       versions:
@@ -799,6 +802,7 @@ bedrock-runtime_InvokeModel_MetaLlama2:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeLlama2
     JavaScript:
       versions:
@@ -972,6 +976,7 @@ bedrock-runtime_InvokeModelWithResponseStream_AnthropicClaude:
           excerpts:
             - description: Use the Invoke Model API to send a text message and process the response stream in real-time.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeModelWithResponseStream
     JavaScript:
       versions:
@@ -1195,6 +1200,7 @@ bedrock-runtime_InvokeModel_TitanImageGenerator:
           excerpts:
             - description: Create an image with the Amazon Titan Image Generator.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeTitanImage
     PHP:
       versions:

.doc_gen/metadata/dynamodb_metadata.yaml

@@ -394,6 +394,8 @@ dynamodb_BatchWriteItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.BatchWriteItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Java:
       versions:
@@ -643,6 +645,8 @@ dynamodb_PutItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.PutItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -780,6 +784,8 @@ dynamodb_GetItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.GetItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -908,6 +914,8 @@ dynamodb_UpdateItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.UpdateItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1024,6 +1032,8 @@ dynamodb_DeleteItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.DeleteItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1309,6 +1319,8 @@ dynamodb_Query:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.Query
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1448,6 +1460,8 @@ dynamodb_Scan:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.Scan
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1578,6 +1592,9 @@ dynamodb_ExecuteStatement:
         - sdk_version: 2
           github: gov2/dynamodb
           excerpts:
+            - description: Define a function receiver struct for the example.
+              snippet_tags:
+                - gov2.dynamodb.PartiQLRunner.struct
             - description: Use an INSERT statement to add an item.
               snippet_tags:
                 - gov2.dynamodb.ExecuteStatement.Insert
@@ -1699,6 +1716,9 @@ dynamodb_BatchExecuteStatement:
         - sdk_version: 2
           github: gov2/dynamodb
           excerpts:
+            - description: Define a function receiver struct for the example.
+              snippet_tags:
+                - gov2.dynamodb.PartiQLRunner.struct
             - description: Use batches of INSERT statements to add items.
               snippet_tags:
                 - gov2.dynamodb.BatchExecuteStatement.Insert

.doc_gen/metadata/lambda_metadata.yaml

@@ -794,9 +794,6 @@ lambda_Scenario_GettingStartedFunctions:
             - description: Create a struct that wraps individual &LAM; actions.
               snippet_tags:
                 - gov2.lambda.FunctionWrapper.complete
-            - description: Create a struct that implements functions to help run the scenario.
-              snippet_tags:
-                - gov2.lambda.GetStartedFunctions_Helper
             - description: Define a &LAM; handler that increments a number.
               snippet_tags:
                 - gov2.lambda.handlers.increment

.doc_gen/metadata/s3_metadata.yaml

@@ -2742,6 +2742,7 @@ s3_Scenario_PresignedUrl:
             - description: Run an interactive example that generates and uses presigned URLs to upload, download, and delete
                 an S3 object.
               snippet_tags:
+                - gov2.s3.Scenario_Presigning.imports
                 - gov2.s3.Scenario_Presigning
             - description: Define an HTTP request wrapper used by the example to make HTTP requests.
               snippet_tags:

.doc_gen/metadata/sqs_metadata.yaml

@@ -980,6 +980,9 @@ sqs_Scenario_TopicsAndQueues:
             - description: Define a struct that wraps &SQS; actions used in this example.
               snippet_tags:
                 - gov2.sqs.SqsActions.complete
+            - description: Clean up resources.
+              snippet_tags:
+                - gov2.workflows.TopicsAndQueues.Resources.complete
     JavaScript:
       versions:
         - sdk_version: 3

gov2/aurora/actions/clusters.go

@@ -2,6 +2,9 @@
 // SPDX-License-Identifier: Apache-2.0
 package actions
 
+// snippet-start:[gov2.aurora.DbClusters.complete]
+// snippet-start:[gov2.aurora.DbClusters.struct]
+
 import (
 	"context"
 	"errors"
@@ -12,9 +15,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/rds/types"
 )
 
-// snippet-start:[gov2.aurora.DbClusters.complete]
-// snippet-start:[gov2.aurora.DbClusters.struct]
-
 type DbClusters struct {
 	AuroraClient *rds.Client
 }

gov2/aurora/scenarios/get_started_clusters.go

@@ -3,6 +3,8 @@
 
 package scenarios
 
+// snippet-start:[gov2.aurora.Scenario_GetStartedClusters]
+
 import (
 	"aurora/actions"
 	"context"
@@ -21,26 +23,6 @@ import (
 	"github.com/google/uuid"
 )
 
-// IScenarioHelper abstracts the function from a scenario so that it
-// can be mocked for unit testing.
-type IScenarioHelper interface {
-	Pause(secs int)
-	UniqueId() string
-}
-type ScenarioHelper struct{}
-
-// Pause waits for the specified number of seconds.
-func (helper ScenarioHelper) Pause(secs int) {
-	time.Sleep(time.Duration(secs) * time.Second)
-}
-
-// UniqueId returns a new UUID.
-func (helper ScenarioHelper) UniqueId() string {
-	return uuid.New().String()
-}
-
-// snippet-start:[gov2.aurora.Scenario_GetStartedClusters]
-
 // GetStartedClusters is an interactive example that shows you how to use the AWS SDK for Go
 // with Amazon Aurora to do the following:
 //
@@ -384,4 +366,22 @@ func (scenario GetStartedClusters) Cleanup(ctx context.Context, dbInstance *type
 	}
 }
 
+// IScenarioHelper abstracts the function from a scenario so that it
+// can be mocked for unit testing.
+type IScenarioHelper interface {
+	Pause(secs int)
+	UniqueId() string
+}
+type ScenarioHelper struct{}
+
+// Pause waits for the specified number of seconds.
+func (helper ScenarioHelper) Pause(secs int) {
+	time.Sleep(time.Duration(secs) * time.Second)
+}
+
+// UniqueId returns a new UUID.
+func (helper ScenarioHelper) UniqueId() string {
+	return uuid.New().String()
+}
+
 // snippet-end:[gov2.aurora.Scenario_GetStartedClusters]

gov2/bedrock-runtime/README.md

@@ -42,24 +42,24 @@ functions within the same service.
 
 ### AI21 Labs Jurassic-2
 
-- [InvokeModel](actions/invoke_model.go#L83)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Amazon Titan Image Generator
 
-- [InvokeModel](actions/invoke_model.go#L191)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Amazon Titan Text
 
-- [InvokeModel](actions/invoke_model.go#L261)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Anthropic Claude
 
-- [InvokeModel](actions/invoke_model.go#L27)
+- [InvokeModel](actions/invoke_model.go#L7)
 - [InvokeModelWithResponseStream](actions/invoke_model_with_response_stream.go#L30)
 
 ### Meta Llama
 
-- [InvokeModel: Llama 2](actions/invoke_model.go#L140)
+- [InvokeModel: Llama 2](actions/invoke_model.go#L7)
 
 
 <!--custom.examples.start-->

gov2/bedrock-runtime/actions/invoke_model.go

@@ -3,6 +3,9 @@
 
 package actions
 
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.complete]
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.struct]
+
 import (
 	"context"
 	"encoding/json"
@@ -13,9 +16,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/bedrockruntime"
 )
 
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.complete]
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.struct]
-
 // InvokeModelWrapper encapsulates Amazon Bedrock actions used in the examples.
 // It contains a Bedrock Runtime client that is used to invoke foundation models.
 type InvokeModelWrapper struct {

gov2/bedrock-runtime/actions/invoke_model_with_response_stream.go

@@ -3,6 +3,9 @@
 
 package actions
 
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.complete]
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.struct]
+
 import (
 	"bytes"
 	"context"
@@ -16,9 +19,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/bedrockruntime/types"
 )
 
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.complete]
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.struct]
-
 // InvokeModelWithResponseStreamWrapper encapsulates Amazon Bedrock actions used in the examples.
 // It contains a Bedrock Runtime client that is used to invoke foundation models.
 type InvokeModelWithResponseStreamWrapper struct {

gov2/bedrock-runtime/scenarios/scenario_invoke_models.go

@@ -3,6 +3,8 @@
 
 package scenarios
 
+// snippet-start:[gov2.bedrock-runtime.Scenario_InvokeModels]
+
 import (
 	"context"
 	"encoding/base64"
@@ -19,16 +21,14 @@ import (
 	"github.com/awsdocs/aws-doc-sdk-examples/gov2/demotools"
 )
 
-// snippet-start:[gov2.bedrock-runtime.Scenario_InvokeModels]
-
 // InvokeModelsScenario demonstrates how to use the Amazon Bedrock Runtime client
 // to invoke various foundation models for text and image generation
 //
 // 1. Generate text with Anthropic Claude 2
 // 2. Generate text with AI21 Labs Jurassic-2
 // 3. Generate text with Meta Llama 2 Chat
 // 4. Generate text and asynchronously process the response stream with Anthropic Claude 2
-// 5. Generate and image with the Amazon Titan image generation model
+// 5. Generate an image with the Amazon Titan image generation model
 // 6. Generate text with Amazon Titan Text G1 Express model
 type InvokeModelsScenario struct {
 	sdkConfig             aws.Config

gov2/bedrock/actions/foundation_model.go

@@ -3,6 +3,9 @@
 
 package actions
 
+// snippet-start:[gov2.bedrock.FoundationModelWrapper.complete]
+// snippet-start:[gov2.bedrock.FoundationModelWrapper.struct]
+
 import (
 	"context"
 	"log"
@@ -11,9 +14,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/bedrock/types"
 )
 
-// snippet-start:[gov2.bedrock.FoundationModelWrapper.complete]
-// snippet-start:[gov2.bedrock.FoundationModelWrapper.struct]
-
 // FoundationModelWrapper encapsulates Amazon Bedrock actions used in the examples.
 // It contains a Bedrock service client that is used to perform foundation model actions.
 type FoundationModelWrapper struct {

gov2/cognito/README.md

@@ -38,15 +38,15 @@ For prerequisites, see the [README](../README.md#Prerequisites) in the `gov2` fo
 
 Code excerpts that show you how to call individual service functions.
 
-- [AdminCreateUser](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L183)
-- [AdminSetUserPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L208)
-- [ConfirmForgotPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L145)
-- [DeleteUser](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L168)
-- [ForgotPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L128)
-- [InitiateAuth](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L103)
+- [AdminCreateUser](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L182)
+- [AdminSetUserPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L207)
+- [ConfirmForgotPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L144)
+- [DeleteUser](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L167)
+- [ForgotPassword](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L127)
+- [InitiateAuth](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L102)
 - [ListUserPools](hello/hello.go#L4)
-- [SignUp](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L75)
-- [UpdateUserPool](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L26)
+- [SignUp](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L74)
+- [UpdateUserPool](../workflows/user_pools_and_lambda_triggers/actions/cognito_actions.go#L25)
 
 ### Scenarios
 

gov2/dynamodb/README.md

@@ -40,13 +40,13 @@ Code examples that show you how to perform the essential operations within a ser
 
 Code excerpts that show you how to call individual service functions.
 
-- [BatchExecuteStatement](actions/partiql.go#L164)
+- [BatchExecuteStatement](actions/partiql.go#L7)
 - [BatchWriteItem](actions/table_basics.go#L177)
 - [CreateTable](actions/table_basics.go#L54)
 - [DeleteItem](actions/table_basics.go#L332)
 - [DeleteTable](actions/table_basics.go#L347)
 - [DescribeTable](actions/table_basics.go#L31)
-- [ExecuteStatement](actions/partiql.go#L30)
+- [ExecuteStatement](actions/partiql.go#L7)
 - [GetItem](actions/table_basics.go#L221)
 - [ListTables](actions/table_basics.go#L99)
 - [PutItem](actions/table_basics.go#L121)