edda-framework 0.13.0__py3-none-any.whl → 0.14.0__py3-none-any.whl

edda/channels.py

@@ -129,6 +129,24 @@ class WaitForTimerException(Exception):
         super().__init__(f"Waiting for timer: {timer_id}")
 
 
+class ChannelModeConflictError(Exception):
+    """
+    Raised when subscribing with a different mode than the channel's established mode.
+
+    A channel's mode is locked when the first subscription is created. Subsequent
+    subscriptions must use the same mode.
+    """
+
+    def __init__(self, channel: str, existing_mode: str, requested_mode: str) -> None:
+        self.channel = channel
+        self.existing_mode = existing_mode
+        self.requested_mode = requested_mode
+        super().__init__(
+            f"Channel '{channel}' is already configured as '{existing_mode}' mode. "
+            f"Cannot subscribe with '{requested_mode}' mode."
+        )
+
+
 # =============================================================================
 # Subscription Functions
 # =============================================================================
@@ -150,6 +168,10 @@ async def subscribe(
               - "competing": Each message goes to only one subscriber (work queue pattern)
               - "direct": Receive messages sent via send_to() to this instance
 
+    Raises:
+        ChannelModeConflictError: If the channel is already configured with a different mode
+        ValueError: If mode is not 'broadcast', 'competing', or 'direct'
+
     The "direct" mode is syntactic sugar that subscribes to "channel:instance_id" internally,
     allowing simpler code when receiving direct messages:
 
@@ -204,6 +226,11 @@ async def subscribe(
             f"Invalid subscription mode: {mode}. Must be 'broadcast', 'competing', or 'direct'"
         )
 
+    # Check for mode conflict
+    existing_mode = await ctx.storage.get_channel_mode(actual_channel)
+    if existing_mode is not None and existing_mode != actual_mode:
+        raise ChannelModeConflictError(channel, existing_mode, mode)
+
     await ctx.storage.subscribe_to_channel(ctx.instance_id, actual_channel, actual_mode)
 
 

edda/storage/protocol.py

@@ -990,6 +990,18 @@ class StorageProtocol(Protocol):
         """
         ...
 
+    async def get_channel_mode(self, channel: str) -> str | None:
+        """
+        Get the mode for a channel (from any existing subscription).
+
+        Args:
+            channel: Channel name
+
+        Returns:
+            The mode ('broadcast' or 'competing') or None if no subscriptions exist
+        """
+        ...
+
     async def register_channel_receive_and_release_lock(
         self,
         instance_id: str,

edda/storage/sqlalchemy_storage.py

@@ -3170,6 +3170,26 @@ class SQLAlchemyStorage:
                 "cursor_message_id": subscription.cursor_message_id,
             }
 
+    async def get_channel_mode(self, channel: str) -> str | None:
+        """
+        Get the mode for a channel (from any existing subscription).
+
+        Args:
+            channel: Channel name
+
+        Returns:
+            The mode ('broadcast' or 'competing') or None if no subscriptions exist
+        """
+        session = self._get_session_for_operation()
+        async with self._session_scope(session) as session:
+            result = await session.execute(
+                select(ChannelSubscription.mode)
+                .where(ChannelSubscription.channel == channel)
+                .limit(1)
+            )
+            row = result.scalar_one_or_none()
+            return row
+
     async def register_channel_receive_and_release_lock(
         self,
         instance_id: str,

{edda_framework-0.13.0.dist-info → edda_framework-0.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edda-framework
-Version: 0.13.0
+Version: 0.14.0
 Summary: Lightweight Durable Execution Framework
 Project-URL: Homepage, https://github.com/i2y/edda
 Project-URL: Documentation, https://github.com/i2y/edda#readme

{edda_framework-0.13.0.dist-info → edda_framework-0.14.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 edda/__init__.py,sha256=hGC6WR2R36M8LWC97F-0Rw4Ln0QUUT_1xC-7acOy_Fk,2237
 edda/activity.py,sha256=nRm9eBrr0lFe4ZRQ2whyZ6mo5xd171ITIVhqytUhOpw,21025
 edda/app.py,sha256=ITTc7x5S4ykCP3KPZXKxuNczXkPtbn04ZQaxcem46Hw,68406
-edda/channels.py,sha256=CosFoB9HVHBKRmhU_t6qoCV3l6egAGt3sqpakfgZLKc,36596
+edda/channels.py,sha256=6JFZkeOs0xDumexr0_bLI_Mb4S245hLJM_Sqp3xPCCA,37676
 edda/compensation.py,sha256=iKLlnTxiF1YSatmYQW84EkPB1yMKUEZBtgjuGnghLtY,11824
 edda/context.py,sha256=Qqm_nUC5NNnOfHAb7taqKqZVIc0GoRWUrjZ4L9_-q70,22128
 edda/exceptions.py,sha256=-ntBLGpVQgPFG5N1o8m_7weejAYkNrUdxTkOP38vsHk,1766
@@ -34,8 +34,8 @@ edda/storage/migrations.py,sha256=KrceouVODct9WWDBhmjAW0IYptDWd2mqJmhrHnee59M,13
 edda/storage/models.py,sha256=axXGJ-Orwcd_AsEUwIyFfDyg3NQxMcOQ2mrTzXkNv3g,12284
 edda/storage/notify_base.py,sha256=gUb-ypG1Bo0c-KrleYmC7eKtdwQNUeqGS5k7UILlSsQ,5055
 edda/storage/pg_notify.py,sha256=myzJ9xX86uiro9aaiA1SW1sN3E-zYafn7_lpeAy1jOg,11830
-edda/storage/protocol.py,sha256=vdB5GvBen8lgUA0qEfBXfQTLbVfGKeBTQuEwSUqLZtI,39463
-edda/storage/sqlalchemy_storage.py,sha256=HREK7fHmq3DGx6w4jA03_NrQu9HbyMomyIawMuOQLYQ,146246
+edda/storage/protocol.py,sha256=tLUbD7SQ71oJVaTKfeh5HG1hvuLfaxoqC-a8m-iF0LY,39786
+edda/storage/sqlalchemy_storage.py,sha256=UQmq3C_iC2j3N7q2V0kPcbtdwnFHAtyYWd9NBHVWsWQ,146934
 edda/viewer_ui/__init__.py,sha256=N1-T33SXadOXcBsDSgJJ9Iqz4y4verJngWryQu70c5c,517
 edda/viewer_ui/app.py,sha256=xZdIIGX5D2efNWQSVpPdldxLukHHpJD7JiAa_YKG5Uw,97084
 edda/viewer_ui/components.py,sha256=A0IxLwgj_Lu51O57OfzOwME8jzoJtKegEVvSnWc7uPo,45174
@@ -47,8 +47,8 @@ edda/visualizer/mermaid_generator.py,sha256=XWa2egoOTNDfJEjPcwoxwQmblUqXf7YInWFj
 edda/migrations/mysql/20251217000000_initial_schema.sql,sha256=LpINasESRhadOeqABwDk4JZ0OZ4_zQw_opnhIR4Xe9U,12367
 edda/migrations/postgresql/20251217000000_initial_schema.sql,sha256=hCaGMWeptpzpnsjfNKVsMYuwPRe__fK9E0VZpClAumQ,11732
 edda/migrations/sqlite/20251217000000_initial_schema.sql,sha256=Wq9gCnQ0K9SOt0PY_8f1MG4va8rLVWIIcf2lnRzSK5g,11906
-edda_framework-0.13.0.dist-info/METADATA,sha256=K-ar-0liixJ38d34eDvPGYPyWxUSKjgsQ_xwZPCbZ2A,37567
-edda_framework-0.13.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-edda_framework-0.13.0.dist-info/entry_points.txt,sha256=dPH47s6UoJgUZxHoeSMqZsQkLaSE-SGLi-gh88k2WrU,48
-edda_framework-0.13.0.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
-edda_framework-0.13.0.dist-info/RECORD,,
+edda_framework-0.14.0.dist-info/METADATA,sha256=FbHEPrrr0THCfzFccY0_NJyCPuGArsxK6AKVrmTUKjQ,37567
+edda_framework-0.14.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+edda_framework-0.14.0.dist-info/entry_points.txt,sha256=dPH47s6UoJgUZxHoeSMqZsQkLaSE-SGLi-gh88k2WrU,48
+edda_framework-0.14.0.dist-info/licenses/LICENSE,sha256=udxb-V7_cYKTHqW7lNm48rxJ-Zpf0WAY_PyGDK9BPCo,1069
+edda_framework-0.14.0.dist-info/RECORD,,