google-cloud-bigquery 3.45.0__tar.gz → 3.45.2__tar.gz

{google_cloud_bigquery-3.45.0/google_cloud_bigquery.egg-info → google_cloud_bigquery-3.45.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.45.0
+Version: 3.45.2
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2}/google/cloud/bigquery/client.py

@@ -78,6 +78,9 @@ from google.cloud.bigquery import (
     job,
 )
 from google.cloud.bigquery import exceptions as bq_exceptions
+from google.cloud.bigquery import (
+    version as bq_version,
+)
 from google.cloud.bigquery._helpers import (
     _DEFAULT_HOST,
     _DEFAULT_HOST_TEMPLATE,
@@ -148,7 +151,7 @@ _MULTIPART_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + "multipart"
 _RESUMABLE_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + "resumable"
 _GENERIC_CONTENT_TYPE = "*/*"
 _READ_LESS_THAN_SIZE = (
-    "Size {:d} was specified but the file-like object only had " "{:d} bytes remaining."
+    "Size {:d} was specified but the file-like object only had {:d} bytes remaining."
 )
 _NEED_TABLE_ARGUMENT = (
     "The table argument should be a table ID string, Table, or TableReference"
@@ -641,9 +644,16 @@ class Client(ClientWithProject):
             pandas_gbq = None  # type: ignore
 
         if pandas_gbq is None:
-            user_agent = "pandas-gbq/0.0.0"
+            # Even if pandas-gbq isn't installed, attribute all
+            # to_dataframe/to_arrow usage the same as we do the recommended
+            # (pandas-gbq) code paths.
+            pandas_user_agent = "pandas-gbq/0.0.0"
         else:
-            user_agent = f"pandas-gbq/{pandas_gbq.__version__}"
+            pandas_user_agent = f"pandas-gbq/{pandas_gbq.__version__}"
+
+        # Track the google-cloud-bigquery version as "legacy" because this code
+        # path is intended to be migrated to pandas-gbq itself.
+        user_agent = f"legacy-gcb/{bq_version.__version__} {pandas_user_agent}"
 
         if client_info is None:
             amended_client_info = google.api_core.gapic_v1.client_info.ClientInfo(

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2}/google/cloud/bigquery/table.py

@@ -20,7 +20,6 @@ import base64
 import copy
 import datetime
 import functools
-import logging
 import operator
 import typing
 import warnings
@@ -87,7 +86,6 @@ if typing.TYPE_CHECKING:  # pragma: NO COVER
     from google.cloud import bigquery_storage  # type: ignore
     from google.cloud.bigquery.dataset import DatasetReference
 
-_LOGGER = logging.getLogger(__name__)
 
 _NO_GEOPANDAS_ERROR = (
     "The geopandas library is not installed, please install "
@@ -2993,21 +2991,6 @@ class RowIterator(HTTPIterator):
             create_bqstorage_client = False
             bqstorage_client = None
 
-        if _versions_helpers.PANDAS_GBQ_VERSIONS.is_delegation_supported:
-            try:
-                client_info = getattr(
-                    getattr(self.client, "_connection", None), "_client_info", None
-                )
-                if client_info:
-                    ua = getattr(client_info, "user_agent", None) or ""
-                    if "pandas-gbq" not in ua:
-                        version = (
-                            _versions_helpers.PANDAS_GBQ_VERSIONS.installed_version
-                        )
-                        client_info.user_agent = f"{ua} pandas-gbq/{version}".strip()
-            except Exception as exc:
-                _LOGGER.debug("Failed to update telemetry user-agent: %s", exc)
-
         with warnings.catch_warnings():
             warnings.filterwarnings(
                 "ignore",

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2}/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.45.0"
+__version__ = "3.45.2"

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2/google_cloud_bigquery.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.45.0
+Version: 3.45.2
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2}/google_cloud_bigquery.egg-info/SOURCES.txt

@@ -111,6 +111,7 @@ tests/unit/test_dbapi_connection.py
 tests/unit/test_dbapi_cursor.py
 tests/unit/test_dbapi_types.py
 tests/unit/test_delete_dataset.py
+tests/unit/test_docs.py
 tests/unit/test_encryption_configuration.py
 tests/unit/test_external_config.py
 tests/unit/test_format_options.py

{google_cloud_bigquery-3.45.0 → google_cloud_bigquery-3.45.2}/tests/unit/test_client.py

@@ -54,7 +54,7 @@ import google.cloud.bigquery.retry
 import google.cloud.bigquery.table
 from google.api_core import client_info
 from google.cloud import bigquery
-from google.cloud.bigquery import ParquetOptions, exceptions
+from google.cloud.bigquery import ParquetOptions, exceptions, version
 from google.cloud.bigquery.dataset import Dataset, DatasetReference
 from google.cloud.bigquery.enums import DatasetView, TimestampPrecision, UpdateMode
 from google.cloud.bigquery.retry import DEFAULT_TIMEOUT
@@ -840,6 +840,9 @@ class TestClient(unittest.TestCase):
         self.assertIs(kwargs["client_options"], mock.sentinel.client_options)
         self.assertIn("test-agent", kwargs["client_info"].user_agent)
         self.assertIn("pandas-gbq", kwargs["client_info"].user_agent)
+        self.assertIn(
+            f"legacy-gcb/{version.__version__}", kwargs["client_info"].user_agent
+        )
 
     def test_ensure_bqstorage_client_pandas_gbq_installed(self):
         bigquery_storage = pytest.importorskip("google.cloud.bigquery_storage")
@@ -857,15 +860,17 @@ class TestClient(unittest.TestCase):
         mock_pandas = mock.Mock()
         mock_pandas.__version__ = "0.13.0"
 
-        with mock.patch(
-            "google.cloud.bigquery_storage.BigQueryReadClient", mock_client
-        ), mock.patch.dict(sys.modules, {"pandas_gbq": mock_pandas}):
+        with (
+            mock.patch("google.cloud.bigquery_storage.BigQueryReadClient", mock_client),
+            mock.patch.dict(sys.modules, {"pandas_gbq": mock_pandas}),
+        ):
             client._ensure_bqstorage_client(client_info=client_info)
 
         mock_client.assert_called_once()
         _, kwargs = mock_client.call_args
         self.assertEqual(
-            kwargs["client_info"].user_agent, "app-agent pandas-gbq/0.13.0"
+            kwargs["client_info"].user_agent,
+            f"app-agent legacy-gcb/{version.__version__} pandas-gbq/0.13.0",
         )
 
     def test_ensure_bqstorage_client_pandas_gbq_not_installed(self):
@@ -881,14 +886,18 @@ class TestClient(unittest.TestCase):
             user_agent="app-agent"
         )
 
-        with mock.patch(
-            "google.cloud.bigquery_storage.BigQueryReadClient", mock_client
-        ), mock.patch.dict(sys.modules, {"pandas_gbq": None}):
+        with (
+            mock.patch("google.cloud.bigquery_storage.BigQueryReadClient", mock_client),
+            mock.patch.dict(sys.modules, {"pandas_gbq": None}),
+        ):
             client._ensure_bqstorage_client(client_info=client_info)
 
         mock_client.assert_called_once()
         _, kwargs = mock_client.call_args
-        self.assertEqual(kwargs["client_info"].user_agent, "app-agent pandas-gbq/0.0.0")
+        self.assertEqual(
+            kwargs["client_info"].user_agent,
+            f"app-agent legacy-gcb/{version.__version__} pandas-gbq/0.0.0",
+        )
 
     def test_ensure_bqstorage_client_client_info_none(self):
         bigquery_storage = pytest.importorskip("google.cloud.bigquery_storage")
@@ -898,14 +907,18 @@ class TestClient(unittest.TestCase):
         creds = _make_credentials()
         client = self._make_one(project=self.PROJECT, credentials=creds)
 
-        with mock.patch(
-            "google.cloud.bigquery_storage.BigQueryReadClient", mock_client
-        ), mock.patch.dict(sys.modules, {"pandas_gbq": None}):
+        with (
+            mock.patch("google.cloud.bigquery_storage.BigQueryReadClient", mock_client),
+            mock.patch.dict(sys.modules, {"pandas_gbq": None}),
+        ):
             client._ensure_bqstorage_client(client_info=None)
 
         mock_client.assert_called_once()
         _, kwargs = mock_client.call_args
-        self.assertEqual(kwargs["client_info"].user_agent, "pandas-gbq/0.0.0")
+        self.assertEqual(
+            kwargs["client_info"].user_agent,
+            f"legacy-gcb/{version.__version__} pandas-gbq/0.0.0",
+        )
 
     def test_ensure_bqstorage_client_client_info_user_agent_none(self):
         bigquery_storage = pytest.importorskip("google.cloud.bigquery_storage")
@@ -919,14 +932,18 @@ class TestClient(unittest.TestCase):
 
         client_info = google.api_core.gapic_v1.client_info.ClientInfo(user_agent=None)
 
-        with mock.patch(
-            "google.cloud.bigquery_storage.BigQueryReadClient", mock_client
-        ), mock.patch.dict(sys.modules, {"pandas_gbq": None}):
+        with (
+            mock.patch("google.cloud.bigquery_storage.BigQueryReadClient", mock_client),
+            mock.patch.dict(sys.modules, {"pandas_gbq": None}),
+        ):
             client._ensure_bqstorage_client(client_info=client_info)
 
         mock_client.assert_called_once()
         _, kwargs = mock_client.call_args
-        self.assertEqual(kwargs["client_info"].user_agent, "pandas-gbq/0.0.0")
+        self.assertEqual(
+            kwargs["client_info"].user_agent,
+            f"legacy-gcb/{version.__version__} pandas-gbq/0.0.0",
+        )
 
     def test_ensure_bqstorage_client_missing_dependency(self):
         creds = _make_credentials()
@@ -9157,9 +9174,10 @@ class TestClientUpload(object):
             SchemaField("unknown_col", "BYTES"),
         )
         job_config = job.LoadJobConfig(schema=schema)
