Raise custom OutOfContextError when working outside domain context

src/protean/adapters/repository/sqlalchemy.py

@@ -18,7 +18,11 @@
 from sqlalchemy.types import CHAR, TypeDecorator
 
 from protean.core.model import BaseModel
-from protean.exceptions import ConfigurationError, ObjectNotFoundError
+from protean.exceptions import (
+    ConfigurationError,
+    ObjectNotFoundError,
+    OutOfContextError,
+)
 from protean.fields import (
     Auto,
     Boolean,
@@ -101,8 +105,9 @@ def _get_identity_type():
             raise ConfigurationError(
                 f'Unknown Identity Type {current_domain.config["IDENTITY_TYPE"]}'
             )
-    except RuntimeError as exc:
-        logger.error(f"RuntimeError while identifying data type for identities: {exc}")
+    except OutOfContextError:
+        # This happens only when the module is being imported the first time.
+        #   All further calls will have `current_domain` available.
         return sa_types.String
 
 

src/protean/exceptions.py

@@ -101,3 +101,7 @@ class SendError(Exception):
 
 class ExpectedVersionError(Exception):
     """Raised on expected version conflicts in EventSourcing"""
+
+
+class OutOfContextError(RuntimeError):
+    """Raised when current_domain global is accessed without an active context"""

src/protean/globals.py

@@ -9,6 +9,8 @@
 
 from werkzeug.local import LocalProxy, LocalStack
 
+from protean.exceptions import OutOfContextError
+
 _domain_ctx_err_msg = """\
 Working outside of domain context.
 This typically means that you attempted to use functionality that needed
@@ -21,14 +23,14 @@
 def _lookup_domain_object(name) -> Any:
     top = _domain_context_stack.top
     if top is None:
-        raise RuntimeError(_domain_ctx_err_msg)
+        raise OutOfContextError(_domain_ctx_err_msg)
     return getattr(top, name)
 
 
 def _find_domain() -> Domain:
     top = _domain_context_stack.top
     if top is None:
-        raise RuntimeError(_domain_ctx_err_msg)
+        raise OutOfContextError(_domain_ctx_err_msg)
     return top.domain