add support for actions

Author: austinvalle

README.md

@@ -230,7 +230,7 @@ For examples:
 |------------------------------------------------------------------------------|--------------------------------------------|
 | `examples/`                                                                  | Root of examples                           |
 | `examples/provider/provider<*>.tf`                                           | Provider example config(s)                 |
-| `examples/actions/<action_type>/action.tf`                                   | Action example config                      |
+| `examples/actions/<action_type>/action<*>.tf`                                | Action example config(s)                   |
 | `examples/data-sources/<data source name>/data-source<*>.tf`                 | Data source example config(s)              |
 | `examples/ephemeral-resources/<ephemeral resource>/ephemeral-resource<*>.tf` | Ephemeral resource example config(s)       |
 | `examples/functions/<function name>/function<*>.tf`                          | Function example config(s)                 |
@@ -350,8 +350,10 @@ using the following data fields and functions:
 | `.Name`                 | string | Name of the action (ex. `examplecloud_do_thing`)                                          |
 | `.Type`                 | string | `Action`                                                                                  |
 | `.Description`          | string | Action description                                                                        |
-| `.HasExample`           | bool   | Is there an example file?                                                                 |
-| `.ExampleFile`          | string | Path to the file with the terraform configuration example                                 |
+| `.HasExample`           | bool   | (Legacy) Is there an example file?                                                        |
+| `.HasExamples`          | bool   | Are there example files? Always true if HasExample is true.                               |
+| `.ExampleFile`          | string | (Legacy) Path to the file with the Terraform configuration example.                       |
+| `.ExampleFiles`         | string | Paths to the files with Terraform configuration examples. Includes ExampleFile.           |
 | `.ProviderName`         | string | Canonical provider name (ex. `terraform-provider-random`)                                 |
 | `.ProviderShortName`    | string | Short version of the rendered provider name (ex. `random`)                                |
 | `.RenderedProviderName` | string | Value provided via argument `--rendered-provider-name`, otherwise same as `.ProviderName` |

cmd/tfplugindocs/testdata/scripts/schema-json/generate/framework_provider_success_no_templates_multiple_examples.txtar

@@ -64,6 +64,14 @@ action "scaffolding_example" "example" {
 }
 ```
 
+```terraform
+action "scaffolding_example" "example" {
+  config {
+    required_attr = "some-value-2"
+  }
+}
+```
+
 <!-- action schema generated by tfplugindocs -->
 ## Schema
 

internal/provider/action_template.go

@@ -14,7 +14,25 @@ const actionSchemaComment = "<!-- action schema generated by tfplugindocs -->"
 
 type actionTemplate string
 
-func (t actionTemplate) Render(providerDir, name, providerName, renderedProviderName, typeName, exampleFile string, schema *tfjson.ActionSchema) (string, error) {
+type ActionTemplateType struct {
+	Type        string
+	Name        string
+	Description string
+
+	HasExample   bool
+	HasExamples  bool
+	ExampleFile  string
+	ExampleFiles []string
+
+	ProviderName      string
+	ProviderShortName string
+
+	SchemaMarkdown string
+
+	RenderedProviderName string
+}
+
+func (t actionTemplate) Render(providerDir, name, providerName, renderedProviderName, typeName, exampleFile string, exampleFiles []string, schema *tfjson.ActionSchema) (string, error) {
 	schemaBuffer := bytes.NewBuffer(nil)
 	err := schemamd.RenderAction(schema, schemaBuffer)
 	if err != nil {
@@ -26,27 +44,15 @@ func (t actionTemplate) Render(providerDir, name, providerName, renderedProvider
 		return "", nil
 	}
 
-	return renderStringTemplate(providerDir, "actionTemplate", s, struct {
-		Type        string
-		Name        string
-		Description string
-
-		HasExample  bool
-		ExampleFile string
-
-		ProviderName      string
-		ProviderShortName string
-
-		SchemaMarkdown string
-
-		RenderedProviderName string
-	}{
+	return renderStringTemplate(providerDir, "actionTemplate", s, ActionTemplateType{
 		Type:        typeName,
 		Name:        name,
 		Description: schema.Block.Description,
 
-		HasExample:  exampleFile != "" && fileExists(exampleFile),
-		ExampleFile: exampleFile,
+		HasExample:   exampleFile != "" && fileExists(exampleFile),
+		HasExamples:  len(exampleFiles) > 0,
+		ExampleFile:  exampleFile,
+		ExampleFiles: exampleFiles,
 
 		ProviderName:      providerName,
 		ProviderShortName: providerShortName(renderedProviderName),
@@ -69,10 +75,13 @@ description: |-
 
 {{ .Description | trimspace }}
 
-{{ if .HasExample -}}
+{{ if .HasExamples -}}
 ## Example Usage
 
-{{tffile .ExampleFile }}
+{{- range .ExampleFiles }}
+
+{{ tffile . }}
+{{- end }}
 {{- end }}
 
 {{ .SchemaMarkdown | trimspace }}

internal/provider/action_template_test.go

@@ -49,7 +49,7 @@ action "scaffolding_example" "example1" {
 		},
 	}
 
-	result, err := tpl.Render("testdata/test-action-dir", "testTemplate", "test-action", "test-action", "action", "action.tf", &schema)
+	result, err := tpl.Render("testdata/test-action-dir", "testTemplate", "test-action", "test-action", "action", "action.tf", []string{"action.tf"}, &schema)
 	if err != nil {
 		t.Error(err)
 	}

internal/provider/generate.go

@@ -801,11 +801,20 @@ func (g *generator) renderStaticWebsite(providerSchema *tfjson.ProviderSchema) e
 			g.warnf("ephemeral resource entitled %q, or %q does not exist", shortName, resName)
 		case "actions/":
 			actionSchema, resName := actionSchema(providerSchema.ActionSchemas, shortName, relFile)
-			exampleFilePath := filepath.Join(g.ProviderExamplesDir(), "actions", resName, "action.tf")
 
 			if actionSchema != nil {
+				exampleFilePath := filepath.Join(g.ProviderExamplesDir(), "actions", resName, "action.tf")
+				exampleFilesPattern := filepath.Join(g.ProviderExamplesDir(), "actions", resName, "action*.tf")
+				exampleFiles, err := filepath.Glob(exampleFilesPattern)
+
+				if err != nil {
+					return fmt.Errorf("unable to glob example files with pattern %q: %w", exampleFilesPattern, err)
+				}
+
+				slices.Sort(exampleFiles)
+
 				tmpl := actionTemplate(tmplData)
-				render, err := tmpl.Render(g.providerDir, resName, g.providerName, g.renderedProviderName, "Action", exampleFilePath, actionSchema)
+				render, err := tmpl.Render(g.providerDir, resName, g.providerName, g.renderedProviderName, "Action", exampleFilePath, exampleFiles, actionSchema)
 				if err != nil {
 					return fmt.Errorf("unable to render action template %q: %w", rel, err)
 				}