Fix handling of multiple nested types for the example config spec consumer (DataDog#8465)

Author: ofek

datadog_checks_dev/datadog_checks/dev/tooling/specs/configuration/consumers/example.py

@@ -44,13 +44,17 @@ def value_type_string(value):
         if value_type == 'object':
             return 'mapping'
         elif value_type == 'array':
-            item_type = value['items']['type']
-            if item_type == 'object':
-                return 'list of mappings'
-            elif item_type == 'array':
-                return 'list of lists'
+            items = value['items']
+            if 'oneOf' in items:
+                return f'(list of {value_type_string(items)})'
             else:
-                return f'list of {item_type}s'
+                item_type = items['type']
+                if item_type == 'object':
+                    return 'list of mappings'
+                elif item_type == 'array':
+                    return 'list of lists'
+                else:
+                    return f'list of {item_type}s'
         else:
             return value_type
 

datadog_checks_dev/tests/tooling/configuration/consumers/test_example.py

@@ -1467,3 +1467,47 @@ def test_option_multiple_types():
             # foo: <FOO>
         """
     )
+
+
+def test_option_multiple_types_nested():
+    consumer = get_example_consumer(
+        """
+        name: foo
+        version: 0.0.0
+        files:
+        - name: test.yaml
+          example_name: test.yaml.example
+          options:
+          - template: instances
+            options:
+            - name: foo
+              description: words
+              value:
+                oneOf:
+                - type: string
+                - type: array
+                  items:
+                    oneOf:
+                    - type: string
+                    - type: object
+                      required:
+                      - foo
+        """
+    )
+
+    files = consumer.render()
+    contents, errors = files['test.yaml.example']
+    assert not errors
+    assert contents == normalize_yaml(
+        """
+        ## Every instance is scheduled independent of the others.
+        #
+        instances:
+
+          -
+            ## @param foo - string or (list of string or mapping) - optional
+            ## words
+            #
+            # foo: <FOO>
+        """
+    )