feat(codegen): Add support for terraform lists/queries

Author: kklimonda-cl

assets/terraform/internal/manager/entry_import.go

@@ -18,6 +18,7 @@ type SDKImportableEntryService[E EntryObject, L EntryLocation, IL ImportLocation
 	Delete(context.Context, L, []IL, ...string) error
 	ImportToLocations(context.Context, L, []IL, string) error
 	UnimportFromLocations(context.Context, L, []IL, []string) error
+	ListWithXpath(context.Context, string, string, string, string) ([]E, error)
 }
 
 type ImportableEntryObjectManager[E EntryObject, L EntryLocation, IL ImportLocation, IS SDKImportableEntryService[E, L, IL]] struct {
@@ -38,8 +39,22 @@ func NewImportableEntryObjectManager[E EntryObject, L EntryLocation, IL ImportLo
 	}
 }
 
-func (o *ImportableEntryObjectManager[E, L, IL, IS]) ReadMany(ctx context.Context, location L, entries []E) ([]E, error) {
-	return nil, &Error{err: ErrInternal, message: "called ReadMany on an importable singular resource"}
+func (o *ImportableEntryObjectManager[E, L, IL, IS]) ReadMany(ctx context.Context, location L, components []string) ([]E, error) {
+	xpath, err := location.XpathWithComponents(o.client.Versioning(), append(components, util.AsEntryXpath(""))...)
+	if err != nil {
+		return nil, err
+	}
+
+	existing, err := o.service.ListWithXpath(ctx, util.AsXpath(xpath), "get", "", "")
+	if err != nil {
+		if sdkerrors.IsObjectNotFound(err) {
+			return nil, ErrObjectNotFound
+		} else {
+			return nil, &Error{err: err, message: "Failed to read entries from the server"}
+		}
+	}
+
+	return existing, nil
 }
 
 func (o *ImportableEntryObjectManager[E, L, IL, IS]) Read(ctx context.Context, location L, components []string, name string) (E, error) {

pkg/commands/codegen/codegen.go

@@ -76,6 +76,7 @@ func (c *Command) Execute() error {
 	var dataSourceList []string
 	var ephemeralResourceList []string
 	var actionsList []string
+	var listResourceList []string
 	specMetadata := make(map[string]properties.TerraformProviderSpecMetadata)
 
 	for _, specPath := range c.specs {
@@ -138,6 +139,7 @@ func (c *Command) Execute() error {
 				dataSourceList = append(dataSourceList, data.DataSources...)
 				ephemeralResourceList = append(ephemeralResourceList, data.EphemeralResources...)
 				actionsList = append(actionsList, data.Actions...)
+				listResourceList = append(listResourceList, data.ListResources...)
 
 				for k, v := range data.SpecMetadata {
 					specMetadata[k] = v
@@ -168,6 +170,7 @@ func (c *Command) Execute() error {
 				dataSourceList = append(dataSourceList, data.DataSources...)
 				ephemeralResourceList = append(ephemeralResourceList, data.EphemeralResources...)
 				actionsList = append(actionsList, data.Actions...)
+				listResourceList = append(listResourceList, data.ListResources...)
 
 				for k, v := range data.SpecMetadata {
 					specMetadata[k] = v
@@ -190,6 +193,7 @@ func (c *Command) Execute() error {
 		newProviderObject.DataSources = append(newProviderObject.DataSources, dataSourceList...)
 		newProviderObject.Resources = append(newProviderObject.Resources, resourceList...)
 		newProviderObject.EphemeralResources = append(newProviderObject.EphemeralResources, ephemeralResourceList...)
+		newProviderObject.ListResources = append(newProviderObject.ListResources, listResourceList...)
 		newProviderObject.Actions = append(newProviderObject.Actions, actionsList...)
 		newProviderObject.SpecMetadata = specMetadata
 

pkg/generate/generator.go

@@ -60,6 +60,7 @@ func (c *Creator) RenderTemplate() error {
 
 type TerraformProviderFileData struct {
 	EphemeralResources []string
+	ListResources      []string
 	Resources          []string
 	DataSources        []string
 	Actions            []string
@@ -90,6 +91,12 @@ func (c *Creator) RenderTerraformProviderFile(spec *properties.Normalization, ty
 		return nil, err
 	}
 
+	if !*spec.TerraformProviderConfig.SkipListResource && (typ == properties.ResourceEntry || typ == properties.ResourceUuid) {
+		if err := tfp.GenerateTerraformListResource(typ, spec, terraformProvider); err != nil {
+			return nil, err
+		}
+	}
+
 	if spec.TerraformProviderConfig.Action {
 		if err := tfp.GenerateTerraformAction(spec, terraformProvider); err != nil {
 			return nil, err
@@ -126,6 +133,7 @@ func (c *Creator) RenderTerraformProviderFile(spec *properties.Normalization, ty
 		EphemeralResources: terraformProvider.EphemeralResources,
 		Actions:            terraformProvider.Actions,
 		SpecMetadata:       terraformProvider.SpecMetadata,
+		ListResources:      terraformProvider.ListResources,
 	}
 	return data, nil
 }

pkg/properties/normalized.go

@@ -83,6 +83,7 @@ type TerraformProviderConfig struct {
 	Ephemeral             bool                       `json:"ephemeral" yaml:"ephemeral"`
 	Action                bool                       `json:"action" yaml:"action"`
 	SkipResource          bool                       `json:"skip_resource" yaml:"skip_resource"`
+	SkipListResource      *bool                      `json:"skip_list_resource", yaml:"skip_list_resource"`
 	SkipDatasource        bool                       `json:"skip_datasource" yaml:"skip_datasource"`
 	SkipDatasourceListing bool                       `json:"skip_datasource_listing" yaml:"skip_datasource_listing"`
 	ResourceType          TerraformResourceType      `json:"resource_type" yaml:"resource_type"`
@@ -719,6 +720,7 @@ func schemaToSpec(object object.Object) (*Normalization, error) {
 			Ephemeral:             object.TerraformConfig.Epheneral,
 			Action:                object.TerraformConfig.Action,
 			SkipResource:          object.TerraformConfig.SkipResource,
+			SkipListResource:      object.TerraformConfig.SkipListResource,
 			SkipDatasource:        object.TerraformConfig.SkipDatasource,
 			SkipDatasourceListing: object.TerraformConfig.SkipdatasourceListing,
 			ResourceType:          TerraformResourceType(object.TerraformConfig.ResourceType),

pkg/properties/provider_file.go

@@ -68,6 +68,10 @@ func (o TerraformNameProvider) IdentityModelStructName() string {
 	return fmt.Sprintf("%sIdentityModel", o.ResourceStructName)
 }
 
+func (o TerraformNameProvider) ListResourceStructName() string {
+	return fmt.Sprintf("%sListResource", o.StructName)
+}
+
 type TerraformSpecFlags uint
 
 const (
@@ -91,6 +95,7 @@ type TerraformProviderFile struct {
 	DataSources        []string
 	Resources          []string
 	EphemeralResources []string
+	ListResources      []string
 	Actions            []string
 	SpecMetadata       map[string]TerraformProviderSpecMetadata
 	Code               *strings.Builder

pkg/properties/resourcetype.go

@@ -16,8 +16,10 @@ type SchemaType string
 const (
 	SchemaResource          SchemaType = "resource"
 	SchemaEphemeralResource SchemaType = "ephemeral-resource"
+	SchemaListResource      SchemaType = "list-resource"
 	SchemaAction            SchemaType = "action"
 	SchemaDataSource        SchemaType = "datasource"
 	SchemaCommon            SchemaType = "common"
 	SchemaProvider          SchemaType = "provider"
+	SchemaCustom            SchemaType = "custom"
 )

pkg/schema/object/object.go

@@ -42,6 +42,7 @@ type TerraformConfig struct {
 	SkipResource          bool                       `yaml:"skip_resource"`
 	SkipDatasource        bool                       `yaml:"skip_datasource"`
 	SkipdatasourceListing bool                       `yaml:"skip_datasource_listing"`
+	SkipListResource      *bool                      `yaml:"skip_list_resource"`
 	ResourceType          TerraformResourceType      `yaml:"resource_type"`
 	XmlNode               *string                    `yaml:"xml_node"`
 	CustomFunctions       map[string]bool            `yaml:"custom_functions"`
@@ -166,6 +167,11 @@ func (o *Object) UnmarshalYAML(n *yaml.Node) error {
 		return fmt.Errorf("failed to unmarshal yaml spec: plural_type must be list for uuid resource types")
 	}
 
+	if obj.TerraformConfig.SkipListResource == nil {
+		skipListResource := true
+		obj.TerraformConfig.SkipListResource = &skipListResource
+	}
+
 	return nil
 }