zrb 0.24.0__tar.gz → 0.26.2__tar.gz

zrb-0.26.2/PKG-INFO

@@ -0,0 +1,338 @@
+Metadata-Version: 2.1
+Name: zrb
+Version: 0.26.2
+Summary: A Framework to Enhance Your Workflow
+Home-page: https://github.com/state-alchemists/zrb
+License: AGPL-3.0-or-later
+Keywords: Automation,Task Runner,Code Generator,Low Code
+Author: Go Frendi Gunawan
+Author-email: gofrendiasgard@gmail.com
+Requires-Python: >=3.10.0,<4.0.0
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: Jinja2 (>=3.1.3,<3.2.0)
+Requires-Dist: aiofiles (>=23.2.1,<23.3.0)
+Requires-Dist: autopep8 (>=2.0.4,<2.1.0)
+Requires-Dist: beartype (>=0.17.2,<0.18.0)
+Requires-Dist: click (>=8.1.7,<8.2.0)
+Requires-Dist: croniter (>=2.0.2,<2.1.0)
+Requires-Dist: jsons (>=1.6.3,<1.7.0)
+Requires-Dist: libcst (>=0.4.9,<0.5.0)
+Requires-Dist: python-dotenv (>=1.0.1,<1.1.0)
+Requires-Dist: ruamel.yaml (>=0.18.6,<0.19.0)
+Requires-Dist: setuptools (>=70.0.0,<70.1.0)
+Requires-Dist: termcolor (>=2.4.0,<2.5.0)
+Requires-Dist: tomlkit (>=0.12.4,<0.13.0)
+Project-URL: Documentation, https://github.com/state-alchemists/zrb
+Project-URL: Repository, https://github.com/state-alchemists/zrb
+Description-Content-Type: text/markdown
+
+![](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/zrb/android-chrome-192x192.png)
+
+
+[🫰 Installation](https://github.com/state-alchemists/zrb/blob/main/docs/installation.md) | [📖 Documentation](https://github.com/state-alchemists/zrb/blob/main/docs/README.md) | [🏁 Getting Started](https://github.com/state-alchemists/zrb/blob/main/docs/getting-started.md) | [💃 Common Mistakes](https://github.com/state-alchemists/zrb/blob/main/docs/common-mistakes/README.md) | [❓ FAQ](https://github.com/state-alchemists/zrb/blob/main/docs/faq/README.md)
+
+
+# 🤖 Zrb: A Framework to Enhance Your Workflow
+
+Zrb is a [CLI-based](https://en.wikipedia.org/wiki/Command-line_interface) automation [tool](https://en.wikipedia.org/wiki/Programming_tool) and [low-code](https://en.wikipedia.org/wiki/Low-code_development_platform) platform. Zrb can help you to:
+
+- __Automate__ day-to-day tasks.
+- __Generate__ projects or applications.
+- __Prepare__, __run__, and __deploy__ your applications with a single command.
+- Deliver __faster__ with __fewer human errors__.
+
+Zrb allows you to write custom task definitions in [Python](https://www.python.org/), further enhancing Zrb's capabilities. Defining your tasks in Zrb gives you several advantages because:
+
+- Every Zrb Task has a __retry mechanism__.
+- Every Zrb Task is __configurable__ via __environment variables__ or __user inputs__.
+- Zrb handles your __task dependencies__ automatically.
+- Zrb runs your task dependencies __concurrently__.
+
+# 🫰 Installing Zrb
+
+You can install Zrb as a pip package by invoking the following command:
+
+```bash
+pip install zrb
+```
+
+Alternatively, you can also use our installation script to install Zrb along with some prerequisites:
+
+```bash
+bash -c "$(curl -fsSL https://raw.githubusercontent.com/state-alchemists/zrb/main/install.sh)"
+```
+
+Check our [installation guide](https://github.com/state-alchemists/zrb/blob/main/docs/installation.md) for more information about the installation methods, including installation as a docker container.
+
+# ⚙️ Zrb as A Task-Automation Tool
+
+At the very core, Zrb is a task automation tool. It helps you to automate some tedious jobs so that you can focus on what matters.
+
+Let's say you want to be able to describe the statistics property of any public CSV dataset. To do this, you need to perform three tasks like the following:
+
+- Install pandas.
+- Download the CSV dataset (at the same time).
+- Show statistics properties of the CSV dataset.
+
+```
+       🐼
+Install Pandas ─────┐           📊
+                    ├──► Show Statistics
+Download Datasets ──┘
+       ⬇️
+```
+
+Zrb Task is the smallest automation unit. You can configure a Zrb Task using user input (`inputs`) or environment variables (`envs` or `env_files`). Every Zrb Task has a configurable `retry` mechanism. Moreover, you can also define Zrb Task dependencies using the shift right operator `>>` or `upstreams` parameter.
+
+You can create a file named `zrb_init.py` and define your Zrb Tasks as follows:
+
+```python
+# File name: zrb_init.py
+from zrb import runner, Parallel, CmdTask, python_task, StrInput
+
+DEFAULT_URL = 'https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv'
+
+# 🐼 Define a task named `install-pandas` to install pandas.
+# If this task failed, we want Zrb to retry it again 4 times at most.
+install_pandas = CmdTask(
+    name='install-pandas',
+    cmd='pip install pandas',
+    retry=4
+)
+
+# ⬇️ Define a task named `download-dataset` to download dataset.
+# This task has an input named `url`.
+# The input will be accessible by using Jinja template: `{{input.url}}`
+# If this task failed, we want Zrb to retry it again 4 times at most
+download_dataset = CmdTask(
+    name='download-dataset',
+    inputs=[
+        StrInput(name='url', default=DEFAULT_URL)
+    ],
+    cmd='wget -O dataset.csv {{input.url}}',
+    retry=4
+)
+
+# 📊 Define a task named `show-stat` to show the statistics properties of the dataset.
+# @python_task` decorator turns a function into a Zrb Task (i.e., `show_stat` is now a Zrb Task).
+# If this task failed, we don't want to retry
+@python_task(
+    name='show-stats',
+    retry=0
+)
+def show_stats(*args, **kwargs):
+    import pandas as pd
+    df = pd.read_csv('dataset.csv')
+    return df.describe()
+
+# Define dependencies: `show_stat` depends on both, `download_dataset` and `install_pandas`
+Parallel(download_dataset, install_pandas) >> show_stats
+
+# Register the tasks so that they are accessble from the CLI
+runner.register(install_pandas, download_dataset, show_stats)
+```
+
+> __📝 NOTE:__ It is possible (although less readable) to define `show_stat` as `CmdTask`:
+> <details>
+> <summary>Show code</summary>
+>
+> ```python
+> show_stats = CmdTask(
+>     name='show-stats',
+>     cmd='python -c "import pandas as pd; df=pd.read_csv(\'dataset.csv\'); print(df.describe())"',
+>     retry=0
+> )
+> ```
+> </details>
+
+
+Once you write the definitions, Zrb will automatically load your `zrb_init.py` so that you can invoke your registered task:
+
+```bash
+zrb show-stat
+```
+
+The command will give you the statistics property of the dataset:
+
+```
+       sepal_length  sepal_width  petal_length  petal_width
+count    150.000000   150.000000    150.000000   150.000000
+mean       5.843333     3.054000      3.758667     1.198667
+std        0.828066     0.433594      1.764420     0.763161
+min        4.300000     2.000000      1.000000     0.100000
+25%        5.100000     2.800000      1.600000     0.300000
+50%        5.800000     3.000000      4.350000     1.300000
+75%        6.400000     3.300000      5.100000     1.800000
+max        7.900000     4.400000      6.900000     2.500000
+```
+
+<details>
+<summary>See the full output</summary>
+
+```
+Url [https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv]:
+🤖 ○ ◷ ❁ 43598 → 1/3 🐮 zrb project install-pandas • Run script: pip install pandas
+🤖 ○ ◷ ❁ 43598 → 1/3 🐮 zrb project install-pandas • Working directory: /home/gofrendi/playground/my-project
+🤖 ○ ◷ ❁ 43598 → 1/3 🍓 zrb project download-dataset • Run script: wget -O dataset.csv https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv
+🤖 ○ ◷ ❁ 43598 → 1/3 🍓 zrb project download-dataset • Working directory: /home/gofrendi/playground/my-project
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • --2023-11-12 09:45:12--  https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.111.133, 185.199.109.133, 185.199.110.133, ...
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|185.199.111.133|:443... connected.
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • HTTP request sent, awaiting response... 200 OK
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • Length: 4606 (4.5K) [text/plain]
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • Saving to: ‘dataset.csv’
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset •
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset •      0K ....                                                  100% 1.39M=0.003s
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset •
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset • 2023-11-12 09:45:12 (1.39 MB/s) - ‘dataset.csv’ saved [4606/4606]
+🤖 △ ◷ ❁ 43603 → 1/3 🍓 zrb project download-dataset •
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: pandas in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (2.1.3)
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: numpy<2,>=1.22.4 in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (from pandas) (1.26.1)
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: python-dateutil>=2.8.2 in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (from pandas) (2.8.2)
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: pytz>=2020.1 in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (from pandas) (2023.3.post1)
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: tzdata>=2022.1 in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (from pandas) (2023.3)
+🤖 ○ ◷ ❁ 43601 → 1/3 🐮 zrb project install-pandas • Requirement already satisfied: six>=1.5 in /home/gofrendi/zrb/.venv/lib/python3.10/site-packages (from python-dateutil>=2.8.2->pandas) (1.16.0)
+Support zrb growth and development!
+☕ Donate at: https://stalchmst.com/donation
+🐙 Submit issues/PR at: https://github.com/state-alchemists/zrb
+🐤 Follow us at: https://twitter.com/zarubastalchmst
+🤖 ○ ◷ 2023-11-12 09:45:14.366 ❁ 43598 → 1/3 🍎 zrb project show-stats • Completed in 2.2365798950195312 seconds
+       sepal_length  sepal_width  petal_length  petal_width
+count    150.000000   150.000000    150.000000   150.000000
+mean       5.843333     3.054000      3.758667     1.198667
+std        0.828066     0.433594      1.764420     0.763161
+min        4.300000     2.000000      1.000000     0.100000
+25%        5.100000     2.800000      1.600000     0.300000
+50%        5.800000     3.000000      4.350000     1.300000
+75%        6.400000     3.300000      5.100000     1.800000
+max        7.900000     4.400000      6.900000     2.500000
+To run again: zrb project show-stats --url "https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv"
+```
+</details>
+
+Since you have registered `install_pandas` and `download_dataset` (i.e., `runner.register(install_pandas, download_dataset)`), then you can also execute those tasks as well:
+
+```bash
+zrb install-pandas
+zrb download-dataset
+```
+
+> __📝 NOTE:__  When executing a task, you can also provide the parameter directly, for example you want to provide the `url`
+>
+> ```bash
+> zrb show-stat --url https://raw.githubusercontent.com/state-alchemists/datasets/main/iris.csv
+> ```
+>
+> When you provide the parameter directly, Zrb will not prompt you to supply the URL.
+> Another way to disable the prompt is by set `ZRB_SHOW_PROMPT` to `0` or `false`.
+
+You can also run a Docker compose file, start a Web server, generate a CRUD application, or set up multiple servers simultaneously.
+
+See [our getting started guide](https://github.com/state-alchemists/zrb/blob/main/docs/getting-started.md) and [tutorials](https://github.com/state-alchemists/zrb/blob/main/docs/tutorials/README.md) to learn more about the details.
+
+# ✂️ Zrb as A Low-Code Framework
+
+Zrb has some built-in tasks that allow you to create and run a [CRUD](https://en.wikipedia.org/wiki/Create,_read,_update_and_delete) application.
+
+Let's see the following example.
+
+```bash
+# Create a project
+zrb project create --project-dir my-project --project-name "My Project"
+cd my-project
+
+# Create a Fastapp
+zrb project add fastapp app --project-dir . --app-name "fastapp" --http-port 3000
+
+# Add library module to fastapp
+zrb project add fastapp module --project-dir . --app-name "fastapp" --module-name "library"
+
+# Add entity named "books"
+zrb project add fastapp crud --project-dir . --app-name "fastapp" --module-name "library" \
+    --entity-name "book" --plural-entity-name "books" --column-name "code"
+
+# Add column to the entity
+zrb project add fastapp field --project-dir . --app-name "fastapp" --module-name "library" \
+    --entity-name "book" --column-name "title" --column-type "string"
+
+# Run Fastapp as monolith
+zrb project fastapp monolith start
+```
+
+Once you invoke the commands, you will be able to access the CRUD application by pointing your browser to [http://localhost:3000](http://localhost:3000)
+
+![](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/fastapp.png)
+
+Furthermore, you can also split your application into `microservices`, run them as `docker containers`, and even deploy them to your `kubernetes cluster`.
+
+```bash
+# Run Fastapp as microservices
+zrb project fastapp microservices start
+
+# Run Fastapp as container
+zrb project fastapp container microservices start
+zrb project fastapp container stop
+
+# Deploy fastapp and all it's dependencies to kubernetes
+docker login
+zrb project fastapp microservices deploy
+```
+
+Visit [our tutorials](https://github.com/state-alchemists/zrb/blob/main/docs/tutorials/README.md) to see more cool tricks.
+
+# 📖 Documentation
+
+- [🫰 Installation](https://github.com/state-alchemists/zrb/blob/main/docs/installation.md)
+- [🏁 Getting Started](https://github.com/state-alchemists/zrb/blob/main/docs/getting-started.md)
+- [📖 Documentation](https://github.com/state-alchemists/zrb/blob/main/docs/README.md)
+- [💃 Common Mistakes](https://github.com/state-alchemists/zrb/blob/main/docs/common-mistakes/README.md)
+- [❓ FAQ](https://github.com/state-alchemists/zrb/blob/main/docs/faq/README.md)
+
+# 🐞 Bug Report + Feature Request
+
+You can submit bug reports and feature requests by creating a new [issue](https://github.com/state-alchemists/zrb/issues) on Zrb's GitHub Repositories. When reporting a bug or requesting a feature, please be sure to:
+
+- Include the version of Zrb you are using (i.e., `zrb version`)
+- Tell us what you have tried
+- Tell us what you expect
+- Tell us what you get
+
+We will also welcome your [pull requests and contributions](https://github.com/state-alchemists/zrb/pulls).
+
+
+# ☕ Donation
+
+Help Red Skull to click the donation button:
+
+[![](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/donator.png)](https://stalchmst.com/donation)
+
+# 🎉 Fun Fact
+
+> Madou Ring Zaruba (魔導輪ザルバ, Madōrin Zaruba) is a Madougu which supports bearers of the Garo Armor. [(Garo Wiki | Fandom)](https://garo.fandom.com/wiki/Zaruba)
+
+![Madou Ring Zaruba on Kouga's Hand](https://raw.githubusercontent.com/state-alchemists/zrb/main/_images/madou-ring-zaruba.jpg)
+
+# 🙇 Credits
+
+We are thankful for the following libraries and services. They accelerate Zrb development processes and make things more fun.
+
+- Libraries
+    - [Beartype](https://pypi.org/project/beartype/): Catch invalid typing earlier during runtime.
+    - [Click](https://pypi.org/project/click/): Creating a beautiful CLI interface.
+    - [Termcolor](https://pypi.org/project/termcolor/): Make the terminal interface more colorful.
+    - [Jinja](https://pypi.org/project/Jinja2): A robust templating engine.
+    - [Ruamel.yaml](https://pypi.org/project/ruamel.yaml/): Parse YAML effortlessly.
+    - [Jsons](https://pypi.org.project/jsons/): Parse JSON. This package should be part of the standard library.
+    - [Libcst](https://pypi.org/project/libcst/): Turn Python code into a Concrete Syntax Tree.
+    - [Croniter](https://pypi.org/project/croniter/): Parse cron pattern.
+    - [Poetry](https://pypi.org/project/poetry), [flake8](https://pypi.org/project/flake8/), [black](https://pypi.org/project/black), [isort](https://pypi.org/project/isort), and many more. See the complete list of Zrb's [pyproject.toml](https://github.com/state-alchemists/zrb/blob/main/pyproject.toml)
+- Services
+    - [asciiflow.com](https://asciiflow.com/): Creates beautiful ASCII-based diagrams.
+    - [emojipedia.org](https://emojipedia.org/): Find emoji.
+    - [emoji.aranja.com](https://emoji.aranja.com/): Turns emoji into images
+    - [favicon.io](https://favicon.io/): Turns pictures and texts (including emoji) into favicon.
+

zrb-0.26.2/pyproject.toml

@@ -0,0 +1,44 @@
+[tool.poetry]
+name = "zrb"
+version = "0.26.2"
+description = "A Framework to Enhance Your Workflow"
+authors = ["Go Frendi Gunawan <gofrendiasgard@gmail.com>"]
+license = "AGPL-3.0-or-later"
+readme = "README.md"
+homepage = "https://github.com/state-alchemists/zrb"
+repository = "https://github.com/state-alchemists/zrb"
+documentation = "https://github.com/state-alchemists/zrb"
+keywords = ["Automation", "Task Runner", "Code Generator", "Low Code"]
+
+[tool.poetry.dependencies]
+python = ">=3.10.0,<4.0.0"
+click = "~8.1.7"
+aiofiles = "~23.2.1"
+beartype = "~0.17.2"
+termcolor = "~2.4.0"
+Jinja2 = "~3.1.3"
+libcst = "~0.4.9"
+python-dotenv = "~1.0.1"
+jsons = "~1.6.3"
+"ruamel.yaml" = "~0.18.6"
+setuptools = "~70.0.0"
+autopep8 = "~2.0.4"
+croniter = "~2.0.2"
+tomlkit = "^0.12.4"
+
+[tool.poetry.dev-dependencies]
+flake8 = "~7.0.0"
+black = "~24.4.2"
+isort = "~5.13.2"
+pytest = "~7.4.0"
+pytest-cov = "~4.1.0"
+pytest-asyncio = "~0.21.0"
+flameprof = "~0.4"
+
+[tool.poetry.scripts]
+zrb = "zrb.__main__:cli"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+

zrb-0.26.2/src/zrb/action/runner.py

@@ -0,0 +1,129 @@
+import sys
+from collections.abc import Callable, Mapping
+from typing import Any, Union
+
+import click
+
+from zrb.helper.accessories.color import colored
+from zrb.helper.asyncio_task import stop_asyncio_sync
+from zrb.helper.log import logger
+from zrb.helper.typecheck import typechecked
+from zrb.task.any_task import AnyTask
+from zrb.task_group.group import Group as TaskGroup
+
+logger.debug(colored("Loading zrb.action.runner", attrs=["dark"]))
+
+CliSubcommand = Union[click.Group, click.Command]
+
+
+@typechecked
+class Runner:
+    """
+    Runner class.
+    Any tasks registered to the runner will be accessible from the terminal
+    """
+
+    def __init__(self, env_prefix: str = ""):
+        logger.info(colored("Create runner", attrs=["dark"]))
+        self.__env_prefix = env_prefix
+        self.__tasks: list[AnyTask] = []
+        self.__registered_groups: Mapping[str, click.Group] = {}
+        self.__top_levels: list[CliSubcommand] = []
+        self.__subcommands: Mapping[str, list[click.Group]] = {}
+        self.__registered_task_cli_name: list[str] = []
+        logger.info(colored("Runner created", attrs=["dark"]))
+
+    def register(self, *tasks: AnyTask):
+        for task in tasks:
+            task._set_has_cli_interface()
+            cli_name = task._get_full_cli_name()
+            if cli_name in self.__registered_task_cli_name:
+                raise RuntimeError(f'Task "{cli_name}" has already been registered')
+            logger.debug(colored(f'Register task: "{cli_name}"', attrs=["dark"]))
+            self.__tasks.append(task)
+            self.__registered_task_cli_name.append(cli_name)
+            logger.debug(colored(f'Task registered: "{cli_name}"', attrs=["dark"]))
+
+    def serve(self, cli: click.Group) -> click.Group:
+        for task in self.__tasks:
+            subcommand = self.__create_cli_subcommand(task)
+            if subcommand not in self.__top_levels:
+                self.__top_levels.append(subcommand)
+                cli.add_command(subcommand)
+        return cli
+
+    def __create_cli_subcommand(
+        self, task: AnyTask
+    ) -> Union[click.Group, click.Command]:
+        subcommand: CliSubcommand = self.__create_cli_command(task)
+        task_group = task._group
+        while task_group is not None:
+            group = self.__register_sub_command(task_group, subcommand)
+            parent_group = task_group.get_parent()
+            if parent_group is None:
+                return group
+            subcommand = group
+            task_group = parent_group
+        return subcommand
+
+    def __register_sub_command(
+        self, task_group: TaskGroup, subcommand: CliSubcommand
+    ) -> click.Group:
+        task_group_id = task_group._get_full_cli_name()
+        group = self.__get_cli_group(task_group)
+        if task_group_id not in self.__subcommands:
+            self.__subcommands[task_group_id] = []
+        if subcommand not in self.__subcommands[task_group_id]:
+            group.add_command(subcommand)
+            self.__subcommands[task_group_id].append(subcommand)
+        return group
+
+    def __get_cli_group(self, task_group: TaskGroup) -> click.Group:
+        task_group_id = task_group._get_full_cli_name()
+        if task_group_id in self.__registered_groups:
+            return self.__registered_groups[task_group_id]
+        group_cli_name = task_group.get_cli_name()
+        group_description = task_group.get_description()
+        group = click.Group(name=group_cli_name, help=group_description)
+        self.__registered_groups[task_group_id] = group
+        return group
+
+    def __create_cli_command(self, task: AnyTask) -> click.Command:
+        task_inputs = task._get_combined_inputs()
+        task_cli_name = task.get_cli_name()
+        task_description = task.get_description()
+        callback = self.__get_wrapped_task_function(task)
+        command = click.Command(
+            callback=callback, name=task_cli_name, help=task_description
+        )
+        # by default, add an argument named _args
+        command.params.append(click.Argument(["_args"], nargs=-1))
+        # add task inputs,
+        # if there are inputs with the same name, choose the first.
+        registered_input: Mapping[str, bool] = {}
+        for task_input in task_inputs:
+            if task_input.get_name() in registered_input:
+                continue
+            registered_input[task_input.get_name()] = True
+            param_decl = task_input.get_param_decl()
+            options = task_input.get_options()
+            command.params.append(click.Option(param_decl, **options))
+        return command
+
+    def __get_wrapped_task_function(self, task: AnyTask) -> Callable[..., Any]:
+        def wrapped_function(*args: Any, **kwargs: Any) -> Any:
+            function = task.to_function(
+                env_prefix=self.__env_prefix,
+                raise_error=True,
+                should_clear_xcom=True,
+                should_stop_looper=True,
+            )
+            try:
+                function(*args, **kwargs)
+            except Exception:
+                stop_asyncio_sync()
+                sys.exit(1)
+            finally:
+                task.clear_xcom()
+
+        return wrapped_function

zrb-0.26.2/src/zrb/advertisement.py

@@ -0,0 +1,21 @@
+from zrb.helper.accessories.color import colored
+from zrb.helper.advertisement import Advertisement
+from zrb.helper.log import logger
+
+logger.debug(colored("Loading zrb.advertisement", attrs=["dark"]))
+
+# flake8: noqa E501
+
+advertisements: list[Advertisement] = [
+    Advertisement(
+        content="\n".join(
+            [
+                "Support zrb growth and development!",
+                "☕ Donate at: https://stalchmst.com/donation",
+                "🐙 Submit issues/PR at: https://github.com/state-alchemists/zrb",
+                "🐤 Follow us at: https://twitter.com/zarubastalchmst",
+            ]
+        ),
+        time_pattern=".*",
+    ),
+]

zrb-0.26.2/src/zrb/builtin/__init__.py

@@ -0,0 +1,135 @@
+from zrb.builtin.base64 import base64_group, decode_base64, encode_base64
+from zrb.builtin.devtool import (
+    devtool_group,
+    devtool_install_group,
+    install_aws,
+    install_docker,
+    install_gcloud,
+    install_gvm,
+    install_helix,
+    install_helm,
+    install_kubectl,
+    install_nvm,
+    install_pulumi,
+    install_pyenv,
+    install_sdkman,
+    install_selenium,
+    install_terraform,
+    install_tmux,
+    install_zsh,
+)
+from zrb.builtin.docker import docker_group, prune_docker
+from zrb.builtin.env import env_group, get_env
+from zrb.builtin.eval import evaluate
+from zrb.builtin.explain import explain_group, explain_tasks
+from zrb.builtin.git import clear_git_branch, get_git_file_changes, git_group
+from zrb.builtin.md5 import hash_text_md5, md5_group, sum_file_md5
+from zrb.builtin.monorepo import add_to_monorepo, pull_from_monorepo, push_to_monorepo
+from zrb.builtin.process import (
+    get_process_pid_by_name,
+    get_process_pid_by_port,
+    process_group,
+    process_pid_group,
+)
+from zrb.builtin.project import (
+    add_cmd_task,
+    add_docker_compose_task,
+    add_fastapp_application,
+    add_fastapp_crud,
+    add_fastapp_field,
+    add_fastapp_module,
+    add_plugin,
+    add_project_tasks,
+    add_python_app,
+    add_python_task,
+    create_project,
+    project_add_app_group,
+    project_add_fastapp_group,
+    project_add_group,
+    project_add_task_group,
+    project_group,
+)
+from zrb.builtin.say import say
+from zrb.builtin.schedule import schedule
+from zrb.builtin.ubuntu import (
+    install_ubuntu_all,
+    install_ubuntu_essentials,
+    install_ubuntu_tex,
+    install_ubuntu_toys,
+    ubuntu_group,
+    ubuntu_install_group,
+    update_ubuntu,
+)
+from zrb.builtin.update import update_zrb
+from zrb.builtin.version import get_version
+from zrb.builtin.watch_changes import watch_changes
+
+assert base64_group
+assert decode_base64
+assert encode_base64
+assert devtool_group
+assert devtool_install_group
+assert install_aws
+assert install_docker
+assert install_gcloud
+assert install_gvm
+assert install_helix
+assert install_helm
+assert install_kubectl
+assert install_nvm
+assert install_pulumi
+assert install_pyenv
+assert install_sdkman
+assert install_selenium
+assert install_terraform
+assert install_tmux
+assert install_zsh
+assert docker_group
+assert prune_docker
+assert env_group
+assert get_env
+assert git_group
+assert clear_git_branch
+assert get_git_file_changes
+assert md5_group
+assert hash_text_md5
+assert sum_file_md5
+assert process_group
+assert process_pid_group
+assert get_process_pid_by_name
+assert get_process_pid_by_port
+assert project_group
+assert project_add_group
+assert project_add_app_group
+assert project_add_fastapp_group
+assert project_add_task_group
+assert create_project
+assert add_plugin
+assert add_fastapp_application
+assert add_fastapp_crud
+assert add_fastapp_module
+assert add_fastapp_field
+assert add_python_app
+assert add_project_tasks
+assert add_cmd_task
+assert add_docker_compose_task
+assert add_python_task
+assert add_to_monorepo
+assert pull_from_monorepo
+assert push_to_monorepo
+assert ubuntu_group
+assert ubuntu_install_group
+assert update_ubuntu
+assert ubuntu_install_group
+assert install_ubuntu_all
+assert install_ubuntu_essentials
+assert install_ubuntu_tex
+assert install_ubuntu_toys
+assert explain_group
+assert explain_tasks
+assert evaluate
+assert say
+assert schedule
+assert update_zrb
+assert get_version
+assert watch_changes