refactor: improve exception handling and update dependencies

- Use BaseException instead of Exception for comprehensive error handling
- Change all enum values to uppercase
- Update dependencies to latest versions

Author: HosseinNejatiJavaremi

archipy/adapters/starrocks/sqlalchemy/session_managers.py

@@ -208,9 +208,7 @@ def _get_connect_args(self) -> dict:
         """Return connection arguments for async StarRocks to ensure proper transaction support.
 
         StarRocks (using MySQL protocol) requires autocommit to be explicitly disabled
-        to ensure transactions work properly with rollback support.
-
-        Returns:
+        to ensure transactions work properly with rollback support.        Returns:
             A dictionary with autocommit=False to ensure transaction support.
         """
         return {"autocommit": False}

archipy/helpers/decorators/sqlalchemy_atomic.py

@@ -54,11 +54,11 @@
 R = TypeVar("R")
 
 
-def _handle_db_exception(exception: Exception, db_type: str, func_name: str) -> None:
+def _handle_db_exception(exception: BaseException, db_type: str, func_name: str) -> None:
     """Handle database exceptions and raise appropriate errors.
 
     Args:
-        exception (Exception): The exception to handle.
+        exception (BaseException): The exception to handle.
         db_type (str): The database type ("postgres", "sqlite", or "starrocks").
         func_name (str): The name of the function being executed.
 
@@ -243,7 +243,7 @@ async def async_wrapper(*args: Any, **kwargs: Any) -> R:
                         async with session.begin():
                             result = await func(*args, **kwargs)
                             return result
-                except Exception as exception:
+                except BaseException as exception:
                     await session.rollback()
                     func_name = getattr(func, "__name__", "unknown")
                     _handle_db_exception(exception, db_type, func_name)
@@ -291,7 +291,7 @@ def sync_wrapper(*args: Any, **kwargs: Any) -> R:
                     else:
                         with session.begin():
                             return func(*args, **kwargs)
-                except Exception as exception:
+                except BaseException as exception:
                     session.rollback()
                     func_name = getattr(func, "__name__", "unknown")
                     _handle_db_exception(exception, db_type, func_name)

archipy/models/types/base_types.py

@@ -48,18 +48,18 @@ class FilterOperationType(Enum):
         IS_NOT_NULL (str): Represents a check if a value is not null.
     """
 
-    EQUAL = "equal"
-    NOT_EQUAL = "not_equal"
-    LESS_THAN = "less_than"
-    LESS_THAN_OR_EQUAL = "less_than_or_equal"
-    GREATER_THAN = "greater_than"
-    GREATER_THAN_OR_EQUAL = "greater_than_or_equal"
-    IN_LIST = "in_list"
-    NOT_IN_LIST = "not_in_list"
-    LIKE = "like"
-    ILIKE = "ilike"
-    STARTS_WITH = "starts_with"
-    ENDS_WITH = "ends_with"
-    CONTAINS = "contains"
-    IS_NULL = "is_null"
-    IS_NOT_NULL = "is_not_null"
+    EQUAL = "EQUAL"
+    NOT_EQUAL = "NOT_EQUAL"
+    LESS_THAN = "LESS_THAN"
+    LESS_THAN_OR_EQUAL = "LESS_THAN_OR_EQUAL"
+    GREATER_THAN = "GREATER_THAN"
+    GREATER_THAN_OR_EQUAL = "GREATER_THAN_OR_EQUAL"
+    IN_LIST = "IN_LIST"
+    NOT_IN_LIST = "NOT_IN_LIST"
+    LIKE = "LIKE"
+    ILIKE = "ILIKE"
+    STARTS_WITH = "STARTS_WITH"
+    ENDS_WITH = "ENDS_WITH"
+    CONTAINS = "CONTAINS"
+    IS_NULL = "IS_NULL"
+    IS_NOT_NULL = "IS_NOT_NULL"

archipy/models/types/email_types.py

