@cdktn/provider-generator 0.24.0-pre.9 → 0.24.0-pre.91

package/src/get/__tests__/generator/fixtures/deeply-nested-collections.test.fixture.json

@@ -0,0 +1,129 @@
+{
+  "format_version": "1.0",
+  "provider_schemas": {
+    "registry.terraform.io/hashicorp/test": {
+      "data_source_schemas": {
+        "deeply_nested_collections": {
+          "version": 0,
+          "block": {
+            "attributes": {
+              "map_map_list_string": {
+                "type": [
+                  "map",
+                  [
+                    "map",
+                    [
+                      "list",
+                      "string"
+                    ]
+                  ]
+                ],
+                "description": "map(map(list(string))) - unsupported triple nesting, reproduces open-constructs/cdk-terrain#11.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "list_map_map_string": {
+                "type": [
+                  "list",
+                  [
+                    "map",
+                    [
+                      "map",
+                      "string"
+                    ]
+                  ]
+                ],
+                "description": "list(map(map(string))) - unsupported triple nesting.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "set_map_list_number": {
+                "type": [
+                  "set",
+                  [
+                    "map",
+                    [
+                      "list",
+                      "number"
+                    ]
+                  ]
+                ],
+                "description": "set(map(list(number))) - unsupported triple nesting.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "map_list_string": {
+                "type": [
+                  "map",
+                  [
+                    "list",
+                    "string"
+                  ]
+                ],
+                "description": "map(list(string)) - supported double nesting, must still emit cdktn.StringListMap.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "map_map_number": {
+                "type": [
+                  "map",
+                  [
+                    "map",
+                    "number"
+                  ]
+                ],
+                "description": "map(map(number)) - now directly supported via cdktn.NumberMapMap.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "map_map_bool": {
+                "type": [
+                  "map",
+                  [
+                    "map",
+                    "bool"
+                  ]
+                ],
+                "description": "map(map(bool)) - now directly supported via cdktn.BooleanMapMap.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "map_map_string": {
+                "type": [
+                  "map",
+                  [
+                    "map",
+                    "string"
+                  ]
+                ],
+                "description": "map(map(string)) - pre-existing support via cdktn.StringMapMap, unchanged.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "map_map_map_list_string": {
+                "type": [
+                  "map",
+                  [
+                    "map",
+                    [
+                      "map",
+                      [
+                        "list",
+                        "string"
+                      ]
+                    ]
+                  ]
+                ],
+                "description": "map(map(map(list(string)))) - unsupported quadruple nesting, collapses to cdktn.AnyMapMap.",
+                "description_kind": "plain",
+                "computed": true
+              }
+            },
+            "description": "Data source used to verify deeply nested collection attribute types are handled without generating references to non-existent cdktn classes.",
+            "description_kind": "plain"
+          }
+        }
+      }
+    }
+  }
+}

package/src/get/__tests__/generator/fixtures/ephemeral-resources.test.fixture.json

