google-cloud-bigtable 2.38.0__tar.gz → 2.40.0__tar.gz

{google_cloud_bigtable-2.38.0 → google_cloud_bigtable-2.40.0}/MANIFEST.in

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_bigtable-2.38.0/google_cloud_bigtable.egg-info → google_cloud_bigtable-2.40.0}/PKG-INFO

@@ -1,18 +1,17 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigtable
-Version: 2.38.0
+Version: 2.40.0
 Summary: Google Cloud Bigtable API client library
 Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-bigtable
 Author: Google LLC
 Author-email: googleapis-packages@google.com
-License: Apache 2.0
+License: Apache-2.0
 Platform: Posix; MacOS X; Windows
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -20,18 +19,17 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]<3.0.0,>=2.11.0
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.24.2
 Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
-Requires-Dist: grpcio<2.0.0,>=1.33.2
+Requires-Dist: grpcio<2.0.0,>=1.59.0
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
-Requires-Dist: proto-plus<2.0.0,>=1.22.3
-Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
-Requires-Dist: protobuf<8.0.0,>=4.25.8
-Requires-Dist: google-cloud-core<3.0.0,>=1.4.4
-Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.12.4
-Requires-Dist: google-crc32c<2.0.0dev,>=1.5.0
+Requires-Dist: proto-plus<2.0.0,>=1.26.1
+Requires-Dist: protobuf<8.0.0,>=6.33.5
+Requires-Dist: google-cloud-core<3.0.0,>=2.0.0
+Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.14.2
+Requires-Dist: google-crc32c<2.0.0dev,>=1.6.0
 Provides-Extra: libcst
 Requires-Dist: libcst>=0.2.5; extra == "libcst"
 Dynamic: author
@@ -47,14 +45,13 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-Python Client for Google Cloud Bigtable
-=======================================
+Python Client for Cloud Bigtable
+================================
 
 |stable| |pypi| |versions|
 
-`Google Cloud Bigtable`_: is Google's NoSQL Big Data database service. It's the
-same database that powers many core Google services, including Search,
-Analytics, Maps, and Gmail.
+`Cloud Bigtable`_: API for reading and writing the contents of Bigtable tables associated with
+a Google Cloud project.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -65,7 +62,7 @@ Analytics, Maps, and Gmail.
    :target: https://pypi.org/project/google-cloud-bigtable/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-bigtable.svg
    :target: https://pypi.org/project/google-cloud-bigtable/
-.. _Google Cloud Bigtable: https://cloud.google.com/bigtable
+.. _Cloud Bigtable: https://cloud.google.com/bigtable/docs
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/bigtable/latest/summary_overview
 .. _Product Documentation:  https://cloud.google.com/bigtable/docs
 
@@ -100,12 +97,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Google Cloud Bigtable.`_
+3. `Enable the Cloud Bigtable.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Google Cloud Bigtable.:  https://cloud.google.com/bigtable
+.. _Enable the Cloud Bigtable.:  https://cloud.google.com/bigtable/docs
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -136,14 +133,15 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.9, including 3.14
+Python >= 3.10, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.8
+Python <= 3.9
+
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -172,14 +170,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Google Cloud Bigtable
+-  Read the `Client Library Documentation`_ for Cloud Bigtable
    to see other available methods on the client.
--  Read the `Google Cloud Bigtable Product documentation`_ to learn
+-  Read the `Cloud Bigtable Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Google Cloud Bigtable Product documentation:  https://cloud.google.com/bigtable
+.. _Cloud Bigtable Product documentation:  https://cloud.google.com/bigtable/docs
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_cloud_bigtable-2.38.0 → google_cloud_bigtable-2.40.0}/README.rst

@@ -1,11 +1,10 @@
-Python Client for Google Cloud Bigtable
-=======================================
+Python Client for Cloud Bigtable
+================================
 
 |stable| |pypi| |versions|
 
-`Google Cloud Bigtable`_: is Google's NoSQL Big Data database service. It's the
-same database that powers many core Google services, including Search,
-Analytics, Maps, and Gmail.
+`Cloud Bigtable`_: API for reading and writing the contents of Bigtable tables associated with
+a Google Cloud project.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -16,7 +15,7 @@ Analytics, Maps, and Gmail.
    :target: https://pypi.org/project/google-cloud-bigtable/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-bigtable.svg
    :target: https://pypi.org/project/google-cloud-bigtable/
-.. _Google Cloud Bigtable: https://cloud.google.com/bigtable
+.. _Cloud Bigtable: https://cloud.google.com/bigtable/docs
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/bigtable/latest/summary_overview
 .. _Product Documentation:  https://cloud.google.com/bigtable/docs
 
@@ -51,12 +50,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Google Cloud Bigtable.`_
+3. `Enable the Cloud Bigtable.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Google Cloud Bigtable.:  https://cloud.google.com/bigtable
+.. _Enable the Cloud Bigtable.:  https://cloud.google.com/bigtable/docs
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -87,14 +86,15 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.9, including 3.14
+Python >= 3.10, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.8
+Python <= 3.9
+
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -123,14 +123,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Google Cloud Bigtable
+-  Read the `Client Library Documentation`_ for Cloud Bigtable
    to see other available methods on the client.
--  Read the `Google Cloud Bigtable Product documentation`_ to learn
+-  Read the `Cloud Bigtable Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Google Cloud Bigtable Product documentation:  https://cloud.google.com/bigtable
+.. _Cloud Bigtable Product documentation:  https://cloud.google.com/bigtable/docs
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_cloud_bigtable-2.38.0 → google_cloud_bigtable-2.40.0}/google/cloud/bigtable/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_bigtable-2.38.0 → google_cloud_bigtable-2.40.0}/google/cloud/bigtable/data/_async/_mutate_rows.py

@@ -22,10 +22,8 @@ from google.api_core import retry as retries
 import google.cloud.bigtable.data.exceptions as bt_exceptions
 import google.cloud.bigtable_v2.types.bigtable as types_pb
 from google.cloud.bigtable.data._cross_sync import CrossSync
