diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 0b9e26a6..dac16de6 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "3.10.0" + ".": "3.10.1" } diff --git a/CHANGELOG.md b/CHANGELOG.md index f4fc0538..c96299e0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,18 @@ [1]: https://pypi.org/project/google-cloud-bigquery-datatransfer/#history +## [3.10.1](https://github.com/googleapis/python-bigquery-datatransfer/compare/v3.10.0...v3.10.1) (2023-01-20) + + +### Bug Fixes + +* Add context manager return types ([a10a470](https://github.com/googleapis/python-bigquery-datatransfer/commit/a10a470dc53947e35202c0b296fe74e519c0abe2)) + + +### Documentation + +* Add documentation for enums ([a10a470](https://github.com/googleapis/python-bigquery-datatransfer/commit/a10a470dc53947e35202c0b296fe74e519c0abe2)) + ## [3.10.0](https://github.com/googleapis/python-bigquery-datatransfer/compare/v3.9.0...v3.10.0) (2023-01-10) diff --git a/google/cloud/bigquery_datatransfer/gapic_version.py b/google/cloud/bigquery_datatransfer/gapic_version.py index b2ead68d..9d71162c 100644 --- a/google/cloud/bigquery_datatransfer/gapic_version.py +++ b/google/cloud/bigquery_datatransfer/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "3.10.0" # {x-release-please-version} +__version__ = "3.10.1" # {x-release-please-version} diff --git a/google/cloud/bigquery_datatransfer_v1/gapic_version.py b/google/cloud/bigquery_datatransfer_v1/gapic_version.py index b2ead68d..9d71162c 100644 --- a/google/cloud/bigquery_datatransfer_v1/gapic_version.py +++ b/google/cloud/bigquery_datatransfer_v1/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "3.10.0" # {x-release-please-version} +__version__ = "3.10.1" # {x-release-please-version} diff --git a/google/cloud/bigquery_datatransfer_v1/services/data_transfer_service/client.py b/google/cloud/bigquery_datatransfer_v1/services/data_transfer_service/client.py index f1c91d21..fb865c8f 100644 --- a/google/cloud/bigquery_datatransfer_v1/services/data_transfer_service/client.py +++ b/google/cloud/bigquery_datatransfer_v1/services/data_transfer_service/client.py @@ -2131,7 +2131,7 @@ def sample_enroll_data_sources(): metadata=metadata, ) - def __enter__(self): + def __enter__(self) -> "DataTransferServiceClient": return self def __exit__(self, type, value, traceback): diff --git a/google/cloud/bigquery_datatransfer_v1/types/datatransfer.py b/google/cloud/bigquery_datatransfer_v1/types/datatransfer.py index 218295ca..4d3a5150 100644 --- a/google/cloud/bigquery_datatransfer_v1/types/datatransfer.py +++ b/google/cloud/bigquery_datatransfer_v1/types/datatransfer.py @@ -102,7 +102,25 @@ class DataSourceParameter(proto.Message): """ class Type(proto.Enum): - r"""Parameter type.""" + r"""Parameter type. + + Values: + TYPE_UNSPECIFIED (0): + Type unspecified. + STRING (1): + String parameter. + INTEGER (2): + Integer parameter (64-bits). + Will be serialized to json as string. + DOUBLE (3): + Double precision floating point parameter. + BOOLEAN (4): + Boolean parameter. + RECORD (5): + Deprecated. This field has no effect. + PLUS_PAGE (6): + Page ID for a Google+ Page. + """ TYPE_UNSPECIFIED = 0 STRING = 1 INTEGER = 2 @@ -246,14 +264,44 @@ class DataSource(proto.Message): """ class AuthorizationType(proto.Enum): - r"""The type of authorization needed for this data source.""" + r"""The type of authorization needed for this data source. + + Values: + AUTHORIZATION_TYPE_UNSPECIFIED (0): + Type unspecified. + AUTHORIZATION_CODE (1): + Use OAuth 2 authorization codes that can be + exchanged for a refresh token on the backend. + GOOGLE_PLUS_AUTHORIZATION_CODE (2): + Return an authorization code for a given + Google+ page that can then be exchanged for a + refresh token on the backend. + FIRST_PARTY_OAUTH (3): + Use First Party OAuth. + """ AUTHORIZATION_TYPE_UNSPECIFIED = 0 AUTHORIZATION_CODE = 1 GOOGLE_PLUS_AUTHORIZATION_CODE = 2 FIRST_PARTY_OAUTH = 3 class DataRefreshType(proto.Enum): - r"""Represents how the data source supports data auto refresh.""" + r"""Represents how the data source supports data auto refresh. + + Values: + DATA_REFRESH_TYPE_UNSPECIFIED (0): + The data source won't support data auto + refresh, which is default value. + SLIDING_WINDOW (1): + The data source supports data auto refresh, + and runs will be scheduled for the past few + days. Does not allow custom values to be set for + each transfer config. + CUSTOM_SLIDING_WINDOW (2): + The data source supports data auto refresh, + and runs will be scheduled for the past few + days. Allows custom values to be set for each + transfer config. + """ DATA_REFRESH_TYPE_UNSPECIFIED = 0 SLIDING_WINDOW = 1 CUSTOM_SLIDING_WINDOW = 2 @@ -775,7 +823,14 @@ class ListTransferRunsRequest(proto.Message): """ class RunAttempt(proto.Enum): - r"""Represents which runs should be pulled.""" + r"""Represents which runs should be pulled. + + Values: + RUN_ATTEMPT_UNSPECIFIED (0): + All runs should be returned. + LATEST (1): + Only latest run per day should be returned. + """ RUN_ATTEMPT_UNSPECIFIED = 0 LATEST = 1 diff --git a/google/cloud/bigquery_datatransfer_v1/types/transfer.py b/google/cloud/bigquery_datatransfer_v1/types/transfer.py index 8a75dd99..b99c1423 100644 --- a/google/cloud/bigquery_datatransfer_v1/types/transfer.py +++ b/google/cloud/bigquery_datatransfer_v1/types/transfer.py @@ -36,7 +36,18 @@ class TransferType(proto.Enum): - r"""DEPRECATED. Represents data transfer type.""" + r"""DEPRECATED. Represents data transfer type. + + Values: + TRANSFER_TYPE_UNSPECIFIED (0): + Invalid or Unknown transfer type placeholder. + BATCH (1): + Batch data transfer. + STREAMING (2): + Streaming data transfer. Streaming data + source currently doesn't support multiple + transfer configs per project. + """ _pb_options = {"deprecated": True} TRANSFER_TYPE_UNSPECIFIED = 0 BATCH = 1 @@ -44,7 +55,23 @@ class TransferType(proto.Enum): class TransferState(proto.Enum): - r"""Represents data transfer run state.""" + r"""Represents data transfer run state. + + Values: + TRANSFER_STATE_UNSPECIFIED (0): + State placeholder (0). + PENDING (2): + Data transfer is scheduled and is waiting to + be picked up by data transfer backend (2). + RUNNING (3): + Data transfer is in progress (3). + SUCCEEDED (4): + Data transfer completed successfully (4). + FAILED (5): + Data transfer failed (5). + CANCELLED (6): + Data transfer is cancelled (6). + """ TRANSFER_STATE_UNSPECIFIED = 0 PENDING = 2 RUNNING = 3 @@ -466,7 +493,18 @@ class TransferMessage(proto.Message): """ class MessageSeverity(proto.Enum): - r"""Represents data transfer user facing message severity.""" + r"""Represents data transfer user facing message severity. + + Values: + MESSAGE_SEVERITY_UNSPECIFIED (0): + No severity specified. + INFO (1): + Informational message. + WARNING (2): + Warning message. + ERROR (3): + Error message. + """ MESSAGE_SEVERITY_UNSPECIFIED = 0 INFO = 1 WARNING = 2 diff --git a/samples/generated_samples/snippet_metadata_google.cloud.bigquery.datatransfer.v1.json b/samples/generated_samples/snippet_metadata_google.cloud.bigquery.datatransfer.v1.json index d761b151..22d7ce94 100644 --- a/samples/generated_samples/snippet_metadata_google.cloud.bigquery.datatransfer.v1.json +++ b/samples/generated_samples/snippet_metadata_google.cloud.bigquery.datatransfer.v1.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-bigquery-datatransfer", - "version": "3.10.0" + "version": "3.10.1" }, "snippets": [ { diff --git a/samples/snippets/requirements-test.txt b/samples/snippets/requirements-test.txt index aa7d2984..472e3a68 100644 --- a/samples/snippets/requirements-test.txt +++ b/samples/snippets/requirements-test.txt @@ -1,4 +1,4 @@ -google-cloud-bigquery==3.4.1 +google-cloud-bigquery==3.4.2 google-cloud-pubsub==2.13.12 -pytest==7.2.0 +pytest==7.2.1 mock==5.0.1 diff --git a/samples/snippets/requirements.txt b/samples/snippets/requirements.txt index 510a5c5f..d3fca50f 100644 --- a/samples/snippets/requirements.txt +++ b/samples/snippets/requirements.txt @@ -1 +1 @@ -google-cloud-bigquery-datatransfer==3.9.0 +google-cloud-bigquery-datatransfer==3.10.0