ergon-framework-python 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

ergon/task/mixins/consumer.py

@@ -103,7 +103,7 @@ class ConsumerMixin(ABC):
             # -----------------------
             # 1) PROCESS STEP
             # -----------------------
-            logger.info(f"Transaction {transaction.id} processing started")
+            logger.debug("Transaction %s processing started", transaction.id)
             process_ok, process_result = self._handle_process(transaction, policy.process.retry)
 
             # -----------------------
@@ -195,7 +195,7 @@ class ConsumerMixin(ABC):
     # PROCESS HANDLER
     # =====================================================================
     def _handle_process(self, transaction, retry: policies.RetryPolicy):
-        logger.info(f"Transaction {transaction.id} process handler started")
+        logger.debug("Transaction %s process handler started", transaction.id)
         stage_start = time.perf_counter()
         success, result = helpers.run_fn(
             fn=lambda: self.process_transaction(transaction),
@@ -210,8 +210,10 @@ class ConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} process handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s process handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, result
 
@@ -219,7 +221,7 @@ class ConsumerMixin(ABC):
     # SUCCESS HANDLER
     # =====================================================================
     def _handle_success(self, transaction, result, retry: policies.RetryPolicy):
-        logger.info(f"Transaction {transaction.id} success handler started")
+        logger.debug("Transaction %s success handler started", transaction.id)
         stage_start = time.perf_counter()
         success, handler_result = helpers.run_fn(
             fn=lambda: self.handle_process_success(transaction, result),
@@ -234,8 +236,10 @@ class ConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} success handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s success handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, handler_result
 
@@ -243,7 +247,7 @@ class ConsumerMixin(ABC):
     # EXCEPTION HANDLER
     # =====================================================================
     def _handle_exception(self, transaction, exc, retry: policies.RetryPolicy):
-        logger.error(f"Transaction {transaction.id} exception handler started")
+        logger.debug("Transaction %s exception handler started", transaction.id)
         stage_start = time.perf_counter()
         success, result = helpers.run_fn(
             fn=lambda: self.handle_process_exception(transaction, exc),
@@ -258,8 +262,10 @@ class ConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} exception handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s exception handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, result
 
@@ -337,7 +343,7 @@ class ConsumerMixin(ABC):
                 # -------------------------
                 # 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 = self._handle_fetch(conn, policy.fetch)
                 if not success:
                     logger.error(f"Fetch failed → {result}")
@@ -645,7 +651,7 @@ class AsyncConsumerMixin(ABC):
             # -----------------------
             # 1) PROCESS STEP
             # -----------------------
-            logger.info(f"Transaction {transaction.id} processing started")
+            logger.debug("Transaction %s processing started", transaction.id)
             process_ok, process_result = await self._handle_process(transaction, policy.process.retry)
 
             # -----------------------
@@ -735,7 +741,7 @@ class AsyncConsumerMixin(ABC):
     #   PROCESS HANDLER WITH RETRIES
     # =====================================================================
     async def _handle_process(self, transaction, retry: policies.RetryPolicy):
-        logger.info(f"Transaction {transaction.id} process handler started")
+        logger.debug("Transaction %s process handler started", transaction.id)
         stage_start = time.perf_counter()
         success, result = await helpers.run_fn_async(
             fn=lambda: self.process_transaction(transaction),
@@ -750,8 +756,10 @@ class AsyncConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} process handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s process handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, result
 
@@ -759,7 +767,7 @@ class AsyncConsumerMixin(ABC):
     #   SUCCESS HANDLER
     # =====================================================================
     async def _handle_success(self, transaction, result, retry: policies.RetryPolicy):
-        logger.info(f"Transaction {transaction.id} success handler started")
+        logger.debug("Transaction %s success handler started", transaction.id)
         stage_start = time.perf_counter()
         success, handler_result = await helpers.run_fn_async(
             fn=lambda: self.handle_process_success(transaction, result),
@@ -774,8 +782,10 @@ class AsyncConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} success handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s success handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, handler_result
 
@@ -783,7 +793,7 @@ class AsyncConsumerMixin(ABC):
     #   EXCEPTION HANDLER
     # =====================================================================
     async def _handle_exception(self, transaction, exc, retry: policies.RetryPolicy):
-        logger.error(f"Transaction {transaction.id} exception handler started")
+        logger.debug("Transaction %s exception handler started", transaction.id)
         stage_start = time.perf_counter()
         success, result = await helpers.run_fn_async(
             fn=lambda: self.handle_process_exception(transaction, exc),
@@ -798,8 +808,10 @@ class AsyncConsumerMixin(ABC):
             duration=time.perf_counter() - stage_start,
             outcome="ok" if success else "error",
         )
