cloud-radar 0.14.1a2__tar.gz → 0.15.0a0__tar.gz

{cloud_radar-0.14.1a2 → cloud_radar-0.15.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: cloud-radar
-Version: 0.14.1a2
+Version: 0.15.0a0
 Summary: Run functional tests on cloudformation stacks.
 License: Apache-2.0
 Keywords: aws,cloudformation,cloud-radar,testing,taskcat,cloud,radar
@@ -239,7 +239,7 @@ dynamic_references = {
 template = Template(template_content, dynamic_references=dynamic_references)
 ```
 
-There are cases where the default behaviour of our `GetAtt` implementation may not be sufficient and you need a more accurate returned value. When unit testing there are no real AWS resources created, and cloud-radar does not attempt to realistically generate attribute values - a string is always returned. This works good enough most of the time, but there are some cases where if you are attempting to apply intrinsic functions against the attribute value it needs to be more correct. When this occurs, you can add Metadata to the template to provide test values to use.
+There are cases where the default behaviour of our `Ref` and `GetAtt` implementations may not be sufficient and you need a more accurate returned value. When unit testing there are no real AWS resources created, and cloud-radar does not attempt to realistically generate attribute values - a string is always returned. For `Ref` this is the logical resource name, for `GetAtt` this is `<logical resource name>.<attribute name>`. This works good enough most of the time, but there are some cases where if you are attempting to apply intrinsic functions against these value it needs to be more correct. When this occurs, you can add Metadata to the template to provide test values to use.
 
 ```
 Resources:
@@ -247,6 +247,7 @@ Resources:
     Type: AWS::MediaPackageV2::Channel
     Metadata:
       Cloud-Radar:
+        ref: arn:aws:mediapackagev2:region:AccountId:ChannelGroup/ChannelGroupName/Channel/ChannelName
         attribute-values:
         # Default behaviour of a string is not good enough here, the attribute value is expected to be a List.
           IngestEndpointUrls:
@@ -256,6 +257,7 @@ Resources:
       ChannelGroupName: dev_video_1
       ChannelName: !Sub ${AWS::StackName}-MediaPackageChannel
 ```
+If you are unable to modify the template itself, it is also possible to inject this metadata as part of the unit test. See [this test case](./tests/test_cf/test_unit/test_functions_ref.py) for an example.
 
 A real unit testing example using Pytest can be seen [here](./tests/test_cf/test_examples/test_unit.py)
 

{cloud_radar-0.14.1a2 → cloud_radar-0.15.0a0}/README.md

@@ -211,7 +211,7 @@ dynamic_references = {
 template = Template(template_content, dynamic_references=dynamic_references)
 ```
 
-There are cases where the default behaviour of our `GetAtt` implementation may not be sufficient and you need a more accurate returned value. When unit testing there are no real AWS resources created, and cloud-radar does not attempt to realistically generate attribute values - a string is always returned. This works good enough most of the time, but there are some cases where if you are attempting to apply intrinsic functions against the attribute value it needs to be more correct. When this occurs, you can add Metadata to the template to provide test values to use.
+There are cases where the default behaviour of our `Ref` and `GetAtt` implementations may not be sufficient and you need a more accurate returned value. When unit testing there are no real AWS resources created, and cloud-radar does not attempt to realistically generate attribute values - a string is always returned. For `Ref` this is the logical resource name, for `GetAtt` this is `<logical resource name>.<attribute name>`. This works good enough most of the time, but there are some cases where if you are attempting to apply intrinsic functions against these value it needs to be more correct. When this occurs, you can add Metadata to the template to provide test values to use.
 
 ```
 Resources:
@@ -219,6 +219,7 @@ Resources:
     Type: AWS::MediaPackageV2::Channel
     Metadata:
       Cloud-Radar:
+        ref: arn:aws:mediapackagev2:region:AccountId:ChannelGroup/ChannelGroupName/Channel/ChannelName
         attribute-values:
         # Default behaviour of a string is not good enough here, the attribute value is expected to be a List.
           IngestEndpointUrls:
@@ -228,6 +229,7 @@ Resources:
       ChannelGroupName: dev_video_1
       ChannelName: !Sub ${AWS::StackName}-MediaPackageChannel
 ```
+If you are unable to modify the template itself, it is also possible to inject this metadata as part of the unit test. See [this test case](./tests/test_cf/test_unit/test_functions_ref.py) for an example.
 
 A real unit testing example using Pytest can be seen [here](./tests/test_cf/test_examples/test_unit.py)
 

{cloud_radar-0.14.1a2 → cloud_radar-0.15.0a0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cloud-radar"
-version = "0.14.1a2"
+version = "0.15.0a0"
 description = "Run functional tests on cloudformation stacks."
 readme = "README.md"
 authors = [

{cloud_radar-0.14.1a2 → cloud_radar-0.15.0a0}/src/cloud_radar/cf/unit/_output.py

@@ -27,11 +27,12 @@ class Output(UserDict):
         Args:
             value (Any): The value to compare the output value to.
         """
-        acutal_value = self.get_value()
+        actual_value = self.get_value()
 
-        assert (
-            value == acutal_value
-        ), f"Output '{self.name}' actual value did not match input value."
+        assert value == actual_value, (
+            f"Output '{self.name}' actual value ({actual_value}) did not match"
+            f" input value ({value})."
+        )
 
     def has_export(self):
         """Check if the output has an export."""

{cloud_radar-0.14.1a2 → cloud_radar-0.15.0a0}/src/cloud_radar/cf/unit/functions.py

@@ -459,14 +459,17 @@ def get_att(template: "Template", values: Any) -> str:
     # Check if there is a value in the resource Metadata for this attribute.
     # If the attribute requested is in the metadata, return it.
     # Otherwise use the string value of "{resource_name}.{att_name}"
-
-    metadata = resource.get("Metadata", {})
-    cloud_radar_metadata = metadata.get("Cloud-Radar", {})
+    cloud_radar_metadata = _get_cloud_radar_metadata(resource)
     attribute_values = cloud_radar_metadata.get("attribute-values", {})
 
     return attribute_values.get(att_name, f"{resource_name}.{att_name}")
 
 
+def _get_cloud_radar_metadata(resource) -> dict:
+    metadata = resource.get("Metadata", {})
+    return metadata.get("Cloud-Radar", {})
+
+
 def get_azs(_t: "Template", region: Any) -> List[str]:
     """Solves AWS GetAZs intrinsic function.
 
@@ -857,7 +860,13 @@ def ref(template: "Template", var_name: str) -> Any:
             return param_value
 
     if var_name in template.template["Resources"]:
-        return var_name
+        # Check if there is a value in the resource Metadata for this reference.
+        # If the ref requested is in the metadata, return it.
+        # Otherwise use the string value of the logical resource name
+        cloud_radar_metadata = _get_cloud_radar_metadata(
+            template.template["Resources"][var_name]
+        )
+        return cloud_radar_metadata.get("ref", var_name)
 
     raise Exception(f"Fn::Ref - {var_name} is not a valid Resource or Parameter.")