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

bluer_objects/tests/test_README_consts.py

@@ -0,0 +1,71 @@
+import pytest
+
+from bluer_objects.env import abcli_path_git
+from bluer_objects.README.consts import (
+    assets_path,
+    assets_url,
+    designs_repo,
+    designs_url,
+    github_kamangir,
+)
+
+
+@pytest.mark.parametrize(
+    ["suffix"],
+    [
+        ["this"],
+        ["that/which"],
+    ],
+)
+@pytest.mark.parametrize(
+    ["volume"],
+    [
+        [""],
+        ["2"],
+        [2],
+    ],
+)
+def test_README_assets(
+    suffix: str,
+    volume: str,
+):
+    volume_url = assets_url(volume=volume)
+    assert isinstance(volume_url, str)
+    assert volume_url.startswith(github_kamangir)
+
+    # ---
+
+    suffix_url = assets_url(
+        suffix=suffix,
+        volume=volume,
+    )
+
+    assert isinstance(suffix_url, str)
+    assert suffix_url.endswith(suffix)
+    assert volume_url in suffix_url
+
+    # ---
+
+    suffix_path = assets_path(
+        suffix=suffix,
+        volume=volume,
+    )
+
+    assert isinstance(suffix_url, str)
+    assert suffix_path.endswith(suffix)
+    assert abcli_path_git in suffix_path
+
+
+@pytest.mark.parametrize(
+    ["suffix"],
+    [
+        ["this"],
+        ["that/which"],
+    ],
+)
+def test_README_designs_url(suffix):
+    url = designs_url(suffix=suffix)
+
+    assert isinstance(url, str)
+    assert url.startswith(designs_repo)
+    assert url.endswith(suffix)

bluer_objects/tests/test_README_items.py

@@ -0,0 +1,128 @@
+from bluer_objects.README.items import ImageItems, Items, Items_of_dict, list_of_dict
+from bluer_objects.README.consts import assets, assets2
+from bluer_objects import markdown
+from bluer_objects import env
+
+dict_of_validations = dict_of_validations = {
+    "village-1": {
+        "ugv_name": [
+            "arzhang1:ugv",
+            "arzhang2:ugv",
+            "arzhang3:anchor",
+        ],
+        "items": ImageItems(
+            {
+                f"{assets2}/arzhang/20250905_120526.jpg": "",
+                f"{assets2}/arzhang/20250905_120808.jpg": "",
+                f"{assets2}/arzhang/20250905_121030.jpg": "",
+                f"{assets2}/arzhang/20250905_121032.jpg": "",
+                f"{assets2}/arzhang/20250905_121702.jpg": "",
+                f"{assets2}/arzhang/20250905_121711.jpg": "",
+            }
+        ),
+        "marquee": f"{assets}/2025-09-05-11-48-27-d56azo/VID-20250905-WA0014_1.gif",
+    },
+    "village-2": {
+        "ugv_name": [
+            "arzhang1:ugv",
+            "arzhang2:ugv",
+            "arzhang3:anchor",
+        ],
+        "items": ImageItems(
+            {
+                f"{assets2}/arzhang/20250922_094548.jpg": "",
+                f"{assets2}/arzhang/20250922_101156.jpg": "",
+                f"{assets2}/arzhang/20250922_101409.jpg": "",
+                f"{assets2}/arzhang/20250922_101557.jpg": "",
+                f"{assets2}/arzhang/20250922_101653.jpg": "",
+                f"{assets2}/arzhang/20250922_102822.jpg": "",
+            }
+        ),
+        "macros": {
+            "debug_objects": markdown.generate_table(
+                Items(
+                    [
+                        {
+                            "name": object_name,
+                            "url": "https://{}.{}/{}".format(
+                                env.S3_PUBLIC_STORAGE_BUCKET,
+                                env.S3_STORAGE_ENDPOINT_URL.split("https://", 1)[1],
+                                f"{object_name}.tar.gz",
+                            ),
+                            "marquee": f"{assets}/{object_name}/{object_name}.gif",
+                        }
+                        for object_name in [
+                            "swallow-debug-2025-09-22-09-47-32-85hag3",
+                            "swallow-debug-2025-09-22-09-59-29-emj29v",
+                            "swallow-debug-2025-09-22-10-01-01-uzray6",
+                            "swallow-debug-2025-09-22-10-06-19-hcyl1v",
+                            "swallow-debug-2025-09-22-10-09-44-z6q9kn",
+                            "swallow-debug-2025-09-22-10-19-35-mobajm",
+                        ]
+                    ]
+                ),
+                cols=3,
+                log=False,
+            ),
+        },
+        "marquee": f"{assets}/arzhang/20250922_101202_1.gif",
+    },
+}
+
+
+def test_ImageItems():
+    items = ImageItems(
+        {
+            f"{assets2}/swallow/20250701_2206342_1.gif": "",
+            f"{assets2}/swallow/20250913_203635~2_1.gif": "",
+        }
+    )
+
+    assert isinstance(items, list)
+    for item in items:
+        assert isinstance(item, str)
+
+
+def test_Items():
+    items = Items(
+        [
+            {
+                "name": "yolo",
+                "description": "a yolo interface.",
+                "marquee": "https://github.com/kamangir/assets/raw/main/swallow-debug-2025-09-16-19-53-19-4yzsp8/swallow-debug-2025-09-16-19-53-19-4yzsp8-2.gif?raw=true",
+                "url": "./bluer_algo/docs/yolo",
+            },
+            {
+                "name": "tracker",
+                "marquee": "https://github.com/kamangir/assets/raw/main/tracker-camshift-2025-07-16-11-07-52-4u3nu4/tracker.gif?raw=true",
+                "description": "a visual tracker.",
+                "url": "./bluer_algo/docs/tracker",
+            },
+            {
+                "name": "image classifier",
+                "marquee": "https://github.com/kamangir/assets/raw/main/swallow-model-2025-07-11-15-04-03-2glcch/evaluation.png?raw=true",
+                "description": "an image classifier.",
+                "url": "./bluer_algo/docs/image_classifier",
+            },
+        ]
+    )
+
+    assert isinstance(items, list)
+    for item in items:
+        assert isinstance(item, str)
+
+
+def test_Items_of_dict():
+    items = Items_of_dict(dict_of_validations)
+
+    assert isinstance(items, list)
+    for item in items:
+        assert isinstance(item, str)
+
+
+def test_list_of_dict():
+    items = list_of_dict(dict_of_validations)
+
+    assert isinstance(items, list)
+    for item in items:
+        assert isinstance(item, str)

bluer_objects/tests/test_alias.py

@@ -0,0 +1,33 @@
+import pytest
+from bluer_objects import NAME
+from bluer_objects.README.alias import list_of_aliases
+
+
+@pytest.mark.parametrize(
+    ["alias_name", "expected_to_exist", "as_markdown", "itemized"],
+    [
+        ["void", False, False, False],
+        ["host", True, True, False],
+        ["host", True, True, True],
+    ],
+)
+def test_alias_list_of_aliases(
+    alias_name: str,
+    expected_to_exist: bool,
+    as_markdown: bool,
+    itemized: bool,
+):
+    output = list_of_aliases(
+        module_name=NAME,
+        as_markdown=as_markdown,
+        itemized=itemized,
+    )
+
+    assert isinstance(output, list)
+    for thing in output:
+        assert isinstance(thing, str)
+
+    if as_markdown:
+        return
+
+    assert (alias_name in output) == expected_to_exist

bluer_objects/tests/test_env.py

@@ -1,8 +1,12 @@
 from bluer_ai.tests.test_env import test_bluer_ai_env
 
 from bluer_objects import env
-from bluer_objects.storage.WebDAV import WebDAVInterface
-from bluer_objects.storage.WebDAVzip import WebDAVzipInterface
+from bluer_objects.storage import (
+    S3Interface,
+    WebDAVInterface,
+    WebDAVRequestInterface,
+    WebDAVzipInterface,
+)
 
 
 def test_required_env():
@@ -12,11 +16,30 @@ def test_required_env():
 def test_bluer_objects_env():
     assert env.ABCLI_MLFLOW_EXPERIMENT_PREFIX
 
+    assert env.S3_STORAGE_BUCKET
+    assert env.S3_PUBLIC_STORAGE_BUCKET
+
+    assert env.S3_STORAGE_ENDPOINT_URL
+    assert env.S3_STORAGE_AWS_ACCESS_KEY_ID
+    assert env.S3_STORAGE_AWS_SECRET_ACCESS_KEY
+
     assert env.BLUER_OBJECTS_STORAGE_INTERFACE in [
+        S3Interface.name,
         WebDAVInterface.name,
+        WebDAVRequestInterface.name,
         WebDAVzipInterface.name,
     ]
 
+    assert env.MLFLOW_DEPLOYMENT
+
+    assert isinstance(env.MLFLOW_LOCK_WAIT_FOR_CLEARANCE, int)
+    assert env.MLFLOW_LOCK_WAIT_FOR_CLEARANCE > 0
+
+    assert isinstance(env.MLFLOW_LOCK_WAIT_FOR_EXCLUSIVITY, int)
+    assert env.MLFLOW_LOCK_WAIT_FOR_EXCLUSIVITY > 0
+
     assert env.WEBDAV_HOSTNAME
     assert env.WEBDAV_LOGIN
     assert env.WEBDAV_PASSWORD
+
+    assert env.BLUER_OBJECTS_TEST_OBJECT

