diff --git a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/async_client.py b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/async_client.py index 9953ec4..8828bef 100644 --- a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/async_client.py +++ b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/async_client.py @@ -558,6 +558,7 @@ async def list_builds( metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListBuildsAsyncPager: r"""Lists previously requested builds. + Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. @@ -612,6 +613,7 @@ async def sample_list_builds(): Returns: google.cloud.devtools.cloudbuild_v1.services.cloud_build.pagers.ListBuildsAsyncPager: Response including listed builds. + Iterating over this object will yield results and resolve additional pages automatically. @@ -1010,6 +1012,7 @@ async def approve_build( metadata: Sequence[Tuple[str, str]] = (), ) -> operation_async.AsyncOperation: r"""Approves or rejects a pending build. + If approved, the returned LRO will be analogous to the LRO returned from a CreateBuild call. diff --git a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/client.py b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/client.py index fb4e90d..c04862d 100644 --- a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/client.py +++ b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/client.py @@ -964,6 +964,7 @@ def list_builds( metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListBuildsPager: r"""Lists previously requested builds. + Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. @@ -1018,6 +1019,7 @@ def sample_list_builds(): Returns: google.cloud.devtools.cloudbuild_v1.services.cloud_build.pagers.ListBuildsPager: Response including listed builds. + Iterating over this object will yield results and resolve additional pages automatically. @@ -1418,6 +1420,7 @@ def approve_build( metadata: Sequence[Tuple[str, str]] = (), ) -> operation.Operation: r"""Approves or rejects a pending build. + If approved, the returned LRO will be analogous to the LRO returned from a CreateBuild call. diff --git a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc.py b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc.py index 4fb6ebe..cce2211 100644 --- a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc.py +++ b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc.py @@ -319,6 +319,7 @@ def list_builds( r"""Return a callable for the list builds method over gRPC. Lists previously requested builds. + Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. @@ -428,6 +429,7 @@ def approve_build( r"""Return a callable for the approve build method over gRPC. Approves or rejects a pending build. + If approved, the returned LRO will be analogous to the LRO returned from a CreateBuild call. diff --git a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc_asyncio.py b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc_asyncio.py index dadb593..76cca5b 100644 --- a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc_asyncio.py +++ b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/grpc_asyncio.py @@ -328,6 +328,7 @@ def list_builds( r"""Return a callable for the list builds method over gRPC. Lists previously requested builds. + Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully. @@ -439,6 +440,7 @@ def approve_build( r"""Return a callable for the approve build method over gRPC. Approves or rejects a pending build. + If approved, the returned LRO will be analogous to the LRO returned from a CreateBuild call. diff --git a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/rest.py b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/rest.py index d61a5d5..0d2d16f 100644 --- a/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/rest.py +++ b/google/cloud/devtools/cloudbuild_v1/services/cloud_build/transports/rest.py @@ -41,8 +41,8 @@ from google.cloud.devtools.cloudbuild_v1.types import cloudbuild -from google.longrunning import operations_pb2 # type: ignore from google.protobuf import empty_pb2 # type: ignore +from google.longrunning import operations_pb2 # type: ignore from .base import CloudBuildTransport, DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO diff --git a/google/cloud/devtools/cloudbuild_v1/types/cloudbuild.py b/google/cloud/devtools/cloudbuild_v1/types/cloudbuild.py index 1b7c699..047b825 100644 --- a/google/cloud/devtools/cloudbuild_v1/types/cloudbuild.py +++ b/google/cloud/devtools/cloudbuild_v1/types/cloudbuild.py @@ -255,6 +255,7 @@ class RepoSource(proto.Message): Name of the Cloud Source Repository. branch_name (str): Regex matching branches to build. + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax @@ -262,6 +263,7 @@ class RepoSource(proto.Message): This field is a member of `oneof`_ ``revision``. tag_name (str): Regex matching tags to build. + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax @@ -607,6 +609,7 @@ class BuildStep(proto.Message): be specified in the build's ``Secret``. volumes (MutableSequence[google.cloud.devtools.cloudbuild_v1.types.Volume]): List of volumes to mount into the build step. + Each volume is created as an empty volume prior to execution of the build step. Upon completion of the build, volumes and their contents are @@ -649,6 +652,7 @@ class BuildStep(proto.Message): take precedence. script (str): A shell script to be executed in the step. + When script is provided, the user cannot specify the entrypoint or args. automap_substitutions (bool): @@ -748,12 +752,14 @@ class Volume(proto.Message): Attributes: name (str): Name of the volume to mount. + Volume names must be unique per build step and must be valid names for Docker volumes. Each named volume must be used by at least two build steps. path (str): Path at which to mount the volume. + Paths must be absolute and cannot conflict with other volume paths on the same build step or with certain reserved volume paths. @@ -1305,6 +1311,7 @@ class Artifacts(proto.Message): The images will be pushed using the builder service account's credentials. + The digests of the pushed images will be stored in the Build resource's results field. @@ -1314,6 +1321,7 @@ class Artifacts(proto.Message): A list of objects to be uploaded to Cloud Storage upon successful completion of all build steps. + Files in the workspace matching specified paths globs will be uploaded to the specified Cloud Storage location using the builder service @@ -1329,6 +1337,7 @@ class Artifacts(proto.Message): A list of Maven artifacts to be uploaded to Artifact Registry upon successful completion of all build steps. + Artifacts in the workspace matching specified paths globs will be uploaded to the specified Artifact Registry repository using the builder @@ -1340,14 +1349,17 @@ class Artifacts(proto.Message): A list of Python packages to be uploaded to Artifact Registry upon successful completion of all build steps. + The build service account credentials will be used to perform the upload. + If any objects fail to be pushed, the build is marked FAILURE. npm_packages (MutableSequence[google.cloud.devtools.cloudbuild_v1.types.Artifacts.NpmPackage]): A list of npm packages to be uploaded to Artifact Registry upon successful completion of all build steps. + Npm packages in the specified paths will be uploaded to the specified Artifact Registry repository using the builder service account's @@ -1399,6 +1411,7 @@ class MavenArtifact(proto.Message): repository (str): Artifact Registry repository, in the form "https://$REGION-maven.pkg.dev/$PROJECT/$REPOSITORY" + Artifact in the workspace specified by path will be uploaded to Artifact Registry with this location as a prefix. @@ -1451,6 +1464,7 @@ class PythonPackage(proto.Message): repository (str): Artifact Registry repository, in the form "https://$REGION-python.pkg.dev/$PROJECT/$REPOSITORY" + Files in the workspace matching any path pattern will be uploaded to Artifact Registry with this location as a prefix. @@ -1477,6 +1491,7 @@ class NpmPackage(proto.Message): repository (str): Artifact Registry repository, in the form "https://$REGION-npm.pkg.dev/$PROJECT/$REPOSITORY" + Npm package in the workspace specified by path will be zipped and uploaded to Artifact Registry with this location as a prefix. @@ -2754,6 +2769,7 @@ class PullRequestFilter(proto.Message): Attributes: branch (str): Regex of branches to match. + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax @@ -2818,6 +2834,7 @@ class PushFilter(proto.Message): Attributes: branch (str): Regexes matching branches to build. + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax @@ -2825,6 +2842,7 @@ class PushFilter(proto.Message): This field is a member of `oneof`_ ``git_ref``. tag (str): Regexes matching tags to build. + The syntax of the regular expressions accepted is the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/Syntax @@ -3066,6 +3084,7 @@ class BuildOptions(proto.Message): Option to specify whether or not to apply bash style string operations to the substitutions. + NOTE: this is always enabled for triggered builds and cannot be overridden in the build configuration file. @@ -3093,6 +3112,7 @@ class BuildOptions(proto.Message): in this build. If a variable is defined in both globally and in a build step, the variable will use the build step value. + The elements are of the form "KEY=VALUE" for the environment variable "KEY" being given the value "VALUE". @@ -3547,9 +3567,8 @@ class WorkerPool(proto.Message): Output only. A unique identifier for the ``WorkerPool``. annotations (MutableMapping[str, str]): User specified annotations. See - https://google.aip.dev/128#annotations - for more details such as format and size - limitations. + https://google.aip.dev/128#annotations for more + details such as format and size limitations. create_time (google.protobuf.timestamp_pb2.Timestamp): Output only. Time at which the request to create the ``WorkerPool`` was received. diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/async_client.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/async_client.py index a179a94..a8cf789 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/async_client.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/async_client.py @@ -50,7 +50,7 @@ from google.cloud.location import locations_pb2 # type: ignore from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 +from google.longrunning import operations_pb2 # type: ignore from google.protobuf import empty_pb2 # type: ignore from google.protobuf import field_mask_pb2 # type: ignore from google.protobuf import timestamp_pb2 # type: ignore diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/client.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/client.py index e3c0a66..7fbf2bf 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/client.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/client.py @@ -54,7 +54,7 @@ from google.cloud.location import locations_pb2 # type: ignore from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 +from google.longrunning import operations_pb2 # type: ignore from google.protobuf import empty_pb2 # type: ignore from google.protobuf import field_mask_pb2 # type: ignore from google.protobuf import timestamp_pb2 # type: ignore diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/base.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/base.py index d7390a9..eedf13e 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/base.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/base.py @@ -31,7 +31,6 @@ from google.cloud.location import locations_pb2 # type: ignore from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 from google.longrunning import operations_pb2 # type: ignore DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo( diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc.py index 4132d2f..88bfc06 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc.py @@ -29,7 +29,6 @@ from google.cloud.location import locations_pb2 # type: ignore from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 from google.longrunning import operations_pb2 # type: ignore from .base import RepositoryManagerTransport, DEFAULT_CLIENT_INFO diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc_asyncio.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc_asyncio.py index fa8bb5b..cd9c115 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc_asyncio.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/grpc_asyncio.py @@ -29,7 +29,6 @@ from google.cloud.location import locations_pb2 # type: ignore from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 from google.longrunning import operations_pb2 # type: ignore from .base import RepositoryManagerTransport, DEFAULT_CLIENT_INFO from .grpc import RepositoryManagerGrpcTransport diff --git a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/rest.py b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/rest.py index d174619..b78c0c8 100644 --- a/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/rest.py +++ b/google/cloud/devtools/cloudbuild_v2/services/repository_manager/transports/rest.py @@ -31,7 +31,6 @@ from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore from google.cloud.location import locations_pb2 # type: ignore -from google.longrunning import operations_pb2 from requests import __version__ as requests_version import dataclasses import re diff --git a/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v1.json b/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v1.json index 0857ed9..e379efa 100644 --- a/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v1.json +++ b/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-build", - "version": "3.20.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v2.json b/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v2.json index 7ae3efe..818d3fc 100644 --- a/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v2.json +++ b/samples/generated_samples/snippet_metadata_google.devtools.cloudbuild.v2.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-build", - "version": "3.20.0" + "version": "0.1.0" }, "snippets": [ { diff --git a/tests/unit/gapic/cloudbuild_v1/test_cloud_build.py b/tests/unit/gapic/cloudbuild_v1/test_cloud_build.py index 2570d63..df79bd5 100644 --- a/tests/unit/gapic/cloudbuild_v1/test_cloud_build.py +++ b/tests/unit/gapic/cloudbuild_v1/test_cloud_build.py @@ -56,7 +56,7 @@ from google.cloud.devtools.cloudbuild_v1.services.cloud_build import pagers from google.cloud.devtools.cloudbuild_v1.services.cloud_build import transports from google.cloud.devtools.cloudbuild_v1.types import cloudbuild -from google.longrunning import operations_pb2 +from google.longrunning import operations_pb2 # type: ignore from google.oauth2 import service_account from google.protobuf import any_pb2 # type: ignore from google.protobuf import duration_pb2 # type: ignore diff --git a/tests/unit/gapic/cloudbuild_v2/test_repository_manager.py b/tests/unit/gapic/cloudbuild_v2/test_repository_manager.py index 6c49bc2..cbb3d46 100644 --- a/tests/unit/gapic/cloudbuild_v2/test_repository_manager.py +++ b/tests/unit/gapic/cloudbuild_v2/test_repository_manager.py @@ -62,7 +62,7 @@ from google.iam.v1 import iam_policy_pb2 # type: ignore from google.iam.v1 import options_pb2 # type: ignore from google.iam.v1 import policy_pb2 # type: ignore -from google.longrunning import operations_pb2 +from google.longrunning import operations_pb2 # type: ignore from google.oauth2 import service_account from google.protobuf import empty_pb2 # type: ignore from google.protobuf import field_mask_pb2 # type: ignore