bluer-objects 6.104.1__py3-none-any.whl → 6.464.1__py3-none-any.whl

bluer_objects/.abcli/tests/file.sh

@@ -0,0 +1,64 @@
+#! /usr/bin/env bash
+
+function test_file_asset() {
+    echo $abcli_path_git/bluer-objects/bluer_objects/.abcli/tests/file.sh
+}
+
+function test_file_replace() {
+    local options=$1
+
+    local filename=$abcli_path_git/file.sh
+
+    cp -v \
+        $(test_file_asset) \
+        $filename
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_objects_file - \
+        replace \
+        $filename \
+        --this function+local \
+        --that FUNCTION+LOCAL \
+        --cat 1 \
+        "${@:2}"
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    # ---
+
+    bluer_objects_file - \
+        replace \
+        $filename \
+        --this "FUNCTION test_file_asset() {+echo" \
+        --that ":)+:(" \
+        --cat 1 \
+        --whole_line 1 \
+        "${@:2}"
+    [[ $? -ne 0 ]] && return 1
+    rm -v $filename
+}
+
+function test_file_size() {
+    local options=$1
+
+    local size=$(bluer_objects_file - \
+        size \
+        $(test_file_asset))
+
+    bluer_ai_assert \
+        "$size" \
+        "1.18 kB"
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    # ---
+
+    local size=$(bluer_objects_file - \
+        size \
+        $(test_file_asset) \
+        --pretty 0)
+
+    bluer_ai_assert \
+        "$size" \
+        "1209"
+}

bluer_objects/.abcli/tests/gif.sh