@@ -31,5 +31,5 @@ class EmailAttachmentDispositionType(StrEnum):
         INLINE (str): Represents an attachment that should be displayed inline.
     """
 
-    ATTACHMENT = "attachment"
-    INLINE = "inline"
+    ATTACHMENT = "ATTACHMENT"
+    INLINE = "INLINE"

archipy/models/types/sort_order_type.py

@@ -12,5 +12,5 @@ class SortOrderType(Enum):
         DESCENDING (str): Represents sorting in descending order.
     """
 
-    ASCENDING = "ascending"
-    DESCENDING = "descending"
+    ASCENDING = "ASCENDING"
+    DESCENDING = "DESCENDING"

archipy/models/types/time_interval_unit_type.py

@@ -10,10 +10,10 @@ class TimeIntervalUnitType(str, Enum):
     seamless integration with string-based APIs or databases.
     """
 
-    SECONDS = "seconds"
-    MINUTES = "minutes"
-    HOURS = "hours"
-    DAYS = "days"
-    WEEKS = "weeks"
-    MONTHS = "months"
-    YEAR = "year"
+    SECONDS = "SECONDS"
+    MINUTES = "MINUTES"
+    HOURS = "HOURS"
+    DAYS = "DAYS"
+    WEEKS = "WEEKS"
+    MONTHS = "MONTHS"
+    YEAR = "YEAR"

docs/changelog.md

@@ -2,6 +2,55 @@
 
 All notable changes to ArchiPy are documented in this changelog, organized by version.
 
+## [v4.0.4] - 2026-01-31
+
+### Changed
+
+#### Helpers - Decorators
+
+- **Enhanced Exception Handling** - Improved exception handling in SQLAlchemy atomic decorators
+  - Changed exception handling from `Exception` to `BaseException` for comprehensive error catching
+  - Updated `_handle_db_exception()` function signature to accept `BaseException` instead of `Exception`
+  - Enhanced error handling in both sync and async atomic decorator implementations
+  - Ensures all exceptions (including system exceptions) are properly caught and handled
+
+#### Models - Types
+
+- **Enum Value Standardization** - Standardized all enum values to uppercase format for consistency
+  - **SortOrderType**: Changed `ASCENDING` and `DESCENDING` from lowercase to uppercase
+  - **FilterOperationType**: Changed all 15 operation types to uppercase (EQUAL, NOT_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, IN_LIST, NOT_IN_LIST, LIKE, ILIKE, STARTS_WITH, ENDS_WITH, CONTAINS, IS_NULL, IS_NOT_NULL)
+  - **EmailAttachmentDispositionType**: Changed `ATTACHMENT` and `INLINE` from lowercase to uppercase
+  - **TimeIntervalUnitType**: Changed all 7 unit types to uppercase (SECONDS, MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEAR)
+  - Improved consistency with other enum patterns in the codebase
+  - Enhanced code readability and standardization across all type definitions
+
+### Fixed
+
+#### Adapters - StarRocks
+
+- **Docstring Formatting** - Fixed docstring formatting in StarRocks session manager
+  - Corrected docstring formatting in `get_connection_args()` method
+  - Improved code documentation consistency
+
+### Chore
+
+#### Dependencies
+
+- **Comprehensive Dependency Updates** - Updated multiple dependencies to latest versions
+  - Updated `cachetools` from `>=6.2.4` to `>=6.2.6` (cache, keycloak, minio, scylladb extras)
+  - Updated `cryptography` from `46.0.3` to `46.0.4` for enhanced security
+  - Updated `protobuf` from `>=6.33.4` to `>=6.33.5` (grpc extra)
+  - Updated `pyjwt` from `>=2.10.1` to `>=2.11.0` (jwt extra)
+  - Updated `python-keycloak` from `>=7.0.2` to `>=7.0.3` (keycloak extra)
+  - Updated `python-multipart` from `0.0.21` to `0.0.22`
+  - Updated `rich` from `14.3.0` to `14.3.1`
+  - Updated `rich-toolkit` from `0.17.1` to `0.17.2`
+  - Updated `sentry-sdk` from `>=2.50.0` to `>=2.51.0` (sentry extra)
+  - Updated `ty` from `>=0.0.13` to `>=0.0.14` (dev dependency)
+  - Updated `mkdocstrings` from `>=1.0.1` to `>=1.0.2` (docs dependency)
+  - Updated `pathspec` from `1.0.3` to `1.0.4`
+  - Updated `orjson` from `3.11.5` to `3.11.6`
+
 ## [v4.0.3] - 2026-01-24
 
 ### Added

pyproject.toml

@@ -20,26 +20,26 @@ license = { file = "LICENSE" }
 # Core optional dependencies
 aiosqlite = ["aiosqlite>=0.22.1"]
 behave = ["behave>=1.3.3"]
-cache = ["cachetools>=6.2.4", "async-lru>=2.1.0"]
+cache = ["cachetools>=6.2.6", "async-lru>=2.1.0"]
 dependency-injection = ["dependency-injector>=4.48.3"]
 elastic-apm = ["elastic-apm>=6.25.0"]
 elasticsearch = ["elasticsearch>=9.2.1"]
 elasticsearch-async = ["elasticsearch[async]>=9.2.1"]
 fakeredis = ["fakeredis>=2.33.0"]
 fastapi = ["fastapi[all]>=0.128.0"]
-grpc = ["grpcio>=1.76.0", "grpcio-health-checking>=1.76.0", "protobuf>=6.33.4"]
-jwt = ["pyjwt>=2.10.1"]
+grpc = ["grpcio>=1.76.0", "grpcio-health-checking>=1.76.0", "protobuf>=6.33.5"]
+jwt = ["pyjwt>=2.11.0"]
 kafka = ["confluent-kafka>=2.13.0"]
 kavenegar = ["kavenegar>=1.1.2"]
-keycloak = ["python-keycloak>=7.0.2", "cachetools>=6.2.4", "async-lru>=2.1.0"]
-minio = ["minio>=7.2.20", "cachetools>=6.2.4", "async-lru>=2.1.0"]
+keycloak = ["python-keycloak>=7.0.3", "cachetools>=6.2.6", "async-lru>=2.1.0"]
+minio = ["minio>=7.2.20", "cachetools>=6.2.6", "async-lru>=2.1.0"]
 parsian-ipg = ["zeep>=4.3.2", "requests[socks]>=2.32.5"]
 postgres = ["psycopg[binary,pool]>=3.3.2"]
 prometheus = ["prometheus-client>=0.24.1"]
 redis = ["redis[hiredis]>=7.1.0"]
 scheduler = ["apscheduler>=3.11.2"]
-scylladb = ["scylla-driver>=3.29.7", "lz4>=4.4.5", "cachetools>=6.2.4", "async-lru>=2.1.0"]
-sentry = ["sentry-sdk>=2.50.0"]
+scylladb = ["scylla-driver>=3.29.7", "lz4>=4.4.5", "cachetools>=6.2.6", "async-lru>=2.1.0"]
+sentry = ["sentry-sdk>=2.51.0"]
 sqlalchemy = ["sqlalchemy>=2.0.46"]
 sqlalchemy-async = ["sqlalchemy[asyncio]>=2.0.46"]
 starrocks = ["starrocks>=1.3.3", "pymysql>=1.1.2"]
@@ -68,7 +68,7 @@ dev = [
     "add-trailing-comma>=4.0.0",
     "bandit>=1.9.3",
     "codespell>=2.4.1",
-    "ty>=0.0.13",
+    "ty>=0.0.14",
     "pre-commit-hooks>=6.0.0",
     "pre-commit>=4.5.1",
     "ruff>=0.14.14",
@@ -86,7 +86,7 @@ docs = [
     "mkdocs-material>=9.7.1",
     "mkdocs>=1.6.1",
     "mkdocstrings-python>=2.0.1",
-    "mkdocstrings>=1.0.1",
+    "mkdocstrings>=1.0.2",
     "pymdown-extensions>=10.20.1",
 ]