zrb 0.9.3__py3-none-any.whl → 0.10.0__py3-none-any.whl

zrb/__init__.py

@@ -28,6 +28,7 @@ from zrb.task.resource_maker import Replacement, ReplacementMutator, ResourceMak
 from zrb.task.rsync_task import RsyncTask
 from zrb.task.task import Task
 from zrb.task.time_watcher import TimeWatcher
+from zrb.task.wiki_task import create_wiki_tasks
 from zrb.task_env.env import Env
 from zrb.task_env.env_file import EnvFile
 from zrb.task_group.group import Group
@@ -40,6 +41,7 @@ from zrb.task_input.password_input import PasswordInput
 from zrb.task_input.str_input import StrInput
 from zrb.task_input.task_input import Input
 
+assert create_wiki_tasks
 assert runner
 assert AnyTask
 assert OnTriggered

zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/image/pyproject.toml

@@ -13,7 +13,7 @@ uvicorn = "==0.20.0"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 pytest = "~7.4.0"
 pytest-cov = "~4.1.0"

zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/pyproject.toml

@@ -13,7 +13,7 @@ locust = "==2.16.1"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~6.0.0"
-black = "~23.12.1"
+black = "~24.3.0"
 isort = "~5.13.2"
 
 [build-system]

zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/pyproject.toml

@@ -30,7 +30,7 @@ opentelemetry-instrumentation-fastapi= "==0.44b0"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 pytest = "~7.4.0"
 pytest-cov = "~4.1.0"

zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/publish.sh

@@ -1,2 +1,2 @@
 echo "Publish"
-poetry publish --repository {{input.snake_zrb_package_name_repo}}
+poetry publish

zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/local.py

@@ -1,6 +1,6 @@
 import os
 
-from zrb import CmdTask, StrInput, runner
+from zrb import CmdTask, runner
 from zrb.builtin.group import project_group
 
 CURRENT_DIR = os.path.dirname(__file__)
