good old cursor wiped my functoni

rilldata · royendo · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025
commit 7065bcc181a62931f77671f621d0bc4b0eb02dba
diff --git a/cli/cmd/docs/generate_project.go b/cli/cmd/docs/generate_project.go
@@ -446,8 +446,12 @@ func generateDoc(sidebarPosition, level int, node *yaml.Node, indent string, req
 			for _, item := range oneOf.Content {
 				// Since $ref values are already resolved, look for connector definitions directly
 				title := getScalarValue(item, "title")
+				exampleOutput := generateConnectorExample(title, item)
+
 				if title != "" {
 					doc.WriteString(fmt.Sprintf("\n\n### %s\n\n", title))
+					// Generate copiable example for this connector
+					doc.WriteString(fmt.Sprintf("\n\n\n%s", exampleOutput))
 					// Add description first
 					description := getPrintableDescription(item, indent, "")
 					if description != "" {
@@ -472,6 +476,8 @@ func generateDoc(sidebarPosition, level int, node *yaml.Node, indent string, req
 							required))
 					}
 				}
+
+
 			}
 
 		} else {
@@ -561,6 +567,8 @@ func generateDoc(sidebarPosition, level int, node *yaml.Node, indent string, req
 					doc.WriteString(fmt.Sprintf("%s\n\n", description))
 				}
 			}
+			exampleOutput := generateConnectorExample(title, connectorDef)
+			doc.WriteString(fmt.Sprintf("\n\n#### Example\n\n%s", exampleOutput))
 
 			// Generate the connector definition documentation (properties, etc.) but skip the header
 			// We need to process properties manually to avoid duplicate headers
@@ -580,6 +588,7 @@ func generateDoc(sidebarPosition, level int, node *yaml.Node, indent string, req
 						required))
 				}
 			}
+
 		}
 	}
 
@@ -620,3 +629,82 @@ func hasCombinators(node *yaml.Node) bool {
 	return getNodeForKey(node, "anyOf") != nil || getNodeForKey(node, "oneOf") != nil || getNodeForKey(node, "allOf") != nil
 }
 
+func generateConnectorExample(connectorType string, connectorDef *yaml.Node) string {
+	if connectorDef == nil {
+		return ""
+	}
+
+	var example strings.Builder
+	example.WriteString("```yaml\n")
+	example.WriteString("type: connector                                  # Must be `connector` (required)\n")
+
+	// Get the driver from the schema and add it first
+	driverAdded := false
+	if driver := getNodeForKey(connectorDef, "driver"); driver != nil {
+		if constVal := getScalarValue(driver, "const"); constVal != "" {
+			example.WriteString(fmt.Sprintf("driver: %s                                   # Must be `%s` _(required)_\n\n", constVal, constVal))
+			driverAdded = true
+		}
+	}
+
+	// Fallback: if driver wasn't found, use the connector type name
+	if !driverAdded {
+		// Special case for MotherDuck which uses duckdb driver
+		if connectorType == "MotherDuck" {
+			example.WriteString("driver: duckdb                                   # Must be `duckdb` _(required)_\n\n")
+		} else {
+			example.WriteString(fmt.Sprintf("driver: %s                                   # Must be `%s` _(required)_\n\n", strings.ToLower(connectorType), strings.ToLower(connectorType)))
+		}
+	}
+
+	// Get all properties from the schema
+	if properties := getNodeForKey(connectorDef, "properties"); properties != nil && properties.Kind == yaml.MappingNode {
+		for i := 0; i < len(properties.Content); i += 2 {
+			propName := properties.Content[i].Value
+			propValue := properties.Content[i+1]
+
+			// Skip the driver property since we already added it
+			if propName == "driver" {
+				continue
+			}
+
+			// Get property description
+			description := getPrintableDescription(propValue, "", "")
+			if description == "" {
+				description = "Property description"
+			}
+
+			// Get sample value from the schema
+			sampleValue := getScalarValue(propValue, "sample")
+			if sampleValue == "" {
+				// Fallback to const value if no sample
+				sampleValue = getScalarValue(propValue, "const")
+			}
+			if sampleValue == "" {
+				// Final fallback
+				sampleValue = "example_value"
+			}
+
+			// Check if it's required
+			required := ""
+			if requiredFields := getRequiredMapFromNode(connectorDef); requiredFields[propName] {
+				required = " _(required)_"
+			}
+
+			// Format the line with proper alignment
+			example.WriteString(fmt.Sprintf("%s: %s", propName, sampleValue))
+
+			// Add padding for alignment
+			padding := 35 - len(propName) - len(sampleValue)
+			if padding > 0 {
+				example.WriteString(strings.Repeat(" ", padding))
+			}
+
+			example.WriteString(fmt.Sprintf("# %s%s\n", description, required))
+		}
+	}
+
+	example.WriteString("```\n\n")
+	return example.String()
+}
+