aws-cdk-lib 2.181.1__py3-none-any.whl → 2.183.0__py3-none-any.whl

aws_cdk/_jsii/__init__.py

@@ -34,7 +34,7 @@ import aws_cdk.cloud_assembly_schema._jsii
 import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
-    "aws-cdk-lib", "2.181.1", __name__[0:-6], "aws-cdk-lib@2.181.1.jsii.tgz"
+    "aws-cdk-lib", "2.183.0", __name__[0:-6], "aws-cdk-lib@2.183.0.jsii.tgz"
 )
 
 __all__ = [

aws_cdk/assertions/__init__.py

@@ -135,6 +135,34 @@ Beyond assertions, the module provides APIs to retrieve matching resources.
 The `findResources()` API is complementary to the `hasResource()` API, except,
 instead of asserting its presence, it returns the set of matching resources.
 
+Similarly, the `getResourceId()` API is complementary to the `findResources()` API,
+except it expects only one matching resource, and returns the matched resource's resource id.
+Useful for asserting that certain cloudformation resources correlate expectedly.
+
+```python
+# Assert that a certain bucket denies unsecure communication
+bucket = template.get_resource_id("AWS::S3::Bucket", {
+    "Properties": {
+        "BucketName": "my-bucket"
+    }
+})
+
+template.has_resource_properties("AWS::S3::BucketPolicy", {
+    "Bucket": {
+        "Ref": bucket
+    },
+    "PolicyDocument": {
+        "Statement": [{
+            "Effect": "Deny",
+            "Action": "s3:*",
+            "Principal": {"AWS": "*"},
+            "Condition": {"Bool": {"aws:_secure_transport": "false"}}
+        }
+        ]
+    }
+})
+```
+
 By default, the `hasResource()` and `hasResourceProperties()` APIs perform deep
 partial object matching. This behavior can be configured using matchers.
 See subsequent section on [special matchers](#special-matchers).
@@ -1678,6 +1706,30 @@ class Template(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.assertions.Templa
             check_type(argname="argument props", value=props, expected_type=type_hints["props"])
         return typing.cast(typing.Mapping[builtins.str, typing.Mapping[builtins.str, typing.Any]], jsii.invoke(self, "findResources", [type, props]))
 
+    @jsii.member(jsii_name="getResourceId")
+    def get_resource_id(
+        self,
+        type: builtins.str,
+        props: typing.Any = None,
+    ) -> builtins.str:
+        '''Get the Resource ID of a matching resource, expects only to find one match.
+
+        Throws AssertionError if none or multiple resources were found.
+
+        :param type: the resource type; ex: ``AWS::S3::Bucket``
+        :param props: by default, matches all resources with the given type.
+
+        :return:
+
+        The resource id of the matched resource.
+        Performs a partial match via ``Match.objectLike()``.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__2f7c6944fc7b237368ae228a894f8b38d522a3e852eff794e0f83205175667d4)
+            check_type(argname="argument type", value=type, expected_type=type_hints["type"])
+            check_type(argname="argument props", value=props, expected_type=type_hints["props"])
+        return typing.cast(builtins.str, jsii.invoke(self, "getResourceId", [type, props]))
+
     @jsii.member(jsii_name="hasCondition")
     def has_condition(self, logical_id: builtins.str, props: typing.Any) -> None:
         '''Assert that a Condition with the given properties exists in the CloudFormation template.
@@ -2274,6 +2326,13 @@ def _typecheckingstub__8dfdecc696a85cbadb9124975e7619b743acea4afb3b4cfdbc07ad48a
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__2f7c6944fc7b237368ae228a894f8b38d522a3e852eff794e0f83205175667d4(
+    type: builtins.str,
+    props: typing.Any = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ac5b639f55bbadd46a290effbbbd13769b71a711bcc8b3e04c9b2e4f29931a84(
     logical_id: builtins.str,
     props: typing.Any,