-        logger.info(
-            f"Transaction {transaction.id} exception handler completed with status: {'success' if success else 'error'}"
+        logger.debug(
+            "Transaction %s exception handler completed with status: %s",
+            transaction.id,
+            "success" if success else "error",
         )
         return success, result
 
@@ -869,7 +881,7 @@ class AsyncConsumerMixin(ABC):
                             trace_name=f"{self.__class__.__name__}.start_processing",
                             trace_attrs={"transaction_id": tr.id},
                         )
-                except TimeoutError as exc:
+                except asyncio.TimeoutError as exc:
                     timeout_error = exceptions.TransactionTimeoutException(
                         transaction_id=tr.id,
                         cause=exc,

{ergon_framework_python-0.2.2.dist-info → ergon_framework_python-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.2.2
+Version: 0.2.4
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT
@@ -31,6 +31,7 @@ Requires-Dist: asyncpg>=0.29.0; extra == "all"
 Requires-Dist: boto3>=1.35.0; extra == "all"
 Requires-Dist: ergon-platform-sdk>=0.2.0; extra == "all"
 Requires-Dist: httpx>=0.28.0; extra == "all"
+Requires-Dist: msal>=1.37.0; extra == "all"
 Requires-Dist: nylas>=6.0.0; extra == "all"
 Requires-Dist: openpyxl>=3.1.5; extra == "all"
 Requires-Dist: pika>=1.3.0; extra == "all"
@@ -42,6 +43,9 @@ Provides-Extra: excel
 Requires-Dist: openpyxl>=3.1.5; extra == "excel"
 Provides-Extra: nylas
 Requires-Dist: nylas>=6.0.0; extra == "nylas"
+Provides-Extra: outlook
+Requires-Dist: msal>=1.37.0; extra == "outlook"
+Requires-Dist: requests>=2.32.5; extra == "outlook"
 Provides-Extra: pipefy
 Requires-Dist: httpx>=0.28.0; extra == "pipefy"
 Requires-Dist: requests>=2.32.5; extra == "pipefy"
@@ -77,13 +81,53 @@ pull in client libraries that your application does not use:
 ```bash
 pip install 'ergon-framework-python[rabbitmq]'
 pip install 'ergon-framework-python[sqs,postgres]'
+pip install 'ergon-framework-python[outlook]'
 pip install 'ergon-framework-python[all]'
 ```
 
 Available extras are `rabbitmq`, `sqs`, `postgres`, `pipefy`, `excel`,
-`ergon-platform`, and `nylas`.
+`ergon-platform`, `nylas`, and `outlook`.
 
-For local development, install in editable mode:
+### Outlook / Microsoft Graph
+
+```bash
+pip install 'ergon-framework-python[outlook]'
+```
+
+The Outlook connector talks to Microsoft Graph with Entra **application**
+credentials. Consuming messages and attachments needs `Mail.Read`; marking,
+categorizing, moving, and deleting need `Mail.ReadWrite`; send, reply, and
+forward need `Mail.Send`. Graph `$filter` and `$search` cannot be combined.
+
+```python
+from ergon.connector.outlook import (
+    AsyncOutlookGraphConnector,
+    OutlookAckActionConfig,
+    OutlookConsumerConfig,
+    OutlookGraphClient,
+    OutlookMessageFilter,
+)
+
+client = OutlookGraphClient(
+    tenant_id="...",
+    client_id="...",
+    client_secret="...",
+    user_email="mailbox@example.com",
+)
+consumer = OutlookConsumerConfig(
+    folder_id="Inbox",
+    filter=OutlookMessageFilter(unread_only=True, has_attachments=True),
+    download_attachments=True,
+    ack_config=OutlookAckActionConfig(mark_as_read=True),
+)
+```
+
+Runnable example: [examples/outlook](https://github.com/danzanellovossos/ergon-framework/tree/main/sdks/python/examples/outlook).
+Module reference: [Outlook connector README](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/src/ergon/connector/outlook/README.md).
+
+### Local development
+
+Install in editable mode:
 
 ```bash
 pip install -e /path/to/ergon-framework/sdks/python

{ergon_framework_python-0.2.2.dist-info → ergon_framework_python-0.2.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ergon/__init__.py,sha256=o88UpQYh3RcjogyA8PsDjekDAK6Xfth93UCFdDWixyo,218
+ergon/__init__.py,sha256=YxjNiBz68BV9DIN53Yy5zCKMVcca7VJk8A_8_Z184M4,218
 ergon/cli.py,sha256=CF8PvOjIguR18a657aEBEyhFXUoSVtSRVXv5PfnuWtA,6021
 ergon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ergon/bootstrap/src/__project__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -22,7 +22,7 @@ ergon/bootstrap/src/__project__/tasks/example_task/exceptions.py,sha256=LTWwquhM
 ergon/bootstrap/src/__project__/tasks/example_task/helpers.py,sha256=uR_XZEtxR6JzbJloi7OhJb77f7Wc6pnOe1W3CHvl8vE,122
 ergon/bootstrap/src/__project__/tasks/example_task/schemas.py,sha256=3_qANKlJIQ90gaRNrDuBAM42UNzfDbLI4-F0kkjjWHc,155
 ergon/bootstrap/src/__project__/tasks/example_task/task.py,sha256=XnmVg-B0N8Ld48FMLJgGfTTJLjmpy5Nog_Gaj1ruVEQ,36
-ergon/connector/__init__.py,sha256=qBgpM6yArVb-ns7l09RN6hYU84Rxx1_3aD4ZZiCFTRE,6648
+ergon/connector/__init__.py,sha256=zqKuXsx1nO7Dh2-Dei-GjRo2pre__PwmSUq9JpW2s-w,8396
 ergon/connector/_lazy.py,sha256=ANsKY3JTtmVo8Z8p3ey3LwkQGVVYITKO1eEK66IvA3U,1690
 ergon/connector/connector.py,sha256=jaF1iXKALE1IHHfcP54mTD5mvj-wzk5iNaLo96IOcDI,3944
 ergon/connector/transaction.py,sha256=LMGEFfisdjGGCPrWps3nYJ-SRBKa-P2pOFmwbSgDN-E,291
@@ -63,6 +63,13 @@ ergon/connector/nylas/connector.py,sha256=4mIRdaQ6YH6j1gt4htAVeXVoKvZMYses6M3d2G
 ergon/connector/nylas/models.py,sha256=dqPG5xhM5ZBFKN1hPW0US7lDztSaV-CZwwIherrdDkA,10230
 ergon/connector/nylas/service.py,sha256=kj0zY0cvBWkqlne_gZyw4fFDDiIJ5ACB4PX7vYksE3Q,11525
 ergon/connector/nylas/utils.py,sha256=jP-_hslfSWQgS4Sh5FPOKKLnX-n68m38mkuHOcRVaFk,4715
+ergon/connector/outlook/__init__.py,sha256=lYLgvXtKTv-jxMyJaeGhd6MO_FWnd0N-1nxRGOmXLXs,1737
+ergon/connector/outlook/async_connector.py,sha256=aV60SXsFM9rDmbNItdnvpTNYqFy0iqqbvaxXfO9sOGM,7545
+ergon/connector/outlook/async_service.py,sha256=uC3ldsS8d-yN5inY6qA5-NOyWRaeAc3mxcX-hFslz6M,5618
+ergon/connector/outlook/connector.py,sha256=jX8kGV6glQ1z5cF9Spg5V1fXlYHaslcT7Q9xpuWEJlE,7190
+ergon/connector/outlook/models.py,sha256=zIww_QBqSSnkWv3c13pdtMr97-LwQZn1S4eD5OWXRS0,11219
+ergon/connector/outlook/service.py,sha256=TdkTroNeQxZ-Sh5mcETRFkqb3OGEZuAKJtQfXCcgTNk,15695
+ergon/connector/outlook/utils.py,sha256=--IXPNJAG-Bxe4ATFaT0aAKMznMazAOlMpjRMke3KMQ,4102
 ergon/connector/pipefy/__init__.py,sha256=FI9OfHDa_914NC2s-SMjNYwZj6tpgBve7TER9SE9zo4,1119
 ergon/connector/pipefy/async_connector.py,sha256=Ls4fRcTD21gWbeSj32WpSID6b5ZYTNBjWN7kNw-9Ey0,1739
 ergon/connector/pipefy/async_service.py,sha256=Kpd-LVTet3Ve6z85pUWZ2uUWFpgTaF74znbKFzmXAMA,26298
@@ -76,7 +83,7 @@ ergon/connector/postgres/async_service.py,sha256=PdPnNElMKzLoov1as3Kcb_viuSyBaVE
 ergon/connector/postgres/models.py,sha256=DL9wBdZ6QZPH1iVft71cTabnFUCH1Hg1RmG5f5E8578,1749
 ergon/connector/rabbitmq/__init__.py,sha256=R0VuHRuKRbshm7drw7p3vi2Az6e8PjIsvT-JTtRwxxo,1478
 ergon/connector/rabbitmq/async_connector.py,sha256=1ltA8wGcB91Sxq6xJcX0OeOTRd6co4cpq5drG-6gHAc,5175
-ergon/connector/rabbitmq/async_service.py,sha256=g9WQXYMszkJsQwwp7AVHWUf7CDKwQjOCbqoVaKOQYaI,33048
+ergon/connector/rabbitmq/async_service.py,sha256=1nY-Bt9qEno1H4ycB31nG3USUFBoKjOcu6BRt8VEVLM,35157
 ergon/connector/rabbitmq/connector.py,sha256=vsSzbVuuE8rKkwBfPgD97qTsqADxJGALnUvrEwZIL5Q,1633
 ergon/connector/rabbitmq/helper.py,sha256=xlQGx2SGR2DC1fi-5BMlCOvWydWEFkcN7fPJjlNvGLA,372
 ergon/connector/rabbitmq/models.py,sha256=Q8tFPdRuvSxVe70HlTBRY66DdrC7kXuSCbRjtPSSq6k,9910
@@ -99,7 +106,7 @@ ergon/task/policies.py,sha256=3x1SV-yt3FXNgmnATdQdpRtsDtlskjx582SpbC6UH6A,7358
 ergon/task/runner.py,sha256=xUaMSO6V_iOq6QJdiyW1IA5kfWuwQjh1IJl6HUh06hY,20344
 ergon/task/utils.py,sha256=OmlP2AhLM32V8O9OMky6DdSvxwmMNn9x2LTguf0y-M0,2501
 ergon/task/mixins/__init__.py,sha256=6A8vNgdjaQYNJvymWNF-kBN2oTaQBYRLctS3Sq1w_-Y,320
-ergon/task/mixins/consumer.py,sha256=DhN2qBtNtB6xdKEdCokw1Z5ic2W8QfoUCm1QH_YPIFA,52270
+ergon/task/mixins/consumer.py,sha256=LrCSbekQos5GU0xIY3F5_jUd69L09JV6FY_hMy2eol4,52467
 ergon/task/mixins/metrics.py,sha256=4bavwo8koWiN5ADD8t5qd2BVeVcgxo6ddzq-xOybeTg,13159
 ergon/task/mixins/producer.py,sha256=xENTZdZ7t0dpw5YsreQT20iTycSaj1EA4ny-60u-SWM,20427
 ergon/telemetry/__init__.py,sha256=8waeIAHEx6tMXWfw-zOEKgjrg7V8S1poG070MdAmi_8,100
@@ -109,9 +116,9 @@ ergon/telemetry/metrics.py,sha256=0T_CuNw9P5AG1U9k1-bNp1g7McyiNLUIt_zKyLOtrnA,28
 ergon/telemetry/tracing.py,sha256=_ktiZWAgB1DU-uN91Mzr0iYNXxbCN21LnKiRo5SOJxY,4454
 ergon/utils/__init__.py,sha256=M0_VCjMN7jvSPlRZLZHeFKTHAl1zu3BnAhjrzJjDfiI,57
 ergon/utils/env.py,sha256=lji4xENvfHqg2GTGnzG95VKpxxM4f3DHIKKP61xQG08,621
-ergon_framework_python-0.2.2.dist-info/licenses/LICENSE,sha256=bWCIhHzaadz_ecLdCdtwyMafeQ17s2d7_FSSuSuEcDs,1079
-ergon_framework_python-0.2.2.dist-info/METADATA,sha256=VNSh11YTgbAxLcsXPSj44s5pvfEniE9QST6-JEmsK1w,16914
-ergon_framework_python-0.2.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-ergon_framework_python-0.2.2.dist-info/entry_points.txt,sha256=reZ934txb5OrtcNBgTGqCsXa1biUDQWubD2a9fGZynE,42
-ergon_framework_python-0.2.2.dist-info/top_level.txt,sha256=KSPt6N7RzsjU7PRAalWQ9Cul7YTUxbo84yAJ-y2vLm8,6
-ergon_framework_python-0.2.2.dist-info/RECORD,,
+ergon_framework_python-0.2.4.dist-info/licenses/LICENSE,sha256=bWCIhHzaadz_ecLdCdtwyMafeQ17s2d7_FSSuSuEcDs,1079
+ergon_framework_python-0.2.4.dist-info/METADATA,sha256=Mt-c5h17mfvb-JJDgqNfQKXg2zeIYBBxUh9XrsKrt2A,18371
+ergon_framework_python-0.2.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ergon_framework_python-0.2.4.dist-info/entry_points.txt,sha256=reZ934txb5OrtcNBgTGqCsXa1biUDQWubD2a9fGZynE,42
+ergon_framework_python-0.2.4.dist-info/top_level.txt,sha256=KSPt6N7RzsjU7PRAalWQ9Cul7YTUxbo84yAJ-y2vLm8,6
+ergon_framework_python-0.2.4.dist-info/RECORD,,