-from google.cloud.bigtable.data._helpers import (
-    _attempt_timeout_generator,
-    _retry_exception_factory,
-)
+from google.cloud.bigtable.data._helpers import _attempt_timeout_generator
+from google.cloud.bigtable.data._metrics import tracked_retry
 
 # mutate_rows requests are limited to this number of mutations
 from google.cloud.bigtable.data.mutations import (
@@ -34,6 +32,7 @@ from google.cloud.bigtable.data.mutations import (
 )
 
 if TYPE_CHECKING:
+    from google.cloud.bigtable.data._metrics import ActiveOperationMetric
     from google.cloud.bigtable.data.mutations import RowMutationEntry
 
     if CrossSync.is_async:
@@ -72,6 +71,8 @@ class _MutateRowsOperationAsync:
         operation_timeout: the timeout to use for the entire operation, in seconds.
         attempt_timeout: the timeout to use for each mutate_rows attempt, in seconds.
             If not specified, the request will run until operation_timeout is reached.
+        metric: the metric object representing the active operation
+        retryable_exceptions: a list of exceptions that should be retried
     """
 
     @CrossSync.convert
@@ -82,6 +83,7 @@ class _MutateRowsOperationAsync:
         mutation_entries: list["RowMutationEntry"],
         operation_timeout: float,
         attempt_timeout: float | None,
+        metric: ActiveOperationMetric,
         retryable_exceptions: Sequence[type[Exception]] = (),
     ):
         # check that mutations are within limits
@@ -101,13 +103,12 @@ class _MutateRowsOperationAsync:
             # Entry level errors
             bt_exceptions._MutateRowsIncomplete,
         )
-        sleep_generator = retries.exponential_sleep_generator(0.01, 2, 60)
-        self._operation = lambda: CrossSync.retry_target(
-            self._run_attempt,
-            self.is_retryable,
-            sleep_generator,
-            operation_timeout,
-            exception_factory=_retry_exception_factory,
+        self._operation = lambda: tracked_retry(
+            retry_fn=CrossSync.retry_target,
+            operation=metric,
+            target=self._run_attempt,
+            predicate=self.is_retryable,
+            timeout=operation_timeout,
         )
         # initialize state
         self.timeout_generator = _attempt_timeout_generator(
@@ -116,6 +117,8 @@ class _MutateRowsOperationAsync:
         self.mutations = [_EntryWithProto(m, m._to_pb()) for m in mutation_entries]
         self.remaining_indices = list(range(len(self.mutations)))
         self.errors: dict[int, list[Exception]] = {}
+        # set up metrics
+        self._operation_metric = metric
 
     @CrossSync.convert
     async def start(self):
@@ -125,34 +128,35 @@ class _MutateRowsOperationAsync:
         Raises:
             MutationsExceptionGroup: if any mutations failed
         """
-        try:
-            # trigger mutate_rows
-            await self._operation()
-        except Exception as exc:
-            # exceptions raised by retryable are added to the list of exceptions for all unfinalized mutations
-            incomplete_indices = self.remaining_indices.copy()
-            for idx in incomplete_indices:
-                self._handle_entry_error(idx, exc)
-        finally:
-            # raise exception detailing incomplete mutations
-            all_errors: list[Exception] = []
-            for idx, exc_list in self.errors.items():
-                if len(exc_list) == 0:
-                    raise core_exceptions.ClientError(
-                        f"Mutation {idx} failed with no associated errors"
+        with self._operation_metric:
+            try:
+                # trigger mutate_rows
+                await self._operation()
+            except Exception as exc:
+                # exceptions raised by retryable are added to the list of exceptions for all unfinalized mutations
+                incomplete_indices = self.remaining_indices.copy()
+                for idx in incomplete_indices:
+                    self._handle_entry_error(idx, exc)
+            finally:
+                # raise exception detailing incomplete mutations
+                all_errors: list[Exception] = []
+                for idx, exc_list in self.errors.items():
+                    if len(exc_list) == 0:
+                        raise core_exceptions.ClientError(
+                            f"Mutation {idx} failed with no associated errors"
+                        )
+                    elif len(exc_list) == 1:
+                        cause_exc = exc_list[0]
+                    else:
+                        cause_exc = bt_exceptions.RetryExceptionGroup(exc_list)
+                    entry = self.mutations[idx].entry
+                    all_errors.append(
+                        bt_exceptions.FailedMutationEntryError(idx, entry, cause_exc)
+                    )
+                if all_errors:
+                    raise bt_exceptions.MutationsExceptionGroup(
+                        all_errors, len(self.mutations)
                     )
-                elif len(exc_list) == 1:
-                    cause_exc = exc_list[0]
-                else:
-                    cause_exc = bt_exceptions.RetryExceptionGroup(exc_list)
-                entry = self.mutations[idx].entry
-                all_errors.append(
-                    bt_exceptions.FailedMutationEntryError(idx, entry, cause_exc)
-                )
-            if all_errors:
-                raise bt_exceptions.MutationsExceptionGroup(
-                    all_errors, len(self.mutations)
-                )
 
     @CrossSync.convert
     async def _run_attempt(self):
@@ -164,6 +168,8 @@ class _MutateRowsOperationAsync:
                 retry after the attempt is complete
             GoogleAPICallError: if the gapic rpc fails
         """
+        # register attempt start
+        self._operation_metric.start_attempt()
         request_entries = [self.mutations[idx].proto for idx in self.remaining_indices]
         # track mutations in this request that have not been finalized yet
         active_request_indices = {