@@ -49,14 +49,6 @@ publish_snake_zrb_package_name = CmdTask(
     name="publish-kebab-zrb-package-name",
     description="Publish human readable zrb package name",
     group=project_group,
-    inputs=[
-        StrInput(
-            name="kebab-zrb-package-name-repo",
-            prompt="Pypi repository for human readable zrb package name",
-            description="Pypi repository for human readalbe zrb package name",
-            default="pypi",
-        )
-    ],
     upstreams=[build_snake_zrb_package_name],
     cwd=RESOURCE_DIR,
     cmd_path=[

zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/pyproject.toml

@@ -16,7 +16,7 @@ zrb = ">=zrbVersion"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 pytest = "~7.4.0"
 pytest-cov = "~4.1.0"

zrb/builtin/generator/plugin/template/_cmd/publish.sh

@@ -1,2 +1,2 @@
 echo "Publish"
-poetry publish --repository {{input.plugin_repo}}
+poetry publish

zrb/builtin/generator/plugin/template/pyproject.toml

@@ -16,7 +16,7 @@ zrb = ">=zrbVersion"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 pytest = "~7.4.0"
 pytest-cov = "~4.1.0"

zrb/builtin/generator/plugin/template/zrb_init.py

@@ -1,6 +1,6 @@
 import os
 
-from zrb import CmdTask, StrInput, runner
+from zrb import CmdTask, runner
 from zrb.builtin.group import plugin_group
 
 PROJECT_DIR = os.path.dirname(__file__)
@@ -46,14 +46,6 @@ publish_plugin = CmdTask(
     name="publish",
     group=plugin_group,
     description="Publish plugin",
-    inputs=[
-        StrInput(
-            name="plugin-repo",
-            prompt="Pypi repository for plugin",
-            description="Pypi repository for human readalbe zrb package name",
-            default="pypi",
-        )
-    ],
     upstreams=[build_plugin],
     cwd=PROJECT_DIR,
     cmd_path=[

zrb/builtin/generator/project/template/pyproject.toml

@@ -14,7 +14,7 @@ zrb = ">=zrbVersion"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 
 [tool.poetry.scripts]

zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/pyproject.toml

@@ -14,7 +14,7 @@ uvicorn = "==0.20.0"
 
 [tool.poetry.dev-dependencies]
 flake8 = "~7.0.0"
-black = "~24.2.0"
+black = "~24.3.0"
 isort = "~5.13.2"
 pytest = "~7.4.0"
 pytest-cov = "~4.1.0"

zrb/config/config.py

@@ -7,13 +7,7 @@ from zrb.helper.typecheck import typechecked
 
 @typechecked
 def get_version() -> str:
-    try:
-        return metadata.version("zrb")
-    except metadata.PackageNotFoundError:
-        import flit
-
-        meta = flit.read_module_metadata("zrb")
-        return str(meta["module"]["version"])
+    return metadata.version("zrb")
 
 
 @typechecked
@@ -24,6 +18,12 @@ def get_current_shell() -> str:
     return "bash"
 
 
+def _get_valid_container_backend(container_backend: str) -> str:
+    if container_backend.lower().strip() == "podman":
+        return "podman"
+    return "docker"
+
+
 default_shell = os.getenv("ZRB_SHELL", get_current_shell())
 init_script_str = os.getenv("ZRB_INIT_SCRIPTS", "")
 init_scripts = init_script_str.split(":") if init_script_str != "" else []
@@ -34,3 +34,6 @@ show_advertisement = to_boolean(os.getenv("ZRB_SHOW_ADVERTISEMENT", "1"))
 show_prompt = to_boolean(os.getenv("ZRB_SHOW_PROMPT", "1"))
 show_time = to_boolean(os.getenv("ZRB_SHOW_TIME", "1"))
 version = get_version()
+container_backend = _get_valid_container_backend(
+    os.getenv("ZRB_CONTAINER_BACKEND", "docker")
+)

zrb/shell-scripts/ensure-podman-is-installed.sh

@@ -0,0 +1,55 @@
+set -e
+if command_exists podman
+then
+    log_info "Podman is already installed."
+else
+    log_info "Installing Podman..."
+    if [ "$OS_TYPE" = "Darwin" ]
+    then
+        if command_exists brew
+        then
+            brew install --cask podman
+            log_info "Please start Podman before proceeding."
+        else
+            log_info "Homebrew not found. Please install Homebrew and try again."
+            exit 1
+        fi
+    elif [ "$OS_TYPE" = "Linux" ]
+    then
+        if command_exists apt
+        then
+            try_sudo apt update
+            try_sudo apt install -y podman
+        elif command_exists yum
+        then
+            try_sudo yum install -y podman
+        elif command_exists dnf
+        then
+            try_sudo dnf install -y podman
+        elif command_exists pacman
+        then
+            try_sudo pacman -Syu --noconfirm podman
+        else
+            log_info "No known package manager found. Please install Podman manually."
+            exit 1
+        fi
+    else
+        log_info "Unsupported OS type. Please install Podman manually."
+        exit 1
+    fi
+fi
+
+if ! command_exists podman-compose
+then
+    log_info "Installing Podman Compose plugin..."
+    pip install podman-compose
+fi
+
+# Check Podman Compose plugin installation
+if command_exists podman && command_exists podman-compose
+then
+    log_info "Podman Compose plugin is already installed."
+else
+    log_info "Podman Compose plugin is not installed or podman is not running. Please check your installation."
+    exit 1
+fi

zrb/task/any_task.py

@@ -384,6 +384,44 @@ class AnyTask(ABC):
         """
         pass
 
+    @abstractmethod
+    def insert_fallback(self, *fallbacks: TAnyTask):
+        """
+        Inserts one or more `AnyTask` instances at the beginning of the current task's fallback list.
+
+        This method is used to define dependencies for the current task. Tasks in the fallback list are executed when the task is failed.
+        Adding a task to the beginning of the list means it will be
+        executed earlier than those already in the list.
+
+        Args:
+            fallbacks (TAnyTask): One or more task instances to be added to the fallback list.
+
+        Examples:
+            >>> from zrb import Task
+            >>> task = Task(name='task')
+            >>> fallback_task = Task(name='fallback-task')
+            >>> task.insert_fallback(fallback_task)
+        """
+        pass
+
+    @abstractmethod
+    def add_fallback(self, *fallbacks: TAnyTask):
+        """
+        Adds one or more `AnyTask` instances to the end of the current task's fallback list.
+
+        This method appends tasks to the fallback list, indicating that these tasks should be executed when the task is failed.
+
+        Args:
+            fallbacks (TAnyTask): One or more task instances to be added to the fallback list.
+
+        Examples:
+            >>> from zrb import Task
+            >>> task = Task(name='task')
+            >>> fallback_task = Task(name='fallback-task')
+            >>> task.add_fallback(fallback_task)
+        """
+        pass
+
     @abstractmethod
     def add_upstream(self, *upstreams: TAnyTask):
         """
@@ -519,6 +557,20 @@ class AnyTask(ABC):
         """
         pass
 
+    @abstractmethod
+    def _lock_upstreams(self):
+        """
+        Lock upstreams so that it cannot be altered anymore
+        """
+        pass
+
+    @abstractmethod
+    def _lock_fallbacks(self):
+        """
+        Lock fallbacks so that it cannot be altered anymore
+        """
+        pass
+
     @abstractmethod
     def _set_execution_id(self, execution_id: str):
         """
@@ -885,6 +937,37 @@ class AnyTask(ABC):
         """
         pass
 
+    @abstractmethod
+    def inject_fallbacks(self):
+        """
+        Injects fallback tasks into the current task.
+
+        This method is used for programmatically adding fallback to the task.
+        fallback tasks are those that must be completed when the task is failed.
+        Override this method in subclasses to specify such dependencies.
+
+        Examples:
+            >>> from zrb import Task
+            >>> class MyTask(Task):
+            >>>     def inject_fallbacks(self):
+            >>>         self.add_fallback(another_task)
+        """
+        pass
+
+    @abstractmethod
+    def _get_fallbacks(self) -> Iterable[TAnyTask]:
+        """
+        Retrieves the fallback tasks of the current task.
+
+        An internal method to get the list of fallback tasks that have been set for the
+        task, either statically or through `inject_fallbacks`. This is essential for task
+        fallback scenario.
+
+        Returns:
+            Iterable[TAnyTask]: An iterable of fallback tasks.
+        """
+        pass
+
     @abstractmethod
     def _get_combined_inputs(self) -> Iterable[AnyInput]:
         """

zrb/task/base_remote_cmd_task.py

@@ -78,6 +78,7 @@ class SingleBaseRemoteCmdTask(CmdTask):
         post_cmd_path: CmdVal = "",
         cwd: Optional[Union[str, pathlib.Path]] = None,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -110,6 +111,7 @@ class SingleBaseRemoteCmdTask(CmdTask):
             cmd_path=cmd_path,
             cwd=cwd,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/base_task/base_task.py

@@ -39,6 +39,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
     """
 
     __xcom: Mapping[str, Mapping[str, str]] = {}
+    __running_tasks: List[AnyTask] = []
 
     def __init__(
         self,
@@ -53,6 +54,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
         retry: int = 2,
         retry_interval: Union[float, int] = 1,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         checkers: Iterable[AnyTask] = [],
         checking_interval: Union[float, int] = 0,
         run: Optional[Callable[..., Any]] = None,
@@ -87,6 +89,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
             retry=retry,
             retry_interval=retry_interval,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             checkers=checkers,
             checking_interval=checking_interval,
             run=run,
@@ -257,7 +260,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
         except Exception as e:
             self.log_error(f"{e}")
             if raise_error:
-                raise
+                raise e
         finally:
             if show_done_info:
                 self._show_env_prefix()
@@ -303,7 +306,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.1)
+            await asyncio.sleep(0.05)
         check_coroutines: Iterable[asyncio.Task] = []
         for checker_task in self._get_checkers():
             checker_task._set_execution_id(self.get_execution_id())
@@ -334,15 +337,7 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
         await self.on_triggered()
         self.__is_execution_triggered = True
         await self.on_waiting()
-        # get upstream checker
-        upstream_check_processes: Iterable[asyncio.Task] = []
-        self._lock_upstreams()
-        for upstream_task in self._get_upstreams():
-            upstream_check_processes.append(
-                asyncio.create_task(upstream_task._loop_check())
-            )
-        # wait all upstream checkers to complete
-        await asyncio.gather(*upstream_check_processes)
+        await self.__check_upstreams()
         # mark execution as started, so that checkers can start checking
         self.__is_execution_started = True
         local_kwargs = dict(kwargs)
@@ -353,27 +348,70 @@ class BaseTask(FinishTracker, AttemptTracker, Renderer, BaseTaskModel, AnyTask):
             return None
         # start running task
         result: Any = None
+        is_failed: bool = False
         while self._should_attempt():
             try:
                 self.log_debug(f"Started with args: {args} and kwargs: {local_kwargs}")
                 await self.on_started()
+                self.__running_tasks.append(self)
                 result = await run_async(self.run, *args, **local_kwargs)
+                self.__running_tasks.remove(self)
                 break
             except Exception as e:
-                is_last_attempt = self._is_last_attempt()
-                await self.on_failed(is_last_attempt, e)
-                if is_last_attempt:
-                    raise e
                 attempt = self._get_attempt()
                 self.log_error(f"Encounter error on attempt {attempt}")
+                if self._is_last_attempt():
+                    is_failed = True
+                    raise e
+                self.__running_tasks.remove(self)
+                await self.on_failed(is_last_attempt=False, exception=e)
                 self._increase_attempt()
                 await asyncio.sleep(self._retry_interval)
                 await self.on_retry()
+            finally:
+                if is_failed:
+                    running_tasks = self.__running_tasks
+                    self.__running_tasks = []
+                    await self.__trigger_failure(running_tasks)
+                    await self.__trigger_fallbacks(running_tasks, kwargs)
         self.set_xcom(self.get_name(), f"{result}")
         self.log_debug(f"XCom: {self.__xcom}")
         await self._mark_done()
         return result
 
+    async def __check_upstreams(self):
+        coroutines: Iterable[asyncio.Task] = []
+        self._lock_upstreams()
+        for upstream_task in self._get_upstreams():
+            coroutines.append(asyncio.create_task(upstream_task._loop_check()))
+        # wait all upstream checkers to complete
+        await asyncio.gather(*coroutines)
+
+    async def __trigger_failure(self, tasks: List[AnyTask]):
+        coroutines = [
+            task.on_failed(is_last_attempt=True, exception=Exception("canceled"))
+            for task in tasks
+        ]
+        await asyncio.gather(*coroutines)
+
+    async def __trigger_fallbacks(
+        self, tasks: List[AnyTask], kwargs: Mapping[str, Any]
+    ):
+        coroutines: Iterable[asyncio.Task] = []
+        for fallback in self.__get_all_fallbacks(tasks):
+            fallback._set_execution_id(self.get_execution_id())
+            coroutines.append(asyncio.create_task(fallback._run_all(**kwargs)))
+        await asyncio.gather(*coroutines)
+
+    def __get_all_fallbacks(self, tasks: List[AnyTask]) -> List[AnyTask]:
+        all_fallbacks: List[AnyTask] = []
+        for task in tasks:
+            task._lock_fallbacks()
+            for fallback in task._get_fallbacks():
+                if fallback not in all_fallbacks:
+                    all_fallbacks.append(fallback)
+        return all_fallbacks
+
     async def _check_should_execute(self, *args: Any, **kwargs: Any) -> bool:
         if callable(self._should_execute):
             return await run_async(self._should_execute, *args, **kwargs)

zrb/task/base_task/component/base_task_model.py

@@ -56,6 +56,7 @@ class BaseTaskModel(CommonTaskModel, PidModel, TimeTracker):
         retry: int = 2,
         retry_interval: Union[int, float] = 1,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         checkers: Iterable[AnyTask] = [],
         checking_interval: Union[int, float] = 0,
         run: Optional[Callable[..., Any]] = None,
@@ -85,6 +86,7 @@ class BaseTaskModel(CommonTaskModel, PidModel, TimeTracker):
             retry=retry,
             retry_interval=retry_interval,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             checkers=checkers,
             checking_interval=checking_interval,
             run=run,

zrb/task/base_task/component/common_task_model.py

@@ -47,6 +47,7 @@ class CommonTaskModel:
         retry: int = 2,
         retry_interval: Union[float, int] = 1,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         checkers: Iterable[AnyTask] = [],
         checking_interval: Union[float, int] = 0,
         run: Optional[Callable[..., Any]] = None,
@@ -73,6 +74,7 @@ class CommonTaskModel:
         self._retry = retry
         self._retry_interval = retry_interval
         self._upstreams = upstreams
+        self._fallbacks = fallbacks
         self._checkers = [checker.copy() for checker in checkers]
         self._checking_interval = checking_interval
         self._run_function: Optional[Callable[..., Any]] = run
@@ -90,16 +92,21 @@ class CommonTaskModel:
         self.__allow_add_env_files = True
         self.__allow_add_inputs = True
         self.__allow_add_upstreams: bool = True
+        self.__allow_add_fallbacks: bool = True
         self.__allow_add_checkers: bool = True
         self.__has_already_inject_env_files: bool = False
         self.__has_already_inject_envs: bool = False
         self.__has_already_inject_inputs: bool = False
         self.__has_already_inject_upstreams: bool = False
+        self.__has_already_inject_fallbacks: bool = False
         self.__all_inputs: Optional[List[AnyInput]] = None
 
     def _lock_upstreams(self):
         self.__allow_add_upstreams = False
 
+    def _lock_fallbacks(self):
+        self.__allow_add_fallbacks = False
+
     def _set_execution_id(self, execution_id: str):
         if self.__execution_id == "":
             self.__execution_id = execution_id
@@ -276,6 +283,25 @@ class CommonTaskModel:
             self.__has_already_inject_upstreams = True
         return list(self._upstreams)
 
+    def insert_fallback(self, *fallbacks: AnyTask):
+        if not self.__allow_add_fallbacks:
+            raise Exception(f"Cannot insert fallbacks to `{self.get_name()}`")
+        self._fallbacks = list(fallbacks) + list(self._fallbacks)
+
+    def add_fallback(self, *fallbacks: AnyTask):
+        if not self.__allow_add_fallbacks:
+            raise Exception(f"Cannot add fallbacks to `{self.get_name()}`")
+        self._fallbacks = list(self._fallbacks) + list(fallbacks)
+
+    def inject_fallbacks(self):
+        pass
+
+    def _get_fallbacks(self) -> List[AnyTask]:
+        if not self.__has_already_inject_fallbacks:
+            self.inject_fallbacks()
+            self.__has_already_inject_fallbacks = True
+        return list(self._fallbacks)
+
     def get_icon(self) -> str:
         return self._icon
 

zrb/task/checker.py

@@ -32,6 +32,7 @@ class Checker(BaseTask):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -55,6 +56,7 @@ class Checker(BaseTask):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/cmd_task.py

@@ -113,6 +113,7 @@ class CmdTask(BaseTask):
         cmd_path: CmdVal = "",
         cwd: Optional[Union[str, pathlib.Path]] = None,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -141,6 +142,7 @@ class CmdTask(BaseTask):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/docker_compose_task.py

@@ -1,6 +1,7 @@
 import os
 import pathlib
 
+from zrb.config.config import container_backend
 from zrb.helper.accessories.name import get_random_name
 from zrb.helper.docker_compose.fetch_external_env import fetch_compose_file_env_map
 from zrb.helper.docker_compose.file import read_compose_file, write_compose_file
@@ -36,27 +37,30 @@ from zrb.task_env.env_file import EnvFile
 from zrb.task_group.group import Group
 from zrb.task_input.any_input import AnyInput
 
-CURRENT_DIR = os.path.dirname(__file__)
-SHELL_SCRIPT_DIR = os.path.join(CURRENT_DIR, "..", "shell-scripts")
-TDockerComposeTask = TypeVar("TDockerComposeTask", bound="DockerComposeTask")
 
-ensure_docker_is_installed = CmdTask(
-    name="ensure-docker-is-installed",
-    cmd_path=[
-        os.path.join(SHELL_SCRIPT_DIR, "_common-util.sh"),
-        os.path.join(SHELL_SCRIPT_DIR, "ensure-docker-is-installed.sh"),
-    ],
-    preexec_fn=None,
-)
+def _get_ensure_zrb_network_task(backend: str):
+    CURRENT_DIR = os.path.dirname(__file__)
+    SHELL_SCRIPT_DIR = os.path.join(CURRENT_DIR, "..", "shell-scripts")
+    ensure_container_backend = CmdTask(
+        name="ensure-container_backend",
+        cmd_path=[
+            os.path.join(SHELL_SCRIPT_DIR, "_common-util.sh"),
+            os.path.join(SHELL_SCRIPT_DIR, f"ensure-{backend}-is-installed.sh"),
+        ],
+        preexec_fn=None,
+    )
+    return CmdTask(
+        name="ensure-zrb-network",
+        cmd=[
+            f"{backend} network inspect zrb >/dev/null 2>&1 || \\",
+            f"{backend} network create -d bridge zrb",
+        ],
+        upstreams=[ensure_container_backend],
+    )
 
-ensure_zrb_network_exists = CmdTask(
-    name="ensure-zrb-network-exists",
-    cmd=[
-        "docker network inspect zrb >/dev/null 2>&1 || \\",
-        "docker network create -d bridge zrb",
-    ],
-    upstreams=[ensure_docker_is_installed],
-)
+
+TDockerComposeTask = TypeVar("TDockerComposeTask", bound="DockerComposeTask")
+ensure_zrb_network_task = _get_ensure_zrb_network_task(container_backend)
 
 
 @typechecked
@@ -96,6 +100,7 @@ class DockerComposeTask(CmdTask):
         setup_cmd_path: CmdVal = "",
         cwd: Optional[Union[str, pathlib.Path]] = None,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -126,7 +131,8 @@ class DockerComposeTask(CmdTask):
             description=description,
             executable=executable,
             cwd=cwd,
-            upstreams=[ensure_zrb_network_exists] + upstreams,
+            upstreams=[ensure_zrb_network_task] + upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,
@@ -350,7 +356,7 @@ class DockerComposeTask(CmdTask):
         cmd_str = "\n".join(
             [
                 setup_cmd_str,
-                f"docker compose {options} {self._compose_cmd} {flags} {args}",
+                f"{container_backend} compose {options} {self._compose_cmd} {flags} {args}",  # noqa
             ]
         )
         self.log_info(f"Command: {cmd_str}")

zrb/task/flow_task.py

@@ -32,6 +32,7 @@ class FlowTask(BaseTask):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -72,6 +73,7 @@ class FlowTask(BaseTask):
             color=color,
             description=description,
             upstreams=final_upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/http_checker.py

@@ -75,6 +75,7 @@ class HTTPChecker(Checker):
         url: str = "/",
         is_https: Union[bool, str] = False,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -98,6 +99,7 @@ class HTTPChecker(Checker):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/notifier.py

@@ -46,6 +46,7 @@ class Notifier(BaseTask):
         show_toast: bool = True,
         show_stdout: bool = True,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -69,6 +70,7 @@ class Notifier(BaseTask):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/path_checker.py

@@ -42,6 +42,7 @@ class PathChecker(Checker):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -67,6 +68,7 @@ class PathChecker(Checker):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/path_watcher.py

@@ -56,6 +56,7 @@ class PathWatcher(Checker):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -83,6 +84,7 @@ class PathWatcher(Checker):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/port_checker.py

@@ -54,6 +54,7 @@ class PortChecker(Checker):
         port: Union[int, JinjaTemplate] = 80,
         timeout: Union[int, JinjaTemplate] = 5,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -77,6 +78,7 @@ class PortChecker(Checker):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/recurring_task.py

@@ -63,6 +63,7 @@ class RecurringTask(BaseTask):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -92,6 +93,7 @@ class RecurringTask(BaseTask):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/remote_cmd_task.py

@@ -53,6 +53,7 @@ class RemoteCmdTask(BaseRemoteCmdTask):
         cmd_path: CmdVal = "",
         cwd: Optional[Union[str, pathlib.Path]] = None,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -94,6 +95,7 @@ class RemoteCmdTask(BaseRemoteCmdTask):
             post_cmd=post_cmd,
             cwd=cwd,
             upstreams=[ensure_ssh_is_installed] + upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/resource_maker.py

@@ -57,6 +57,7 @@ class ResourceMaker(BaseTask):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -78,6 +79,7 @@ class ResourceMaker(BaseTask):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/rsync_task.py

@@ -56,6 +56,7 @@ class RsyncTask(BaseRemoteCmdTask):
         executable: Optional[str] = None,
         cwd: Optional[Union[str, pathlib.Path]] = None,
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -91,6 +92,7 @@ class RsyncTask(BaseRemoteCmdTask):
             cmd=cmd,
             cwd=cwd,
             upstreams=[ensure_rsync_is_installed] + upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/time_watcher.py

@@ -51,6 +51,7 @@ class TimeWatcher(Checker):
         color: Optional[str] = None,
         description: str = "",
         upstreams: Iterable[AnyTask] = [],
+        fallbacks: Iterable[AnyTask] = [],
         on_triggered: Optional[OnTriggered] = None,
         on_waiting: Optional[OnWaiting] = None,
         on_skipped: Optional[OnSkipped] = None,
@@ -74,6 +75,7 @@ class TimeWatcher(Checker):
             color=color,
             description=description,
             upstreams=upstreams,
+            fallbacks=fallbacks,
             on_triggered=on_triggered,
             on_waiting=on_waiting,
             on_skipped=on_skipped,

zrb/task/wiki_task.py

@@ -0,0 +1,119 @@
+import os
+
+from zrb.action.runner import Runner
+from zrb.helper.python_task import show_lines
+from zrb.helper.typecheck import typechecked
+from zrb.helper.typing import Any, Callable, Iterable, List, Mapping, Optional, Union
+from zrb.task.any_task import AnyTask
+from zrb.task.any_task_event_handler import (
+    OnFailed,
+    OnReady,
+    OnRetry,
+    OnSkipped,
+    OnStarted,
+    OnTriggered,
+    OnWaiting,
+)
+from zrb.task.task import Task
+from zrb.task_env.env import Env
+from zrb.task_env.env_file import EnvFile
+from zrb.task_group.group import Group
+from zrb.task_input.any_input import AnyInput
+
+
+@typechecked
+def create_wiki_tasks(
+    directory: str,
+    group: Optional[Group] = None,
+    inputs: Iterable[AnyInput] = [],
+    envs: Iterable[Env] = [],
+    env_files: Iterable[EnvFile] = [],
+    icon: Optional[str] = None,
+    color: Optional[str] = None,
+    upstreams: Iterable[AnyTask] = [],
+    fallbacks: Iterable[AnyTask] = [],
+    on_triggered: Optional[OnTriggered] = None,
+    on_waiting: Optional[OnWaiting] = None,
+    on_skipped: Optional[OnSkipped] = None,
+    on_started: Optional[OnStarted] = None,
+    on_ready: Optional[OnReady] = None,
+    on_retry: Optional[OnRetry] = None,
+    on_failed: Optional[OnFailed] = None,
+    should_execute: Union[bool, str, Callable[..., bool]] = True,
+    runner: Optional[Runner] = None,
+):
+    abs_directory = os.path.abspath(directory)
+    directory_structure = _get_directory_structure(abs_directory)
+    tasks: List[AnyTask] = []
+    for file_name in directory_structure["files"]:
+        if not file_name.endswith(".md"):
+            continue
+        task_name = file_name[:-3]
+        task = Task(
+            name=task_name,
+            group=group,
+            inputs=inputs,
+            envs=envs,
+            env_files=env_files,
+            icon=icon,
+            color=color,
+            upstreams=upstreams,
+            fallbacks=fallbacks,
+            on_triggered=on_triggered,
+            on_waiting=on_waiting,
+            on_skipped=on_skipped,
+            on_started=on_started,
+            on_ready=on_ready,
+            on_retry=on_retry,
+            on_failed=on_failed,
+            should_execute=should_execute,
+            run=_create_function(directory=directory, file_name=file_name),
+        )
+        if runner is not None:
+            runner.register(task)
+        tasks.append(task)
+    for dir_name in directory_structure["dirs"]:
+        sub_group = Group(name=dir_name, parent=group)
+        sub_tasks = create_wiki_tasks(
+            directory=os.path.join(abs_directory, dir_name),
+            group=sub_group,
+            inputs=inputs,
+            envs=envs,
+            env_files=env_files,
+            icon=icon,
+            color=color,
+            upstreams=upstreams,
+            fallbacks=fallbacks,
+            on_triggered=on_triggered,
+            on_waiting=on_waiting,
+            on_skipped=on_skipped,
+            on_started=on_started,
+            on_ready=on_ready,
+            on_retry=on_retry,
+            on_failed=on_failed,
+            should_execute=should_execute,
+            runner=runner,
+        )
+        tasks = tasks + sub_tasks
+    return tasks
+
+
+def _create_function(directory: str, file_name: str) -> Callable[..., Any]:
+    def fn(*args: Any, **kwargs: Any):
+        with open(os.path.join(directory, file_name)) as f:
+            content = f.read()
+            lines = content.split("\n")
+            show_lines(kwargs["_task"], *lines)
+
+    return fn
+
+
+def _get_directory_structure(path) -> Mapping[str, List[str]]:
+    contents = {"files": [], "dirs": []}
+    for item in os.listdir(path):
+        full_path = os.path.join(path, item)
+        if os.path.isdir(full_path):
+            contents["dirs"].append(item)
+        elif os.path.isfile(full_path):
+            contents["files"].append(item)
+    return contents

{zrb-0.9.3.dist-info → zrb-0.10.0.dist-info}/METADATA

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

{zrb-0.9.3.dist-info → zrb-0.10.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-zrb/__init__.py,sha256=rAdL6lnrlKAcFBrqC2otYsF-UsOyeH9pOtcQDukemDI,2440
+zrb/__init__.py,sha256=a6q4Q6WsU-IEACDBmoE3mYhtTXPKr8dj3QqOMTLLsfI,2514
 zrb/__main__.py,sha256=cNxFamU9qYt50y33wh1ekEMpRJ8_A3pPXW4wLywQaqY,314
 zrb/action/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/action/runner.py,sha256=Tphwb60lKTnW3UCSo8urn23W4qzJ4TlkY9Xwy4Sl2a8,4839
@@ -111,7 +111,7 @@ zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/docke
 zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/docker-compose.yml,sha256=NlCmer0mm-NyoF-yDRSlucgpxPrYtc6hVzAVvs8Obpg,762
 zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/image/Dockerfile,sha256=p1lq7ckHynkTakKop6pk6qcZI5en1pag5Jj71pL-lJ8,312
 zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/image/main.py,sha256=9oXlXs0J3d2fhm9flhVGA-H_XxCDsOj_dFRhyhWEjvc,511
-zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/image/pyproject.toml,sha256=j-B3WOCItCFNPYCkxoQXyAIZg6adx_4aVPn4hgYiFpM,525
+zrb/builtin/generator/docker_compose_task/template/src/kebab-zrb-task-name/image/pyproject.toml,sha256=lCuHzvgZ541o8vm-9I_hnSIL4YP_LWd4PA9jS6GRB9Y,525
 zrb/builtin/generator/fastapp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/fastapp/add.py,sha256=oNmwFxcHrzLQI_dqprTVyOc1ssC5uzqio_D530tikDk,7637
 zrb/builtin/generator/fastapp/template/_automate/snake_zrb_app_name/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -794,7 +794,7 @@ zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/docs/modular-monol
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/docs/modular-monolith/images/fastapp.png,sha256=0etGKABnezz-2igIVXrPfCeVGu1ZNCfCfEVRKqYiSek,40600
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/.gitignore,sha256=pV8ocs2GHxcYONxSStiofsLNjBiao0VxgcWQ36WWKyc,17
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/locustfile.py,sha256=Xi73PCgvtJd7lUbvN3k8fanYffct3JVTKWrGLsFjsn8,870
-zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/pyproject.toml,sha256=g8E1uRwpqRANF4szjeLo-07u1d-3ltHH9lVEGt6GaJ8,495
+zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/pyproject.toml,sha256=09Alg5DVE3yddSPyZs6apJoPcrngJXTRACc7-j4vf9E,494
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/loadtest/template.env,sha256=KVDIKgYQ-PdOTm5nho96HIgResVkn7MQy7dJWuPF65U,107
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/monitoring/clickhouse/clickhouse-cluster.xml,sha256=02gTyN8aPK3QWnYLfJHSv3SG_AgZ7lDJ5kxwRMx_uII,2870
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/monitoring/clickhouse/clickhouse-config.xml,sha256=sx3tdbrynKx9BKyRA-eFq8MUsRcD9WD3FZS-QsfpSQM,55854
@@ -1008,7 +1008,7 @@ zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/module/log/reg
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/module/log/rpc.py,sha256=Q1ClGIxzRij8oHrWKDtkb0fC_BeqCjKBi1xP962MGEc,445
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/module/log/schema/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/module/log/schema/activity.py,sha256=1Wqitx-6-UjXeFhscrbIystLm-XY2FqbUkxwbJ3sgxA,338
-zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/pyproject.toml,sha256=bnyLqnOtwFvLUFsvZgyBv7gD8hR9rxlx0QoSIG4X5d8,1000
+zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/pyproject.toml,sha256=7w5FxHFCW_LqFooddSoS1L-3NFMRWfnXN47AyL8lFTg,1000
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/schema/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/schema/frontend_config.py,sha256=l_tDK3RkTrXBKQZxMAEmiSC_rlJb956wVMp53k-4SZE,163
 zrb/builtin/generator/fastapp/template/src/kebab-zrb-app-name/src/start.sh,sha256=ssQUi5Ad8VCYR8bNCgjn49YaHtkajiDnzuY2hpdlkwU,1950
@@ -1077,11 +1077,11 @@ zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/
 zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/build.sh,sha256=BdrlubJq1b9kjtB06IIBxy615NUCh98x-eD3e9JFeAY,86
 zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/install-symlink.sh,sha256=DntlTyRlfRyxier2byya2dUqW33T2g61yhZLKELVri8,37
 zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/prepare-venv.sh,sha256=rXg-BvwoWK2xgbZvl01xHko6TZkSkb-yc_LiW8iF2n4,38
-zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/publish.sh,sha256=UjIEE_ta-wfmz3CfTfy8xrpSsZ4Ck10OyabPGTmUiZc,80
-zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/local.py,sha256=HN6baO5SbNENvxpeOrxpjSQSisZ_WTTPI0k2zcB5TC4,3131
+zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/cmd/publish.sh,sha256=eR83QHGe96VQN4ULgFF2HYI1687WXhOmZ53CN7reM9U,29
+zrb/builtin/generator/pip_package/template/_automate/snake_zrb_package_name/local.py,sha256=2MJ4kAvF__XcR8DxwVR-o_m86afPdhx3Tc_nBfoNsAQ,2844
 zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/.gitignore,sha256=0EufjWT4Uway6zeCoEbXUIHxyE0GuJD-l58Bbp8kVyo,6
 zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/README.md,sha256=hk0zeAogO6xDhpXOyqNQmWJW70tszYbqupoD94A0bF8,1995
-zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/pyproject.toml,sha256=f-1tLKqM1CQC--CxZjKQnj04XeJCSx5a6APQ9zUMpjA,764
+zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/pyproject.toml,sha256=DYYx99Z8UAB45VpBRxc2i0JBXwHlVXLFUMirIKiKUk4,764
 zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/src/snake_zrb_package_name/__init__.py,sha256=nFL5b7hvWxJ48FAtlq-kdS5HYpTaFahCuCVzxx8LvG0,38
 zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/src/snake_zrb_package_name/__main__.py,sha256=nFL5b7hvWxJ48FAtlq-kdS5HYpTaFahCuCVzxx8LvG0,38
 zrb/builtin/generator/pip_package/template/src/kebab-zrb-package-name/src/snake_zrb_package_name/util.py,sha256=A7e4ILr3Vyhb4bONNlh6NoaF_-5hLZ4YwhWrSZ40jaI,60
@@ -1095,14 +1095,14 @@ zrb/builtin/generator/plugin/template/_cmd/activate-venv.sh,sha256=DWgQyDPqIhvTK
 zrb/builtin/generator/plugin/template/_cmd/build.sh,sha256=BdrlubJq1b9kjtB06IIBxy615NUCh98x-eD3e9JFeAY,86
 zrb/builtin/generator/plugin/template/_cmd/install-symlink.sh,sha256=DntlTyRlfRyxier2byya2dUqW33T2g61yhZLKELVri8,37
 zrb/builtin/generator/plugin/template/_cmd/prepare-venv.sh,sha256=rXg-BvwoWK2xgbZvl01xHko6TZkSkb-yc_LiW8iF2n4,38
-zrb/builtin/generator/plugin/template/_cmd/publish.sh,sha256=kiF-8ngC9g-2OqDHH3Px5VLuP0q58JVh-EIPMYSLvr4,64
+zrb/builtin/generator/plugin/template/_cmd/publish.sh,sha256=eR83QHGe96VQN4ULgFF2HYI1687WXhOmZ53CN7reM9U,29
 zrb/builtin/generator/plugin/template/project.sh,sha256=yVjqMckvg2AFxDDMg6xbUjCF_t4xDt8HSLQsfe6m6lY,1938
-zrb/builtin/generator/plugin/template/pyproject.toml,sha256=vEovnqYgMWPkT8Ayh2AcZnJXDFN44xK6TyqGfEYYCj0,763
+zrb/builtin/generator/plugin/template/pyproject.toml,sha256=s45zeBuZ_6PDtqYu3BxsVgysnF7-Pqcj3-FCRceKRds,763
 zrb/builtin/generator/plugin/template/src/snake_zrb_package_name/__init__.py,sha256=5Twm0lVcddWW1tnRKDkKSkwMeuTxZgZ-GyPcr2MeyZk,130
 zrb/builtin/generator/plugin/template/src/snake_zrb_package_name/__main__.py,sha256=xniLN9eAYflMDjM9LOPlt7FATS1P6aZBkUTGa9cfv6w,121
 zrb/builtin/generator/plugin/template/src/snake_zrb_package_name/task/example_task.py,sha256=HainQwB35U6keQjN4DDm_0CKdLfLSaXDzWoVkWRAOAg,325
 zrb/builtin/generator/plugin/template/template.env,sha256=91EyYfFAatX6OB46KoH6c6Sc54yqN-lXSm5NlPuvh3Q,118
-zrb/builtin/generator/plugin/template/zrb_init.py,sha256=dneMFEC6d4jWB8-j15EigUo2FKtW3oDbpjVRQ38Cmzk,2459
+zrb/builtin/generator/plugin/template/zrb_init.py,sha256=5JOhOPMPXsIgOhnqAmW9zJU9Rwc8uinns8y6ZdHdcL0,2213
 zrb/builtin/generator/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/project/create.py,sha256=Z3h1u3ZKxlzsMOhLNxLBkUewtcArnTOGg8dO3j-6mP4,3303
 zrb/builtin/generator/project/template/.flake8,sha256=uBzLhwCiogbbtgxD9dBTGxSm_8VQ1UHpVkn2CroGl3c,56
@@ -1113,7 +1113,7 @@ zrb/builtin/generator/project/template/.python-version,sha256=rGeoqWHOE1NzOu73di
 zrb/builtin/generator/project/template/README.md,sha256=jNnkBuWhfab1HlcOqi0NKaM1O1NtTjchFrvOtR4KQPg,2026
 zrb/builtin/generator/project/template/_automate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/project/template/project.sh,sha256=yVjqMckvg2AFxDDMg6xbUjCF_t4xDt8HSLQsfe6m6lY,1938
-zrb/builtin/generator/project/template/pyproject.toml,sha256=xlAUFSQR4N9z8dfxgUCsbQYdsb1Xn_tFhUW9L9yH-To,520
+zrb/builtin/generator/project/template/pyproject.toml,sha256=RcFR64JMegOsGuO0xlvCrqkeW6yEaNmBpEQtW7nyS3g,520
 zrb/builtin/generator/project/template/src/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/builtin/generator/project/template/template.env,sha256=y7EQynzEPauiYe0Qqx2xQqg-x0FCn6tkalWfg8BpzOE,64
 zrb/builtin/generator/project/template/zrb_init.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -1157,7 +1157,7 @@ zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/.doc
 zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/.gitignore,sha256=-HAk8HPeDhUKv-zCBPehLdOdolHVNfjOi_QcdmHosus,23
 zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/Dockerfile,sha256=xTuQw_l427RQAt3zTmYN4YcA7M5szz753a88jVEdKfg,311
 zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/main.py,sha256=9oXlXs0J3d2fhm9flhVGA-H_XxCDsOj_dFRhyhWEjvc,511
-zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/pyproject.toml,sha256=oQMu5-uqgGtcLpWwMcygI-S48uA-WQ5klEC29DPbuOk,568
+zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/pyproject.toml,sha256=UPXIM0ukot6YkkEVPmG2by0aPN0Mgf8s_TbURxSADJg,568
 zrb/builtin/generator/simple_python_app/template/src/kebab-zrb-app-name/src/template.env,sha256=vtoZ0LV8OKAU1EUWBiB8PIKbf1FaNfm-49j7aXvKsgs,87
 zrb/builtin/git.py,sha256=Djz83w8_DiF1lZkWSl5HRgWlj7SArOpyQW5rQTjVUf0,3016
 zrb/builtin/group.py,sha256=LotriKtrebUzHgA4_0XzO4WPSG6Dkwb-E8_HsHPQlo8,1168
@@ -1173,7 +1173,7 @@ zrb/builtin/update.py,sha256=4CY6qqpRChaxKL0d6ckDQmziLlQTX4Q5QmEgmCJVx1s,397
 zrb/builtin/version.py,sha256=3VibJO-_AOC0Kx4thuKT2HKM0Jhe92liFFsOYrjTdeY,478
 zrb/builtin/watch_changes.py,sha256=sylF-qCSsivffjh0nd5-M4aobRpQu3S58S00X370fzQ,1191
 zrb/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/config/config.py,sha256=mqLM8TjyHsJ9Da5rFkC4IePTBtLyao-DNjM_JPuPRK4,1170
+zrb/config/config.py,sha256=h3Sx75fTi_mRntW1zkuDXSTzTdUd4HJhrQAzoaSgqsU,1266
 zrb/helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/helper/accessories/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 zrb/helper/accessories/color.py,sha256=nYoL77v-9dJATLuSyu7ySq-orIcr4hXB5CqMoxaG7qQ,805
@@ -1224,40 +1224,42 @@ zrb/helper/util.py,sha256=qaJY-r-z9O1DTg6etptQsxnUO5u165Rv0RraP0VUTiA,3545
 zrb/runner.py,sha256=MPCNPMCyiYNZeubSxd1eM2Zr6PCIKF-9pkG385AXElw,118
 zrb/shell-scripts/_common-util.sh,sha256=8zvSAbDp8z4JWxMT6s6bSnNBCfCB88gLLpK5LOhyPBg,229
 zrb/shell-scripts/ensure-docker-is-installed.sh,sha256=8CL5gYs428LPWcF43X-1O1i2YyWAOGzXTKZttiS9J1Q,2999
+zrb/shell-scripts/ensure-podman-is-installed.sh,sha256=RvLLQIBN5cfLEsFkTpomgl_PxJZ6z0Wl0VGGtjIA5JM,1529
 zrb/shell-scripts/ensure-rsync-is-installed.sh,sha256=ffr8avoCUSoDQkEBWmeelgn-EtF9reQTaM0wfW6B0hc,1146
 zrb/shell-scripts/ensure-ssh-is-installed.sh,sha256=w5pCzsbEa3bnxT07q6gX0nWn-7HXsMiwBRrg7dMD57w,2414
 zrb/shell-scripts/notify.ps1,sha256=6_xPoIwuxARpYljcjVV-iRJS3gJqGfx-B6kj719cJ9o,843
 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=VtEXfPTdi5sVYIPT5pupOrj3kjx-yhyHTyNUnn1h06U,36254
+zrb/task/any_task.py,sha256=hxL55NcbsXhMy4xa1z7pdhV5qE41QC5s63BrN81s0MQ,39020
 zrb/task/any_task_event_handler.py,sha256=vpO9t0fck8-oFu1KYptfcg2hXKRsk6V5je4Dg-Bl21o,359
-zrb/task/base_remote_cmd_task.py,sha256=_DPrUp1uzHPhM4KvduAMh6HgRX6hG5yRL7-2CWoAZjo,9220
+zrb/task/base_remote_cmd_task.py,sha256=nwEuiSF4dh3hKNfBH0ABWotx59wU-on4E6jzW2Wl67U,9296
 zrb/task/base_task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/task/base_task/base_task.py,sha256=YD8weEGKdlQlH5isBAHWtekVYlNh40QA-qd8McKYH3c,17502
+zrb/task/base_task/base_task.py,sha256=tN1f6ZWPk0YdkmP9PJFRCuwkoY1n1RuftZLXjUzKLtM,19079
 zrb/task/base_task/component/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zrb/task/base_task/component/base_task_model.py,sha256=EqfkXHjLkW7Fq_VPG3e9D3W_HCC7mgHvBHPs0Bzcdlo,10300
-zrb/task/base_task/component/common_task_model.py,sha256=-zRTWQNqddH2CZyfvmW3gc7XKxmLSU6BsR_9j2TAgdc,11275
+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=T3q7_YXwpa1pG-EFh5sptLpJanWECqOwdc1POBkHnHg,3117
-zrb/task/cmd_task.py,sha256=Di6CPSJS7RJGDIx1J-oEnijVJpjslXoP5q9K6SZ3GHA,13890
+zrb/task/checker.py,sha256=c_7vNq4Li_OdB9OXE6_VDAFazZwUKC9E7aesuksGH_I,3193
+zrb/task/cmd_task.py,sha256=wrSB-6jhPwd0dHVqGgonQjRu8qfXw7w8WH85p7yOOf4,13966
 zrb/task/decorator.py,sha256=7qEkdPoKzOIYQQnCXnjQMw0okG5rC24m7cmNxCou9r8,2887
-zrb/task/docker_compose_task.py,sha256=pOVp9t9NXPb6nHnfTSnAkX5xOkiQLnuCMZvflbt1oa4,14017
-zrb/task/flow_task.py,sha256=VsoGtxolNIdz-lHs0HSUYguVxU8c_R6CaTlsWQ_UjXU,4639
-zrb/task/http_checker.py,sha256=IZgAJk3t3rDCpo-TxQumB7Llhqd_JedMVEu1bx_rGr8,5172
-zrb/task/notifier.py,sha256=PgTekYIkQCnjshUL9p697a7wirgJVpkSs2tErHkFyXs,5986
+zrb/task/docker_compose_task.py,sha256=RYWYZFxHizbFcbkFGm5mQqKRwAm1WeXapffoJ5tEO-c,14333
+zrb/task/flow_task.py,sha256=uhwwT1Xpwcr4V9LPfJq4kyD3QC-4U9ijTAYLMBV2NIU,4715
+zrb/task/http_checker.py,sha256=QF43EuqY8FhLr7u-zVlITnjKgq6ozTy42f8kiqlBYAY,5248
+zrb/task/notifier.py,sha256=DNzRyG1goF-p6bSXWOkiJ1JO5FtXwVFaXaB63hj6GwM,6062
 zrb/task/parallel.py,sha256=HD8jTNkM-korep1vjllE4ZKS50-_P5a8rktq1QHHVd0,1042
-zrb/task/path_checker.py,sha256=qRWGgtf4SXpyFUiHyAmpktiUmK_VvOQqUJmJvatvGfM,4153
-zrb/task/path_watcher.py,sha256=QhGXO39A1avMRUNVni-lbapmtaImFC_zxqNHMXQo0gg,6268
-zrb/task/port_checker.py,sha256=2-077O1DBa9RidxnijuAx3GKsyc6oy2mmSb0XniGuZk,4072
-zrb/task/recurring_task.py,sha256=PezKAfMHtpe-CKJqZuUufcA1VGADTEnxaLP__9u95bE,7133
-zrb/task/remote_cmd_task.py,sha256=9ObPxcIFaY7kFQw2Gg34ifyeGxfA3c_T_y1KO5aoZrI,3709
-zrb/task/resource_maker.py,sha256=9lZ288jGHuBzz1jrFU_Enw_Mj2j8CS0hxzb5XSCVwnI,6576
-zrb/task/rsync_task.py,sha256=EBzeZyO-L-lUgI9ARBiLFOrgjfnEtwseZ0CXKrJHOH8,3949
+zrb/task/path_checker.py,sha256=m_M_bTVGt-dpSQxGODXcZCTXCtB7S5NTm6nNC4OOlek,4229
+zrb/task/path_watcher.py,sha256=BHtKq2lEyl6eOraJz40oSWp8AWPcyisZSaodwdiG3Io,6344
+zrb/task/port_checker.py,sha256=lOt4DG7eVe9cvQ23nLgdPHSYH2hZpw7EuKgNDkvUMFw,4148
+zrb/task/recurring_task.py,sha256=UQ90VMG6oCgKL1akkSmDPHpTj2WQ6yhs-aldoGgTOwU,7209
+zrb/task/remote_cmd_task.py,sha256=pzSqwkKsEy8pGPyiZOY1X1t5m-8bObdWBo73Fjcb508,3785
+zrb/task/resource_maker.py,sha256=QrzYlhWCAMu2_WmMr4RImbP53ppNHzeob6I5cHxX2xU,6652
+zrb/task/rsync_task.py,sha256=tYLbu7q54Fs4z3LizIb_i9IMmaGGx48JFr5S8Lgr9hg,4025
 zrb/task/task.py,sha256=38w8diC22nU5bzN2X9mfJ8PKxxMl1Q_Lrlu5uIBRuc4,182
-zrb/task/time_watcher.py,sha256=UlrwzxwzHxzdKmW6F5wEuhrCzFVk-JC89pdLKLjYOaA,3908
+zrb/task/time_watcher.py,sha256=M-GZPZIYmeBiTDeU9mgecpMJ7UMoZ1Zsj9c4OwTVa7o,3984
+zrb/task/wiki_task.py,sha256=dM4ANgGtiw0O5DK-S1WUM8VxLOG2wgxK5n6OtvN9r4M,3855
 zrb/task_env/constant.py,sha256=pWmniGJQV-74aNR7J0PYldFbL6YxZT27Nxs1jdwhH_Q,44
 zrb/task_env/env.py,sha256=y16WTzZGUJB596a2Qb_X1dhV0oYxU4JwlWf_rrHKMWo,4766
 zrb/task_env/env_file.py,sha256=BWG9ei41GrTKuTAOudneVBM-3ay88cnlM_11zWKMePE,2932
@@ -1274,8 +1276,8 @@ zrb/task_input/int_input.py,sha256=NVXAToqgdmWVwDqnr3XGuvq_QMNvUiIdD-pW5L4uebk,4
 zrb/task_input/password_input.py,sha256=5sS3XP7WtGow7r7Fid8J9SX0iNCidO6Bg7q40UpZDM0,4029
 zrb/task_input/str_input.py,sha256=D2WBeB-CdmAuOSzT7jTXvie7X3EK_m_Oq8_SVwmNpWA,4042
 zrb/task_input/task_input.py,sha256=L-U5dX-I2U5ci7GU226Q8pXcQe5SpGuOl5viFwlfiM0,2022
-zrb-0.9.3.dist-info/LICENSE,sha256=WfnGCl8G60EYOPAEkuc8C9m9pdXWDe08NsKj3TBbxsM,728
-zrb-0.9.3.dist-info/METADATA,sha256=nUsNR8qh2tGtY7Q_FRvRBPgqMLVTMajMEI5zzdxkzOA,16500
-zrb-0.9.3.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-zrb-0.9.3.dist-info/entry_points.txt,sha256=xTgXc1kBKYhJHEujdaSPHUcJT3-hbyP1mLgwkv-5sSk,40
-zrb-0.9.3.dist-info/RECORD,,
+zrb-0.10.0.dist-info/LICENSE,sha256=WfnGCl8G60EYOPAEkuc8C9m9pdXWDe08NsKj3TBbxsM,728
+zrb-0.10.0.dist-info/METADATA,sha256=ZdXksnBCBCCYXhM_SbvSWapwbHVSSTiHyCVeeaZ3r5U,16501
+zrb-0.10.0.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+zrb-0.10.0.dist-info/entry_points.txt,sha256=xTgXc1kBKYhJHEujdaSPHUcJT3-hbyP1mLgwkv-5sSk,40
+zrb-0.10.0.dist-info/RECORD,,