feat: add Fdump(w io.Writer, vs ...any)

Author: Akkadius

godump.go

@@ -75,6 +75,14 @@ func Dump(vs ...any) {
 	tw.Flush()
 }
 
+// Fdump writes the formatted dump of values to the given io.Writer.
+func Fdump(w io.Writer, vs ...any) {
+	printDumpHeader(w, 3)
+	tw := tabwriter.NewWriter(w, 0, 0, 1, ' ', 0)
+	writeDump(tw, vs...)
+	tw.Flush()
+}
+
 // DumpStr dumps the values as a string with colorized output.
 func DumpStr(vs ...any) string {
 	var sb strings.Builder

godump_test.go

@@ -740,3 +740,37 @@ func TestMakeAddressable_CanAddr(t *testing.T) {
 
 	assert.Equal(t, v.Interface(), out.Interface()) // compare by value
 }
+
+func TestFdump_WritesToWriter(t *testing.T) {
+	var buf strings.Builder
+
+	type Inner struct {
+		Field string
+	}
+	type Outer struct {
+		InnerField Inner
+		Number     int
+	}
+
+	val := Outer{
+		InnerField: Inner{Field: "hello"},
+		Number:     42,
+	}
+
+	Fdump(&buf, val)
+
+	out := buf.String()
+
+	if !strings.Contains(out, "Outer") {
+		t.Errorf("expected output to contain type name 'Outer', got: %s", out)
+	}
+	if !strings.Contains(out, "InnerField") || !strings.Contains(out, "hello") {
+		t.Errorf("expected nested struct and field to appear, got: %s", out)
+	}
+	if !strings.Contains(out, "Number") || !strings.Contains(out, "42") {
+		t.Errorf("expected field 'Number' with value '42', got: %s", out)
+	}
+	if !strings.Contains(out, "<#dump //") {
+		t.Errorf("expected dump header with file and line, got: %s", out)
+	}
+}