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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.35.1
+Version: 6.36.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.36.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.36.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.36.1`](https://github.com/kamangir/bluer-objects).

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

@@ -8,9 +8,9 @@ alias @gif=abcli_gif
 
 alias @assets=abcli_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
@@ -23,7 +23,7 @@ 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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.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.36.1}/bluer_objects/__init__.py

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

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

@@ -4,6 +4,7 @@ from bluer_objects import ALIAS
 from bluer_objects.help.clone import help_clone
 from bluer_objects.help.download import help_download
 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)
@@ -13,6 +14,7 @@ help_functions.update(
         "clone": help_clone,
         "download": help_download,
         "metadata": help_metadata,
+        "mlflow": help_mlflow,
         "upload": help_upload,
     }
 )

bluer_objects-6.36.1/bluer_objects/help/mlflow/__init__.py

@@ -0,0 +1,194 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+from bluer_objects.help.mlflow.cache import help_functions as help_cache
+from bluer_objects.help.mlflow.tags import help_functions as help_tags
+from bluer_ai import env
+
+
+def help_browse(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "databricks,experiment,host,models"
+
+    return show_usage(
+        [
+            "@mlflow",
+            "browse",
+            f"[{options}]",
+            "[.|<object-name>]",
+        ],
+        "browse mlflow.",
+        mono=mono,
+    )
+
+
+def help_get_id(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "get_id",
+            "[.|<object-name>]",
+        ],
+        "get mlflow id for <object-name>.",
+        mono=mono,
+    )
+
+
+def help_get_run_id(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    args = [
+        "[--count <1>]",
+        "[--delim <space>]",
+        "[--offset <0>]",
+    ]
+
+    return show_usage(
+        [
+            "@mlflow",
+            "get_run_id",
+            "[.|<object-name>]",
+        ]
+        + args,
+        "get mlflow run ids for <object-name>.",
+        mono=mono,
+    )
+
+
+def help_list_registered_models(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "list_registered_models",
+        ],
+        "list mlflow registered models.",
+        mono=mono,
+    )
+
+
+def help_log_artifacts(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    args = ["[--model_name <model-name>]"]
+
+    return show_usage(
+        [
+            "@mlflow",
+            "log_artifacts",
+            "[.|<object-name>]",
+        ]
+        + args,
+        "<object-name> -artifacts-> mlflow.",
+        mono=mono,
+    )
+
+
+def help_log_run(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "log_run",
+            "[.|<object-name>]",
+        ],
+        "<object-name> -run-> mlflow.",
+        mono=mono,
+    )
+
+
+def help_rm(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "rm",
+            "[.|<object-name>]",
+        ],
+        "rm <object-name> from mlflow.",
+        mono=mono,
+    )
+
+
+def help_run(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "run",
+            "start | end",
+            "[.|<object-name>]",
+        ],
+        "start | end mlflow run.",
+        mono=mono,
+    )
+
+
+def help_test(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("dryrun", mono=mono)
+
+    return show_usage(
+        [
+            "@mlflow",
+            "test",
+            f"[{options}]",
+        ],
+        "test mlflow.",
+        mono=mono,
+    )
+
+
+def help_transition(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "model=<model-name>,stage=<stage>,version=<version>"
+
+    return show_usage(
+        [
+            "@mlflow",
+            "transition",
+            f"[{options}]",
+            "[<description>]",
+        ],
+        "transition <model-name>.",
+        {
+            "stage: {}".format(" | ".join(env.ABCLI_MLFLOW_STAGES.split("|"))): "",
+        },
+        mono=mono,
+    )
+
+
+help_functions = {
+    "browse": help_browse,
+    "cache": help_cache,
+    "get_id": help_get_id,
+    "get_run_id": help_get_run_id,
+    "list_registered_models": help_list_registered_models,
+    "log_artifacts": help_log_artifacts,
+    "log_run": help_log_run,
+    "rm": help_rm,
+    "run": help_run,
+    "tags": help_tags,
+    "test": help_test,
+    "transition": help_transition,
+}

bluer_objects-6.36.1/bluer_objects/help/mlflow/cache.py

@@ -0,0 +1,42 @@
+from typing import List
+
+from bluer_options.terminal import show_usage
+
+
+def help_read(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "cache",
+            "read",
+            "<keyword>",
+        ],
+        "read mlflow.cache[<keyword>].",
+        mono=mono,
+    )
+
+
+def help_write(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@mlflow",
+            "cache",
+            "write",
+            "<keyword>",
+            "<value>",
+        ],
+        "write mlflow.cache[<keyword>]=value.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "read": help_read,
+    "write": help_write,
+}