importer-msgraph-metadata: set descriptions for operations

hashicorp · Aug 18, 2024 · ff06c4f · ff06c4f
1 parent 15d19aa
commit ff06c4f
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 0 deletions.
diff --git a/tools/importer-msgraph-metadata/components/parser/resources.go b/tools/importer-msgraph-metadata/components/parser/resources.go
@@ -21,6 +21,7 @@ type Resource struct {
 
 type Operation struct {
 	Name            string
+	Description     string
 	Type            OperationType
 	Method          string
 	ResourceId      *ResourceId

diff --git a/tools/importer-msgraph-metadata/internal/pipeline/task_parse_resources.go b/tools/importer-msgraph-metadata/internal/pipeline/task_parse_resources.go
@@ -346,8 +346,17 @@ func (p pipelineForService) parseResources(resourceIds parser.ResourceIds, model
 				}
 			}
 
+			operationDescription := make([]string, 0)
+			if operation.Summary != "" {
+				operationDescription = append(operationDescription, operation.Summary)
+			}
+			if operation.Description != "" {
+				operationDescription = append(operationDescription, operation.Description)
+			}
+
 			resources[resourceName].Operations = append(resources[resourceName].Operations, parser.Operation{
 				Name:            operationName,
+				Description:     strings.Join(operationDescription, ". "),
 				Type:            operationType,
 				Method:          method,
 				ResourceId:      resourceId,

diff --git a/tools/importer-msgraph-metadata/internal/pipeline/task_translate_service.go b/tools/importer-msgraph-metadata/internal/pipeline/task_translate_service.go
@@ -296,6 +296,7 @@ func (p pipelineForService) translateServiceToDataApiSdkTypes() (*sdkModels.Serv
 
 			sdkService.APIVersions[resource.Version].Resources[resource.Category].Operations[operation.Name] = sdkModels.SDKOperation{
 				ContentType:                      contentType,
+				Description:                      operation.Description,
 				ExpectedStatusCodes:              expectedStatusCodes,
 				FieldContainingPaginationDetails: operation.PaginationField,
 				LongRunning:                      false,