feat(olm-catalog): Generated alm-examples in a pretty format (#1793)

* feat(olm-catalog) : Generating alm-examples in a pretty format

* feat(olm-catalog) : update test-framework memcached-operator CSV version 0.0.3 with alm-examples in a pretty format

* feat(olm-catalog) : Changelog (ISSUE_1708)

CHANGELOG.md

@@ -1,6 +1,7 @@
 ## Unreleased
 
 ### Added
+- The `operator-sdk olm-catalog gen-csv` command now produces indented JSON for the `alm-examples` annotation. ([#1793](https://github.com/operator-framework/operator-sdk/pull/1793))
 
 ### Changed
 

internal/pkg/scaffold/olm-catalog/csv_updaters.go

@@ -343,16 +343,26 @@ func (u *ALMExamplesUpdate) Apply(csv *olmapiv1alpha1.ClusterServiceVersion) err
 	if csv.GetAnnotations() == nil {
 		csv.SetAnnotations(make(map[string]string))
 	}
-	sb := &strings.Builder{}
-	sb.WriteString(`[`)
+	buf := &bytes.Buffer{}
+	buf.WriteString(`[`)
 	for i, example := range u.crs {
-		sb.WriteString(example)
+		buf.WriteString(example)
 		if i < len(u.crs)-1 {
-			sb.WriteString(`,`)
+			buf.WriteString(`,`)
 		}
 	}
-	sb.WriteString(`]`)
-
-	csv.GetAnnotations()["alm-examples"] = sb.String()
+	buf.WriteString(`]`)
+	examplesJSON, err := prettyJSON(buf.Bytes())
+	if err != nil {
+		return err
+	}
+	csv.GetAnnotations()["alm-examples"] = examplesJSON
 	return nil
 }
+
+// prettyJSON returns a JSON in a pretty format
+func prettyJSON(b []byte) (string, error) {
+	var out bytes.Buffer
+	err := json.Indent(&out, b, "", "  ")
+	return out.String(), err
+}

test/test-framework/deploy/olm-catalog/memcached-operator/0.0.3/memcached-operator.v0.0.3.clusterserviceversion.yaml

@@ -2,8 +2,20 @@ apiVersion: operators.coreos.com/v1alpha1
 kind: ClusterServiceVersion
 metadata:
   annotations:
-    alm-examples: '[{"apiVersion":"cache.example.com/v1alpha1","kind":"Memcached","metadata":{"name":"example-memcached"},"spec":{"size":3}}]'
-    capabilities: Basic Install
+    alm-examples: |-
+      [
+        {
+          "apiVersion": "cache.example.com/v1alpha1",
+          "kind": "Memcached",
+          "metadata": {
+            "name": "example-memcached"
+          },
+          "spec": {
+            "size": 3
+          }
+        }
+      ]
+  capabilities: Basic Install
   name: memcachedoperator.v0.0.3
   namespace: placeholder
 spec: