google-cloud-bigquery 3.42.2__tar.gz → 3.43.0__tar.gz

{google_cloud_bigquery-3.42.2/google_cloud_bigquery.egg-info → google_cloud_bigquery-3.43.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.42.2
+Version: 3.43.0
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0
@@ -19,7 +19,7 @@ Classifier: Topic :: Internet
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]<3.0.0,>=2.25.0
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.28.0
 Requires-Dist: google-auth[pyopenssl]<3.0.0,>=2.14.1
 Requires-Dist: google-cloud-core<3.0.0,>=2.4.1
 Requires-Dist: google-resumable-media<3.0.0,>=2.0.0
@@ -27,16 +27,14 @@ Requires-Dist: packaging>=24.2.0
 Requires-Dist: python-dateutil<3.0.0,>=2.8.2
 Requires-Dist: requests<3.0.0,>=2.21.0
 Provides-Extra: bqstorage
-Requires-Dist: google-cloud-bigquery-storage<3.0.0,>=2.18.0; extra == "bqstorage"
-Requires-Dist: grpcio<2.0.0,>=1.47.0; extra == "bqstorage"
-Requires-Dist: grpcio<2.0.0,>=1.49.1; python_version >= "3.11" and extra == "bqstorage"
+Requires-Dist: google-cloud-bigquery-storage<3.0.0,>=2.29.0; extra == "bqstorage"
+Requires-Dist: grpcio<2.0.0,>=1.59.0; extra == "bqstorage"
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14" and extra == "bqstorage"
 Requires-Dist: pyarrow>=4.0.0; extra == "bqstorage"
 Provides-Extra: pandas
 Requires-Dist: pandas>=1.3.0; extra == "pandas"
 Requires-Dist: pandas-gbq>=0.26.1; extra == "pandas"
-Requires-Dist: grpcio<2.0.0,>=1.47.0; extra == "pandas"
-Requires-Dist: grpcio<2.0.0,>=1.49.1; python_version >= "3.11" and extra == "pandas"
+Requires-Dist: grpcio<2.0.0,>=1.59.0; extra == "pandas"
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14" and extra == "pandas"
 Requires-Dist: pyarrow>=3.0.0; extra == "pandas"
 Requires-Dist: db-dtypes<2.0.0,>=1.0.4; extra == "pandas"
@@ -58,8 +56,8 @@ Requires-Dist: opentelemetry-api>=1.1.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-sdk>=1.1.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-instrumentation>=0.20b0; extra == "opentelemetry"
 Provides-Extra: bigquery-v2
-Requires-Dist: proto-plus<2.0.0,>=1.22.3; extra == "bigquery-v2"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2; extra == "bigquery-v2"
+Requires-Dist: proto-plus<2.0.0,>=1.26.1; extra == "bigquery-v2"
+Requires-Dist: protobuf<8.0.0,>=6.33.5; extra == "bigquery-v2"
 Provides-Extra: all
 Requires-Dist: google-cloud-bigquery[bigquery_v2,bqstorage,geopandas,ipython,ipywidgets,matplotlib,opentelemetry,pandas,tqdm]; extra == "all"
 Dynamic: license-file
@@ -87,6 +85,26 @@ processing power of Google's infrastructure.
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/bigquery/latest/summary_overview
 .. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/
 
+
+Related Libraries
+-----------------
+
+For higher-level data analysis and DataFrame operations, consider using one of the following connector libraries:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Library
+     - Description
+     - Documentation
+   * - `BigQuery DataFrames (bigframes) <https://dataframes.bigquery.dev/>`_
+     - Flexible pandas-like and scikit-learn-like API powered by BigQuery engine for large-scale data analysis and ML.
+     - `BigFrames Docs <https://dataframes.bigquery.dev/>`_
+   * - `pandas-gbq <https://pandas-gbq.readthedocs.io/>`_
+     - Convenient integration allowing pandas DataFrames to load from and write to BigQuery.
+     - `pandas-gbq Docs <https://pandas-gbq.readthedocs.io/>`_
+
+
 Quick Start
 -----------
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/README.rst

@@ -21,6 +21,26 @@ processing power of Google's infrastructure.
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/bigquery/latest/summary_overview
 .. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/
 
+
+Related Libraries
+-----------------
+
+For higher-level data analysis and DataFrame operations, consider using one of the following connector libraries:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Library
+     - Description
+     - Documentation
+   * - `BigQuery DataFrames (bigframes) <https://dataframes.bigquery.dev/>`_
+     - Flexible pandas-like and scikit-learn-like API powered by BigQuery engine for large-scale data analysis and ML.
+     - `BigFrames Docs <https://dataframes.bigquery.dev/>`_
+   * - `pandas-gbq <https://pandas-gbq.readthedocs.io/>`_
+     - Convenient integration allowing pandas DataFrames to load from and write to BigQuery.
+     - `pandas-gbq Docs <https://pandas-gbq.readthedocs.io/>`_
+
+
 Quick Start
 -----------
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/_helpers.py

@@ -295,7 +295,7 @@ class CellDataParser:
             return _date_from_iso8601_date(value)
 
     def time_to_py(self, value, field):
-        """Coerce 'value' to a datetime date, if set or not nullable"""
+        """Coerce 'value' to a datetime time, if set or not nullable"""
         if _not_null(value, field):
             if len(value) == 8:  # HH:MM:SS
                 fmt = _TIMEONLY_WO_MICROS

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/_versions_helpers.py

@@ -16,10 +16,8 @@
 from typing import Any
 
 import packaging.version
-
 from google.cloud.bigquery import exceptions
 
-
 _MIN_PYARROW_VERSION = packaging.version.Version("3.0.0")
 _MIN_BQ_STORAGE_VERSION = packaging.version.Version("2.0.0")
 _BQ_STORAGE_OPTIONAL_READ_SESSION_VERSION = packaging.version.Version("2.6.0")
@@ -27,6 +25,7 @@ _MIN_PANDAS_VERSION = packaging.version.Version("1.1.0")
 
 _MIN_PANDAS_VERSION_RANGE = packaging.version.Version("1.5.0")
 _MIN_PYARROW_VERSION_RANGE = packaging.version.Version("10.0.1")
+_MIN_PANDAS_GBQ_DELEGATION_VERSION = packaging.version.Version("1.0.0")
 
 
 class PyarrowVersions:
@@ -247,3 +246,52 @@ SUPPORTS_RANGE_PYARROW = (
     and PYARROW_VERSIONS.try_import() is not None
     and PYARROW_VERSIONS.installed_version >= _MIN_PYARROW_VERSION_RANGE
 )
+
+
+class PandasGBQVersions:
+    """Version and delegation comparisons for pandas-gbq package."""
+
+    def __init__(self):
+        self._installed_version = None
+        self._delegation_api_version = None
+
+    @property
+    def installed_version(self) -> packaging.version.Version:
+        """Return the parsed version of pandas-gbq."""
+        if self._installed_version is not None:
+            return self._installed_version
+
+        try:
+            import pandas_gbq  # type: ignore
+
+            self._installed_version = packaging.version.parse(
+                getattr(pandas_gbq, "__version__", "0.0.0")
+            )
+        except Exception:
+            self._installed_version = packaging.version.parse("0.0.0")
+        return self._installed_version
+
+    @property
+    def delegation_api_version(self) -> packaging.version.Version:
+        """Return the delegation API version of pandas-gbq if installed, otherwise 0.0.0."""
+        if self._delegation_api_version is not None:
+            return self._delegation_api_version
+
+        try:
+            import pandas_gbq  # type: ignore
+
+            raw_version = getattr(
+                pandas_gbq, "_internal_delegation_api_version", "0.0.0"
+            )
+            self._delegation_api_version = packaging.version.parse(str(raw_version))
+        except Exception:
+            self._delegation_api_version = packaging.version.parse("0.0.0")
+        return self._delegation_api_version
+
+    @property
+    def is_delegation_supported(self) -> bool:
+        """True if the installed pandas-gbq version supports query delegation API."""
+        return self.delegation_api_version >= _MIN_PANDAS_GBQ_DELEGATION_VERSION
+
+
+PANDAS_GBQ_VERSIONS = PandasGBQVersions()

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/dbapi/connection.py

@@ -17,8 +17,7 @@
 import weakref
 
 from google.cloud import bigquery
-from google.cloud.bigquery.dbapi import cursor
-from google.cloud.bigquery.dbapi import _helpers
+from google.cloud.bigquery.dbapi import _helpers, cursor
 
 
 @_helpers.raise_on_closed("Operating on a closed connection.")
@@ -79,16 +78,26 @@ class Connection(object):
         """
         self._closed = True
 
-        if self._owns_client:
+        for cursor_ in list(self._cursors_created):
+            if not cursor_._closed:
+                cursor_.close()
+
+        if self._owns_client and self._client is not None:
             self._client.close()
 
-        if self._owns_bqstorage_client:
+        if self._owns_bqstorage_client and self._bqstorage_client is not None:
             # There is no close() on the BQ Storage client itself.
-            self._bqstorage_client._transport.close()
-
-        for cursor_ in self._cursors_created:
-            if not cursor_._closed:
-                cursor_.close()
+            transport = self._bqstorage_client.transport
+            transport.close()
+
+            # Ensure the underlying gRPC channel is closed explicitly.
+            # This is important because the transport might be wrapped by interceptors
+            # which may not propagate the close call to the underlying channel immediately,
+            # or Garbage Collection delays might keep sockets open longer than expected,
+            # leading to intermittent socket leaks in tests.
+            channel = getattr(transport, "_grpc_channel", None)
+            if channel is not None:
+                channel.close()
 
     def commit(self):
         """No-op, but for consistency raise an error if connection is closed."""

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/dbapi/cursor.py

@@ -17,8 +17,8 @@
 from __future__ import annotations
 
 import collections
-from collections import abc as collections_abc
 import re
+from collections import abc as collections_abc
 from typing import Optional
 
 try:
@@ -29,11 +29,9 @@ else:
     # Having BQ Storage available implies that pyarrow >=1.0.0 is available, too.
     _ARROW_COMPRESSION_SUPPORT = True
 
-from google.cloud.bigquery import job
-from google.cloud.bigquery.dbapi import _helpers
-from google.cloud.bigquery.dbapi import exceptions
 import google.cloud.exceptions  # type: ignore
-
+from google.cloud.bigquery import job
+from google.cloud.bigquery.dbapi import _helpers, exceptions
 
 # Per PEP 249: A 7-item sequence containing information describing one result
 # column. The first two items (name and type_code) are mandatory, the other
@@ -105,6 +103,15 @@ class Cursor(object):
         """Mark the cursor as closed, preventing its further use."""
         self._closed = True
 
+        # Explicitly release references to query data and rows.
+        # This is important because these objects may hold references to underlying
+        # transports or gRPC streams (especially when using BQ Storage API).
+        # Clearing them ensures that resources can be garbage collected deterministically,
+        # preventing intermittent socket leaks (e.g., ESTABLISHED connections) in tests
+        # and long-running applications.
+        self._query_data = None
+        self._query_rows = None
+
     def _set_description(self, schema):
         """Set description from schema.
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/query.py

@@ -1020,7 +1020,6 @@ class RangeQueryParameter(_AbstractQueryParameter):
     ):
         self.name = name
         self.range_element_type = self._parse_range_element_type(range_element_type)
-        print(self.range_element_type.type_._type)
         self.start = start
         self.end = end
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google/cloud/bigquery/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "3.42.2"
+__version__ = "3.43.0"

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0/google_cloud_bigquery.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.42.2
+Version: 3.43.0
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0
@@ -19,7 +19,7 @@ Classifier: Topic :: Internet
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]<3.0.0,>=2.25.0
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.28.0
 Requires-Dist: google-auth[pyopenssl]<3.0.0,>=2.14.1
 Requires-Dist: google-cloud-core<3.0.0,>=2.4.1
 Requires-Dist: google-resumable-media<3.0.0,>=2.0.0
@@ -27,16 +27,14 @@ Requires-Dist: packaging>=24.2.0
 Requires-Dist: python-dateutil<3.0.0,>=2.8.2
 Requires-Dist: requests<3.0.0,>=2.21.0
 Provides-Extra: bqstorage
-Requires-Dist: google-cloud-bigquery-storage<3.0.0,>=2.18.0; extra == "bqstorage"
-Requires-Dist: grpcio<2.0.0,>=1.47.0; extra == "bqstorage"
-Requires-Dist: grpcio<2.0.0,>=1.49.1; python_version >= "3.11" and extra == "bqstorage"
+Requires-Dist: google-cloud-bigquery-storage<3.0.0,>=2.29.0; extra == "bqstorage"
+Requires-Dist: grpcio<2.0.0,>=1.59.0; extra == "bqstorage"
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14" and extra == "bqstorage"
 Requires-Dist: pyarrow>=4.0.0; extra == "bqstorage"
 Provides-Extra: pandas
 Requires-Dist: pandas>=1.3.0; extra == "pandas"
 Requires-Dist: pandas-gbq>=0.26.1; extra == "pandas"
-Requires-Dist: grpcio<2.0.0,>=1.47.0; extra == "pandas"
-Requires-Dist: grpcio<2.0.0,>=1.49.1; python_version >= "3.11" and extra == "pandas"
+Requires-Dist: grpcio<2.0.0,>=1.59.0; extra == "pandas"
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14" and extra == "pandas"
 Requires-Dist: pyarrow>=3.0.0; extra == "pandas"
 Requires-Dist: db-dtypes<2.0.0,>=1.0.4; extra == "pandas"
@@ -58,8 +56,8 @@ Requires-Dist: opentelemetry-api>=1.1.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-sdk>=1.1.0; extra == "opentelemetry"
 Requires-Dist: opentelemetry-instrumentation>=0.20b0; extra == "opentelemetry"
 Provides-Extra: bigquery-v2
-Requires-Dist: proto-plus<2.0.0,>=1.22.3; extra == "bigquery-v2"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2; extra == "bigquery-v2"
+Requires-Dist: proto-plus<2.0.0,>=1.26.1; extra == "bigquery-v2"
+Requires-Dist: protobuf<8.0.0,>=6.33.5; extra == "bigquery-v2"
 Provides-Extra: all
 Requires-Dist: google-cloud-bigquery[bigquery_v2,bqstorage,geopandas,ipython,ipywidgets,matplotlib,opentelemetry,pandas,tqdm]; extra == "all"
 Dynamic: license-file
@@ -87,6 +85,26 @@ processing power of Google's infrastructure.
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/bigquery/latest/summary_overview
 .. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/
 
+
+Related Libraries
+-----------------
+
+For higher-level data analysis and DataFrame operations, consider using one of the following connector libraries:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Library
+     - Description
+     - Documentation
+   * - `BigQuery DataFrames (bigframes) <https://dataframes.bigquery.dev/>`_
+     - Flexible pandas-like and scikit-learn-like API powered by BigQuery engine for large-scale data analysis and ML.
+     - `BigFrames Docs <https://dataframes.bigquery.dev/>`_
+   * - `pandas-gbq <https://pandas-gbq.readthedocs.io/>`_
+     - Convenient integration allowing pandas DataFrames to load from and write to BigQuery.
+     - `pandas-gbq Docs <https://pandas-gbq.readthedocs.io/>`_
+
+
 Quick Start
 -----------
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/google_cloud_bigquery.egg-info/requires.txt

@@ -1,4 +1,4 @@
-google-api-core[grpc]<3.0.0,>=2.25.0
+google-api-core[grpc]<3.0.0,>=2.28.0
 google-auth[pyopenssl]<3.0.0,>=2.14.1
 google-cloud-core<3.0.0,>=2.4.1
 google-resumable-media<3.0.0,>=2.0.0
@@ -10,17 +10,14 @@ requests<3.0.0,>=2.21.0
 google-cloud-bigquery[bigquery_v2,bqstorage,geopandas,ipython,ipywidgets,matplotlib,opentelemetry,pandas,tqdm]
 
 [bigquery_v2]
-proto-plus<2.0.0,>=1.22.3
-protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
+proto-plus<2.0.0,>=1.26.1
+protobuf<8.0.0,>=6.33.5
 
 [bqstorage]
