start of help-refactors-2025-01-05-1ySw0l 🪄 - 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.174.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.440.1`](https://github.com/kamangir/awesome-bash-cli).
+built by 🌀 [`blue_options-4.174.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.441.1`](https://github.com/kamangir/awesome-bash-cli).

abcli/.abcli/tests/help.sh

@@ -105,6 +105,8 @@ function test_abcli_help() {
         "@seed eject" \
         "@seed list" \
         \
+        "@select" \
+        \
         "@sleep" \
         \
         "@test" \

abcli/__init__.py

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

abcli/help/functions.py

@@ -25,6 +25,7 @@
 from abcli.help.repeat import help_repeat
 from abcli.help.sagemaker import help_functions as help_sagemaker
 from abcli.help.seed import help_functions as help_seed
+from abcli.help.select import help_select
 from abcli.help.sleep import help_sleep
 from abcli.help.source import (
     help_source_caller_suffix_path,
@@ -66,6 +67,7 @@
         "repeat": help_repeat,
         "sagemaker": help_sagemaker,
         "seed": help_seed,
+        "select": help_select,
         "sleep": help_sleep,
         "source_caller_suffix_path": help_source_caller_suffix_path,
         "source_path": help_source_path,

abcli/help/select.py

@@ -0,0 +1,20 @@
+from typing import List
+
+from blue_options.terminal import show_usage, xtra
+
+
+def help_select(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("open,type=<type>,~trail", mono=mono)
+
+    return show_usage(
+        [
+            "@select",
+            "[-|<object-name>]",
+            f"[{options}]",
+        ],
+        "select <object-name>.",
+        mono=mono,
+    )