fix: Implement two-tier exception handling for Calamine panics and update test

- Add two-tier exception handling: catch Exception first, then BaseException
- PyO3 PanicException from Calamine inherits from BaseException, not Exception
- Keep targeted BLE001 suppression with explanatory comment
- Re-raise KeyboardInterrupt/SystemExit in BaseException handler
- Update calamine_exc type to Optional[BaseException] for MyPy
- Update test mocks to accept sheet_name parameter
- Verified: test passes and MyPy succeeds locally

This preserves the functional requirement to catch Calamine panics while
following Python best practices for normal exception handling.

Co-Authored-By: unknown <>

Author: devin-ai-integration[bot]

airbyte_cdk/sources/file_based/file_types/excel_parser.py

@@ -200,7 +200,7 @@ def open_and_parse_file(
             file_url = getattr(file_info, "url", None)
         elif isinstance(file_info, str):
             file_label = file_info
-        calamine_exc: Optional[Exception] = None
+        calamine_exc: Optional[BaseException] = None
         try:
             with pd.ExcelFile(fp, engine="calamine") as excel_file:  # type: ignore [arg-type, call-overload]
                 return excel_file.parse(sheet_name=0)  # type: ignore [no-any-return]
@@ -213,6 +213,18 @@ def open_and_parse_file(
                         file_url,
                     )
                 )
+        except BaseException as exc:  # noqa: BLE001
+            # PyO3 PanicException from Calamine inherits from BaseException, not Exception
+            if isinstance(exc, (KeyboardInterrupt, SystemExit)):
+                raise
+            calamine_exc = exc
+            if logger:
+                logger.warning(
+                    ExcelParser._format_message_with_link(
+                        f"Calamine parsing failed for {file_label}, falling back to openpyxl: {exc}",
+                        file_url,
+                    )
+                )
 
         # Fallback to openpyxl
         try:

unit_tests/sources/file_based/file_types/test_excel_parser.py

@@ -152,13 +152,17 @@ def test_open_and_parse_file_falls_back_to_openpyxl(mock_logger):
     calamine_ctx = MagicMock()
     calamine_excel_file = MagicMock()
     calamine_ctx.__enter__.return_value = calamine_excel_file
-    calamine_excel_file.parse.side_effect = FakePanic("calamine panic")
+    
+    def calamine_parse_side_effect(sheet_name=None):
+        raise FakePanic("calamine panic")
+    
+    calamine_excel_file.parse.side_effect = calamine_parse_side_effect
 
     openpyxl_ctx = MagicMock()
     openpyxl_excel_file = MagicMock()
     openpyxl_ctx.__enter__.return_value = openpyxl_excel_file
 
-    def openpyxl_parse_side_effect():
+    def openpyxl_parse_side_effect(sheet_name=None):
         warnings.warn("Cell A146 has invalid date", UserWarning)
         return fallback_df