@help @ls - 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.167.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.430.1`](https://github.com/kamangir/awesome-bash-cli).
+built by 🌀 [`blue_options-4.169.1`](https://github.com/kamangir/awesome-bash-cli), based on 🪄 [`abcli-9.431.1`](https://github.com/kamangir/awesome-bash-cli).

abcli/.abcli/tests/help.sh

@@ -66,6 +66,8 @@ function test_abcli_help() {
         "@latex build" \
         "@latex install" \
         \
+        "@ls" \
+        \
         "@pause" \
         \
         "@plugins get_module_name" \

abcli/__init__.py

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

abcli/help/functions.py

@@ -14,6 +14,7 @@
 from abcli.help.latex import help_functions as help_latex
 from abcli.help.logging import help_cat, help_log_list
 from abcli.help.logging import help_functions as help_log
+from abcli.help.ls import help_ls
 from abcli.help.metadata import help_functions as help_metadata
 from abcli.help.mlflow import help_functions as help_mlflow
 from abcli.help.notebooks import help_functions as help_notebooks
@@ -53,6 +54,7 @@
         "init": help_init,
         "latex": help_latex,
         "log": help_log,
+        "ls": help_ls,
         "metadata": help_metadata,
         "mlflow": help_mlflow,
         "notebooks": help_notebooks,

abcli/help/ls.py

@@ -0,0 +1,30 @@
+from typing import List
+
+from blue_options.terminal import show_usage
+
+
+def help_ls(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return "\n".join(
+        [
+            show_usage(
+                [
+                    "@ls",
+                    "cloud | local",
+                    "<object-name>",
+                ],
+                "ls <object-name>",
+                mono=mono,
+            ),
+            show_usage(
+                [
+                    "@ls",
+                    "<path>",
+                ],
+                "ls <path>.",
+                mono=mono,
+            ),
+        ]
+    )