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

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.45.2
+Version: 3.46.1
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0
-Project-URL: Repository, https://github.com/googleapis/python-bigquery
+Project-URL: Repository, https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-bigquery
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.10

{google_cloud_bigquery-3.45.2 → google_cloud_bigquery-3.46.1}/google/cloud/bigquery/schema.py

@@ -15,16 +15,14 @@
 """Schemas for BigQuery tables / queries."""
 
 from __future__ import annotations
+
 import enum
 import typing
-from typing import Any, cast, Dict, Iterable, Optional, Union, Sequence
+from typing import Any, Dict, Iterable, Optional, Sequence, Union, cast
 
-from google.cloud.bigquery import _helpers
-from google.cloud.bigquery import standard_sql
-from google.cloud.bigquery import enums
+from google.cloud.bigquery import _helpers, enums, standard_sql
 from google.cloud.bigquery.enums import StandardSqlTypeNames
 
-
 _STRUCT_TYPES = ("RECORD", "STRUCT")
 
 # SQL types reference:
@@ -109,6 +107,43 @@ class FieldElementType(object):
         """
         return self._properties
 
+    def _key(self):
+        """A tuple key that uniquely describes this FieldElementType.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            Tuple: The contents of this :class:`~google.cloud.bigquery.schema.FieldElementType`.
+        """
+        return (self.element_type,)
+
+    def __eq__(self, other):
+        if not isinstance(other, FieldElementType):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(element_type={self.element_type!r})"
+
+
+class _SchemaFieldKey(typing.NamedTuple):
+    name: str
+    field_type: str
+    mode: str
+    default_value_expression: Optional[str]
+    description: Optional[str]
+    fields: tuple
+    policy_tags: Optional[tuple[str, ...]]
+    timestamp_precision: Optional[int]
+    rounding_mode: Optional[str]
+    foreign_type_definition: Optional[str]
+
 
 class SchemaField(object):
     """Describe a single field within a table schema.
@@ -436,6 +471,9 @@ class SchemaField(object):
                     field_type = f"{field_type}({self.precision}, {self.scale})"
                 else:
                     field_type = f"{field_type}({self.precision})"
