bluer-objects 6.35.1__tar.gz → 6.37.1__tar.gz

{bluer_objects-6.35.1/bluer_objects.egg-info → bluer_objects-6.37.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.35.1
+Version: 6.37.1
 Summary: 🌀 data objects for Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -53,6 +53,6 @@ Also home to [blue README](https://github.com/kamangir/bluer-objects/blob/main/b
 
 [![pylint](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/bluer-objects.svg)](https://pypi.org/project/bluer-objects/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/bluer-objects)](https://pypistats.org/packages/bluer-objects)
 
-built by 🌀 [`bluer_options-5.28.1`](https://github.com/kamangir/awesome-bash-cli), based on 🌀 [`bluer_objects-6.35.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer_options-5.28.1`](https://github.com/kamangir/awesome-bash-cli), based on 🌀 [`bluer_objects-6.37.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.96.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/README.md

@@ -19,4 +19,4 @@ Also home to [blue README](./bluer_objects/README/).
 
 [![pylint](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/bluer-objects/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/bluer-objects.svg)](https://pypi.org/project/bluer-objects/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/bluer-objects)](https://pypistats.org/packages/bluer-objects)
 
-built by 🌀 [`bluer_options-5.28.1`](https://github.com/kamangir/awesome-bash-cli), based on 🌀 [`bluer_objects-6.35.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer_options-5.28.1`](https://github.com/kamangir/awesome-bash-cli), based on 🌀 [`bluer_objects-6.37.1`](https://github.com/kamangir/bluer-objects).

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/alias.sh

@@ -4,26 +4,26 @@ alias @ai=bluer_ai
 
 alias @download=bluer_objects_download
 
-alias @gif=abcli_gif
+alias @gif=bluer_objects_gif
 
-alias @assets=abcli_assets
+alias @assets=bluer_objects_assets
 
-alias @cache=abcli_cache
-alias @ref="abcli_cache read"
-alias @tags=abcli_mlflow_tags
+alias @cache=bluer_objects_mlflow_cache
+alias @ref="bluer_objects_mlflow_cache read"
+alias @tags=bluer_objects_mlflow_tags
 
 alias @clone=bluer_objects_clone
 alias @cp=bluer_objects_clone
 
 alias @file=bluer_objects_file
 
-alias @host=abcli_host
+alias @host=bluer_objects_host
 
 alias @ls=bluer_ai_ls
 
 alias @metadata=bluer_objects_metadata
 
-alias @mlflow=abcli_mlflow
+alias @mlflow=bluer_objects_mlflow
 
 alias @mysql=abcli_mysql
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/clone.sh

@@ -36,12 +36,12 @@ function bluer_objects_clone() {
     fi
 
     [[ "$clone_tags" == 1 ]] &&
-        abcli_mlflow_tags clone \
+        bluer_objects_mlflow_tags clone \
             $object_1_name \
             $object_2_name
 
     [[ "$do_relate" == 1 ]] &&
-        abcli_mlflow_tags set \
+        bluer_objects_mlflow_tags set \
             $object_2_name \
             cloned.$object_1_name
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/gif.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_gif() {
+function bluer_objects_gif() {
     local options=$1
     local do_dryrun=$(abcli_option_int "$options" dryrun 0)
     local do_download=$(abcli_option_int "$options" download $(abcli_not $do_dryrun))

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/host.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_host() {
+function bluer_objects_host() {
     local task=$1
     local options=$2
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/browse.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_browse() {
+function bluer_objects_mlflow_browse() {
     local options=$1
     local browse_experiment=$(abcli_option_int "$options" experiment 0)
 
@@ -15,7 +15,7 @@ function abcli_mlflow_browse() {
     else
         local object_name=$(abcli_clarify_object $2 .)
 
-        local experiment_id=$(abcli_mlflow get_id $object_name)
+        local experiment_id=$(bluer_objects_mlflow get_id $object_name)
         if [ -z "$experiment_id" ]; then
             abcli_log_error "@mlflow: browse: $object_name: object not found."
             return 1
@@ -25,7 +25,7 @@ function abcli_mlflow_browse() {
         url="$url/experiments/$experiment_id"
 
         if [[ "$browse_experiment" == 0 ]]; then
-            local last_run_id=$(abcli_mlflow get_run_id $object_name --count 1)
+            local last_run_id=$(bluer_objects_mlflow get_run_id $object_name --count 1)
             abcli_log "last run id: $last_run_id"
 
             url="$url/runs/$last_run_id"

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/cache.sh

@@ -1,13 +1,13 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_cache() {
+function bluer_objects_mlflow_cache() {
     local task=$1
 
     local keyword=$2
 
     if [ "$task" == "read" ]; then
 
-        abcli_mlflow_tags get \
+        bluer_objects_mlflow_tags get \
             $keyword \
             --tag referent \
             "${@:3}"
@@ -18,7 +18,7 @@ function abcli_mlflow_cache() {
     if [ "$task" == "write" ]; then
         local value=$3
 
-        abcli_mlflow_tags set \
+        bluer_objects_mlflow_tags set \
             $keyword \
             referent=$value \
             "${@:4}"

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/list_registered_models.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_list_registered_models() {
+function bluer_objects_mlflow_list_registered_models() {
     local options=$1
 
     python3 -m bluer_objects.mlflow \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/log_artifacts.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_log_artifacts() {
+function bluer_objects_mlflow_log_artifacts() {
     local object_name=$(abcli_clarify_object $1 .)
 
     python3 -m bluer_objects.mlflow \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/log_run.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_log_run() {
+function bluer_objects_mlflow_log_run() {
     local object_name=$(abcli_clarify_object $1 .)
 
     python3 -m bluer_objects.mlflow \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/run.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_run() {
+function bluer_objects_mlflow_run() {
     local object_name=$(abcli_clarify_object $1 .)
 
     python3 -m bluer_objects.mlflow \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/tags/clone.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_tags_clone() {
+function bluer_objects_mlflow_tags_clone() {
     local source_object=$(abcli_clarify_object $1 ..)
 
     local destination_object=$(abcli_clarify_object $2 .)

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/tags/get.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_tags_get() {
+function bluer_objects_mlflow_tags_get() {
     local object_name=$(abcli_clarify_object $1 .)
 
     python3 -m bluer_objects.mlflow \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/tags/search.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_tags_search() {
+function bluer_objects_mlflow_tags_search() {
     local options=$1
     local is_explicit=$(abcli_option_int "$options" explicit 0)
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/tags/set.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_tags_set() {
+function bluer_objects_mlflow_tags_set() {
     local object_name=$(abcli_clarify_object $1 .)
 
     local tags=$2

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/tags.sh

@@ -1,9 +1,9 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_tags() {
+function bluer_objects_mlflow_tags() {
     local task=$1
 
-    local function_name=abcli_mlflow_tags_$task
+    local function_name=bluer_objects_mlflow_tags_$task
     if [[ $(type -t $function_name) == "function" ]]; then
         $function_name "${@:2}"
         return

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/test.sh

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-function abcli_mlflow_test() {
+function bluer_objects_mlflow_test() {
     local options=$1
     local do_dryrun=$(abcli_option_int "$options" dryrun 0)
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow/transition.sh

@@ -2,7 +2,7 @@
 
 export ABCLI_MLFLOW_STAGES="Staging|Production|Archived"
 
-function abcli_mlflow_transition() {
+function bluer_objects_mlflow_transition() {
     local options=$1
     local model_name=$(abcli_option "$options" model)
     local stage_name=$(abcli_option_choice "$options" $(echo $ABCLI_MLFLOW_STAGES | tr \| ,) Staging)

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/mlflow.sh

@@ -2,10 +2,10 @@
 
 export MLFLOW_TRACKING_URI=$HOME/mlruns
 
-function abcli_mlflow() {
+function bluer_objects_mlflow() {
     local task=$1
 
-    local function_name=abcli_mlflow_$task
+    local function_name=bluer_objects_mlflow_$task
     if [[ $(type -t $function_name) == "function" ]]; then
         $function_name "${@:2}"
         return

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/publish.sh

@@ -11,7 +11,7 @@ function bluer_ai_publish() {
     [[ "$do_download" == 1 ]] &&
         bluer_objects_download - $object_name
 
-    abcli_mlflow_tags set $object_name published
+    bluer_objects_mlflow_tags set $object_name published
 
     local public_object_name=$(abcli_option "$options" as $object_name)
 

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/gif.sh

@@ -10,7 +10,7 @@ function test_bluer_objects_gif() {
         --object_name $source_object_name
     [[ $? -ne 0 ]] && return 1
 
-    abcli_gif \
+    bluer_objects_gif \
         ~upload,$options \
         $source_object_name \
         --frame_duration 200 \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/help.sh

@@ -58,9 +58,6 @@ function test_bluer_objects_help() {
         "@mlflow test" \
         "@mlflow transition" \
         \
-        "@object" \
-        "@object open" \
-        \
         "@publish" \
         \
         "@select" \

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/host.sh

@@ -2,6 +2,6 @@
 
 function test_bluer_objects_host() {
     abcli_assert \
-        $(abcli_host get name) \
+        $(bluer_objects_host get name) \
         - non-empty
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/mlflow_cache.sh

@@ -4,11 +4,11 @@ function test_bluer_objects_mlflow_cache() {
     local keyword="test-keyword-$(abcli_string_timestamp_short)"
     local value="test-value-$(abcli_string_timestamp_short)"
 
-    abcli mlflow cache write \
+    bluer_objects_mlflow cache write \
         $keyword $value
     [[ $? -ne 0 ]] && return 1
 
     abcli_assert \
-        $(abcli mlflow cache read $keyword) \
+        $(bluer_objects_mlflow cache read $keyword) \
         $value
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/mlflow_logging.sh

@@ -3,10 +3,10 @@
 function test_bluer_objects_mlflow_logging() {
     local object_name="test-object-$(abcli_string_timestamp_short)"
 
-    abcli clone \
+    bluer_objects_clone \
         upload \
         vanwatch-mlflow-validation-2024-09-23-10673 \
         "$object_name"
 
-    abcli_mlflow rm $object_name
+    bluer_objects_mlflow rm $object_name
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/mlflow_tags.sh

@@ -5,25 +5,25 @@ function test_bluer_objects_mlflow_tags_validation() {
     local tag="test-tag-$(abcli_string_timestamp_short)"
     local value="test-value-$(abcli_string_timestamp_short)"
 
-    abcli mlflow tags set \
+    bluer_objects_mlflow tags set \
         $object_name \
         $tag=$value
     [[ $? -ne 0 ]] && return 1
 
     abcli_assert \
-        "$(abcli mlflow tags get $object_name --tag $tag)" \
+        "$(bluer_objects_mlflow tags get $object_name --tag $tag)" \
         $value
     [[ $? -ne 0 ]] && return 1
 
     abcli_assert \
-        "$(abcli mlflow tags get $object_name --tag some-tag)" \
+        "$(bluer_objects_mlflow tags get $object_name --tag some-tag)" \
         - empty
 }
 
 function test_bluer_objects_mlflow_tags_search() {
     local options=$1
 
-    abcli_mlflow_tags search \
+    bluer_objects_mlflow_tags search \
         cloned.firms_area-template-v1=True \
         --log 0
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/tests/mlflow_test.sh

@@ -3,5 +3,5 @@
 function test_bluer_objects_mlflow_test() {
     local options=$1
 
-    abcli_mlflow_test "$@"
+    bluer_objects_mlflow_test "$@"
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/.abcli/upload.sh

@@ -16,6 +16,6 @@ function bluer_objects_upload() {
     [[ $? -ne 0 ]] && return 1
 
     if [[ -z "$filename" ]]; then
-        abcli_mlflow_log_run $object_name
+        bluer_objects_mlflow_log_run $object_name
     fi
 }

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/__init__.py

@@ -4,7 +4,7 @@ ICON = "🌀"
 
 DESCRIPTION = f"{ICON} data objects for Bash."
 
-VERSION = "6.35.1"
+VERSION = "6.37.1"
 
 REPO_NAME = "bluer-objects"
 

bluer_objects-6.37.1/bluer_objects/help/assets.py

@@ -0,0 +1,38 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+
+def help_publish(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            xtra("download,", mono=mono),
+            "extensions=png+geojson",
+            xtra(",~pull,", mono=mono),
+            "push",
+        ]
+    )
+
+    args = [
+        "[--prefix <prefix>]",
+    ]
+
+    return show_usage(
+        [
+            "@assets",
+            "publish",
+            f"[{options}]",
+            "[.|<object-name>]",
+        ]
+        + args,
+        "<object-name>/<prefix> -> assets.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "publish": help_publish,
+}

{bluer_objects-6.35.1 → bluer_objects-6.37.1}/bluer_objects/help/functions.py

@@ -1,18 +1,26 @@
 from bluer_ai.help.generic import help_functions as generic_help_functions
 
 from bluer_objects import ALIAS
+from bluer_objects.help.assets import help_functions as help_assets
 from bluer_objects.help.clone import help_clone
 from bluer_objects.help.download import help_download
+from bluer_objects.help.gif import help_gif
+from bluer_objects.help.host import help_functions as help_host
 from bluer_objects.help.metadata import help_functions as help_metadata
+from bluer_objects.help.mlflow import help_functions as help_mlflow
 from bluer_objects.help.upload import help_upload
 
 help_functions = generic_help_functions(plugin_name=ALIAS)
 
 help_functions.update(
     {
+        "assets": help_assets,
         "clone": help_clone,
         "download": help_download,
+        "gif": help_gif,
+        "host": help_host,
         "metadata": help_metadata,
+        "mlflow": help_mlflow,
         "upload": help_upload,
     }
 )

bluer_objects-6.37.1/bluer_objects/help/gif.py

@@ -0,0 +1,28 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+
+def help_gif(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("~download,dryrun,~upload", mono=mono)
+
+    args = [
+        "[--frame_duration <150>]",
+        "[--output_filename <object-name>.gif]",
+        "[--scale <1>]",
+        "[--suffix <.png>]",
+    ]
+
+    return show_usage(
+        [
+            "@gif",
+            f"[{options}]",
+            "[.|<object-name>]",
+        ]
+        + args,
+        "generate <object-name>.gif.",
+        mono=mono,
+    )

bluer_objects-6.37.1/bluer_objects/help/host.py

@@ -0,0 +1,61 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+
+def help_get(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "name"
+
+    return show_usage(
+        [
+            "@host",
+            "get",
+            f"[{options}]",
+        ],
+        "get $abcli_host_name.",
+        mono=mono,
+    )
+
+
+def help_reboot(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("dryrun", mono=mono)
+
+    return show_usage(
+        [
+            "@host",
+            "reboot",
+            f"[{options}]",
+        ],
+        "reboot host.",
+        mono=mono,
+    )
+
+
+def help_shutdown(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("dryrun", mono=mono)
+
+    return show_usage(
+        [
+            "@host",
+            "shutdown",
+            f"[{options}]",
+        ],
+        "shutdown host.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "get": help_get,
+    "reboot": help_reboot,
+    "shutdown": help_shutdown,
+}