-        with load_patch as load_table_from_file, pytest.raises(
-            ValueError
-        ) as exc_context:
+        with (
+            load_patch as load_table_from_file,
+            pytest.raises(ValueError) as exc_context,
+        ):
             client.load_table_from_dataframe(
                 dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
             )
@@ -9429,9 +9447,13 @@ class TestClientUpload(object):
         get_table_patch = mock.patch(
             "google.cloud.bigquery.client.Client.get_table", autospec=True
         )
-        with load_patch, get_table_patch, pytest.warns(
-            PendingDeprecationWarning,
-            match="Loading DataFrames via google-cloud-bigquery is deprecated",
+        with (
+            load_patch,
+            get_table_patch,
+            pytest.warns(
+                PendingDeprecationWarning,
+                match="Loading DataFrames via google-cloud-bigquery is deprecated",
+            ),
         ):
             client.load_table_from_dataframe(dataframe, self.TABLE_REF)
 
@@ -9853,7 +9875,7 @@ class TestClientUpload(object):
 
         client = self._make_client()
 
-        emoji = "\U0001F3E6"
+        emoji = "\U0001f3e6"
         json_row = {"emoji": emoji}
         json_rows = [json_row]
 

google_cloud_bigquery-3.45.2/tests/unit/test_docs.py

@@ -0,0 +1,97 @@
+# 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.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pathlib
+import runpy
+import sys
+import types
+from unittest import mock
+
+import pytest
+
+
+def test_docs_conf_executes_successfully():
+    docs_dir = pathlib.Path(__file__).parent.parent.parent / "docs"
+    conf_path = docs_dir / "conf.py"
+    if not conf_path.exists():
+        pytest.skip("docs/conf.py not found")
+
+    res = runpy.run_path(str(conf_path))
+
+    assert res.get("project") == "google-cloud-bigquery"
+
+
+@pytest.fixture
+def fake_translator_and_mock():
+    docs_dir = pathlib.Path(__file__).parent.parent.parent / "docs"
+    conf_path = docs_dir / "conf.py"
+    if not conf_path.exists():
+        pytest.skip("docs/conf.py not found")
+
+    mock_orig_depart = mock.MagicMock(return_value="original_output")
+
+    class FakeTranslator:
+        depart_paragraph = mock_orig_depart
+        depart_compact_paragraph = mock_orig_depart
+
+    fake_module = types.ModuleType("sphinx_markdown_builder.markdown_writer")
+    fake_module.MarkdownTranslator = FakeTranslator
+
+    with mock.patch.dict(
+        sys.modules,
+        {
+            "sphinx_markdown_builder": types.ModuleType("sphinx_markdown_builder"),
+            "sphinx_markdown_builder.markdown_writer": fake_module,
+        },
+    ):
+        runpy.run_path(str(conf_path))
+
+    return FakeTranslator, mock_orig_depart
+
+
+def test_depart_paragraph_suppresses_newlines_inside_table_cells(
+    fake_translator_and_mock,
+):
+    FakeTranslator, mock_orig_depart = fake_translator_and_mock
+    translator = FakeTranslator()
+    translator.table_entries = ["cell"]
+    node = mock.MagicMock()
+
+    res_paragraph = FakeTranslator.depart_paragraph(translator, node)
+    res_compact = FakeTranslator.depart_compact_paragraph(translator, node)
+
+    assert res_paragraph is None
+    assert res_compact is None
+    mock_orig_depart.assert_not_called()
+
+
+def test_depart_paragraph_delegates_outside_table_cells(
+    fake_translator_and_mock,
+):
+    FakeTranslator, mock_orig_depart = fake_translator_and_mock
+    translator = FakeTranslator()
+    node = mock.MagicMock()
+
+    res_paragraph = FakeTranslator.depart_paragraph(translator, node)
+    res_compact = FakeTranslator.depart_compact_paragraph(translator, node)
+
+    assert res_paragraph == "original_output"
+    assert res_compact == "original_output"
+    assert mock_orig_depart.call_count == 2
+    mock_orig_depart.assert_has_calls(
+        [
+            mock.call(translator, node),
+            mock.call(translator, node),
+        ]
+    )