bluer-objects 6.32.1__tar.gz → 6.34.1__tar.gz

{bluer_objects-6.32.1/bluer_objects.egg-info → bluer_objects-6.34.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.32.1
+Version: 6.34.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.32.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.34.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.96.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.32.1 → bluer_objects-6.34.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.32.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.34.1`](https://github.com/kamangir/bluer-objects).

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/.abcli/alias.sh

@@ -12,8 +12,8 @@ alias @cache=abcli_cache
 alias @ref="abcli_cache read"
 alias @tags=abcli_mlflow_tags
 
-alias @clone=abcli_clone
-alias @cp=abcli_clone
+alias @clone=bluer_objects_clone
+alias @cp=bluer_objects_clone
 
 alias @file=bluer_objects_file
 

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/.abcli/clone.sh

@@ -1,37 +1,9 @@
 #! /usr/bin/env bash
 
-function abcli_clone() {
+function bluer_objects_clone() {
     local options=$1
     local do_relate=$(abcli_option_int "$options" relate 1)
     local do_upload=$(abcli_option_int "$options" upload 0)
-
-    local from_s3=$(abcli_option_int "$options" s3 0)
-    if [[ "$from_s3" == 1 ]]; then
-        local s3_uri=${2:-void}
-
-        local object_name=$(abcli_clarify_object $3 .)
-        local object_path=$ABCLI_OBJECT_ROOT/$object_name
-        mkdir -pv $object_path
-
-        abcli_log "$s3_uri -clone-> $object_name"
-
-        aws s3 sync \
-            "$s3_uri" \
-            "$object_path" \
-            --exact-timestamps
-        [[ $? -ne 0 ]] && return 1
-
-        [[ "$do_relate" == 1 ]] &&
-            abcli_mlflow_tags set \
-                $object_name \
-                cloned.$s3_uri
-
-        [[ "$do_upload" == 1 ]] &&
-            bluer_objects_upload - $object_name
-
-        return 0
-    fi
-
     local clone_tags=$(abcli_option_int "$options" tags 1)
     local copy_content=$(abcli_option_int "$options" content 1)
     local do_download=$(abcli_option_int "$options" download 1)

bluer_objects-6.34.1/bluer_objects/.abcli/tests/clone.sh

@@ -0,0 +1,19 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_clone() {
+    local options=$1
+
+    local source_object_name=test_bluer_objects_clone-$(abcli_string_timestamp_short)
+
+    python3 -m bluer_objects.testing \
+        create_test_asset \
+        --object_name $source_object_name
+    [[ $? -ne 0 ]] && return 1
+
+    local object_name=test_bluer_objects_clone-$(abcli_string_timestamp_short)
+
+    bluer_objects_clone \
+        ~relate,~tags,~upload,$options \
+        $source_object_name \
+        $object_name
+}

bluer_objects-6.34.1/bluer_objects/.abcli/tests/gif.sh

@@ -0,0 +1,20 @@
+#! /usr/bin/env bash
+
+function test_bluer_objects_gif() {
+    local options=$1
+
+    local source_object_name=test_bluer_objects_clone-$(abcli_string_timestamp_short)
+
+    python3 -m bluer_objects.testing \
+        create_test_asset \
+        --object_name $source_object_name
+    [[ $? -ne 0 ]] && return 1
+
+    abcli_gif \
+        ~upload,$options \
+        $source_object_name \
+        --frame_duration 200 \
+        --output_filename test.gif \
+        --scale 2 \
+        --suffix .png
+}

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/.abcli/tests/help.sh

@@ -11,6 +11,8 @@ function test_bluer_objects_help() {
         "@assets" \
         "@assets publish" \
         \
+        "@cp" \
+        \
         "@objects" \
         \
         "@objects pypi" \

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/.abcli/tests/storage.sh

@@ -7,25 +7,22 @@ function test_bluer_objects_storage() {
     local object_path=$ABCLI_OBJECT_ROOT/$object_name
     mkdir -pv $object_path
 
-    local suffix
-    local extension=yaml
-    for suffix in this.$extension that.$extension subfolder/this.$extension subfolder/that.$extension; do
-        python3 -m bluer_objects.file \
-            create_a_file \
-            --filename $object_path/$suffix
-    done
+    python3 -m bluer_objects.testing \
+        create_test_asset \
+        --object_name $object_name
+    [[ $? -ne 0 ]] && return 1
 
     # testing upload
     abcli_hr
 
     bluer_objects_upload \
-        filename=this.$extension \
+        filename=this.yaml \
         $object_name
     [[ $? -ne 0 ]] && return 1
     abcli_hr
 
     bluer_objects_upload \
-        filename=subfolder/this.$extension \
+        filename=subfolder/this.yaml \
         $object_name
     [[ $? -ne 0 ]] && return 1
     abcli_hr
@@ -43,13 +40,13 @@ function test_bluer_objects_storage() {
     # testing download
 
     bluer_objects_download \
-        filename=this.$extension \
+        filename=this.yaml \
         $object_name
     [[ $? -ne 0 ]] && return 1
     abcli_hr
 
     bluer_objects_download \
-        filename=subfolder/this.$extension \
+        filename=subfolder/this.yaml \
         $object_name
     [[ $? -ne 0 ]] && return 1
     abcli_hr

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/README/functions.py

@@ -60,7 +60,6 @@ def build(
     table_of_items = markdown.generate_table(items, cols=cols) if cols > 0 else items
 
     signature = [
-        # f'to use on [AWS SageMaker](https://aws.amazon.com/sagemaker/) replace `<plugin-name>` with "{NAME}" and follow [these instructions](https://github.com/kamangir/notebooks-and-scripts/blob/main/SageMaker.md).',
         "",
         " ".join(
             [

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/__init__.py

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

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/file/__main__.py

@@ -14,7 +14,7 @@ parser = argparse.ArgumentParser(NAME)
 parser.add_argument(
     "task",
     type=str,
-    help="create_a_file | replace | size",
+    help="replace | size",
 )
 parser.add_argument(
     "--filename",
@@ -38,15 +38,7 @@ parser.add_argument(
 args = parser.parse_args()
 
 success = False
-if args.task == "create_a_file":
-    success = file.save_yaml(
-        args.filename,
-        {
-            string.random(length=args.size): string.random(length=args.size)
-            for _ in range(args.size)
-        },
-    )
-elif args.task == "replace":
+if args.task == "replace":
     logger.info(f"{NAME}.{args.task}: {args.this} -> {args.that} in {args.filename}")
 
     success, content = file.load_text(args.filename)

bluer_objects-6.34.1/bluer_objects/help/clone.py

@@ -0,0 +1,28 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+
+def help_clone(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "".join(
+        [
+            xtra("~content,cp,~download,", mono=mono),
+            "~relate",
+            xtra(",~tags,", mono=mono),
+            "upload",
+        ]
+    )
+
+    return show_usage(
+        [
+            "@cp",
+            f"[{options}]",
+            "[..|<object-1>]",
+            "[.|<object-2>]",
+        ],
+        "copy <object-1> -> <object-2>.",
+        mono=mono,
+    )

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/help/functions.py

@@ -1,6 +1,7 @@
 from bluer_ai.help.generic import help_functions as generic_help_functions
 
 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.upload import help_upload
 
@@ -8,6 +9,7 @@ help_functions = generic_help_functions(plugin_name=ALIAS)
 
 help_functions.update(
     {
+        "clone": help_clone,
         "download": help_download,
         "upload": help_upload,
     }

bluer_objects-6.34.1/bluer_objects/testing/__init__.py

@@ -0,0 +1 @@
+from bluer_objects.testing.functions import create_test_asset

bluer_objects-6.34.1/bluer_objects/testing/__main__.py

@@ -0,0 +1,32 @@
+import argparse
+
+from blueness import module
+from blueness.argparse.generic import sys_exit
+
+from bluer_objects import NAME
+from bluer_objects.testing import create_test_asset
+from bluer_objects.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+parser = argparse.ArgumentParser(NAME)
+parser.add_argument(
+    "task",
+    type=str,
+    help="create_test_asset",
+)
+parser.add_argument(
+    "--object_name",
+    type=str,
+)
+args = parser.parse_args()
+
+success = False
+if args.task == "create_test_asset":
+    success = create_test_asset(
+        object_name=args.object_name,
+    )
+else:
+    success = None
+
+sys_exit(logger, NAME, args.task, success)

bluer_objects-6.34.1/bluer_objects/testing/functions.py

@@ -0,0 +1,60 @@
+from blueness import module
+import numpy as np
+
+from bluer_options import string
+
+from bluer_objects import NAME
+from bluer_objects import file, objects
+from bluer_objects.logger import logger
+
+
+NAME = module.name(__file__, NAME)
+
+
+def create_test_asset(
+    object_name: str,
+    depth: int = 10,
+) -> bool:
+    logger.info(f"{NAME}.create_test_asset: {object_name}")
+
+    for suffix in range(10):
+        if not file.save_image(
+            objects.path_of(
+                object_name=object_name,
+                filename=f"test-{suffix:02d}.png",
+            ),
+            (np.random.rand(512, 512, 3) * 255).astype(np.uint8),
+            log=True,
+        ):
+            return False
+
+    data = {
+        string.random(length=depth): string.random(length=depth) for _ in range(depth)
+    }
+
+    for filename in [
+        "this.yaml",
+        "that.yaml",
+        "subfolder/this.yaml",
+        "subfolder/that.yaml",
+        "test.yaml",
+    ]:
+        if not file.save_yaml(
+            objects.path_of(
+                object_name=object_name,
+                filename=filename,
+            ),
+            data,
+        ):
+            return False
+
+    if not file.save_json(
+        objects.path_of(
+            object_name=object_name,
+            filename="test.json",
+        ),
+        data,
+    ):
+        return False
+
+    return True

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects/tests/test_objects.py

@@ -1,45 +1,15 @@
 import pytest
-import numpy as np
-
-from bluer_options import string
 
 from bluer_objects import file, path, objects
-from bluer_objects import storage
+from bluer_objects.testing import create_test_asset
 from bluer_objects.logger import logger
 
 
 @pytest.fixture
 def test_object():
     object_name = objects.unique_object("test_object")
-    for suffix in range(10):
-        assert file.save_image(
-            objects.path_of(
-                object_name=object_name,
-                filename=f"test-{suffix:02d}.png",
-            ),
-            (np.random.rand(512, 512, 3) * 255).astype(np.uint8),
-        )
-
-    depth = 10
-    data = {
-        string.random(length=depth): string.random(length=depth) for _ in range(depth)
-    }
-
-    assert file.save_yaml(
-        objects.path_of(
-            object_name=object_name,
-            filename="test.yaml",
-        ),
-        data,
-    )
 
-    assert file.save_json(
-        objects.path_of(
-            object_name=object_name,
-            filename="test.json",
-        ),
-        data,
-    )
+    assert create_test_asset(object_name)
 
     yield object_name
 

bluer_objects-6.34.1/bluer_objects/tests/test_testing.py

@@ -0,0 +1,8 @@
+from bluer_objects import objects
+from bluer_objects.testing import create_test_asset
+
+
+def test_bluer_objects_testing():
+    object_name = objects.unique_object("test_bluer_objects_testing")
+
+    assert create_test_asset(object_name)

{bluer_objects-6.32.1 → bluer_objects-6.34.1/bluer_objects.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.32.1
+Version: 6.34.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.32.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.34.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.96.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/bluer_objects.egg-info/SOURCES.txt

@@ -89,6 +89,7 @@ bluer_objects/graphics/signature.py
 bluer_objects/graphics/text.py
 bluer_objects/help/__init__.py
 bluer_objects/help/__main__.py
+bluer_objects/help/clone.py
 bluer_objects/help/download.py
 bluer_objects/help/functions.py
 bluer_objects/help/upload.py
@@ -116,6 +117,9 @@ bluer_objects/storage/WebDAVzip.py
 bluer_objects/storage/__init__.py
 bluer_objects/storage/__main__.py
 bluer_objects/storage/base.py
+bluer_objects/testing/__init__.py
+bluer_objects/testing/__main__.py
+bluer_objects/testing/functions.py
 bluer_objects/tests/__init__.py
 bluer_objects/tests/test_README.py
 bluer_objects/tests/test_env.py
@@ -135,4 +139,5 @@ bluer_objects/tests/test_mlflow.py
 bluer_objects/tests/test_objects.py
 bluer_objects/tests/test_path.py
 bluer_objects/tests/test_storage.py
+bluer_objects/tests/test_testing.py
 bluer_objects/tests/test_version.py

{bluer_objects-6.32.1 → bluer_objects-6.34.1}/setup.py

@@ -18,6 +18,7 @@ setup(
         f"{NAME}.mlflow",
         f"{NAME}.README",
         f"{NAME}.storage",
+        f"{NAME}.testing",
         f"{NAME}.tests",
     ],
     include_package_data=True,

bluer_objects-6.32.1/bluer_objects/.abcli/tests/clone.sh

@@ -1,32 +0,0 @@
-#! /usr/bin/env bash
-
-function test_bluer_objects_clone() {
-    local options=$1
-
-    local source_object_name=$(abcli_mlflow_tags_search \
-        contains=latest-giza \
-        --log 0 \
-        --count 1)
-    abcli_assert $source_object_name - non-empty
-
-    local from_s3
-    for from_s3 in 0 1; do
-        local object_name=test_bluer_objects_clone-$(abcli_string_timestamp_short)
-
-        if [[ "$from_s3" == 0 ]]; then
-            abcli_clone \
-                ~relate,~tags,~upload,$options \
-                $source_object_name \
-                $object_name
-            [[ $? -ne 0 ]] && return 1
-        else
-            abcli_clone \
-                ~relate,s3,~upload,$options \
-                $ABCLI_S3_OBJECT_PREFIX/$source_object_name \
-                $object_name
-            [[ $? -ne 0 ]] && return 1
-        fi
-    done
-
-    return 0
-}

bluer_objects-6.32.1/bluer_objects/.abcli/tests/gif.sh

@@ -1,13 +0,0 @@
-#! /usr/bin/env bash
-
-function test_bluer_objects_gif() {
-    local options=$1
-
-    abcli_gif \
-        ~upload,$options \
-        $VANWATCH_TEST_OBJECT \
-        --frame_duration 200 \
-        --output_filename test.gif \
-        --scale 2 \
-        --suffix .png
-}