dbt-adapters 1.14.5__tar.gz → 1.14.6__tar.gz

dbt_adapters-1.14.6/.changes/1.14.6.md

@@ -0,0 +1,5 @@
+## dbt-adapters 1.14.6 - April 14, 2025
+
+### Under the Hood
+
+- Add more robust operation forwarding to record/replay wrappers. ([#990](https://github.com/dbt-labs/dbt-adapters/issues/990))

{dbt_adapters-1.14.5 → dbt_adapters-1.14.6}/CHANGELOG.md

@@ -10,6 +10,14 @@ and is generated by [Changie](https://github.com/miniscruff/changie)
 - Do not edit this file directly. This file is auto-generated using [changie](https://github.com/miniscruff/changie)
 - For details on how to document a change, see the [contributing guide](/CONTRIBUTING.md#changelog-entry)
 
+## dbt-adapters 1.14.6 - April 14, 2025
+
+### Under the Hood
+
+- Add more robust operation forwarding to record/replay wrappers. ([#990](https://github.com/dbt-labs/dbt-adapters/issues/990))
+
+
+
 ## dbt-adapters 1.14.5 - April 07, 2025
 
 ### Fixes
@@ -20,7 +28,6 @@ and is generated by [Changie](https://github.com/miniscruff/changie)
 ### Contributors
 - [@etx121](https://github.com/etx121) ([#966](https://github.com/dbt-labs/dbt-adapters/issues/966), [#966](https://github.com/dbt-labs/dbt-adapters/issues/966))
 
-
 ## dbt-adapters 1.14.4 - March 31, 2025
 
 ### Features

{dbt_adapters-1.14.5 → dbt_adapters-1.14.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbt-adapters
-Version: 1.14.5
+Version: 1.14.6
 Summary: The set of adapter protocols and base functionality that supports integration with dbt-core
 Project-URL: Homepage, https://github.com/dbt-labs/dbt-adapters/tree/main/dbt-adapters
 Project-URL: Documentation, https://docs.getdbt.com

dbt_adapters-1.14.6/src/dbt/adapters/__about__.py

@@ -0,0 +1 @@
+version = "1.14.6"

{dbt_adapters-1.14.5 → dbt_adapters-1.14.6}/src/dbt/adapters/record/cursor/cursor.py

@@ -1,5 +1,8 @@
 from typing import Any, Optional
 
+from dbt_common.events.base_types import BaseEvent
+from dbt_common.events.functions import fire_event
+from dbt_common.events.types import RecordReplayIssue
 from dbt_common.record import record_function
 
 from dbt.adapters.contracts.connection import Connection
@@ -52,3 +55,15 @@ class RecordReplayCursor:
     @record_function(CursorGetDescriptionRecord, method=True, id_field_name="connection_name")
     def description(self) -> str:
         return self.native_cursor.description
+
+    def _fire_event(self, evt: BaseEvent) -> None:
+        """Wraps fire_event for easier test mocking."""
+        fire_event(evt)
+
+    def __getattr__(self, name: str) -> Any:
+        self._fire_event(
+            RecordReplayIssue(
+                msg=f"Unexpected attribute '{name}' accessed on {self.__class__.__name__}"
+            )
+        )
+        return getattr(self.native_cursor, name)

{dbt_adapters-1.14.5 → dbt_adapters-1.14.6}/src/dbt/adapters/record/handle.py

@@ -1,7 +1,10 @@
 from typing import Any
 
-from dbt.adapters.contracts.connection import Connection
+from dbt_common.events.base_types import BaseEvent
+from dbt_common.events.functions import fire_event
+from dbt_common.events.types import RecordReplayIssue
 
+from dbt.adapters.contracts.connection import Connection
 from dbt.adapters.record.cursor.cursor import RecordReplayCursor
 
 
@@ -38,3 +41,15 @@ class RecordReplayHandle:
     @property
     def closed(self):
         return self.native_handle.closed
+
+    def _fire_event(self, evt: BaseEvent) -> None:
+        """Wraps fire_event for easier test mocking."""
+        fire_event(evt)
+
+    def __getattr__(self, name: str) -> Any:
+        self._fire_event(
+            RecordReplayIssue(
+                msg=f"Unexpected attribute '{name}' accessed on {self.__class__.__name__}"
+            )
+        )
+        return getattr(self.native_handle, name)

dbt_adapters-1.14.6/tests/unit/record/test_record_cursor.py

@@ -0,0 +1,50 @@
+from dbt.adapters.record import RecordReplayCursor
+
+
+class MockCursor:
+    @property
+    def rowcount(self) -> int:
+        return 42
+
+    def execute(self, operation, parameters=None) -> None:
+        pass
+
+    @property
+    def unexpected_prop(self) -> bool:
+        return True
+
+    def unexpected_func(self) -> int:
+        return 1
+
+
+class MockConnection:
+    pass
+
+
+def test_record_cursor():
+    # Ensure that record/replay's cursor wrapper forwards all property accesses
+    # and function calls to the wrapped cursor, even if they were not expected.
+    # Also, verify that a RecordReplayIssue is logged if unexpected accesses or
+    # function calls happen.
+    recorded_cursor = RecordReplayCursor(MockCursor(), MockConnection())  # type: ignore
+
+    # Test that an expected property works as designed
+    assert recorded_cursor.rowcount == 42
+    # Test that an expected function call works as designed
+    recorded_cursor.execute("select 1")
+
+    events = []
+
+    # Mock event firing
+    recorded_cursor._fire_event = events.append
+
+    # Test that an unexpected property works, but fires a warning
+    assert recorded_cursor.unexpected_prop is True
+    assert len(events) == 1
+    assert events[0].__class__.__name__ == "RecordReplayIssue"
+    events.clear()
+
+    # Test that an unexpected function works, but fires a warning
+    assert recorded_cursor.unexpected_func() == 1
+    assert len(events) == 1
+    assert events[0].__class__.__name__ == "RecordReplayIssue"

dbt_adapters-1.14.6/tests/unit/record/test_record_handle.py

@@ -0,0 +1,50 @@
+from dbt.adapters.record import RecordReplayHandle
+
+
+class MockConnection:
+    pass
+
+
+class MockHandle:
+    @property
+    def closed(self) -> bool:
+        return False
+
+    def rollback(self) -> None:
+        pass
+
+    @property
+    def unexpected_prop(self) -> bool:
+        return True
+
+    def unexpected_func(self) -> int:
+        return 1
+
+
+def test_record_handle():
+    # Ensure that record/replay's handle wrapper forwards all property accesses
+    # and function calls to the wrapped cursor, even if they were not expected.
+    # Also, verify that a RecordReplayIssue is logged if unexpected accesses or
+    # function calls happen.
+    recorded_handle = RecordReplayHandle(MockHandle(), MockConnection())  # type: ignore
+
+    # Test that an expected property works as designed
+    assert recorded_handle.closed is False
+    # Test that an expected function call works as designed
+    recorded_handle.rollback()
+
+    events = []
+
+    # Mock event firing
+    recorded_handle._fire_event = events.append
+
+    # Test that an unexpected property works, but fires a warning
+    assert recorded_handle.unexpected_prop is True
+    assert len(events) == 1
+    assert events[0].__class__.__name__ == "RecordReplayIssue"
+    events.clear()
+
+    # Test that an unexpected function works, but fires a warning
+    assert recorded_handle.unexpected_func() == 1
+    assert len(events) == 1
+    assert events[0].__class__.__name__ == "RecordReplayIssue"

dbt_adapters-1.14.5/src/dbt/adapters/__about__.py

@@ -1 +0,0 @@
-version = "1.14.5"