@@ -5,14 +5,14 @@ function test_bluer_objects_gif() {
 
     local source_object_name=test_bluer_objects_clone-$(bluer_ai_string_timestamp_short)
 
-    python3 -m bluer_objects.testing \
-        create_test_asset \
-        --object_name $source_object_name
+    bluer_objects_create_test_asset \
+        $source_object_name
     [[ $? -ne 0 ]] && return 1
 
     bluer_objects_gif \
         ~upload,$options \
         $source_object_name \
+        --frame_count 20 \
         --frame_duration 200 \
         --output_filename test.gif \
         --scale 2 \

bluer_objects/.abcli/tests/help.sh

@@ -3,13 +3,17 @@
 function test_bluer_objects_help() {
     local options=$1
 
-    # legacy, not tested:
-    #  - @mysql
-
     local module
     for module in \
+        "@assets" \
+        "@assets cd" \
+        "@assets mv" \
+        "@assets publish" \
+        \
         "@cp" \
         \
+        "@create_test_asset" \
+        \
         "@objects" \
         \
         "@objects pypi" \
@@ -22,27 +26,43 @@ function test_bluer_objects_help() {
         "@objects test" \
         "@objects test list" \
         \
+        "@pdf" \
+        "@pdf convert" \
+        \
         "@cp" \
         \
         "@download" \
         \
         "@gif" \
+        "@gif open" \
         \
         "@ls" \
         \
+        "@file" \
+        "@file replace" \
+        "@file size" \
+        \
         "@host" \
         "@host get" \
         "@host reboot" \
         "@host shutdown" \
         \
+        "@lock" \
+        "@lock lock" \
+        "@lock unlock" \
+        \
         "@metadata" \
+        "@metadata download" \
+        "@metadata edit" \
         "@metadata get" \
         "@metadata post" \
+        "@metadata upload" \
         \
         "@mlflow" \
         "@mlflow browse" \
         "@mlflow cache" \
         "@mlflow deploy" \
+        "@mlflow deploy set" \
         "@mlflow get_id" \
         "@mlflow get_run_id" \
         "@mlflow list_registered_models" \
@@ -62,10 +82,6 @@ function test_bluer_objects_help() {
         \
         "@storage" \
         "@storage clear" \
-        "@storage download_file" \
-        "@storage exists" \
-        "@storage list" \
-        "@storage rm" \
         "@storage status" \
         \
         "@upload" \

bluer_objects/.abcli/tests/ls.sh

@@ -3,9 +3,8 @@
 function test_bluer_objects_ls() {
     local object_name=test_bluer_objects_ls-$(bluer_ai_string_timestamp_short)
 
-    python3 -m bluer_objects.testing \
-        create_test_asset \
-        --object_name $object_name
+    bluer_objects_create_test_asset \
+        $object_name
     [[ $? -ne 0 ]] && return 1
     bluer_ai_hr
 
@@ -21,5 +20,13 @@ function test_bluer_objects_ls() {
     [[ $? -ne 0 ]] && return 1
     bluer_ai_hr
 
-    bluer_objects_ls $abcli_path_bash/tests/
+    bluer_objects_ls cloud,objects --prefix 2025-09
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_ls local,objects --prefix 2025-09
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_ls $abcli_path_git
 }

bluer_objects/.abcli/tests/metadata.sh

@@ -54,3 +54,38 @@ function test_bluer_objects_metadata() {
 
     return 0
 }
+
+function test_bluer_objects_metadata_upload_download_edit() {
+    local object_name=test_bluer_objects_metadata_upload_download_edit-$(bluer_ai_string_timestamp)
+
+    local key=key-$(bluer_ai_string_timestamp)
+    local value=value-$(bluer_ai_string_timestamp)
+
+    bluer_objects_metadata_post \
+        $key \
+        $value \
+        object \
+        $object_name \
+        --verbose 1
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_objects_metadata_upload \
+        $object_name
+    [[ $? -ne 0 ]] && return 1
+
+    rm -v $ABCLI_OBJECT_ROOT/$object_name/metadata.yaml
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_objects_metadata_download \
+        $object_name
+    [[ $? -ne 0 ]] && return 1
+
+    local value_received=$(bluer_objects_metadata_get \
+        key=$key,object \
+        $object_name)
+
+    bluer_ai_assert \
+        $value \
+        $value_received \
+        yes
+}

bluer_objects/.abcli/tests/mlflow_lock.sh

@@ -0,0 +1,30 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_mlflow_lock() {
+    local options=$1
+
+    local object_name="test-object-$(bluer_ai_string_timestamp_short)"
+    local lock_name="lock-$(bluer_ai_string_random)"
+
+    bluer_ai_eval ,$options \
+        bluer_objects_mlflow_lock \
+        lock \
+        $object_name \
+        --lock $lock_name \
+        --timeout 10
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_ai_eval ,$options \
+        bluer_objects_mlflow_lock \
+        lock \
+        $object_name \
+        --lock $lock_name \
+        --timeout 10
+    [[ $? -eq 0 ]] && return 1
+
+    bluer_ai_eval ,$options \
+        bluer_objects_mlflow_lock \
+        unlock \
+        $object_name \
+        --lock $lock_name
+}

bluer_objects/.abcli/tests/mlflow_tags.sh

@@ -24,6 +24,6 @@ function test_bluer_objects_mlflow_tags_search() {
     local options=$1
 
     bluer_objects_mlflow_tags search \
-        cloned.firms_area-template-v1=True \
+        this=that,what,~who \
         --log 0
 }

bluer_objects/.abcli/tests/open.sh

@@ -0,0 +1,11 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_open() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_ai_open \
+        ,$options \
+        $BLUER_OBJECTS_TEST_OBJECT \
+        "${@:2}"
+}

bluer_objects/.abcli/tests/open_gif_open.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_gif_open() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_objects_gif \
+        open \
+        download \
+        $BLUER_OBJECTS_TEST_OBJECT \
+        "${@:2}"
+
+    return 0
+}

bluer_objects/.abcli/tests/pdf.sh

@@ -0,0 +1,39 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_pdf_convert_inline() {
+    local options=$1
+
+    local do_install=1
+    [[ "$abcli_is_mac" == true ]] &&
+        do_install=0
+
+    local object_name=test_bluer_objects_pdf_convert-$(bluer_ai_string_timestamp)
+
+    bluer_ai_eval ,$options \
+        bluer_objects_pdf_convert \
+        inline,install=$do_install,combine,$2 \
+        bluer_objects \
+        aliases,aliases/assets.md \
+        $object_name \
+        "${@:3}"
+
+    return 0
+}
+
+function test_bluer_objects_pdf_convert() {
+    local options=$1
+
+    local do_install=1
+    [[ "$abcli_is_mac" == true ]] &&
+        do_install=0
+
+    local object_name=test_bluer_objects_pdf_convert-2025-11-30-ci0cd7
+
+    bluer_ai_eval ,$options \
+        bluer_objects_pdf_convert \
+        install=$do_install,combine,$2 \
+        $object_name \
+        "${@:3}"
+
+    return 0
+}

bluer_objects/.abcli/tests/storage_clear.sh

@@ -0,0 +1,11 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_storage_clear() {
+    local options=$1
+
+    bluer_ai_storage_clear cloud
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_ai_storage_clear cloud,public
+}

bluer_objects/.abcli/tests/storage_public_upload.sh

@@ -0,0 +1,25 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_storage_public_upload() {
+    local options=$1
+
+    local object_name=test_bluer_objects_storage_public_upload-$(bluer_ai_string_timestamp_short)
+    local object_path=$ABCLI_OBJECT_ROOT/$object_name
+    mkdir -pv $object_path
+
+    bluer_objects_create_test_asset \
+        $object_name \
+        --depth 1
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_upload \
+        public \
+        $object_name
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_upload \
+        public,zip \
+        $object_name
+}

bluer_objects/.abcli/tests/storage_status.sh

@@ -0,0 +1,12 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_storage_status() {
+    local options=$1
+
+    bluer_ai_storage_status
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_ai_storage_status \
+        depth=2,count=10
+}

bluer_objects/.abcli/tests/{storage.sh → storage_upload_download.sh}

@@ -1,20 +1,23 @@
 #! /usr/bin/env bash
 
-function test_bluer_objects_storage() {
+function test_bluer_objects_storage_upload_download() {
     local options=$1
 
-    local object_name=test_bluer_objects_storage-$(bluer_ai_string_timestamp_short)
+    local object_name=test_bluer_objects_storage_upload_download-$(bluer_ai_string_timestamp_short)
     local object_path=$ABCLI_OBJECT_ROOT/$object_name
     mkdir -pv $object_path
 
-    python3 -m bluer_objects.testing \
-        create_test_asset \
-        --object_name $object_name
+    bluer_objects_create_test_asset \
+        $object_name \
+        --depth 1
     [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
 
-    # testing upload
+    bluer_objects_ls local $object_name
+    [[ $? -ne 0 ]] && return 1
     bluer_ai_hr
 
+    # upload
     bluer_objects_upload \
         filename=this.yaml \
         $object_name
@@ -33,12 +36,15 @@ function test_bluer_objects_storage() {
     [[ $? -ne 0 ]] && return 1
     bluer_ai_hr
 
+    bluer_objects_ls cloud $object_name
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
     # clean-up
     rm -rfv $object_path
     bluer_ai_hr
 
-    # testing download
-
+    # download
     bluer_objects_download \
         filename=this.yaml \
         $object_name
@@ -54,4 +60,16 @@ function test_bluer_objects_storage() {
     bluer_objects_download \
         - \
         $object_name
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_download \
+        policy=doesnt_exist \
+        $object_name
+    [[ $? -ne 0 ]] && return 1
+    bluer_ai_hr
+
+    bluer_objects_upload \
+        zip \
+        $object_name
 }

bluer_objects/.abcli/upload.sh

@@ -3,19 +3,43 @@
 function bluer_objects_upload() {
     local options=$1
     local filename=$(bluer_ai_option "$options" filename)
+    local public=$(bluer_ai_option_int "$options" public 0)
+    local do_zip=$(bluer_ai_option_int "$options" zip 0)
 
     local object_name=$(bluer_ai_clarify_object $2 .)
     local object_path=$ABCLI_OBJECT_ROOT/$object_name
 
     rm -rf $object_path/auxiliary
 
+    if [[ "$do_zip" == 1 ]]; then
+        local zip_filename=$ABCLI_OBJECT_ROOT/$object_name.tar.gz
+
+        [[ -f "$zip_filename" ]] &&
+            rm -v $zip_filename
+
+        bluer_ai_eval - \
+            tar -czvf \
+            $zip_filename \
+            -C $ABCLI_OBJECT_ROOT $object_name
+        [[ $? -ne 0 ]] && return 1
+
+        python3 -m bluer_objects.storage \
+            upload \
+            --object_name $object_name \
+            --zip 1 \
+            --public $public
+
+        return
+    fi
+
     python3 -m bluer_objects.storage \
         upload \
         --object_name $object_name \
-        --filename "$filename"
+        --filename "$filename" \
+        --public $public
     [[ $? -ne 0 ]] && return 1
 
-    if [[ -z "$filename" ]]; then
+    if [[ -z "$filename" ]] && [[ "$public" == 0 ]]; then
         bluer_objects_mlflow_log_run $object_name
     fi
 }

bluer_objects/README/__init__.py

@@ -1,45 +1,30 @@
 import os
 
-from blueness import module
-
 from bluer_options.help.functions import get_help
-from bluer_objects import NAME as MY_NAME
+
+from bluer_objects import NAME, VERSION, REPO_NAME, ICON
 from bluer_objects import file
+from bluer_objects.README.build.docs import docs
 from bluer_objects.README.functions import build
 from bluer_objects.README.items import Items
 from bluer_objects.help.functions import help_functions
-from bluer_objects.logger import logger
-
-MY_NAME = module.name(__file__, MY_NAME)
 
 
 def build_me() -> bool:
-    from bluer_objects import NAME, VERSION, REPO_NAME, ICON
-
     return all(
         build(
-            path=os.path.join(file.path(__file__), path),
+            items=readme.get("items", []),
+            path=os.path.join(file.path(__file__), readme["path"]),
             ICON=ICON,
             NAME=NAME,
             VERSION=VERSION,
             REPO_NAME=REPO_NAME,
+            macros=readme.get("macros", {}),
             help_function=lambda tokens: get_help(
                 tokens,
                 help_functions,
                 mono=True,
             ),
         )
-        for path in [
-            "../..",
-            ".",
-            # aliases
-            "../docs/aliases/clone.md",
-            "../docs/aliases/download.md",
-            "../docs/aliases/gif.md",
-            "../docs/aliases/host.md",
-            "../docs/aliases/ls.md",
-            "../docs/aliases/metadata.md",
-            "../docs/aliases/mlflow.md",
-            "../docs/aliases/upload.md",
-        ]
+        for readme in docs
     )

bluer_objects/README/alias.py

@@ -0,0 +1,67 @@
+from typing import List
+import importlib
+from pathlib import Path
+import os
+import re
+
+from bluer_ai import NAME as BLUER_AI_NAME
+
+from bluer_objects import file
+
+
+def list_of_aliases(
+    module_name: str,
+    log: bool = False,
+    as_markdown: bool = True,
+    itemized: bool = False,
+) -> List[str]:
+    module = importlib.import_module(module_name)
+    module_path = str(Path(module.__file__).parent)
+
+    alias_sh_path = os.path.join(
+        module_path,
+        (
+            ".abcli/plugins/alias.sh"
+            if module_name == BLUER_AI_NAME
+            else ".abcli/alias.sh"
+        ),
+    )
+
+    output: List[str] = []
+
+    success, content = file.load_text(
+        alias_sh_path,
+        ignore_error=True,
+        log=log,
+    )
+    if not success:
+        return output
+
+    content = (
+        lambda content, marker: (
+            content[: content.index(marker)] if marker in content else content
+        )
+    )(content, "# ignore")
+
+    def extract_alias_name(s: str) -> str:
+        m = re.fullmatch(r"alias\s+@([^=]+)=.+", s.strip())
+        return m.group(1) if m else ""
+
+    list_of_aliases = [
+        alias_name
+        for alias_name in sorted([extract_alias_name(line) for line in content])
+        if alias_name not in ["", "."]
+    ]
+
+    return [
+        (
+            (
+                f"- [@{alias_name}](./{alias_name}.md)"
+                if itemized
+                else f"[@{alias_name}](./{module_name}/docs/aliases/{alias_name}.md) "
+            )
+            if as_markdown
+            else alias_name
+        )
+        for alias_name in list_of_aliases
+    ]

bluer_objects/README/build/aliases.py

@@ -0,0 +1,23 @@
+from bluer_objects import NAME
+from bluer_objects.README.alias import list_of_aliases
+
+
+docs = [
+    {
+        "path": "../docs/aliases",
+        "macros": {
+            "aliases:::": list_of_aliases(
+                NAME,
+                itemized=True,
+            ),
+        },
+    },
+] + [
+    {
+        "path": f"../docs/aliases/{alias_name}.md",
+    }
+    for alias_name in list_of_aliases(
+        NAME,
+        as_markdown=False,
+    )
+]

bluer_objects/README/build/docs.py

@@ -0,0 +1,23 @@
+from bluer_objects import NAME
+from bluer_objects.README.build import modules
+from bluer_objects.README.alias import list_of_aliases
+from bluer_objects.README.build import aliases
+
+docs = (
+    [
+        {
+            "path": ".",
+        },
+        {
+            "path": "../..",
+            "macros": {
+                "aliases:::": list_of_aliases(NAME),
+            },
+        },
+        {
+            "path": "../docs",
+        },
+    ]
+    + aliases.docs
+    + modules.docs
+)

bluer_objects/README/build/modules.py

@@ -0,0 +1,9 @@
+docs = [
+    {
+        "path": f"../mlflow/{module_name}",
+    }
+    for module_name in [
+        "lock",
+        "serverless",
+    ]
+]