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

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

@@ -8,8 +8,15 @@ function test_bluer_objects_help() {
 
     local module
     for module in \
+        "@assets" \
+        "@assets cd" \
+        "@assets mv" \
+        "@assets publish" \
+        \
         "@cp" \
         \
+        "@create_test_asset" \
+        \
         "@objects" \
         \
         "@objects pypi" \
@@ -22,27 +29,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,14 +85,14 @@ function test_bluer_objects_help() {
         \
         "@storage" \
         "@storage clear" \
-        "@storage download_file" \
-        "@storage exists" \
-        "@storage list" \
-        "@storage rm" \
         "@storage status" \
         \
         "@upload" \
         \
+        "@web" \
+        "@web is_accessible" \
+        "@web where_am_i" \
+        \
         "@wait" \
         \
         "bluer_objects"; do

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/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,31 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_pdf_convert_inline() {
+    local options=$1
+
+    local object_name=test_bluer_objects_pdf_convert-$(bluer_ai_string_timestamp)
+
+    bluer_ai_eval ,$options \
+        bluer_objects_pdf_convert \
+        inline,install,combine,$2 \
+        bluer_objects \
+        aliases,aliases/assets.md \
+        $object_name \
+        "${@:3}"
+
+    return 0
+}
+
+function test_bluer_objects_pdf_convert() {
+    local options=$1
+
+    local object_name=test_bluer_objects_pdf_convert-2025-11-30-ci0cd7
+
+    bluer_ai_eval ,$options \
+        bluer_objects_pdf_convert \
+        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/tests/web_is_accessible.sh

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_web_is_accessible() {
+    local output=$(bluer_objects_web_is_accessible void)
+    [[ "$output" -ne 0 ]] &&
+        return 1
+
+    local url="https://iribnews.ir"
+    [[ "$abcli_is_github_workflow" == true ]] &&
+        url="https://cnn.com"
+
+    output=$(bluer_objects_web_is_accessible $url)
+    [[ "$output" -ne 1 ]] &&
+        return 1
+
+    return 0
+}

bluer_objects/.abcli/tests/web_where_am_ai.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_web_where_am_i() {
+    bluer_objects_web_where_am_i
+}

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/.abcli/url.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_objects_web() {
+    local task=$1
+
+    local function_name=bluer_objects_web_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_objects.web "$@"
+}
+
+bluer_ai_source_caller_suffix_path /web

bluer_objects/.abcli/web/is_accessible.sh

@@ -0,0 +1,13 @@
+#! /usr/bin/env bash
+
+function bluer_objects_web_is_accessible() {
+    local url=$1
+    if [[ -z "$url" ]]; then
+        bluer_ai_log_error "url not found."
+        return 1
+    fi
+
+    python3 -m bluer_objects.web \
+        is_accessible \
+        --url $url
+}

bluer_objects/.abcli/web/where_am_i.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+function bluer_objects_web_where_am_i() {
+    curl ifconfig.co/json
+}

bluer_objects/README/__init__.py

@@ -30,16 +30,31 @@ def build_me() -> bool:
             ),
         )
         for path in [
+            "../docs/aliases",
+            "../docs",
             "../..",
             ".",
-            # 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",
+        ]
+        + [
+            f"../docs/aliases/{alias}.md"
+            for alias in [
+                "assets",
+                "clone",
+                "download",
+                "file",
+                "gif",
+                "host",
+                "ls",
+                "metadata",
+                "mlflow",
+                "pdf",
+                "upload",
+            ]
+        ]
+        + [
+            f"../mlflow/{module_name}"
+            for module_name in [
+                "lock",
+            ]
         ]
     )

bluer_objects/README/alias.py

@@ -0,0 +1,56 @@
+from typing import List
+import importlib
+from pathlib import Path
+import os
+import re
+
+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/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 ""
+
+    return [
+        (
+            (
+                f"- [@{alias_name}](./{alias_name}.md)"
+                if itemized
+                else f"[@{alias_name}](./bluer_agent/docs/aliases/{alias_name}.md) "
+            )
+            if as_markdown
+            else alias_name
+        )
+        for alias_name in sorted([extract_alias_name(line) for line in content])
+        if alias_name
+    ]

bluer_objects/README/consts.py

@@ -0,0 +1,39 @@
+import os
+from typing import Union
+
+from bluer_objects.env import abcli_path_git
+
+github_kamangir = "https://github.com/kamangir"
+designs_repo = f"{github_kamangir}/bluer-designs/"
+
+
+def designs_url(suffix: str) -> str:
+    return f"{designs_repo}/blob/main/{suffix}"
+
+
+def assets_url(
+    suffix: str = "",
+    volume: Union[str, int] = "",
+) -> str:
+    return "{}/assets{}/raw/main{}".format(
+        github_kamangir,
+        str(volume),
+        f"/{suffix}" if suffix else "",
+    )
+
+
+assets = assets_url(volume="")
+assets2 = assets_url(volume="2")
+
+
+def assets_path(
+    suffix: str = "",
+    volume: Union[str, int] = "",
+) -> str:
+    return os.path.join(
+        abcli_path_git,
+        "assets{}{}".format(
+            str(volume),
+            f"/{suffix}" if suffix else "",
+        ),
+    )