Add meta-test

This test fails on this commit, which shows that it properly detects
that

    outline/_testdata/position_test.go.csv

can not be correctly parsed due to having too many fields.

This test passes on the HEAD of this branch.

ginkgo/outline/outline_test.go

@@ -1,6 +1,7 @@
 package outline
 
 import (
+	"encoding/csv"
 	"encoding/json"
 	"fmt"
 	"go/parser"
@@ -41,6 +42,8 @@ var _ = DescribeTable("Validate outline from file with",
 		Expect(err).To(BeNil(), "error reading CSV outline fixture: %s", err)
 
 		Expect(gotCSV).To(Equal(string(wantCSV)))
+
+		ensureRecordsAreIdentical(csvOutlineFilename, jsonOutlineFilename)
 	},
 	// To add a test:
 	// 1. Create the input, e.g., `myspecialcase_test.go`
@@ -93,3 +96,111 @@ var _ = Describe("Validate position", func() {
 
 	})
 })
+
+func ensureRecordsAreIdentical(csvOutlineFilename, jsonOutlineFilename string) {
+	csvFile, err := os.Open(filepath.Join("_testdata", csvOutlineFilename))
+	Expect(err).To(BeNil(), "error opening CSV outline fixture: %s", err)
+	defer csvFile.Close()
+
+	csvReader := csv.NewReader(csvFile)
+	csvRows, err := csvReader.ReadAll()
+	Expect(err).To(BeNil(), "error reading CSV outline fixture: %s", err)
+
+	// marshal csvRows into some comparable shape
+	csvFields := csvRows[0]
+	var csvRecords []ginkgoMetadata
+	for i := 1; i < len(csvRows); i++ {
+		var record ginkgoMetadata
+
+		for j, field := range csvFields {
+
+			field = strings.ToLower(field)
+			value := csvRows[i][j]
+
+			switch field {
+			case "name":
+				record.Name = value
+			case "text":
+				record.Text = value
+			case "start":
+				start, err := strconv.Atoi(value)
+				Expect(err).To(BeNil(), "error converting start to int: %s", err)
+				record.Start = start
+			case "end":
+				end, err := strconv.Atoi(value)
+				Expect(err).To(BeNil(), "error converting end to int: %s", err)
+				record.End = end
+			case "spec":
+				spec, err := strconv.ParseBool(value)
+				Expect(err).To(BeNil(), "error converting spec to bool: %s", err)
+				record.Spec = spec
+			case "focused":
+				focused, err := strconv.ParseBool(value)
+				Expect(err).To(BeNil(), "error converting focused to bool: %s", err)
+				record.Focused = focused
+			case "pending":
+				pending, err := strconv.ParseBool(value)
+				Expect(err).To(BeNil(), "error converting pending to bool: %s", err)
+				record.Pending = pending
+			case "labels":
+				// strings.Split will return [""] for an empty string, we want []
+				if value == "" {
+					record.Labels = []string{}
+				} else {
+					record.Labels = strings.Split(value, ", ")
+				}
+			default:
+				Fail(fmt.Sprintf("unexpected field: %s", field))
+			}
+		}
+
+		// "By" is a special case; nil out its labels so we can compare to the parsed JSON
+		if record.Name == "By" {
+			record.Labels = nil
+		}
+
+		csvRecords = append(csvRecords, record)
+	}
+
+	jsonFile, err := os.Open(filepath.Join("_testdata", jsonOutlineFilename))
+	Expect(err).To(BeNil(), "error opening JSON outline fixture: %s", err)
+	defer jsonFile.Close()
+
+	jsonDecoder := json.NewDecoder(jsonFile)
+	var jsonRows []ginkgoNode
+	err = jsonDecoder.Decode(&jsonRows)
+	Expect(err).To(BeNil(), "error reading JSON outline fixture: %s", err)
+
+	// marshal jsonRows into some comparable shape - the hierarchical structure needs to be flattened
+	var jsonRecords []ginkgoMetadata
+	flattenNodes(jsonRows, &jsonRecords)
+
+	Expect(csvRecords).To(Equal(jsonRecords))
+}
+
+// flattenNodes converts the hierarchical json output into a list of records
+func flattenNodes(nodes []ginkgoNode, flatNodes *[]ginkgoMetadata) {
+	for _, node := range nodes {
+		record := ginkgoMetadata{
+			Name:    node.Name,
+			Text:    node.Text,
+			Start:   node.Start,
+			End:     node.End,
+			Spec:    node.Spec,
+			Focused: node.Focused,
+			Pending: node.Pending,
+			Labels:  node.Labels,
+		}
+
+		*flatNodes = append(*flatNodes, record)
+
+		// handle nested nodes
+		if len(node.Nodes) > 0 {
+			var nestedNodes []ginkgoNode
+			for _, nestedNode := range node.Nodes {
+				nestedNodes = append(nestedNodes, *nestedNode)
+			}
+			flattenNodes(nestedNodes, flatNodes)
+		}
+	}
+}