chore: Enable TRY and FLY Ruff rules

pyproject.toml

@@ -318,6 +318,8 @@ select = [
     "PLE",  # pylint (error)
     "PLR",  # pylint (refactor)
     "PLW",  # pylint (warning)
+    "TRY",  # tryceratops
+    "FLY",  # flynt
     "PERF", # perflint
     "RUF",  # ruff
 ]

singer_sdk/exceptions.py

@@ -140,6 +140,10 @@ class MissingKeyPropertiesError(Exception):
     """Raised when a recieved (and/or transformed) record is missing key properties."""
 
 
+class InvalidInputLine(Exception):
+    """Raised when an input line is not a valid Singer message."""
+
+
 class InvalidJSONSchema(Exception):
     """Raised when a JSON schema is invalid."""
 

singer_sdk/helpers/_catalog.py

@@ -48,7 +48,8 @@
             f"'{type(schema_at_breadcrumb).__name__}' '{schema_at_breadcrumb}' for "
             f"'{stream_name}' bookmark '{breadcrumb!s}' in '{schema}'"
         )
-        raise ValueError(msg)
+        # TODO: this should be a ValueError, but it's a breaking change.
+        raise ValueError(msg)  # noqa: TRY004
 
     if "properties" not in schema_at_breadcrumb:
         return
@@ -126,7 +127,8 @@
             f"Expected tuple value for breadcrumb '{breadcrumb}'. Got "
             f"{type(breadcrumb).__name__}"
         )
-        raise ValueError(msg)
+        # TODO: this should be a ValueError, but it's a breaking change.
+        raise ValueError(msg)  # noqa: TRY004
 
     catalog_entry = catalog.get_stream(stream_name)
     if not catalog_entry:

singer_sdk/io_base.py

@@ -13,6 +13,7 @@
 from singer_sdk._singerlib.messages import Message, SingerMessageType
 from singer_sdk._singerlib.messages import format_message as singer_format_message
 from singer_sdk._singerlib.messages import write_message as singer_write_message
+from singer_sdk.exceptions import InvalidInputLine
 
 logger = logging.getLogger(__name__)
 
@@ -44,12 +45,12 @@ def _assert_line_requires(line_dict: dict, requires: set[str]) -> None:
             requires: TODO
 
         Raises:
-            Exception: TODO
+            InvalidInputLine: raised if any required keys are missing
         """
         if not requires.issubset(line_dict):
             missing = requires - set(line_dict)
             msg = f"Line is missing required {', '.join(missing)} key(s): {line_dict}"
-            raise Exception(msg)  # TODO: Raise a more specific exception
+            raise InvalidInputLine(msg)
 
     def deserialize_json(self, line: str) -> dict:  # noqa: PLR6301
         """Deserialize a line of json.
@@ -69,7 +70,7 @@ def deserialize_json(self, line: str) -> dict:  # noqa: PLR6301
                 parse_float=decimal.Decimal,
             )
         except json.decoder.JSONDecodeError as exc:
-            logger.error("Unable to parse:\n%s", line, exc_info=exc)
+            logger.exception("Unable to parse:\n%s", line, exc_info=exc)
             raise
 
     def _process_lines(self, file_input: t.IO[str]) -> t.Counter[str]:

singer_sdk/plugin_base.py

@@ -80,7 +80,7 @@ def invoke(self, ctx: click.Context) -> t.Any:  # noqa: ANN401
             return super().invoke(ctx)
         except ConfigValidationError as exc:
             for error in exc.errors:
-                self.logger.error("Config validation error: %s", error)
+                self.logger.exception("Config validation error: %s", error)
             sys.exit(1)
 
 

singer_sdk/sinks/core.py

@@ -494,10 +494,10 @@ def _validate_and_parse(self, record: dict) -> dict:
             # on every record, so it's probably bad and should be moved up the stack.
             try:
                 self._validator.validate(record)
-            except InvalidRecord as e:
+            except InvalidRecord:
                 if self.fail_on_record_validation_exception:
                     raise
