docs: fix examples

Author: cmilesio

docs/examplegen/main.go

@@ -630,35 +630,35 @@ func writeMain(base string, fd *FuncDoc, moduleImportPath, importPath string) er
 	}
 
 	buf.WriteString("func main() {\n")
-	for i := range fd.Examples {
-		buf.WriteString(fmt.Sprintf("\texample%d()\n", i+1))
+	if fd.Description != "" {
+		for _, line := range strings.Split(fd.Description, "\n") {
+			buf.WriteString("\t// " + line + "\n")
+		}
+		buf.WriteString("\n")
 	}
-	buf.WriteString("}\n\n")
 
 	for i, ex := range fd.Examples {
-		buf.WriteString(fmt.Sprintf("func example%d() {\n", i+1))
-
-		if i == 0 && fd.Description != "" {
-			for _, line := range strings.Split(fd.Description, "\n") {
-				buf.WriteString("\t// " + line + "\n")
-			}
+		if i > 0 {
 			buf.WriteString("\n")
 		}
-
 		if ex.Label != "" {
 			buf.WriteString("\t// Example: " + ex.Label + "\n")
 		}
+		// Isolate each example body in an IIFE so snippets can reuse names and
+		// use `return` without exiting the whole generated main().
+		buf.WriteString("\tfunc() {\n")
 
 		ex.Code = strings.TrimLeft(ex.Code, "\n")
 		for _, line := range strings.Split(ex.Code, "\n") {
 			if strings.TrimSpace(line) == "" {
 				buf.WriteString("\n")
 			} else {
-				buf.WriteString("\t" + line + "\n")
+				buf.WriteString("\t\t" + line + "\n")
 			}
 		}
-		buf.WriteString("}\n\n")
+		buf.WriteString("\t}()\n")
 	}
+	buf.WriteString("}\n")
 
 	return os.WriteFile(filepath.Join(dir, "main.go"), buf.Bytes(), 0o644)
 }

examples/job-payload/main.go

@@ -8,46 +8,41 @@ package main
 import "github.com/goforj/queue"
 
 func main() {
-	example1()
-	example2()
-	example3()
-}
-
-func example1() {
 	// Payload sets job payload from common value types.
 
 	// Example: payload bytes
-	jobBytes := queue.NewJob("emails:send").Payload([]byte(`{"id":1}`))
-	_ = jobBytes
+	func() {
+		jobBytes := queue.NewJob("emails:send").Payload([]byte(`{"id":1}`))
+		_ = jobBytes
 
-}
+	}()
 
-func example2() {
 	// Example: payload struct
-	type Meta struct {
-		Nested bool `json:"nested"`
-	}
-	type EmailPayload struct {
-		ID   int    `json:"id"`
-		To   string `json:"to"`
-		Meta Meta   `json:"meta"`
-	}
-	jobStruct := queue.NewJob("emails:send").Payload(EmailPayload{
-		ID:   1,
-		To:   "user@example.com",
-		Meta: Meta{Nested: true},
-	})
-	_ = jobStruct
+	func() {
+		type Meta struct {
+			Nested bool `json:"nested"`
+		}
+		type EmailPayload struct {
+			ID   int    `json:"id"`
+			To   string `json:"to"`
+			Meta Meta   `json:"meta"`
+		}
+		jobStruct := queue.NewJob("emails:send").Payload(EmailPayload{
+			ID:   1,
+			To:   "user@example.com",
+			Meta: Meta{Nested: true},
+		})
+		_ = jobStruct
+
+	}()
 
-}
-
-func example3() {
 	// Example: payload map
-	jobMap := queue.NewJob("emails:send").Payload(map[string]any{
-		"id":  1,
-		"to":  "user@example.com",
-		"meta": map[string]any{"nested": true},
-	})
-	_ = jobMap
+	func() {
+		jobMap := queue.NewJob("emails:send").Payload(map[string]any{
+			"id":  1,
+			"to":  "user@example.com",
+			"meta": map[string]any{"nested": true},
+		})
+		_ = jobMap
+	}()
 }
-