ergon-framework-python 0.1.8__tar.gz → 0.1.9__tar.gz

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.1.8
+Version: 0.1.9
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ergon-framework-python"
-version = "0.1.8"
+version = "0.1.9"
 description = "Ergon internal task-oriented project bootstrapper"
 readme = "README.md"
 license = "MIT"
@@ -47,7 +47,7 @@ dev = [
     "pyright>=1.1.390",
     "pytest>=8.0.0",
     "pytest-asyncio>=0.25.0",
-    "ruff>=0.6.0",
+    "ruff>=0.6.0,<0.16",
 ]
 
 [build-system]

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/src/ergon/__init__.py

@@ -10,4 +10,4 @@ __all__ = [
     "manager",
 ]
 
-__version__ = "0.1.8"
+__version__ = "0.1.9"

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/src/ergon/task/mixins/consumer.py

@@ -601,22 +601,28 @@ class AsyncConsumerMixin(ABC):
     # =====================================================================
     #   FETCH HANDLER (ASYNC)
     # =====================================================================
-    async def _handle_fetch(self, conn, policy: policies.FetchPolicy) -> tuple[bool, List[connector.Transaction]]:
+    async def _handle_fetch(
+        self,
+        conn,
+        policy: policies.FetchPolicy,
+        batch_size: int | None = None,
+    ) -> tuple[bool, List[connector.Transaction]]:
+        fetch_size = policy.batch.size if batch_size is None else batch_size
         self._mark_consumer_progress("fetching")
-        logger.info(f"Fetch handler started for batch size {policy.batch.size}", extra=policy.extra)
+        logger.info(f"Fetch handler started for batch size {fetch_size}", extra=policy.extra)
         fetch_start = time.perf_counter()
         success, result = await helpers.run_fn_async(
-            fn=lambda: conn.fetch_transactions_async(policy.batch.size, **policy.extra),
+            fn=lambda: conn.fetch_transactions_async(fetch_size, **policy.extra),
             retry=policy.retry,
             trace_name=f"{self.__class__.__name__}.fetch_transactions",
-            trace_attrs={"batch_size": policy.batch.size},
+            trace_attrs={"batch_size": fetch_size},
         )
         # Record fetch metrics
         fetched_count = len(result) if success and result else 0
         mixin_metrics.record_consumer_fetch(
             task_name=getattr(self, "name", self.__class__.__name__),
             connector_name=conn.__class__.__name__,
-            batch_size=policy.batch.size,
+            batch_size=fetch_size,
             fetched_count=fetched_count,
             duration=time.perf_counter() - fetch_start,
             success=success,
@@ -877,13 +883,146 @@ class AsyncConsumerMixin(ABC):
                     )
                     return await self._handle_exception(tr, timeout_error, pol.exception.retry)
 