-                self.logger.exception("Record validation failed %s", e)
+                self.logger.exception("Record validation failed")
 
         self._parse_timestamps_in_record(
             record=record,

singer_sdk/streams/core.py

@@ -905,25 +905,17 @@
 
         Args:
             current_record_index: The zero-based index of the current record.
-
-        Raises:
-            AbortedSyncFailedException: Raised if sync could not reach a valid state.
-            AbortedSyncPausedException: Raised if sync was able to be transitioned into
-                a valid state without data loss or corruption.
         """
         if (
             self.ABORT_AT_RECORD_COUNT is not None
             and current_record_index > self.ABORT_AT_RECORD_COUNT - 1
         ):
-            try:
-                self._abort_sync(
-                    abort_reason=MaxRecordsLimitException(
-                        "Stream prematurely aborted due to the stream's max dry run "
-                        f"record limit ({self.ABORT_AT_RECORD_COUNT}) being reached.",
-                    ),
-                )
-            except (AbortedSyncFailedException, AbortedSyncPausedException) as ex:
-                raise ex
+            self._abort_sync(
+                abort_reason=MaxRecordsLimitException(
+                    "Stream prematurely aborted due to the stream's max dry run "
+                    f"record limit ({self.ABORT_AT_RECORD_COUNT}) being reached.",
+                ),
+            )
 
     def _abort_sync(self, abort_reason: Exception) -> None:
         """Handle a sync operation being aborted.
@@ -1106,7 +1098,7 @@
                             state_partition_context=state_partition_context,
                             stream_name=self.name,
                         )
-                        raise ex
+                        raise
 
                     if selected:
                         if write_messages:
@@ -1189,12 +1181,12 @@
                 # Sync the records themselves:
                 for _ in self._sync_records(context=context):
                     pass
-        except Exception as ex:
+        except Exception:
             self.logger.exception(
                 "An unhandled error occurred while syncing '%s'",
                 self.name,
             )
-            raise ex
+            raise
 
     def _sync_children(self, child_context: dict | None) -> None:
         if child_context is None:

singer_sdk/streams/rest.py

@@ -125,7 +125,7 @@ def get_url(self, context: dict | None) -> str:
         vals = copy.copy(dict(self.config))
         vals.update(context or {})
         for k, v in vals.items():
-            search_text = "".join(["{", k, "}"])
+            search_text = f"{{{k}}}"
             if search_text in url:
                 url = url.replace(search_text, self._url_encode(v))
         return url

singer_sdk/tap_base.py

@@ -535,7 +535,7 @@ def cb_discover(
             )
         except ConfigValidationError as exc:  # pragma: no cover
             for error in exc.errors:
-                cls.logger.error("Config validation error: %s", error)
+                cls.logger.exception("Config validation error: %s", error)
             ctx.exit(1)
         tap.run_discovery()
         ctx.exit()

singer_sdk/target_base.py

@@ -258,7 +258,7 @@ def add_sink(
         try:
             sink.setup()
         except Exception:  # pragma: no cover
-            self.logger.error("Error initializing '%s' target sink", self.name)
+            self.logger.exception("Error initializing '%s' target sink", self.name)
             raise
 
         self._sinks_active[stream_name] = sink

singer_sdk/testing/tap_tests.py

@@ -328,7 +328,7 @@ def test(self) -> None:
         for v in self.non_null_attribute_values:
             error_message = f"Unable to cast value ('{v}') to float type."
             if not isinstance(v, (float, int)):
-                raise AssertionError(error_message)
+                raise AssertionError(error_message)  # noqa: TRY004
 
     @classmethod
     def evaluate(

singer_sdk/typing.py

@@ -673,7 +673,8 @@
                 f"Type dict for {wrapped} is not defined. Try instantiating it with a "
                 f"nested type such as {wrapped.__name__}(StringType)."
             )
-            raise ValueError(msg)
+            # TODO: this should be a TypeError, but it's a breaking change.
+            raise ValueError(msg)  # noqa: TRY004
 
         return t.cast(dict, wrapped.type_dict)
 
@@ -1070,7 +1071,8 @@
         type_name = from_type.__name__
     else:
         msg = "Expected `str` or a SQLAlchemy `TypeEngine` object or type."
-        raise ValueError(msg)
+        # TODO: this should be a TypeError, but it's a breaking change.
+        raise ValueError(msg)  # noqa: TRY004
 
     return next(
         (