@@ -0,0 +1,160 @@
+{
+  "provider_schemas": {
+    "registry.terraform.io/hashicorp/random": {
+      "resource_schemas": {
+        "random_uuid": {
+          "version": 0,
+          "block": {
+            "attributes": {
+              "id": {
+                "type": "string",
+                "description": "The generated uuid presented in string format.",
+                "description_kind": "plain",
+                "computed": true
+              },
+              "keepers": {
+                "type": [
+                  "map",
+                  "string"
+                ],
+                "description": "Arbitrary map of values that, when changed, will trigger recreation of resource. See [the main provider documentation](../index.html) for more information.",
+                "description_kind": "plain",
+                "optional": true
+              },
+              "result": {
+                "type": "string",
+                "description": "The generated uuid presented in string format.",
+                "description_kind": "plain",
+                "computed": true
+              }
+            },
+            "description": "The resource `random_uuid` generates a random uuid string that is intended to be used as a unique identifier for other resources.\n\nThis resource uses [hashicorp/go-uuid](https://github.com/hashicorp/go-uuid) to generate a UUID-formatted string for use with services needing a unique string identifier.",
+            "description_kind": "plain"
+          }
+        }
+      },
+      "ephemeral_resource_schemas": {
+        "random_bytes": {
+          "version": 0,
+          "block": {
+            "attributes": {
+              "base64": {
+                "type": "string",
+                "description": "The generated bytes presented in base64 string format.",
+                "description_kind": "plain",
+                "computed": true,
+                "sensitive": true
+              },
+              "hex": {
+                "type": "string",
+                "description": "The generated bytes presented in lowercase hexadecimal string format. The length of the encoded string is exactly twice the `length` parameter.",
+                "description_kind": "plain",
+                "computed": true,
+                "sensitive": true
+              },
+              "length": {
+                "type": "number",
+                "description": "The number of bytes requested. The minimum value for length is 1.",
+                "description_kind": "plain",
+                "required": true
+              }
+            },
+            "description": "-> If the managed resource doesn't have a write-only argument available for the secret (first introduced in Terraform 1.11), then the secret can only be created with the managed resource variant of [`random_bytes`](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/bytes).\n\nGenerates ephemeral random bytes using a cryptographic random number generator.\n\nThe primary use-case for generating ephemeral random bytes is to be used in combination with a write-only argument in a managed resource, which will avoid Terraform storing the secret value in the plan or state file.",
+            "description_kind": "plain"
+          }
+        },
+        "random_password": {
+          "version": 0,
+          "block": {
+            "attributes": {
+              "bcrypt_hash": {
+                "type": "string",
+                "description": "A bcrypt hash of the generated random string. **NOTE**: If the generated random string is greater than 72 bytes in length, `bcrypt_hash` will contain a hash of the first 72 bytes.",
+                "description_kind": "plain",
+                "computed": true,
+                "sensitive": true
+              },
+              "length": {
+                "type": "number",
+                "description": "The length of the string desired. The minimum value for length is 1 and, length must also be >= (`min_upper` + `min_lower` + `min_numeric` + `min_special`).",
+                "description_kind": "plain",
+                "required": true
+              },
+              "lower": {
+                "type": "bool",
+                "description": "Include lowercase alphabet characters in the result. Default value is `true`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "min_lower": {
+                "type": "number",
+                "description": "Minimum number of lowercase alphabet characters in the result. Default value is `0`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "min_numeric": {
+                "type": "number",
+                "description": "Minimum number of numeric characters in the result. Default value is `0`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "min_special": {
+                "type": "number",
+                "description": "Minimum number of special characters in the result. Default value is `0`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "min_upper": {
+                "type": "number",
+                "description": "Minimum number of uppercase alphabet characters in the result. Default value is `0`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "numeric": {
+                "type": "bool",
+                "description": "Include numeric characters in the result. Default value is `true`. If `numeric`, `upper`, `lower`, and `special` are all configured, at least one of them must be set to `true`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "override_special": {
+                "type": "string",
+                "description": "Supply your own list of special characters to use for string generation.  This overrides the default character list in the special argument.  The `special` argument must still be set to true for any overwritten characters to be used in generation.",
+                "description_kind": "plain",
+                "optional": true
+              },
+              "result": {
+                "type": "string",
+                "description": "The generated random string.",
+                "description_kind": "plain",
+                "computed": true,
+                "sensitive": true
+              },
+              "special": {
+                "type": "bool",
+                "description": "Include special characters in the result. These are `!@#$%&*()-_=+[]{}<>:?`. Default value is `true`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              },
+              "upper": {
+                "type": "bool",
+                "description": "Include uppercase alphabet characters in the result. Default value is `true`.",
+                "description_kind": "plain",
+                "optional": true,
+                "computed": true
+              }
+            },
+            "description": "-> If the managed resource doesn't have a write-only argument available for the password (first introduced in Terraform 1.11), then the password can only be created with the managed resource variant of [`random_password`](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/password).\n\nGenerates an ephemeral password string using a cryptographic random number generator.\n\nThe primary use-case for generating an ephemeral random password is to be used in combination with a write-only argument in a managed resource, which will avoid Terraform storing the password string in the plan or state file.",
+            "description_kind": "plain"
+          }
+        }
+      }
+    }
+  }
+}

package/src/get/__tests__/generator/fixtures/provider-functions-collision.test.fixture.json

@@ -0,0 +1,31 @@
+{
+  "provider_schemas": {
+    "registry.terraform.io/hashicorp/example": {
+      "provider": {
+        "version": 0,
+        "block": {
+          "attributes": {
+            "functions": {
+              "type": "string",
+              "description": "A config attribute that happens to be named the same as the generated functions getter.",
+              "description_kind": "plain",
+              "optional": true
+            }
+          }
+        }
+      },
+      "functions": {
+        "greet": {
+          "description": "Greets the given name.",
+          "return_type": "string",
+          "parameters": [
+            {
+              "name": "name",
+              "type": "string"
+            }
+          ]
+        }
+      }
+    }
+  }
+}

package/src/get/__tests__/generator/fixtures/provider-functions-synthetic.test.fixture.json

@@ -0,0 +1,192 @@
+{
+  "provider_schemas": {
+    "registry.terraform.io/hashicorp/example": {
+      "resource_schemas": {},
+      "functions": {
+        "join_strings": {
+          "description": "Joins the given strings together using the provided separator.",
+          "summary": "Join strings with a separator",
+          "return_type": "string",
+          "parameters": [{ "name": "separator", "type": "string" }],
+          "variadic_parameter": { "name": "values", "type": "string" }
+        },
+        "sum": {
+          "description": "Adds up a default starting value and any number of addends.",
+          "summary": "Sum numbers",
+          "return_type": "number",
+          "parameters": [{ "name": "default", "type": "number" }],
+          "variadic_parameter": { "name": "addends", "type": "number" }
+        },
+        "list_prefixed_names": {
+          "description": "Returns a list of names prefixed with the given prefix.",
+          "summary": "List prefixed names",
+          "return_type": ["list", "string"],
+          "parameters": [{ "name": "prefix", "type": "string" }]
+        },
+        "condition_if": {
+          "description": "Returns true_value if condition is true, otherwise returns false_value. The dynamic return type allows either branch to be a value of any type.",
+          "summary": "Dynamic conditional",
+          "return_type": "dynamic",
+          "parameters": [
+            { "name": "condition", "type": "bool" },
+            { "name": "true_value", "type": "dynamic" },
+            { "name": "false_value", "type": "dynamic" }
+          ]
+        },
+        "list_numbers": {
+          "description": "Returns a list of numbers counting up from 1 to the given count.",
+          "summary": "List numbers",
+          "return_type": ["list", "number"],
+          "parameters": [{ "name": "count", "type": "number" }]
+        },
+        "flag_set": {
+          "description": "Returns true if any flag in the given set of flags is true.",
+          "summary": "Any flag set",
+          "return_type": "bool",
+          "parameters": [{ "name": "flags", "type": ["set", "bool"] }]
+        },
+        "flags_for_seed": {
+          "description": "Returns a set of flags derived from the given seed - used to prove a set(bool) RETURN can be fed directly into another function's set(bool) PARAMETER (see flag_set above).",
+          "summary": "Flags for seed",
+          "return_type": ["set", "bool"],
+          "parameters": [{ "name": "seed", "type": "string" }]
+        },
+        "flags_ordered": {
+          "description": "Returns true if any flag in the given ordered list of flags is true.",
+          "summary": "Any flag set (ordered)",
+          "return_type": "bool",
+          "parameters": [{ "name": "flags", "type": ["list", "bool"] }]
+        },
+        "describe_configs": {
+          "description": "Renders the given list of config objects as a single string.",
+          "summary": "Describe configs",
+          "return_type": "string",
+          "parameters": [
+            {
+              "name": "configs",
+              "type": ["list", ["object", { "enabled": "bool" }]]
+            }
+          ]
+        },
+        "nested_list": {
+          "description": "Flattens a matrix (a list of lists of strings) into a single string.",
+          "summary": "Flatten a matrix",
+          "return_type": "string",
+          "parameters": [
+            { "name": "matrix", "type": ["list", ["list", "string"]] }
+          ]
+        },
+        "dedupe_name_groups": {
+          "description": "Deduplicates each group of names, returning a list of name sets.",
+          "summary": "Dedupe name groups",
+          "return_type": ["list", ["set", "string"]],
+          "parameters": [
+            { "name": "name_groups", "type": ["list", ["set", "string"]] }
+          ]
+        },
+        "unique_name_lists": {
+          "description": "Returns the distinct name lists among the given ones.",
+          "summary": "Unique name lists",
+          "return_type": ["set", ["list", "string"]],
+          "parameters": [
+            { "name": "name_lists", "type": ["set", ["list", "string"]] }
+          ]
+        },
+        "build_info": {
+          "description": "Returns an object describing the build that produced the given seed.",
+          "summary": "Build info",
+          "return_type": [
+            "object",
+            { "version": "string", "revision": "string" }
+          ],
+          "parameters": [{ "name": "seed", "type": "string" }]
+        },
+        "tag_map": {
+          "description": "Renders the given map of string tags as a single string.",
+          "summary": "Render tags",
+          "return_type": "string",
+          "parameters": [{ "name": "tags", "type": ["map", "string"] }]
+        },
+        "default_tags": {
+          "description": "Returns a default map of string tags derived from the given prefix - used to prove a map(string) RETURN can be fed directly into another function's map(string) PARAMETER (see tag_map above).",
+          "summary": "Default tags",
+          "return_type": ["map", "string"],
+          "parameters": [{ "name": "prefix", "type": "string" }]
+        },
+        "count_by_tag": {
+          "description": "Returns a map of counts keyed by tag for the given prefix.",
+          "summary": "Count by tag",
+          "return_type": ["map", "number"],
+          "parameters": [{ "name": "prefix", "type": "string" }]
+        },
+        "flags_by_tag": {
+          "description": "Returns a map of flags keyed by tag for the given prefix.",
+          "summary": "Flags by tag",
+          "return_type": ["map", "bool"],
+          "parameters": [{ "name": "prefix", "type": "string" }]
+        },
+        "configs_by_tag": {
+          "description": "Returns a map of config objects keyed by tag for the given prefix.",
+          "summary": "Configs by tag",
+          "return_type": ["map", ["object", { "enabled": "bool" }]],
+          "parameters": [{ "name": "prefix", "type": "string" }]
+        },
+        "config_map": {
+          "description": "Renders the given map of config objects as a single string.",
+          "summary": "Render configs",
+          "return_type": "string",
+          "parameters": [
+            {
+              "name": "configs",
+              "type": ["map", ["object", { "enabled": "bool" }]]
+            }
+          ]
+        },
+        "legacy_helper": {
+          "description": "A deprecated helper kept around for backwards compatibility.",
+          "summary": "Legacy helper",
+          "deprecation_message": "Use new_helper instead.",
+          "return_type": "string",
+          "parameters": [{ "name": "input", "type": "string" }]
+        },
+        "trailing_nullable": {
+          "description": "Greets the given name, optionally with a custom greeting.",
+          "summary": "Greet with an optional greeting",
+          "return_type": "string",
+          "parameters": [
+            { "name": "name", "type": "string" },
+            {
+              "name": "greeting",
+              "type": "string",
+              "is_nullable": true
+            }
+          ]
+        },
+        "mid_nullable": {
+          "description": "Joins a possibly-null prefix with a required suffix.",
+          "summary": "Join with a nullable prefix",
+          "return_type": "string",
+          "parameters": [
+            {
+              "name": "prefix",
+              "type": "string",
+              "is_nullable": true
+            },
+            { "name": "suffix", "type": "string" }
+          ]
+        },
+        "variadic_nullable": {
+          "description": "Joins a label with any number of possibly-null items.",
+          "summary": "Join with nullable items",
+          "return_type": "string",
+          "parameters": [{ "name": "label", "type": "string" }],
+          "variadic_parameter": {
+            "name": "items",
+            "type": "string",
+            "is_nullable": true
+          }
+        }
+      }
+    }
+  }
+}