Clarify default for 'required', add explicit example

src/metldata/builtin_transformations/add_content_properties/instruction.py

@@ -58,7 +58,7 @@ class AddContentPropertyInstruction(BaseSettings):
         True,
         description=(
             "Indicates whether the newly added property shall be added to the"
-            + " 'required' list of the corresponding object."
+            + " 'required' list of the corresponding object. Defaults to 'True'."
         ),
     )
 

tests/fixtures/example_transformations/add_content_properties/multiple/config.yaml

@@ -11,3 +11,12 @@ add_content_properties:
   content_schema:
     type: "boolean"
   value: false
+  # required is not set, so it defaults to false
+- class_name: File
+  target_content:
+    object_path: ""
+    property_name: "content_description"
+  content_schema:
+    type: "string"
+  required: true
+  value: ""

tests/fixtures/example_transformations/add_content_properties/multiple/transformed.datapack.yaml

@@ -9,6 +9,7 @@ resources:
         size: 12321
         additional_information: # <-
           compression: false
+        content_description: "" # <-
     file_b:
       content:
         filename: file_b.fastq
@@ -17,6 +18,7 @@ resources:
         size: 12314
         additional_information: # <-
           compression: false
+        content_description: "" # <-
     file_c:
       content:
         filename: file_c.fastq
@@ -25,6 +27,7 @@ resources:
         size: 12123
         additional_information: # <-
           compression: false
+        content_description: "" # <-
   Dataset:
     dataset_1:
       content:

tests/fixtures/example_transformations/add_content_properties/multiple/transformed.schemapack.yaml

@@ -31,13 +31,17 @@ classes:
           "required": [
             "compression"
           ],
+        },
+        "content_description": {
+          "type" : "string"
         }
       },
       "required": [
         "filename",
         "format",
         "checksum",
         "size",
+        "content_description",
       ],
       "type": "object"
     }