+        elif field_type == "RANGE":
+            if self.range_element_type is not None:
+                field_type = f"{field_type}<{self.range_element_type.element_type}>"
 
         policy_tags = (
             None if self.policy_tags is None else tuple(sorted(self.policy_tags.names))
@@ -443,16 +481,24 @@ class SchemaField(object):
 
         timestamp_precision = self._properties.get("timestampPrecision")
 
-        return (
-            self.name,
-            field_type,
+        rounding_mode = (
+            self.rounding_mode.value
+            if isinstance(self.rounding_mode, enums.RoundingMode)
+            else self.rounding_mode
+        )
+
+        return _SchemaFieldKey(
+            name=self.name,
+            field_type=field_type,
             # Mode is always str, if not given it defaults to a str value
-            self.mode.upper(),  # pytype: disable=attribute-error
-            self.default_value_expression,
-            self.description,
-            self.fields,
-            policy_tags,
-            timestamp_precision,
+            mode=self.mode.upper(),  # pytype: disable=attribute-error
+            default_value_expression=self.default_value_expression,
+            description=self.description,
+            fields=self.fields,
+            policy_tags=policy_tags,
+            timestamp_precision=timestamp_precision,
+            rounding_mode=rounding_mode,
+            foreign_type_definition=self.foreign_type_definition,
         )
 
     def to_standard_sql(self) -> standard_sql.StandardSqlField:
@@ -503,9 +549,11 @@ class SchemaField(object):
         return hash(self._key())
 
     def __repr__(self):
-        *initial_tags, policy_tags, timestamp_precision_tag = self._key()
-        policy_tags_inst = None if policy_tags is None else PolicyTagList(policy_tags)
-        adjusted_key = (*initial_tags, policy_tags_inst, timestamp_precision_tag)
+        key = self._key()
+        policy_tags_inst = (
+            None if key.policy_tags is None else PolicyTagList(key.policy_tags)
+        )
+        adjusted_key = tuple(key._replace(policy_tags=policy_tags_inst))
         return f"{self.__class__.__name__}{adjusted_key}"
 
 

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

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: google-cloud-bigquery
-Version: 3.45.2
+Version: 3.46.1
 Summary: Google BigQuery API client library
 Author-email: Google LLC <googleapis-packages@google.com>
 License: Apache 2.0
-Project-URL: Repository, https://github.com/googleapis/python-bigquery
+Project-URL: Repository, https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-bigquery
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.10

{google_cloud_bigquery-3.45.2 → google_cloud_bigquery-3.46.1}/pyproject.toml

@@ -37,6 +37,7 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
   "Operating System :: OS Independent",
   "Topic :: Internet",
 ]
@@ -52,7 +53,7 @@ dependencies = [
 dynamic = ["version"]
 
 [project.urls]
-Repository = "https://github.com/googleapis/python-bigquery"
+Repository = "https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-bigquery"
 
 [project.optional-dependencies]
 # bqstorage had a period where it was a required dependency, and has been

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

@@ -32,7 +32,7 @@ import pytest
 import requests
 
 try:
-    import opentelemetry
+    import opentelemetry.sdk as opentelemetry
 except ImportError:
     opentelemetry = None
 
@@ -1101,7 +1101,7 @@ class TestClient(unittest.TestCase):
         )
 
     def test_span_status_is_set(self):
-        pytest.importorskip("opentelemetry")
+        pytest.importorskip("opentelemetry.sdk")
         from google.cloud.bigquery.routine import Routine
 
         tracer_provider = TracerProvider()

{google_cloud_bigquery-3.45.2 → google_cloud_bigquery-3.46.1}/tests/unit/test_opentelemetry_tracing.py

@@ -18,7 +18,7 @@ import sys
 from unittest import mock
 
 try:
-    import opentelemetry
+    import opentelemetry.sdk as opentelemetry
 except ImportError:
     opentelemetry = None
 

{google_cloud_bigquery-3.45.2 → google_cloud_bigquery-3.46.1}/tests/unit/test_schema.py

@@ -19,10 +19,9 @@ from unittest import mock
 import pytest
 
 from google.cloud import bigquery
-from google.cloud.bigquery import enums
-from google.cloud.bigquery.standard_sql import StandardSqlStructType
-from google.cloud.bigquery import schema
+from google.cloud.bigquery import enums, schema
 from google.cloud.bigquery.schema import PolicyTagList
+from google.cloud.bigquery.standard_sql import StandardSqlStructType
 
 
 class TestSchemaField(unittest.TestCase):
@@ -635,6 +634,44 @@ class TestSchemaField(unittest.TestCase):
         )
         self.assertEqual(field, other)  # Policy tags order does not matter.
 
