feat: add doc for std.parseCsv and std.manifestCsv

google · May 25, 2023 · a8bebc3 · a8bebc3
1 parent 8ea27ab
commit a8bebc3
Showing 1 changed file with 53 additions and 0 deletions.
diff --git a/doc/_stdlib_gen/stdlib-content.jsonnet b/doc/_stdlib_gen/stdlib-content.jsonnet
@@ -681,6 +681,20 @@ local html = import 'html.libsonnet';
             },
           ],
         },
+        {
+          name: 'parseCsv',
+          params: ['str'],
+          availableSince: 'upcoming',
+          description: |||
+            Parses a CSV string into JSON.
+          |||,
+          examples: [
+            {
+              input: "std.parseCsv('id,name\n1,foo\n2,bar')",
+              output: std.parseCsv('id,name\n1,foo\n2,bar'),
+            },
+          ],
+        },
         {
           name: 'encodeUTF8',
           params: ['str'],
@@ -995,6 +1009,45 @@ local html = import 'html.libsonnet';
             |||),
           ],
         },
+        {
+          name: 'manifestCsv',
+          params: ['json', 'headers=null'],
+          availableSince: 'upcoming',
+          description: [
+            html.p({}, |||
+              Convert the given csv compatible json to a CSV.
+            |||),
+            html.pre({}, |||
+              std.manifestCsv(
+                [
+                  {
+                    "id": 1,
+                    "name": "foo",
+                    "x": "baz",
+                  },
+                  {
+                    "id": 2,
+                    "name": "bar",
+                  },
+                ],
+                ["id", "name"],
+            |||),
+            html.p({}, |||
+              Yields a string containing this CSV:
+            |||),
+            html.pre({}, |||
+              id,name
+              1,foo
+              2,bar
+            |||),
+            html.p({}, |||
+              If <code>json</code> param is not a valid csv compatible object, it would be an error.
+            |||),
+            html.p({}, |||
+              The <code>headers</code> param adds is an optional which would default to all fields in the object.
+            |||),
+          ],
+        },
         {
           name: 'manifestXmlJsonml',
           params: ['value'],