zrb 0.17.0__py3-none-any.whl → 0.17.2__py3-none-any.whl

zrb/builtin/devtool/install/helix/helix.py

@@ -29,7 +29,6 @@ install_helix = FlowTask(
                 run=write_config(
                     template_file=os.path.join(
                         _CURRENT_DIR,
-                        "helix",
                         "resource",
                         "themes",
                         "gruvbox_transparent.toml",  # noqa
@@ -41,9 +40,7 @@ install_helix = FlowTask(
             Task(
                 name="configure-helix",
                 run=write_config(
-                    template_file=os.path.join(
-                        _CURRENT_DIR, "helix", "resource", "config.toml"
-                    ),
+                    template_file=os.path.join(_CURRENT_DIR, "resource", "config.toml"),
                     config_file="~/.config/helix/config.toml",
                     remove_old_config=True,
                 ),

zrb/task/any_task.py

@@ -25,14 +25,12 @@ TAnyTask = TypeVar("TAnyTask", bound="AnyTask")
 
 class AnyTask(ABC):
     """
-    Abstract base class for defining tasks in a task management system.
+    Contract/interface for all Zrb Task.
 
-    This class acts as a template for creating new task types. To define a new task,
-    extend this class and implement all its abstract methods. The `AnyTask` class is
-    considered atomic and is not broken into multiple interfaces.
+    This class acts as a template for creating new Zrb Task types.
 
-    Subclasses should implement the abstract methods to define custom behavior for
-    task execution, state transitions, and other functionalities.
+    To define a new Zrb Task, you should extend this class and implement all its methods.
+    The easiest way to do so is by extending `Task`
     """
 
     @abstractmethod
@@ -74,7 +72,7 @@ class AnyTask(ABC):
         Examples:
             >>> from zrb import Task
             >>> class MyTask(Task):
-            >>>     async def run(self, *args: Any, **kwargs: Any) -> int:
+            >>>     def run(self, *args: Any, **kwargs: Any) -> int:
             >>>         self.print_out('Doing some calculation')
             >>>         return 42
         """
@@ -88,8 +86,7 @@ class AnyTask(ABC):
         Any other tasks depends on the current task, will be `started` once the current task is `ready`.
 
         This method should be implemented to define the criteria for considering the task
-        `ready`. The specifics of this completion depend on the task's
-        nature and the subclass implementation.
+        `ready`. The specifics of this completion depend on the task's nature and the subclass implementation.
 
         Returns:
             bool: True if the task is completed, False otherwise.

zrb/task/base_task/base_task.py

@@ -72,10 +72,10 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
     ):
         # init properties
         retry_interval = retry_interval if retry_interval >= 0 else 0
-        checking_interval = checking_interval if checking_interval > 0 else 0.1
+        checking_interval = checking_interval if checking_interval > 0 else 0.05
         retry = retry if retry >= 0 else 0
         # init parent classes
-        FinishTracker.__init__(self)
+        FinishTracker.__init__(self, checking_interval=checking_interval)
         Renderer.__init__(self)
         AttemptTracker.__init__(self, retry=retry)
         BaseTaskModel.__init__(
@@ -233,7 +233,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
             await run_async(self._on_retry, self)
 
     async def check(self) -> bool:
-        return await self._is_done()
+        return await run_async(self._is_done)
 
     def inject_envs(self):
         super().inject_envs()
@@ -315,7 +315,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
         if self.__is_check_triggered:
             self.log_debug("Waiting readiness flag to be set")
             while not self.__is_ready:
-                await asyncio.sleep(0.1)
+                await asyncio.sleep(self._checking_interval)
             return True
         self.__is_check_triggered = True
         check_result = await self._check()
@@ -336,7 +336,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
         self.log_debug("Waiting execution to be started")
         while not self.__is_execution_started:
             # Don't start checking before the execution itself has been started
-            await asyncio.sleep(0.05)
+            await asyncio.sleep(self._checking_interval / 2.0)
         check_coroutines: Iterable[asyncio.Task] = []
         for checker_task in self._get_checkers():
             checker_task._set_execution_id(self.get_execution_id())

zrb/task/base_task/component/trackers.py

@@ -2,7 +2,7 @@ import asyncio
 import time
 
 from zrb.helper.typecheck import typechecked
-from zrb.helper.typing import Optional
+from zrb.helper.typing import Optional, Union
 
 LOG_NAME_LENGTH = 20
 
@@ -51,9 +51,10 @@ class AttemptTracker:
 
 @typechecked
 class FinishTracker:
-    def __init__(self):
+    def __init__(self, checking_interval: Union[float, int]):
         self.__execution_queue: Optional[asyncio.Queue] = None
         self.__counter = 0
+        self.__checking_interval = checking_interval
 
     async def _mark_awaited(self):
         if self.__execution_queue is None:
@@ -69,5 +70,5 @@ class FinishTracker:
 
     async def _is_done(self) -> bool:
         while self.__execution_queue is None:
-            await asyncio.sleep(0.05)
+            await asyncio.sleep(self.__checking_interval / 2.0)
         return await self.__execution_queue.get()

zrb/task/checker.py

@@ -44,7 +44,7 @@ class Checker(BaseTask):
         on_ready: Optional[OnReady] = None,
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 30,
         expected_result: bool = True,
         should_execute: Union[bool, str, Callable[..., bool]] = True,

zrb/task/decorator.py

@@ -43,9 +43,9 @@ def python_task(
     on_retry: Optional[OnRetry] = None,
     on_failed: Optional[OnFailed] = None,
     checkers: Iterable[AnyTask] = [],
-    checking_interval: float = 0.1,
+    checking_interval: Union[float, int] = 0,
     retry: int = 2,
-    retry_interval: float = 1,
+    retry_interval: Union[float, int] = 1,
     should_execute: Union[bool, str, Callable[..., bool]] = True,
     return_upstream_result: bool = False,
     runner: Optional[Runner] = None,

zrb/task/docker_compose_task.py

@@ -115,9 +115,9 @@ class DockerComposeTask(CmdTask):
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
         checkers: Iterable[AnyTask] = [],
-        checking_interval: float = 0.1,
+        checking_interval: Union[float, int] = 0,
         retry: int = 2,
-        retry_interval: float = 1,
+        retry_interval: Union[float, int] = 1,
         max_output_line: int = 1000,
         max_error_line: int = 1000,
         preexec_fn: Optional[Callable[[], Any]] = os.setsid,

zrb/task/http_checker.py

@@ -87,7 +87,7 @@ class HTTPChecker(Checker):
         on_ready: Optional[OnReady] = None,
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 5,
         expected_result: bool = True,
         should_execute: Union[bool, JinjaTemplate, Callable[..., bool]] = True,

zrb/task/looper.py

@@ -32,8 +32,11 @@ class Looper:
                 if result is not None:
                     if not result:
                         continue
+                    while len(self._queue[identifier]) > 1000:
+                        self._queue[identifier].pop(0)
                     self._queue[identifier].append(result)
             except KeyboardInterrupt:
+                self.stop()
                 break
 
 

zrb/task/path_checker.py

@@ -56,7 +56,7 @@ class PathChecker(Checker):
         on_failed: Optional[OnFailed] = None,
         path: JinjaTemplate = "",
         ignored_path: Union[JinjaTemplate, Iterable[JinjaTemplate]] = [],
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 5,
         expected_result: bool = True,
         should_execute: Union[bool, JinjaTemplate, Callable[..., bool]] = True,

zrb/task/path_watcher.py

@@ -72,7 +72,7 @@ class PathWatcher(Watcher):
         on_failed: Optional[OnFailed] = None,
         path: JinjaTemplate = "",
         ignored_path: Union[JinjaTemplate, Iterable[JinjaTemplate]] = [],
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 30,
         watch_new_files: bool = True,
         watch_modified_files: bool = True,

zrb/task/port_checker.py

@@ -66,7 +66,7 @@ class PortChecker(Checker):
         on_ready: Optional[OnReady] = None,
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 5,
         expected_result: bool = True,
         should_execute: Union[bool, str, Callable[..., bool]] = True,

zrb/task/server.py

@@ -86,6 +86,7 @@ class Controller:
         task = self._get_task()
 
         async def fn() -> Any:
+            task.print_out_dark(f"Starting controller: {self._name}")
             task_fn = task.to_function(is_async=True)
             return await task_fn(*self._args, **self._kwargs)
 

zrb/task/time_watcher.py

@@ -68,7 +68,7 @@ class TimeWatcher(Watcher):
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
         schedule: JinjaTemplate = "",
-        checking_interval: Union[int, float] = 1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 30,
         should_execute: Union[bool, JinjaTemplate, Callable[..., bool]] = True,
     ):
@@ -128,7 +128,7 @@ class TimeWatcher(Watcher):
 
     def create_loop_inspector(self) -> Callable[..., Optional[bool]]:
         async def loop_inspect() -> bool:
-            await asyncio.sleep(0.1)
+            await asyncio.sleep(self._checking_interval)
             label = f"Watching {self._rendered_schedule}"
             identifier = self.get_identifier()
             scheduled_time = self.__scheduled_times[identifier]
@@ -148,7 +148,7 @@ class TimeWatcher(Watcher):
         return cron.get_next(datetime.datetime)
 
     def _get_cron(self) -> Any:
-        margin = datetime.timedelta(seconds=0.001)
+        margin = datetime.timedelta(seconds=self._checking_interval / 2.0)
         slightly_before_now = datetime.datetime.now() - margin
         cron = croniter.croniter(self._rendered_schedule, slightly_before_now)
         return cron

zrb/task/watcher.py

@@ -48,7 +48,7 @@ class Watcher(Checker):
         on_ready: Optional[OnReady] = None,
         on_retry: Optional[OnRetry] = None,
         on_failed: Optional[OnFailed] = None,
-        checking_interval: Union[int, float] = 0.1,
+        checking_interval: Union[int, float] = 0,
         progress_interval: Union[int, float] = 30,
         expected_result: bool = True,
         should_execute: Union[bool, str, Callable[..., bool]] = True,

{zrb-0.17.0.dist-info → zrb-0.17.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zrb
-Version: 0.17.0
+Version: 0.17.2
 Summary: A Framework to Enhance Your Workflow
 Home-page: https://github.com/state-alchemists/zrb
 License: AGPL-3.0-or-later

{zrb-0.17.0.dist-info → zrb-0.17.2.dist-info}/RECORD

@@ -27,7 +27,7 @@ zrb/builtin/devtool/install/gvm/download.sh,sha256=Z4IDsTS4gOeWiezhI-TrRv2nFgMsl
 zrb/builtin/devtool/install/gvm/finalize.sh,sha256=Han_IDq5XwxNsxyAVc99PoW3fdjTnYtv6rsr5KRhtEE,538
 zrb/builtin/devtool/install/gvm/gvm.py,sha256=jD5HzHA4eXHwFeSzKUVAp8PMXiibPNF_Rwq01NaEZIo,1693
 zrb/builtin/devtool/install/gvm/resource/config.sh,sha256=M_r6XjtoYZjx8rJaT3FIwVl3HUd7lJF5_KqUSEJQeo4,253
-zrb/builtin/devtool/install/helix/helix.py,sha256=W0Xm_eq0wIHcoq0CzG9WrQIH9tPByT-AZ-zi4Z72-U0,2098
+zrb/builtin/devtool/install/helix/helix.py,sha256=XQzTbokyAXy9-UMBPp8woIOPNFF0vxWcrg0fr4mYj4E,2010
 zrb/builtin/devtool/install/helix/install-language-server.sh,sha256=ZkV_ARwhTnLjjbAhJe8Pvp1hyRYVn176DYwg7ObkQ1w,1040
 zrb/builtin/devtool/install/helix/install.sh,sha256=Dsg65aEnpU8YnlvHwiKoxRpj8Jo8j3mejB4bTi2eeKo,1375
 zrb/builtin/devtool/install/helix/resource/config.toml,sha256=35IwzDzXGfSnUH3O3nyd2IzDVOWyKqj6Kb3QuympXCE,305
@@ -1355,37 +1355,37 @@ zrb/shell-scripts/notify.ps1,sha256=6_xPoIwuxARpYljcjVV-iRJS3gJqGfx-B6kj719cJ9o,
 zrb/shell-scripts/rsync-util.sh,sha256=QzdhSBvUNMxB4U2B4m0Dxg9czGckRjB7Vk4A1ObG0-k,353
 zrb/shell-scripts/ssh-util.sh,sha256=9lXDzw6oO8HuA4vdbfps_uQMMwKyNYX9fZkZgpK52g8,401
 zrb/task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/task/any_task.py,sha256=1jc0qVZs1yIMfGuInktgH7EqDbI8IqmsaSlH5VijThc,39435
+zrb/task/any_task.py,sha256=lzCbrpm6Mo_isNW7KuHK7Rq0t59_9z0oOLAtaJYCEdg,39214
 zrb/task/any_task_event_handler.py,sha256=AjTC6lIcprutRusNBGl83EifQe4TbZzxdlVIR4ndWN4,524
 zrb/task/base_remote_cmd_task.py,sha256=tZi3jODMXfTkDAmWiFR2YdA-b4-TDTP1uLtO0ulmM34,10101
 zrb/task/base_task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/task/base_task/base_task.py,sha256=qnQSG-nAppmm38JY11wC03-0mZSOjjk-XJ62leco2rw,20354
+zrb/task/base_task/base_task.py,sha256=3kwrxjz5EPRpBp2HAhdRHdgRDgyDTak01C6fQMjU1Pw,20446
 zrb/task/base_task/component/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/task/base_task/component/base_task_model.py,sha256=YlEuvYSzlrK83Kds07bu2drKSw3rKyl7qIR1qwIPNZk,10376
 zrb/task/base_task/component/common_task_model.py,sha256=JoAAf8EvuPx31fCK_TBxX_TBeHZrZyFDjLeK8ts0w3A,12285
 zrb/task/base_task/component/pid_model.py,sha256=RjJIqOpavucDssnd3q3gT4q8QnP8I9SUdlv1b9pR7kU,292
 zrb/task/base_task/component/renderer.py,sha256=9wP2IW811Ta81IoPWmeQ7yVc7eG-uaSnOVbEyeaOIuk,4439
-zrb/task/base_task/component/trackers.py,sha256=gM9eOukMh6kvNJnRsHscQ_JN--Haa2YA4bIufqh8upE,1950
-zrb/task/checker.py,sha256=fn6gmcCUHsar458NQ4Af4-kt2skcyibd0ewsPTRd5-w,3383
+zrb/task/base_task/component/trackers.py,sha256=c5xhZ6agICxKPI5Va1sn66_9OqC92ebF5CNhcwVUNUE,2074
+zrb/task/checker.py,sha256=Y8WnIZM23fGqZpxHw2Bnk5jb0MmEMS598WZiEB8OUFU,3381
 zrb/task/cmd_task.py,sha256=_wjF9MbKGA0EAr_df47AMC0lROCiaJTUyxT-AFQKKJo,14181
-zrb/task/decorator.py,sha256=j62l7ITIRZtk_qE97d4naVl9gbbMoi2eEXOPOmYdF8M,3039
-zrb/task/docker_compose_task.py,sha256=fnFEOAS9yEi2ve7pSzN9guXOVeYt8HYTdQvtjk-yoRQ,14886
+zrb/task/decorator.py,sha256=WInQrxuVlejvZEGIiBMfkiMa0I5rT9lWRGjyyLu_hzw,3061
+zrb/task/docker_compose_task.py,sha256=Cgk9ROW_xSnSYV0x1E2Xo1AphFoota-omrtLPocDaOU,14908
 zrb/task/flow_task.py,sha256=QIIZgq9C7e-kvTRJ0Y1Slb5AQyy15N9H4NZxdFR3FI8,4867
-zrb/task/http_checker.py,sha256=DRIwXjC8StucHo2nP1duM3Ime3zzw1BQH8ib2bFZVmA,5692
-zrb/task/looper.py,sha256=aU7hwXLlfZRhH4rlusIwsusz5fHEhaYfwEpRUVcHx4o,1284
+zrb/task/http_checker.py,sha256=mStzoRlcDWCyeIP4sRAQSns_U_nEp19qYYE-DONZaA8,5690
+zrb/task/looper.py,sha256=0eM3wEIC_RbThg60MRbK4Az16vt81O5p12cORAYTfnI,1430
 zrb/task/notifier.py,sha256=19E4EcFgFZ0thU9p2P1dGUYR04721pa0K3lqsj6a4Xc,6217
 zrb/task/parallel.py,sha256=-coMuiFlS29GpBgW6plPVaCLesgzzD0bYib29OvhXFg,1193
-zrb/task/path_checker.py,sha256=yvMgGlmMQhlaX3Wlq5yI7-nzEpyCFoXHEOFOdlfI6-o,4673
-zrb/task/path_watcher.py,sha256=UGaGYzWExoVQDK6smXEKsd0leO3FZOQYHnpHgZ9hiZU,7420
-zrb/task/port_checker.py,sha256=IoVIP0QjxKz2SLgnK2GIaxn4WASk6ZKf4cQlKog0Fw8,4592
+zrb/task/path_checker.py,sha256=Jn7tnaUiPUbWOPAH3TUgzaa9_uiU0dPkpKCkr2Tlruc,4671
+zrb/task/path_watcher.py,sha256=xoQxfgsGDxzywPPFS2RirtwrK9-cnm_TCTabZRhZr84,7418
+zrb/task/port_checker.py,sha256=KE1fr0NBiUCLplDOHot8RzPBP1h_BvxFzHIZiEOuGaM,4590
 zrb/task/recurring_task.py,sha256=FNxV7n4h9AzUCU8oKXwAS_A9j1newS-esWjmMsC33vE,7430
 zrb/task/remote_cmd_task.py,sha256=rmLB5uCcbbfZBy8-nAZI8mgnNd-J2d4SBemLEDwSlV4,3951
 zrb/task/resource_maker.py,sha256=jQSO7PVIuTZi__JcrpRC4Ni_xmuJszJiMAxH_qfJPhs,7644
 zrb/task/rsync_task.py,sha256=bgCeZQTG-4isvjZGGs_05oOEkkwGc930NTyuUYUm_cg,4187
-zrb/task/server.py,sha256=CdzBkdWZvX1PTvloDrOXtCbAbMeK4KK75C33N_Wz3Sc,6408
+zrb/task/server.py,sha256=w0gO73tt9PLWXVtgY-oe6qzvODtxVcizBGCUjRrhp5w,6478
 zrb/task/task.py,sha256=dHv4cmnd0QFPT9PwrfmHpxTaXj86mm8xf7_jAj_engI,329
-zrb/task/time_watcher.py,sha256=xx82w8ygpL-6pUbeuWjsxSVLSZhkWVWHsAoZUXPV7Jk,5075
-zrb/task/watcher.py,sha256=m72YhUKtQsE4mZSm1y2MKiSdfj6HZo3rj9f3nQLU7Oo,3252
+zrb/task/time_watcher.py,sha256=m0OKCtYHzO8nz-bmp-PuaHpmGwhPzy2riikjol-_7ZA,5119
+zrb/task/watcher.py,sha256=2dxWgwSK8CrhiNF2JF1S9Pe_BXZPlfxU88n495vlIuY,3250
 zrb/task/wiki_task.py,sha256=Mcugk_6Pd7pzubi2ZP4eegJs8e9niYKh-9mCrNHXE_g,4330
 zrb/task_env/constant.py,sha256=ySdHv2dawWE-UoeBHl8FEOmrBl4vfkRI67TIBdkK6l8,220
 zrb/task_env/env.py,sha256=C9IzavEtWlpap4C92XONi1ID-RK9gDDLQKl5rYGBsyc,5195
@@ -1403,8 +1403,8 @@ zrb/task_input/int_input.py,sha256=d2fXcm5fCo09472eMAm6PdzLQD82ZBV9ARq5CjKepAo,4
 zrb/task_input/password_input.py,sha256=g_g8ZWAzDaHx4h2EHY3UCGvTigC6esAUBzXU0T9nDUk,4192
 zrb/task_input/str_input.py,sha256=BNflOhrJvST9bWK0rGdCi7C7y-QDvHj9ISQMRmujIWU,4200
 zrb/task_input/task_input.py,sha256=x1sGHsoSYAYMdQBrCLmcvZa_ZmGggMPj3goAQzewUKI,2181
-zrb-0.17.0.dist-info/LICENSE,sha256=WfnGCl8G60EYOPAEkuc8C9m9pdXWDe08NsKj3TBbxsM,728
-zrb-0.17.0.dist-info/METADATA,sha256=GEA_jDoWaQ2X5kQMiLZFHMRqnYczd1HK-S5g8QwPYfI,16460
-zrb-0.17.0.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-zrb-0.17.0.dist-info/entry_points.txt,sha256=xTgXc1kBKYhJHEujdaSPHUcJT3-hbyP1mLgwkv-5sSk,40
-zrb-0.17.0.dist-info/RECORD,,
+zrb-0.17.2.dist-info/LICENSE,sha256=WfnGCl8G60EYOPAEkuc8C9m9pdXWDe08NsKj3TBbxsM,728
+zrb-0.17.2.dist-info/METADATA,sha256=NNFpLM-mizatYOhAfnsi30eujgnhCA-KPs0KeCP4cRw,16460
+zrb-0.17.2.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+zrb-0.17.2.dist-info/entry_points.txt,sha256=xTgXc1kBKYhJHEujdaSPHUcJT3-hbyP1mLgwkv-5sSk,40
+zrb-0.17.2.dist-info/RECORD,,