+    def test___eq___range_element_type_mismatch(self):
+        field = self._make_one("R", "RANGE", range_element_type="DATE")
+        other = self._make_one("R", "RANGE", range_element_type="DATETIME")
+        self.assertNotEqual(field, other)
+
+    def test___eq___range_element_type_hit(self):
+        field = self._make_one("R", "RANGE", range_element_type="DATE")
+        other = self._make_one(
+            "R", "RANGE", range_element_type=schema.FieldElementType("DATE")
+        )
+        self.assertEqual(field, other)
+
+    def test___eq___rounding_mode_mismatch(self):
+        field = self._make_one(
+            "num", "NUMERIC", rounding_mode="ROUND_HALF_AWAY_FROM_ZERO"
+        )
+        other = self._make_one("num", "NUMERIC", rounding_mode="ROUND_HALF_EVEN")
+        self.assertNotEqual(field, other)
+
+    def test___eq___rounding_mode_hit(self):
+        field = self._make_one(
+            "num", "NUMERIC", rounding_mode=enums.RoundingMode.ROUND_HALF_AWAY_FROM_ZERO
+        )
+        other = self._make_one(
+            "num", "NUMERIC", rounding_mode="ROUND_HALF_AWAY_FROM_ZERO"
+        )
+        self.assertEqual(field, other)
+
+    def test___eq___foreign_type_definition_mismatch(self):
+        field = self._make_one("f", "FOREIGN", foreign_type_definition="type1")
+        other = self._make_one("f", "FOREIGN", foreign_type_definition="type2")
+        self.assertNotEqual(field, other)
+
+    def test___eq___foreign_type_definition_hit(self):
+        field = self._make_one("f", "FOREIGN", foreign_type_definition="type1")
+        other = self._make_one("f", "FOREIGN", foreign_type_definition="type1")
+        self.assertEqual(field, other)
+
     def test___ne___wrong_type(self):
         field = self._make_one("toast", "INTEGER")
         other = object()
@@ -695,7 +732,8 @@ class TestSchemaField(unittest.TestCase):
     def test___repr__(self):
         field1 = self._make_one("field1", "STRING")
         expected = (
-            "SchemaField('field1', 'STRING', 'NULLABLE', None, None, (), None, None)"
+            "SchemaField('field1', 'STRING', 'NULLABLE', None, None, (), "
+            "None, None, None, None)"
         )
         self.assertEqual(repr(field1), expected)
 
@@ -758,6 +796,35 @@ class TestFieldElementType(unittest.TestCase):
     def test_from_api_repr_none(self):
         self.assertEqual(None, self._get_target_class().from_api_repr(None))
 
+    def test___eq___wrong_type(self):
+        element_type = self._make_one("DATE")
+        self.assertNotEqual(element_type, "DATE")
+        self.assertNotEqual(element_type, object())
+
+    def test___eq___hit(self):
+        element_type1 = self._make_one("DATE")
+        element_type2 = self._make_one("DATE")
+        self.assertEqual(element_type1, element_type2)
+
+    def test___eq___case_insensitive(self):
+        element_type1 = self._make_one("date")
+        element_type2 = self._make_one("DATE")
+        self.assertEqual(element_type1, element_type2)
+
+    def test___eq___mismatch(self):
+        element_type1 = self._make_one("DATE")
+        element_type2 = self._make_one("DATETIME")
+        self.assertNotEqual(element_type1, element_type2)
+
+    def test___hash__(self):
+        element_type1 = self._make_one("DATE")
+        element_type2 = self._make_one("DATE")
+        self.assertEqual(hash(element_type1), hash(element_type2))
+
+    def test___repr__(self):
+        element_type = self._make_one("DATE")
+        self.assertEqual(repr(element_type), "FieldElementType(element_type='DATE')")
+
 
 # TODO: dedup with the same class in test_table.py.
 class _SchemaBase(object):
@@ -1188,6 +1255,21 @@ class TestPolicyTags(unittest.TestCase):
             ("n", "BYTES", None, None, 9),
             ("n", "BYTES(9)"),
         ),
+        (
+            dict(name="n", type="RANGE", rangeElementType=dict(type="DATE")),
+            ("n", "RANGE", None, None, None),
+            ("n", "RANGE<DATE>"),
+        ),
+        (
+            dict(name="n", type="RANGE", rangeElementType=dict(type="DATETIME")),
+            ("n", "RANGE", None, None, None),
+            ("n", "RANGE<DATETIME>"),
+        ),
+        (
+            dict(name="n", type="RANGE", rangeElementType=dict(type="TIMESTAMP")),
+            ("n", "RANGE", None, None, None),
+            ("n", "RANGE<TIMESTAMP>"),
+        ),
     ],
 )
 def test_from_api_repr_parameterized(api, expect, key2):