aws-cdk-lib 2.164.1__py3-none-any.whl → 2.165.0__py3-none-any.whl

aws_cdk/aws_bedrock/__init__.py

@@ -9486,7 +9486,7 @@ class CfnFlow(
             :param max_tokens: The maximum number of tokens to return in the response.
             :param stop_sequences: A list of strings that define sequences after which the model will stop generating.
             :param temperature: Controls the randomness of the response. Choose a lower value for more predictable outputs and a higher value for more surprising outputs.
-            :param top_k: The number of most-likely candidates that the model considers for the next token during generation.
+            :param top_k: Sample from the k most likely next tokens.
             :param top_p: The percentage of most-likely candidates that the model considers for the next token.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-flow-promptmodelinferenceconfiguration.html
@@ -9556,7 +9556,7 @@ class CfnFlow(
 
         @builtins.property
         def top_k(self) -> typing.Optional[jsii.Number]:
-            '''The number of most-likely candidates that the model considers for the next token during generation.
+            '''Sample from the k most likely next tokens.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-flow-promptmodelinferenceconfiguration.html#cfn-bedrock-flow-promptmodelinferenceconfiguration-topk
             '''
@@ -13281,7 +13281,7 @@ class CfnFlowVersion(
             :param max_tokens: The maximum number of tokens to return in the response.
             :param stop_sequences: A list of strings that define sequences after which the model will stop generating.
             :param temperature: Controls the randomness of the response. Choose a lower value for more predictable outputs and a higher value for more surprising outputs.
-            :param top_k: The number of most-likely candidates that the model considers for the next token during generation.
+            :param top_k: Sample from the k most likely next tokens.
             :param top_p: The percentage of most-likely candidates that the model considers for the next token.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-flowversion-promptmodelinferenceconfiguration.html
@@ -13351,7 +13351,7 @@ class CfnFlowVersion(
 
         @builtins.property
         def top_k(self) -> typing.Optional[jsii.Number]:
-            '''The number of most-likely candidates that the model considers for the next token during generation.
+            '''Sample from the k most likely next tokens.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-flowversion-promptmodelinferenceconfiguration.html#cfn-bedrock-flowversion-promptmodelinferenceconfiguration-topk
             '''
@@ -17908,7 +17908,7 @@ class CfnPrompt(
             :param max_tokens: The maximum number of tokens to return in the response.
             :param stop_sequences: A list of strings that define sequences after which the model will stop generating.
             :param temperature: Controls the randomness of the response. Choose a lower value for more predictable outputs and a higher value for more surprising outputs.
-            :param top_k: The number of most-likely candidates that the model considers for the next token during generation.
+            :param top_k: Sample from the k most likely next tokens.
             :param top_p: The percentage of most-likely candidates that the model considers for the next token.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-prompt-promptmodelinferenceconfiguration.html
@@ -17978,7 +17978,7 @@ class CfnPrompt(
 
         @builtins.property
         def top_k(self) -> typing.Optional[jsii.Number]:
-            '''The number of most-likely candidates that the model considers for the next token during generation.
+            '''Sample from the k most likely next tokens.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-prompt-promptmodelinferenceconfiguration.html#cfn-bedrock-prompt-promptmodelinferenceconfiguration-topk
             '''
@@ -18965,7 +18965,7 @@ class CfnPromptVersion(
             :param max_tokens: The maximum number of tokens to return in the response.
             :param stop_sequences: A list of strings that define sequences after which the model will stop generating.
             :param temperature: Controls the randomness of the response. Choose a lower value for more predictable outputs and a higher value for more surprising outputs.
-            :param top_k: The number of most-likely candidates that the model considers for the next token during generation.
+            :param top_k: Sample from the k most likely next tokens.
             :param top_p: The percentage of most-likely candidates that the model considers for the next token.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-promptversion-promptmodelinferenceconfiguration.html
@@ -19035,7 +19035,7 @@ class CfnPromptVersion(
 
         @builtins.property
         def top_k(self) -> typing.Optional[jsii.Number]:
-            '''The number of most-likely candidates that the model considers for the next token during generation.
+            '''Sample from the k most likely next tokens.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-promptversion-promptmodelinferenceconfiguration.html#cfn-bedrock-promptversion-promptmodelinferenceconfiguration-topk
             '''

aws_cdk/aws_codebuild/__init__.py

@@ -73,7 +73,7 @@ Example:
 ```python
 git_hub_source = codebuild.Source.git_hub(
     owner="awslabs",
-    repo="aws-cdk",
+    repo="aws-cdk",  # optional, default: undefined if unspecified will create organization webhook
     webhook=True,  # optional, default: true if `webhookFilters` were provided, false otherwise
     webhook_triggers_batch_build=True,  # optional, default is false
     webhook_filters=[
@@ -83,6 +83,19 @@ git_hub_source = codebuild.Source.git_hub(
 )
 ```
 
+The `GitHubSource` is also able to trigger all repos in GitHub Organizations
+Example:
+
+```python
+git_hub_source = codebuild.Source.git_hub(
+    owner="aws",
+    webhook_triggers_batch_build=True,  # optional, default is false
+    webhook_filters=[
+        codebuild.FilterGroup.in_event_of(codebuild.EventAction.WORKFLOW_JOB_QUEUED).and_repository_name_is("aws-.*").and_repository_name_is_not("aws-cdk-lib")
+    ]
+)
+```
+
 To provide GitHub credentials, please either go to AWS CodeBuild Console to connect
 or call `ImportSourceCredentials` to persist your personal access token.
 Example:
@@ -8369,7 +8382,7 @@ class EventAction(enum.Enum):
 
         git_hub_source = codebuild.Source.git_hub(
             owner="awslabs",
-            repo="aws-cdk",
+            repo="aws-cdk",  # optional, default: undefined if unspecified will create organization webhook
             webhook=True,  # optional, default: true if `webhookFilters` were provided, false otherwise
             webhook_triggers_batch_build=True,  # optional, default is false
             webhook_filters=[
@@ -8551,7 +8564,7 @@ class FilterGroup(
 
         git_hub_source = codebuild.Source.git_hub(
             owner="awslabs",
-            repo="aws-cdk",
+            repo="aws-cdk",  # optional, default: undefined if unspecified will create organization webhook
             webhook=True,  # optional, default: true if `webhookFilters` were provided, false otherwise
             webhook_triggers_batch_build=True,  # optional, default is false
             webhook_filters=[
@@ -8741,6 +8754,34 @@ class FilterGroup(
             check_type(argname="argument pattern", value=pattern, expected_type=type_hints["pattern"])
         return typing.cast("FilterGroup", jsii.invoke(self, "andHeadRefIsNot", [pattern]))
 
+    @jsii.member(jsii_name="andRepositoryNameIs")
+    def and_repository_name_is(self, pattern: builtins.str) -> "FilterGroup":
+        '''Create a new FilterGroup with an added condition: the push that is the source of the event affect only a repository name that matches the given pattern.
+
+        Note that you can only use this method if this Group contains only the ``WORKFLOW_JOB_QUEUED`` event action,
+        only for GitHub sources and only for organization webhook.
+
+        :param pattern: a regular expression.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9e7d3f169fef6e265f8052a45ab6fd4a3fd2974d9cbf918ba5d79bbc11b6c0b3)
+            check_type(argname="argument pattern", value=pattern, expected_type=type_hints["pattern"])
+        return typing.cast("FilterGroup", jsii.invoke(self, "andRepositoryNameIs", [pattern]))
+
+    @jsii.member(jsii_name="andRepositoryNameIsNot")
+    def and_repository_name_is_not(self, pattern: builtins.str) -> "FilterGroup":
+        '''Create a new FilterGroup with an added condition: the push that is the source of the event must not affect a repository name that matches the given pattern.
+
+        Note that you can only use this method if this Group contains only the ``WORKFLOW_JOB_QUEUED`` event action,
+        only for GitHub sources and only for organization webhook.
+
+        :param pattern: a regular expression.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e84ee81a663b5ed60423a7ba14b5db0cf1deeb13dee287175257f878aedcc7b2)
+            check_type(argname="argument pattern", value=pattern, expected_type=type_hints["pattern"])
+        return typing.cast("FilterGroup", jsii.invoke(self, "andRepositoryNameIsNot", [pattern]))
+
     @jsii.member(jsii_name="andTagIs")
     def and_tag_is(self, tag_name: builtins.str) -> "FilterGroup":
         '''Create a new FilterGroup with an added condition: the event must affect the given tag.
@@ -14850,12 +14891,12 @@ class Source(
         cls,
         *,
         owner: builtins.str,
-        repo: builtins.str,
         branch_or_ref: typing.Optional[builtins.str] = None,
         build_status_context: typing.Optional[builtins.str] = None,
         build_status_url: typing.Optional[builtins.str] = None,
         clone_depth: typing.Optional[jsii.Number] = None,
         fetch_submodules: typing.Optional[builtins.bool] = None,
+        repo: typing.Optional[builtins.str] = None,
         report_build_status: typing.Optional[builtins.bool] = None,
         webhook: typing.Optional[builtins.bool] = None,
         webhook_filters: typing.Optional[typing.Sequence[FilterGroup]] = None,
@@ -14863,13 +14904,13 @@ class Source(
         identifier: typing.Optional[builtins.str] = None,
     ) -> ISource:
         '''
-        :param owner: The GitHub account/user that owns the repo.
-        :param repo: The name of the repo (without the username).
+        :param owner: The GitHub Organization/user that owns the repo.
         :param branch_or_ref: The commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. Default: the default branch's HEAD commit ID is used
         :param build_status_context: This parameter is used for the ``context`` parameter in the GitHub commit status. Can use built-in CodeBuild variables, like $AWS_REGION. Default: "AWS CodeBuild $AWS_REGION ($PROJECT_NAME)"
         :param build_status_url: The URL that the build will report back to the source provider. Can use built-in CodeBuild variables, like $AWS_REGION. Default: - link to the AWS Console for CodeBuild to a particular build execution
         :param clone_depth: The depth of history to download. Minimum value is 0. If this value is 0, greater than 25, or not provided, then the full history is downloaded with each build of the project.
         :param fetch_submodules: Whether to fetch submodules while cloning git repo. Default: false
+        :param repo: The name of the repo (without the username). Default: undefined will create an organization webhook
         :param report_build_status: Whether to send notifications on your build's start and end. Default: true
         :param webhook: Whether to create a webhook that will trigger a build every time an event happens in the repository. Default: true if any ``webhookFilters`` were provided, false otherwise
         :param webhook_filters: A list of webhook filters that can constraint what events in the repository will trigger a build. A build is triggered if any of the provided filter groups match. Only valid if ``webhook`` was not provided as false. Default: every push and every Pull Request (create or update) triggers a build
@@ -14878,12 +14919,12 @@ class Source(
         '''
         props = GitHubSourceProps(
             owner=owner,
-            repo=repo,
             branch_or_ref=branch_or_ref,
             build_status_context=build_status_context,
             build_status_url=build_status_url,
             clone_depth=clone_depth,
             fetch_submodules=fetch_submodules,
+            repo=repo,
             report_build_status=report_build_status,
             webhook=webhook,
             webhook_filters=webhook_filters,
@@ -16499,12 +16540,12 @@ class GitHubEnterpriseSourceProps(SourceProps):
     name_mapping={
         "identifier": "identifier",
         "owner": "owner",
-        "repo": "repo",
         "branch_or_ref": "branchOrRef",
         "build_status_context": "buildStatusContext",
         "build_status_url": "buildStatusUrl",
         "clone_depth": "cloneDepth",
         "fetch_submodules": "fetchSubmodules",
+        "repo": "repo",
         "report_build_status": "reportBuildStatus",
         "webhook": "webhook",
         "webhook_filters": "webhookFilters",
@@ -16517,12 +16558,12 @@ class GitHubSourceProps(SourceProps):
         *,
         identifier: typing.Optional[builtins.str] = None,
         owner: builtins.str,
-        repo: builtins.str,
         branch_or_ref: typing.Optional[builtins.str] = None,
         build_status_context: typing.Optional[builtins.str] = None,
         build_status_url: typing.Optional[builtins.str] = None,
         clone_depth: typing.Optional[jsii.Number] = None,
         fetch_submodules: typing.Optional[builtins.bool] = None,
+        repo: typing.Optional[builtins.str] = None,
         report_build_status: typing.Optional[builtins.bool] = None,
         webhook: typing.Optional[builtins.bool] = None,
         webhook_filters: typing.Optional[typing.Sequence[FilterGroup]] = None,
@@ -16531,13 +16572,13 @@ class GitHubSourceProps(SourceProps):
         '''Construction properties for ``GitHubSource`` and ``GitHubEnterpriseSource``.
 
         :param identifier: The source identifier. This property is required on secondary sources.
-        :param owner: The GitHub account/user that owns the repo.
-        :param repo: The name of the repo (without the username).
+        :param owner: The GitHub Organization/user that owns the repo.
         :param branch_or_ref: The commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. Default: the default branch's HEAD commit ID is used
         :param build_status_context: This parameter is used for the ``context`` parameter in the GitHub commit status. Can use built-in CodeBuild variables, like $AWS_REGION. Default: "AWS CodeBuild $AWS_REGION ($PROJECT_NAME)"
         :param build_status_url: The URL that the build will report back to the source provider. Can use built-in CodeBuild variables, like $AWS_REGION. Default: - link to the AWS Console for CodeBuild to a particular build execution
         :param clone_depth: The depth of history to download. Minimum value is 0. If this value is 0, greater than 25, or not provided, then the full history is downloaded with each build of the project.
         :param fetch_submodules: Whether to fetch submodules while cloning git repo. Default: false
+        :param repo: The name of the repo (without the username). Default: undefined will create an organization webhook
         :param report_build_status: Whether to send notifications on your build's start and end. Default: true
         :param webhook: Whether to create a webhook that will trigger a build every time an event happens in the repository. Default: true if any ``webhookFilters`` were provided, false otherwise
         :param webhook_filters: A list of webhook filters that can constraint what events in the repository will trigger a build. A build is triggered if any of the provided filter groups match. Only valid if ``webhook`` was not provided as false. Default: every push and every Pull Request (create or update) triggers a build
@@ -16547,31 +16588,30 @@ class GitHubSourceProps(SourceProps):
 
         Example::
 
-            project = codebuild.Project(self, "MyProject",
-                build_spec=codebuild.BuildSpec.from_source_filename("my-buildspec.yml"),
-                source=codebuild.Source.git_hub(
-                    owner="awslabs",
-                    repo="aws-cdk"
-                )
+            git_hub_source = codebuild.Source.git_hub(
+                owner="aws",
+                webhook_triggers_batch_build=True,  # optional, default is false
+                webhook_filters=[
+                    codebuild.FilterGroup.in_event_of(codebuild.EventAction.WORKFLOW_JOB_QUEUED).and_repository_name_is("aws-.*").and_repository_name_is_not("aws-cdk-lib")
+                ]
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__d3b887e14634bc45819a77709375f77df36f65342d6d36aacb8fa50fb075226a)
             check_type(argname="argument identifier", value=identifier, expected_type=type_hints["identifier"])
             check_type(argname="argument owner", value=owner, expected_type=type_hints["owner"])
-            check_type(argname="argument repo", value=repo, expected_type=type_hints["repo"])
             check_type(argname="argument branch_or_ref", value=branch_or_ref, expected_type=type_hints["branch_or_ref"])
             check_type(argname="argument build_status_context", value=build_status_context, expected_type=type_hints["build_status_context"])
             check_type(argname="argument build_status_url", value=build_status_url, expected_type=type_hints["build_status_url"])
             check_type(argname="argument clone_depth", value=clone_depth, expected_type=type_hints["clone_depth"])
             check_type(argname="argument fetch_submodules", value=fetch_submodules, expected_type=type_hints["fetch_submodules"])
+            check_type(argname="argument repo", value=repo, expected_type=type_hints["repo"])
             check_type(argname="argument report_build_status", value=report_build_status, expected_type=type_hints["report_build_status"])
             check_type(argname="argument webhook", value=webhook, expected_type=type_hints["webhook"])
             check_type(argname="argument webhook_filters", value=webhook_filters, expected_type=type_hints["webhook_filters"])
             check_type(argname="argument webhook_triggers_batch_build", value=webhook_triggers_batch_build, expected_type=type_hints["webhook_triggers_batch_build"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "owner": owner,
-            "repo": repo,
         }
         if identifier is not None:
             self._values["identifier"] = identifier
@@ -16585,6 +16625,8 @@ class GitHubSourceProps(SourceProps):
             self._values["clone_depth"] = clone_depth
         if fetch_submodules is not None:
             self._values["fetch_submodules"] = fetch_submodules
+        if repo is not None:
+            self._values["repo"] = repo
         if report_build_status is not None:
             self._values["report_build_status"] = report_build_status
         if webhook is not None:
@@ -16605,7 +16647,7 @@ class GitHubSourceProps(SourceProps):
 
     @builtins.property
     def owner(self) -> builtins.str:
-        '''The GitHub account/user that owns the repo.
+        '''The GitHub Organization/user that owns the repo.
 
         Example::
 
@@ -16615,18 +16657,6 @@ class GitHubSourceProps(SourceProps):
         assert result is not None, "Required property 'owner' is missing"
         return typing.cast(builtins.str, result)
 
-    @builtins.property
-    def repo(self) -> builtins.str:
-        '''The name of the repo (without the username).
-
-        Example::
-
-            "aws-cdk"
-        '''
-        result = self._values.get("repo")
-        assert result is not None, "Required property 'repo' is missing"
-        return typing.cast(builtins.str, result)
-
     @builtins.property
     def branch_or_ref(self) -> typing.Optional[builtins.str]:
         '''The commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build.
@@ -16694,6 +16724,19 @@ class GitHubSourceProps(SourceProps):
         result = self._values.get("fetch_submodules")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def repo(self) -> typing.Optional[builtins.str]:
+        '''The name of the repo (without the username).
+
+        :default: undefined will create an organization webhook
+
+        Example::
+
+            "aws-cdk"
+        '''
+        result = self._values.get("repo")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def report_build_status(self) -> typing.Optional[builtins.bool]:
         '''Whether to send notifications on your build's start and end.
@@ -18332,6 +18375,18 @@ def _typecheckingstub__a2e6773d7ae0ebb1e84bc59b0802dbef393b54896f56ef64f567d576e
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__9e7d3f169fef6e265f8052a45ab6fd4a3fd2974d9cbf918ba5d79bbc11b6c0b3(
+    pattern: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e84ee81a663b5ed60423a7ba14b5db0cf1deeb13dee287175257f878aedcc7b2(
+    pattern: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__9ffb04f4c6555e4c32bf26674c6978ab767449655616070b2b0002f145554f3c(
     tag_name: builtins.str,
 ) -> None:
@@ -19200,12 +19255,12 @@ def _typecheckingstub__d3b887e14634bc45819a77709375f77df36f65342d6d36aacb8fa50fb
     *,
     identifier: typing.Optional[builtins.str] = None,
     owner: builtins.str,
-    repo: builtins.str,
     branch_or_ref: typing.Optional[builtins.str] = None,
     build_status_context: typing.Optional[builtins.str] = None,
     build_status_url: typing.Optional[builtins.str] = None,
     clone_depth: typing.Optional[jsii.Number] = None,
     fetch_submodules: typing.Optional[builtins.bool] = None,
+    repo: typing.Optional[builtins.str] = None,
     report_build_status: typing.Optional[builtins.bool] = None,
     webhook: typing.Optional[builtins.bool] = None,
     webhook_filters: typing.Optional[typing.Sequence[FilterGroup]] = None,