+            async def _consume_continuous():
+                nonlocal batch_number, empty_count, processed
+
+                concurrency = policy.loop.concurrency.value
+                submitted = 0
+                in_flight: set[asyncio.Task] = set()
+
+                async def reap(done: set[asyncio.Task]) -> None:
+                    nonlocal processed
+                    for task in done:
+                        try:
+                            await task
+                        except Exception as exc:
+                            logger.error("[async] Execution error: %s", exc)
+                        finally:
+                            processed += 1
+
+                async def wait_for_completion() -> None:
+                    done, _ = await asyncio.wait(
+                        in_flight,
+                        return_when=asyncio.FIRST_COMPLETED,
+                    )
+                    in_flight.difference_update(done)
+                    await reap(done)
+                    self._mark_consumer_progress("polling")
+
+                try:
+                    while True:
+                        if policy.loop.limit is not None and submitted >= policy.loop.limit:
+                            if in_flight:
+                                await wait_for_completion()
+                                continue
+                            break
+
+                        free_slots = concurrency - len(in_flight)
+                        if free_slots == 0:
+                            await wait_for_completion()
+                            continue
+
+                        if policy.loop.limit is not None:
+                            free_slots = min(free_slots, policy.loop.limit - submitted)
+
+                        logger.debug(
+                            "Fetching transactions for %d free continuous-consumer slot(s) with fetch policy: %s",
+                            free_slots,
+                            policy.fetch.model_dump_json(indent=2),
+                        )
+                        success, result = await self._handle_fetch(
+                            conn,
+                            policy.fetch,
+                            batch_size=free_slots,
+                        )
+
+                        if not success:
+                            logger.error("Fetch failed → %s", result)
+                            # Unlike shutdown/cancellation, a fetch failure must not
+                            # cancel work already in progress: let in-flight
+                            # transactions finish (bounded by the transaction
+                            # runtime timeout) before propagating the failure.
+                            if in_flight:
+                                logger.warning(
+                                    "Fetch failed with %d transaction(s) in flight; draining before raising",
+                                    len(in_flight),
+                                )
+                                await asyncio.gather(*in_flight, return_exceptions=True)
+                                in_flight.clear()
+                            if isinstance(result, (asyncio.TimeoutError, futures.TimeoutError)):
+                                raise exceptions.FetchTimeoutException(str(result))
+                            raise exceptions.FetchException(str(result))
+
+                        transactions = result
+                        if transactions:
+                            empty_count = 0
+                            batch_number += 1
+                            self._mark_consumer_progress("processing")
+                            logger.info(
+                                "%d transaction(s) fetched for continuous processing",
+                                len(transactions),
+                            )
+                            mixin_metrics.record_consumer_batch(
+                                task_name=getattr(self, "name", self.__class__.__name__),
+                                batch_number=batch_number,
+                                batch_size=len(transactions),
+                                streaming=policy.loop.streaming,
+                            )
+                            for transaction in transactions:
+                                in_flight.add(
+                                    asyncio.create_task(
+                                        submit_start_processing(transaction, policy),
+                                    )
+                                )
+                                submitted += 1
+                            continue
+
+                        if in_flight:
+                            await wait_for_completion()
+                            continue
+
+                        self._mark_consumer_progress("idle")
+                        logger.info("Empty fetch detected at %s", datetime.now().isoformat())
+                        if not policy.loop.streaming:
+                            logger.info("Non-streaming mode detected, breaking loop")
+                            break
+
+                        mixin_metrics.record_consumer_empty_queue_wait(
+                            task_name=getattr(self, "name", self.__class__.__name__),
+                            wait_count=empty_count,
+                        )
+                        await utils.backoff_async(
+                            backoff=policy.fetch.empty.backoff,
+                            multiplier=policy.fetch.empty.backoff_multiplier,
+                            cap=policy.fetch.empty.backoff_cap,
+                            attempt=empty_count,
+                        )
+                        empty_count += 1
+                except BaseException:
+                    for task in in_flight:
+                        task.cancel()
+                    if in_flight:
+                        await asyncio.gather(*in_flight, return_exceptions=True)
+                    raise
+
+                elapsed_time = time.perf_counter() - start_time
+                logger.info(
+                    "[Consume continuous] Finished. Processed=%d in %.2f seconds",
+                    processed,
+                    elapsed_time,
+                )
+                return processed
+
+            if policy.loop.mode == "continuous":
+                return await _consume_continuous()
+
             while True:
                 batch_number += 1
 
                 # ============================================================
                 #  FETCH
                 # ============================================================
-                logger.info(f"Fetching transactions batch with fetch policy: {policy.fetch.model_dump_json(indent=2)}")
+                logger.debug(f"Fetching transactions batch with fetch policy: {policy.fetch.model_dump_json(indent=2)}")
                 success, result = await self._handle_fetch(conn, policy.fetch)
 
                 if not success:
@@ -941,7 +1080,7 @@ class AsyncConsumerMixin(ABC):
                 else:
                     batch_context = None  # Use current context
 
-                logger.info(
+                logger.debug(
                     f"Starting batch processing of "
                     f"{len(transactions)} transaction(s) "
                     f"from fetch handler with "

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/src/ergon/task/policies.py

@@ -1,4 +1,4 @@
-from typing import Optional, Union
+from typing import Literal, Optional, Union
 
 from pydantic import BaseModel, Field, field_validator
 
@@ -161,11 +161,20 @@ class ExceptionPolicy(BaseModel):
 
 
 class ConsumerLoopPolicy(BaseModel):
+    mode: Literal["batch", "continuous"] = Field(default="batch")
     concurrency: ConcurrencyPolicy = Field(default_factory=ConcurrencyPolicy)
     timeout: Optional[float] = Field(default=None, ge=0)
     limit: Optional[int] = Field(default=None, ge=0)
     streaming: bool = Field(default=False)
 
+    @field_validator("mode", mode="before")
+    @classmethod
+    def _normalize_mode(cls, v):
+        v = _normalize_optional(v)
+        if v is None:
+            return "batch"
+        return v.strip().lower() if isinstance(v, str) else v
+
     @field_validator("timeout", "limit", mode="before")
     @classmethod
     def _normalize_optional_numbers(cls, v):

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/src/ergon_framework_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.1.8
+Version: 0.1.9
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT

{ergon_framework_python-0.1.8 → ergon_framework_python-0.1.9}/tests/test_smoke.py

@@ -4,4 +4,4 @@ import ergon
 
 
 def test_ergon_package_is_importable() -> None:
-    assert ergon.__version__ == "0.1.8"
+    assert ergon.__version__ == "0.1.9"