-google-cloud-bigquery-storage<3.0.0,>=2.18.0
-grpcio<2.0.0,>=1.47.0
+google-cloud-bigquery-storage<3.0.0,>=2.29.0
+grpcio<2.0.0,>=1.59.0
 pyarrow>=4.0.0
 
-[bqstorage:python_version >= "3.11"]
-grpcio<2.0.0,>=1.49.1
-
 [bqstorage:python_version >= "3.14"]
 grpcio<2.0.0,>=1.75.1
 
@@ -47,13 +44,10 @@ opentelemetry-instrumentation>=0.20b0
 [pandas]
 pandas>=1.3.0
 pandas-gbq>=0.26.1
-grpcio<2.0.0,>=1.47.0
+grpcio<2.0.0,>=1.59.0
 pyarrow>=3.0.0
 db-dtypes<2.0.0,>=1.0.4
 
-[pandas:python_version >= "3.11"]
-grpcio<2.0.0,>=1.49.1
-
 [pandas:python_version >= "3.14"]
 grpcio<2.0.0,>=1.75.1
 

{google_cloud_bigquery-3.42.2 → google_cloud_bigquery-3.43.0}/pyproject.toml

@@ -41,7 +41,7 @@ classifiers = [
   "Topic :: Internet",
 ]
 dependencies = [
-  "google-api-core[grpc] >= 2.25.0, < 3.0.0",
+  "google-api-core[grpc] >= 2.28.0, < 3.0.0",
   "google-auth[pyopenssl] >= 2.14.1, < 3.0.0",
   "google-cloud-core >= 2.4.1, < 3.0.0",
   "google-resumable-media >= 2.0.0, < 3.0.0",
@@ -59,23 +59,21 @@ Repository = "https://github.com/googleapis/python-bigquery"
 # moved back to optional due to bloat.  See
 # https://github.com/googleapis/python-bigquery/issues/1196 for more background.
 bqstorage = [
-  "google-cloud-bigquery-storage >= 2.18.0, < 3.0.0",
+  "google-cloud-bigquery-storage >= 2.29.0, < 3.0.0",
   # Due to an issue in pip's dependency resolver, the `grpc` extra is not
   # installed, even though `google-cloud-bigquery-storage` specifies it
   # as `google-api-core[grpc]`. We thus need to explicitly specify it here.
   # See: https://github.com/googleapis/python-bigquery/issues/83 The
   # grpc.Channel.close() method isn't added until 1.32.0.
   # https://github.com/grpc/grpc/pull/15254
-  "grpcio >= 1.47.0, < 2.0.0",
-  "grpcio >= 1.49.1, < 2.0.0; python_version >= '3.11'",
+  "grpcio >= 1.59.0, < 2.0.0",
   "grpcio >= 1.75.1, < 2.0.0; python_version >= '3.14'",
   "pyarrow >= 4.0.0",
 ]
 pandas = [
   "pandas >= 1.3.0",
   "pandas-gbq >= 0.26.1",
-  "grpcio >= 1.47.0, < 2.0.0",
-  "grpcio >= 1.49.1, < 2.0.0; python_version >= '3.11'",
+  "grpcio >= 1.59.0, < 2.0.0",
   "grpcio >= 1.75.1, < 2.0.0; python_version >= '3.14'",
   "pyarrow >= 3.0.0",
   "db-dtypes >= 1.0.4, < 2.0.0",
@@ -93,8 +91,8 @@ opentelemetry = [
   "opentelemetry-instrumentation >= 0.20b0",
 ]
 bigquery_v2 = [
-  "proto-plus >= 1.22.3, < 2.0.0",
-  "protobuf >= 3.20.2, < 7.0.0, != 4.21.0, != 4.21.1, != 4.21.2, != 4.21.3, != 4.21.4, != 4.21.5", # For the legacy proto-based types.
+  "proto-plus >= 1.26.1, < 2.0.0",
+  "protobuf >= 6.33.5, < 8.0.0", # For the legacy proto-based types.
 ]
 all = [
   "google-cloud-bigquery[bqstorage,pandas,ipywidgets,geopandas,ipython,matplotlib,tqdm,opentelemetry,bigquery_v2]",