release + help refactor - kamangir/bolt#746

README.md

@@ -63,4 +63,4 @@ create a copy of [`sample.env`](./abcli/sample.env) as `.env` and fill in the se
 
 [![pylint](https://github.com/kamangir/awesome-bash-cli/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/awesome-bash-cli/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/awesome-bash-cli/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/awesome-bash-cli/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/awesome-bash-cli/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/awesome-bash-cli/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/abcli.svg)](https://pypi.org/project/abcli/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/abcli)](https://pypistats.org/packages/abcli)
 
-built by 🌀 [`blue_options-4.149.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.403.1`](https://github.com/kamangir/awesome-bash-cli).
+built by 🌀 [`blue_options-4.150.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.404.1`](https://github.com/kamangir/awesome-bash-cli).

abcli/.abcli/tests/eval.sh

@@ -0,0 +1,9 @@
+#! /usr/bin/env bash
+
+function test_abcli_eval() {
+    abcli_eval - ls
+    abcli_assert "$?" 0
+
+    abcli_eval - lsz
+    abcli_assert "$?" 0 not
+}

abcli/.abcli/tests/help.sh

@@ -53,14 +53,16 @@ function test_abcli_help() {
         "@plugins list_of_installed" \
         "@plugins transform" \
         \
-        "abcli_sleep" \
+        "@repeat" \
+        \
+        "@sleep" \
         \
         "@terraform" \
         "@terraform cat" \
         "@terraform disable" \
         "@terraform enable" \
         \
-        "abcli_watch" \
+        "@watch" \
         \
         "abcli"; do
         abcli_eval ,$options \

abcli/.abcli/tests/repeat.sh

@@ -0,0 +1,9 @@
+#! /usr/bin/env bash
+
+function test_abcli_repeat() {
+    abcli_repeat - ls
+    abcli_assert "$?" 0
+
+    abcli_repeat count=3 ls
+    abcli_assert "$?" 0
+}

abcli/__init__.py

@@ -6,7 +6,7 @@
 
 DESCRIPTION = f"{ICON} a language to speak AI."
 
-VERSION = "9.403.1"
+VERSION = "9.404.1"
 
 REPO_NAME = "awesome-bash-cli"
 

abcli/help/eval.py

@@ -0,0 +1,25 @@
+from typing import List
+
+from blue_options.terminal import show_usage, xtra
+
+
+def options(mono: bool):
+    return xtra(
+        "dryrun,~log,path=<path>",
+        mono=mono,
+    )
+
+
+def help_eval(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@eval",
+            f"[{options(mono=mono)}]",
+            "<command-line>",
+        ],
+        "eval <command-line>.",
+        mono=mono,
+    )

abcli/help/functions.py

@@ -2,6 +2,7 @@
 from abcli.help.cp import help_cp
 from abcli.help.docker import help_functions as help_docker
 from abcli.help.download import help_download
+from abcli.help.eval import help_eval
 from abcli.help.gif import help_gif
 from abcli.help.git import help_functions as help_git
 from abcli.help.gpu import help_functions as help_gpu
@@ -13,6 +14,7 @@
 from abcli.help.notebooks import help_functions as help_notebooks
 from abcli.help.plugins import help_functions as help_plugins
 from abcli.help.pytest import help_pytest
+from abcli.help.repeat import help_repeat
 from abcli.help.sagemaker import help_functions as help_sagemaker
 from abcli.help.sleep import help_sleep
 from abcli.help.terraform import help_functions as help_terraform
@@ -24,6 +26,7 @@
     "cp": help_cp,
     "docker": help_docker,
     "download": help_download,
+    "eval": help_eval,
     "gif": help_gif,
     "git": help_git,
     "gpu": help_gpu,
@@ -35,6 +38,7 @@
     "notebooks": help_notebooks,
     "plugins": help_plugins,
     "pytest": help_pytest,
+    "repeat": help_repeat,
     "sagemaker": help_sagemaker,
     "sleep": help_sleep,
     "terraform": help_terraform,

abcli/help/repeat.py

@@ -0,0 +1,27 @@
+from typing import List
+
+from blue_options.terminal import show_usage
+
+from abcli.help.eval import options as eval_options
+
+
+def help_repeat(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            "count=<count>,",
+            eval_options(mono=mono),
+        ]
+    )
+
+    return show_usage(
+        [
+            "@repeat",
+            f"[{options}]",
+            "<command-line>",
+        ],
+        "repeat <command-line>.",
+        mono=mono,
+    )

abcli/help/watch.py

@@ -1,13 +1,18 @@
 from typing import List
 
-from blue_options.terminal import show_usage
+from blue_options.terminal import show_usage, xtra
 
 
 def help_watch(
     tokens: List[str],
     mono: bool,
 ) -> str:
-    options = "~clear,dryrun,seconds=<seconds>"
+    options = "".join(
+        [
+            xtra("~clear,dryrun,", mono=mono),
+            "seconds=<seconds>",
+        ]
+    )
 
     return show_usage(
         [