generate_docs() for conditionalCreateOnlyProperties (#740)

* generate_docs() for conditionalCreateOnlyProperties

#367 (comment)
aws-cloudformation/cloudformation-resource-schema#121
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt

* test coverage

Author: PatMyron

src/rpdk/core/project.py

@@ -859,7 +859,11 @@ def _set_docs_properties(  # noqa: C901
             and proppath_ptr in self.schema["createOnlyProperties"]
         ):
             prop["createonly"] = True
-
+        if (
+            "conditionalCreateOnlyProperties" in self.schema
+            and proppath_ptr in self.schema["conditionalCreateOnlyProperties"]
+        ):
+            prop["conditionalCreateOnly"] = True
         if (
             "readOnlyProperties" in self.schema
             and proppath_ptr in self.schema["readOnlyProperties"]

src/rpdk/core/templates/docs-readme.md

@@ -76,6 +76,9 @@ _Pattern_: <code>{{ prop.pattern }}</code>
 {% if prop.createonly %}
 
 _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
+{% elif prop.conditionalCreateOnly %}
+
+_Update requires_: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)
 {% else %}
 
 _Update requires_: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

src/rpdk/core/templates/docs-subproperty.md

@@ -71,6 +71,9 @@ _Pattern_: <code>{{ prop.pattern }}</code>
 {% if prop.createonly %}
 
 _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
+{% elif prop.conditionalCreateOnly %}
+
+_Update requires_: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)
 {% else %}
 
 _Update requires_: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

tests/data/schema/valid/valid_type_complex.json

@@ -71,5 +71,8 @@
     "createOnlyProperties": [
         "/properties/str2"
     ],
+    "conditionalCreateOnlyProperties": [
+        "/properties/obj1"
+    ],
     "additionalProperties": false
 }