bluer_objects/tests/test_file_download.py

@@ -0,0 +1,25 @@
+import pytest
+
+from bluer_objects import objects, file
+
+
+@pytest.mark.parametrize(
+    ["url"],
+    [
+        ["https://raw.githubusercontent.com/jbrownlee/Datasets/master/shampoo.csv"],
+    ],
+)
+def test_file_download(url: str):
+    object_name = objects.unique_object("test_file_download")
+
+    filename = objects.path_of(
+        object_name=object_name,
+        filename=url.split("/")[-1],
+    )
+
+    assert file.download(
+        url=url,
+        filename=filename,
+    )
+
+    assert file.exists(filename)

bluer_objects/tests/test_file_load_save.py

@@ -78,7 +78,6 @@ def test_file_load_save(
         )
 
 
-@pytest.mark.unit
 @pytest.mark.parametrize(
     ["size", "dtype"],
     [
@@ -94,7 +93,7 @@ def test_file_load_save_matrix(
     size: Tuple[int, ...],
     dtype: Union[np.dtype, type],
 ) -> None:
-    object_name = objects.unique_object(test_file_load_save_matrix)
+    object_name = objects.unique_object("test_file_load_save_matrix")
 
     test_matrix = (
         np.random.randint(0, 256, size=size, dtype=dtype)

bluer_objects/tests/test_file_load_save_text.py

@@ -0,0 +1,46 @@
+import pytest
+
+from bluer_options import string
+
+from bluer_objects import file, objects
+from bluer_objects.file.load import load_text
+from bluer_objects.file.save import save_text
+from bluer_objects.tests.test_objects import test_object
+
+
+@pytest.mark.parametrize(
+    [
+        "filename",
+    ],
+    [
+        ["test.json"],
+        ["test.yaml"],
+        ["test.yaml"],
+    ],
+)
+def test_file_load_save_text(
+    test_object,
+    filename: str,
+):
+    filename_input = objects.path_of(
+        object_name=test_object,
+        filename=filename,
+    )
+    success, text_input = load_text(filename_input)
+    assert success
+
+    filename_test = file.add_suffix(
+        filename_input,
+        string.random(),
+    )
+    assert save_text(
+        filename_test,
+        text_input,
+    )
+
+    success, text_output = load_text(filename_test)
+    assert success
+
+    assert len(text_input) == len(text_output)
+    for line_input, line_output in zip(text_input, text_output):
+        assert line_input == line_output

bluer_objects/tests/test_graphics_gif.py

@@ -24,4 +24,6 @@ def test_graphics_gif_generate_animated_gif(
         list_of_images,
         objects.path_of("test.gif", test_object),
         scale=scale,
+        frame_count=10,
+        frame_duration=100,
     )

bluer_objects/tests/test_log_image_grid.py

@@ -0,0 +1,29 @@
+from bluer_objects import objects
+from bluer_objects.testing import create_test_asset
+from bluer_objects.logger.image import log_image_grid
+
+
+def test_log_image_grid():
+    object_name = objects.unique_object("test_log_image_grid")
+
+    depth = 10
+
+    assert create_test_asset(
+        object_name=object_name,
+        depth=depth,
+    )
+
+    assert log_image_grid(
+        [
+            {
+                "filename": objects.path_of(
+                    object_name=object_name,
+                    filename=f"test-{suffix:02d}.png",
+                )
+                for suffix in range(depth)
+            }
+        ],
+        objects.path_of(object_name=object_name, filename="image_grid.png"),
+        rows=2,
+        cols=5,
+    )

bluer_objects/tests/test_logger_confusion_matrix.py

@@ -0,0 +1,18 @@
+import numpy as np
+
+from bluer_objects import objects
+from bluer_objects.logger.confusion_matrix import log_confusion_matrix
+
+
+def test_logger_confusion_matrix():
+    object_name = objects.unique_object("test_logger_confusion_matrix")
+
+    confusion_matrix = np.random.random((10, 8))
+
+    assert log_confusion_matrix(
+        confusion_matrix,
+        objects.path_of(
+            object_name=object_name,
+            filename="confusion_matrix.png",
+        ),
+    )

bluer_objects/tests/test_logger_matrix.py

@@ -18,7 +18,7 @@ def test_log_matrix(
     test_image,
     verbose: bool,
 ):
-    object_name = objects.unique_object()
+    object_name = objects.unique_object("test_log_matrix")
 
     assert log_matrix(
         matrix=test_image,
@@ -58,7 +58,7 @@ def test_log_matrix_hist(
     test_image,
     verbose: bool,
 ):
-    object_name = objects.unique_object()
+    object_name = objects.unique_object("test_log_matrix_hist")
 
     assert log_matrix_hist(
         matrix=test_image,

bluer_objects/tests/test_logger_stitch_images.py

@@ -0,0 +1,47 @@
+import pytest
+import numpy as np
+import random
+
+from bluer_objects.logger.stitch import stitch_images
+
+
+@pytest.mark.parametrize(
+    ["count"],
+    [[count] for count in range(10)],
+)
+@pytest.mark.parametrize(
+    ["cols"],
+    [[cols] for cols in [-1, 1, 3]],
+)
+@pytest.mark.parametrize(
+    ["rows"],
+    [[rows] for rows in [-1, 1, 3]],
+)
+def test_logger_stitch_images(
+    count: int,
+    cols: int,
+    rows: int,
+):
+    rng = np.random.default_rng()
+
+    list_of_images = list_of_images = [
+        rng.integers(
+            0,
+            256,
+            (
+                random.randint(1, 512),
+                random.randint(1, 512),
+                random.choice([1, 3]),
+            ),
+            dtype=np.uint8,
+        )
+        for _ in range(count)
+    ]
+
+    image = stitch_images(
+        list_of_images,
+        cols=cols,
+        rows=rows,
+        log=True,
+    )
+    assert isinstance(image, np.ndarray)

bluer_objects/tests/test_metadata.py

@@ -77,7 +77,8 @@ def test_metadata(
     get_source: Callable[[str], str],
     get_source_type: MetadataSourceType,
 ):
-    object_name = unique_object()
+    object_name = unique_object("test_metadata")
+
     key = random()
     value = random()
 
@@ -98,7 +99,8 @@ def test_metadata(
 
 
 def test_metadata_dict():
-    object_name = unique_object()
+    object_name = unique_object("test_metadata_dict")
+
     key = random()
     value = {random(): random() for _ in range(10)}
 
@@ -138,7 +140,8 @@ def test_metadata_dict():
 
 
 def test_metadata_file():
-    object_name = unique_object()
+    object_name = unique_object("test_metadata_file")
+
     key = random()
     value = random()
 
@@ -153,7 +156,8 @@ def test_metadata_file():
 
 
 def test_metadata_object():
-    object_name = unique_object()
+    object_name = unique_object("test_metadata_object")
+
     key = random()
     value = random()
 
@@ -163,7 +167,8 @@ def test_metadata_object():
 
 
 def test_metadata_path():
-    object_name = unique_object()
+    object_name = unique_object("test_metadata_path")
+
     key = random()
     value = random()
 
@@ -175,7 +180,8 @@ def test_metadata_path():
 
 
 def test_metadata_upload():
-    object_name = unique_object()
+    object_name = unique_object("test_metadata_upload")
+
     key = random()
     value = random()
 

bluer_objects/tests/test_metadata_flatten.py

@@ -0,0 +1,109 @@
+import pytest
+import numpy as np
+
+from bluer_objects.metadata import flatten
+
+
+test_objects = [
+    np.zeros((4, 5)),
+    [np.zeros((4, 5)) for _ in range(5)],
+    tuple(np.zeros((4, 5)) for _ in range(5)),
+    {"this": np.zeros((4, 5))},
+    {"this": 1, "that": 2},
+]
+
+test_flatten_objects = [
+    [
+        [0.0, 0.0, 0.0, 0.0, 0.0],
+        [0.0, 0.0, 0.0, 0.0, 0.0],
+        [0.0, 0.0, 0.0, 0.0, 0.0],
+        [0.0, 0.0, 0.0, 0.0, 0.0],
+    ],
+    [
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+    ],
+    (
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+        [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ],
+    ),
+    {
+        "this": [
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+            [0.0, 0.0, 0.0, 0.0, 0.0],
+        ]
+    },
+    {"this": 1, "that": 2},
+]
+
+
+@pytest.mark.parametrize(
+    ["obj", "flatten_obj"],
+    [
+        [obj, flatten_obj]
+        for obj, flatten_obj in zip(
+            test_objects,
+            test_flatten_objects,
+        )
+    ],
+)
+def test_metadata_flatten(obj, flatten_obj):
+    assert flatten(obj) == flatten_obj

bluer_objects/tests/test_mlflow.py

@@ -11,7 +11,7 @@ from bluer_objects.mlflow import testing
 
 
 def test_from_and_to_experiment_name():
-    object_name = unique_object()
+    object_name = unique_object("test_from_and_to_experiment_name")
 
     assert (
         objects.to_object_name(objects.to_experiment_name(object_name)) == object_name
@@ -27,7 +27,7 @@ def test_mlflow_testing():
     [["x=1,y=2,z=3"]],
 )
 def test_mlflow_tag_set_get(tags_str: str):
-    object_name = unique_object("test_mlflow_tag_set")
+    object_name = unique_object("test_mlflow_tag_set_get")
 
     assert tags.set_tags(
         object_name,