Fix E501 line length errors in docstrings

Break long docstring lines to comply with 80 char limit:
- exceptions.py: 7 lines fixed
- mixins.py: 2 lines fixed
- transactions.py: 5 lines fixed
- test_v0_2_0_features.py: 2 lines fixed

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: fsecada01

sqlmodel_crud_utils/exceptions.py

@@ -119,7 +119,8 @@ class MultipleRecordsError(SQLModelCRUDError):
         ...     count=3,
         ...     filters={"email": "test@example.com"}
         ... )
-        MultipleRecordsError: Expected 1 User, found 3 (filters: {'email': 'test@example.com'})
+        MultipleRecordsError: Expected 1 User, found 3
+            (filters: {'email': 'test@example.com'})
     """
 
     def __init__(
@@ -174,7 +175,8 @@ class ValidationError(SQLModelCRUDError):
         ...     value=-5,
         ...     message="Age must be a positive integer"
         ... )
-        ValidationError: Validation failed for field 'age': Age must be a positive integer (value: -5)
+        ValidationError: Validation failed for field 'age':
+            Age must be a positive integer (value: -5)
 
         Multiple field errors:
         >>> raise ValidationError(
@@ -324,8 +326,10 @@ class TransactionError(SQLModelCRUDError):
     - Connection issues during transaction
 
     Attributes:
-        operation: The transaction operation that failed (e.g., "commit", "rollback").
-        original_error: The underlying exception that caused the failure.
+        operation: The transaction operation that failed
+            (e.g., "commit", "rollback").
+        original_error: The underlying exception that caused the
+            failure.
 
     Example:
         >>> try:
@@ -335,7 +339,8 @@ class TransactionError(SQLModelCRUDError):
         ...         operation="commit",
         ...         original_error=e
         ...     )
-        TransactionError: Transaction operation 'commit' failed: IntegrityError(...)
+        TransactionError: Transaction operation 'commit' failed:
+            IntegrityError(...)
     """
 
     def __init__(
@@ -471,11 +476,16 @@ def __init__(
             full_message = message
         elif query and original_error:
             full_message = (
-                f"Query execution failed: {type(original_error).__name__}({original_error})\n"
-                f"Query: {query[:200]}{'...' if len(query) > 200 else ''}"
+                f"Query execution failed: "
+                f"{type(original_error).__name__}({original_error})\n"
+                f"Query: {query[:200]}"
+                f"{'...' if len(query) > 200 else ''}"
             )
         elif query:
-            full_message = f"Query execution failed: {query[:200]}{'...' if len(query) > 200 else ''}"
+            full_message = (
+                f"Query execution failed: {query[:200]}"
+                f"{'...' if len(query) > 200 else ''}"
+            )
         elif original_error:
             full_message = f"Query execution failed: {original_error}"
         else:
@@ -546,7 +556,9 @@ def validation_error(
         A configured ValidationError instance.
 
     Example:
-        >>> raise validation_error("Invalid email", field="email", value="not-an-email")
+        >>> raise validation_error(
+        ...     "Invalid email", field="email", value="not-an-email"
+        ... )
     """
     return ValidationError(
         message=message, field=field, value=value, errors=errors

sqlmodel_crud_utils/mixins.py

@@ -23,7 +23,8 @@ class AuditMixin:
 
     Attributes:
         created_at: Timestamp when the record was created (auto-set)
-        updated_at: Timestamp when the record was last updated (auto-set on update)
+        updated_at: Timestamp when the record was last updated
+            (auto-set on update)
         created_by: Optional username/ID of creator
         updated_by: Optional username/ID of last updater
 
@@ -158,11 +159,13 @@ class SoftDeleteMixin:
     def soft_delete(self, user: Optional[str] = None) -> None:
         """Mark this record as deleted.
 
-        Sets the is_deleted flag to True, records the deletion timestamp,
-        and optionally tracks which user performed the deletion.
+        Sets the is_deleted flag to True, records the deletion
+        timestamp, and optionally tracks which user performed the
+        deletion.
 
         Args:
-            user: Optional username or user ID of the person performing the deletion
+            user: Optional username or user ID of the person
+                performing the deletion
 
         Example:
             >>> product.soft_delete(user="admin")

sqlmodel_crud_utils/transactions.py

@@ -18,9 +18,10 @@
 def transaction(session: Session) -> Generator[Session, None, None]:
     """Context manager for synchronous database transactions.
 
-    Automatically commits the transaction on successful completion or rolls back
-    on any exception. The original exception is wrapped in a TransactionError
-    to provide additional context while preserving the exception chain.
+    Automatically commits the transaction on successful completion or
+    rolls back on any exception. The original exception is wrapped in a
+    TransactionError to provide additional context while preserving the
+    exception chain.
 
     Args:
         session: An active SQLModel Session instance
@@ -29,8 +30,9 @@ def transaction(session: Session) -> Generator[Session, None, None]:
         Session: The same session instance for use within the context
 
     Raises:
-        TransactionError: Wraps any exception that occurs during the transaction,
-            with the original exception available via __cause__
+        TransactionError: Wraps any exception that occurs during
+            the transaction, with the original exception available
+            via __cause__
 
     Example:
         Basic usage with automatic commit:
@@ -43,7 +45,9 @@ def transaction(session: Session) -> Generator[Session, None, None]:
         >>> with Session(engine) as session:
         ...     with transaction(session) as tx:
         ...         user = write_row(User(name="Alice"), tx)
-        ...         update_row(user.id, {"email": "alice@example.com"}, User, tx)
+        ...         update_row(
+        ...             user.id, {"email": "alice@example.com"}, User, tx
+        ...         )
         ...         # Automatically commits here if no exceptions
 
         Error handling with automatic rollback:
@@ -93,18 +97,22 @@ async def a_transaction(
 ) -> AsyncGenerator[AsyncSession, None]:
     """Context manager for asynchronous database transactions.
 
-    Asynchronous version of the transaction() context manager. Provides the same
-    automatic commit/rollback behavior for async database operations.
+    Asynchronous version of the transaction() context manager. Provides
+    the same automatic commit/rollback behavior for async database
+    operations.
 
     Args:
-        session: An active AsyncSession instance from sqlmodel.ext.asyncio.session
+        session: An active AsyncSession instance from
+            sqlmodel.ext.asyncio.session
 
     Yields:
-        AsyncSession: The same session instance for use within the async context
+        AsyncSession: The same session instance for use within the
+            async context
 
     Raises:
-        TransactionError: Wraps any exception that occurs during the transaction,
-            with the original exception available via __cause__
+        TransactionError: Wraps any exception that occurs during
+            the transaction, with the original exception available
+            via __cause__
 
     Example:
         Basic async usage with automatic commit:
@@ -117,8 +125,13 @@ async def a_transaction(
         >>> engine = create_async_engine("sqlite+aiosqlite:///database.db")
         >>> async with AsyncSession(engine) as session:
         ...     async with a_transaction(session) as tx:
-        ...         user = await a_write_row(User(name="Alice"), tx)
-        ...         await a_update_row(user.id, {"email": "alice@example.com"}, User, tx)
+        ...         user = await a_write_row(
+        ...             User(name="Alice"), tx
+        ...         )
+        ...         await a_update_row(
+        ...             user.id, {"email": "alice@example.com"},
+        ...             User, tx
+        ...         )
         ...         # Automatically commits here if no exceptions
 
         Error handling with automatic rollback:

tests/test_v0_2_0_features.py

@@ -129,7 +129,9 @@ def test_multiple_records_error_with_count(self):
     def test_multiple_records_error_with_filters(self):
         """Test MultipleRecordsError with filters."""
         filters = {"email": "test@example.com", "active": True}
-        exc = MultipleRecordsError(model=AuditTestModel, count=3, filters=filters)
+        exc = MultipleRecordsError(
+            model=AuditTestModel, count=3, filters=filters
+        )
 
         assert exc.filters == filters
         assert "filters:" in str(exc)
@@ -722,7 +724,11 @@ def test_multiple_soft_deletes(self):
 
         assert model.is_deleted is True
         assert model.deleted_by == "user2"
-        assert second_deleted_at is not None and first_deleted_at is not None and second_deleted_at >= first_deleted_at
+        assert (
+            second_deleted_at is not None
+            and first_deleted_at is not None
+            and second_deleted_at >= first_deleted_at
+        )
 
 
 # ============================================================================