bluer-objects 6.292.1__py3-none-any.whl → 6.299.1__py3-none-any.whl

bluer_objects/README/consts.py

@@ -1,5 +1,8 @@
+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/"
 
@@ -8,19 +11,29 @@ def designs_url(suffix: str) -> str:
     return f"{designs_repo}/blob/main/{suffix}"
 
 
-def asset_volume(volume: Union[str, int] = "") -> str:
-    return f"{github_kamangir}/assets{str(volume)}/raw/main"
+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 = asset_volume(volume="")
-assets2 = asset_volume(volume="2")
+assets = assets_url(volume="")
+assets2 = assets_url(volume="2")
 
 
 def assets_path(
-    suffix: str,
+    suffix: str = "",
     volume: Union[str, int] = "",
 ) -> str:
-    return "{}/{}".format(
-        asset_volume(volume=volume),
-        suffix,
+    return os.path.join(
+        abcli_path_git,
+        "assets{}{}".format(
+            str(volume),
+            f"/{suffix}" if suffix else "",
+        ),
     )

bluer_objects/README/items.py

@@ -59,3 +59,36 @@ def Items(
         output = sorted(output)
 
     return output
+
+
+# dict of {name, url, marquee, description}
+def Items_of_dict(
+    dict_of_things: Dict[str, Dict],
+) -> List[str]:
+    return Items(
+        sorted(
+            [
+                {
+                    "name": thing_name,
+                    "marquee": info.get("marquee", ""),
+                    "url": f"./{thing_name}.md",
+                }
+                for thing_name, info in dict_of_things.items()
+                if thing_name != "template"
+            ],
+            key=lambda x: x["name"],
+        )
+    )
+
+
+# dict of {name, url, marquee, description}
+def list_of_dict(
+    dict_of_things: Dict[str, Dict],
+) -> List[str]:
+    return sorted(
+        [
+            f"- [{thing_name}](./{thing_name}.md)"
+            for thing_name in dict_of_things
+            if thing_name != "template"
+        ]
+    )

bluer_objects/__init__.py

@@ -4,7 +4,7 @@ ICON = "🌀"
 
 DESCRIPTION = f"{ICON} Object management in Bash."
 
-VERSION = "6.292.1"
+VERSION = "6.299.1"
 
 REPO_NAME = "bluer-objects"
 

bluer_objects/tests/test_README_consts.py

@@ -1,9 +1,12 @@
 import pytest
+
+from bluer_objects.env import abcli_path_git
 from bluer_objects.README.consts import (
     assets_path,
-    asset_volume,
+    assets_url,
     designs_repo,
     designs_url,
+    github_kamangir,
 )
 
 
@@ -26,18 +29,31 @@ def test_README_assets(
     suffix: str,
     volume: str,
 ):
-    volume_path = asset_volume(volume=volume)
-    assert isinstance(volume_path, str)
-    assert volume_path.endswith(volume_path)
+    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
+
+    # ---
 
-    path = assets_path(
+    suffix_path = assets_path(
         suffix=suffix,
         volume=volume,
     )
 
-    assert isinstance(path, str)
-    assert path.endswith(suffix)
-    assert volume_path in path
+    assert isinstance(suffix_url, str)
+    assert suffix_path.endswith(suffix)
+    assert abcli_path_git in suffix_path
 
 
 @pytest.mark.parametrize(

bluer_objects/tests/test_README_items.py

@@ -0,0 +1,120 @@
+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": "arzhang",
+        "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": "arzhang",
+        "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-6.292.1.dist-info → bluer_objects-6.299.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.292.1
+Version: 6.299.1
 Summary: 🌀 Object management in Bash.
 Home-page: https://github.com/kamangir/bluer-objects
 Author: Arash Abadpour (Kamangir)
@@ -65,6 +65,6 @@ pip install bluer-objects
 
 [![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 README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.292.1`](https://github.com/kamangir/bluer-objects).
+built by 🌀 [`bluer README`](https://github.com/kamangir/bluer-objects/tree/main/bluer_objects/README), based on 🌀 [`bluer_objects-6.299.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.292.1.dist-info → bluer_objects-6.299.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-bluer_objects/__init__.py,sha256=-GIdP2jG8Ggl4MNlq7WUPFuSCo-pd19UXGan7aEC9hg,315
+bluer_objects/__init__.py,sha256=sqJ1EoYw9xYt3IVvH_jIOJzCZ4UOdyXpiyZL7AVSWS8,315
 bluer_objects/__main__.py,sha256=Yqfov833_hJuRne19WrGhT5DWAPtdffpoMxeSXS7EGw,359
 bluer_objects/config.env,sha256=ReX0OSH_dK2tdD4-zAlp-427BB57yw8uDTS6tLYN4K0,270
 bluer_objects/env.py,sha256=ecwldUVsamxAjOI0a6PmbZPcyhdUZgzJ-nhAPh0CJRo,2085
@@ -74,9 +74,9 @@ bluer_objects/.abcli/tests/web_where_am_ai.sh,sha256=BJ9G_m4id8cx_UB_l_jV2xY6AfQ
 bluer_objects/.abcli/web/is_accessible.sh,sha256=Luv_6IvpscRYx7f39V0RnkkNEWTRfVGyQVUeij3iqa0,262
 bluer_objects/.abcli/web/where_am_i.sh,sha256=QPBXFo6Ni4pZEoOx0rtuJUxk6tOlp0ESMyAc9YPy9zg,92
 bluer_objects/README/__init__.py,sha256=AG9_REFcYVrfMbzK4y02Omie-fCjf6UBP4OnJyNSZ6w,1434
-bluer_objects/README/consts.py,sha256=pJgOJTXHSCh95Lcyl4AyG4t2l1eEp5dAO1hjosv9YMo,566
+bluer_objects/README/consts.py,sha256=GYQ8EikslsUfr8JcrXoU0w4eMIGWpIiNmlchTQbSYV0,803
 bluer_objects/README/functions.py,sha256=PvFawBlJ8IginQn8Kk1QewAyOYRQ4wCuRKpJwr5mUJ8,5844
-bluer_objects/README/items.py,sha256=go4BpNhpdjiRIHf6EHDR5x9YlnboIgkvg7KvCt5rbVU,1508
+bluer_objects/README/items.py,sha256=yWMGI_znoYaF2wQRC9Qn96ybtn-OzN5yOzxKoVL73Xc,2328
 bluer_objects/README/utils.py,sha256=WsEm0ad-gpMGMJ6X11W2nXYY5fBokOGPGNFvzjYZc5o,8241
 bluer_objects/assets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bluer_objects/assets/__main__.py,sha256=X1s4ABevs8y5pafPIhZBj5oFX_kMOLWLTMaCFF6_Rio,1064
@@ -148,7 +148,8 @@ bluer_objects/testing/__main__.py,sha256=hhJV9qn0V_8FxzNDcoHCHr4A7zf9UudnNGJCAPk
 bluer_objects/testing/functions.py,sha256=AXAfzWLcEPkbSYTehdahshjKJ45C4IJkRs_TgrHOntc,1355
 bluer_objects/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bluer_objects/tests/test_README.py,sha256=5D4UV8VcjbeAPThsYVynYtVFuP8gwMAhIjEWuOQZsWs,89
-bluer_objects/tests/test_README_consts.py,sha256=bkPsl1g2k-Zcs9oZSlYmRIZraU4X_ZHUsOYoruUhj1Q,975
+bluer_objects/tests/test_README_consts.py,sha256=fBDNjmPrQN0WhF0AtrTVRcEDQMW02MfLFQPgI3U2PcI,1290
+bluer_objects/tests/test_README_items.py,sha256=K_tRZcifZUpV5WqWaf10mYG2Wi1FouMHQGXtCQxYYkk,4382
 bluer_objects/tests/test_env.py,sha256=HgVCbnHGLIXK8GiaWNWORW9nAHs7fqvIoo6S5Jj29-g,1132
 bluer_objects/tests/test_file_download.py,sha256=1_adHYqgSifkdP-I7TQVW0t8MLCujQ61fvRbcrSkcmg,512
 bluer_objects/tests/test_file_load_save.py,sha256=unqxfiqba6RVhMS95AtHZWsT7Q097jBOKdckAT9PyFU,2390
@@ -181,8 +182,8 @@ bluer_objects/tests/test_web_is_accessible.py,sha256=2Y20NAEDMblg0MKnhnqcfw3XVKE
 bluer_objects/web/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 bluer_objects/web/__main__.py,sha256=xf2Ob54FI8JEokfGhFmiyOBdD9nBactwqmZvsKsdioU,624
 bluer_objects/web/functions.py,sha256=KNufAFOc6N3BYf83lN2rUpKUdsnzb2anWyp9koFRVUo,172
-bluer_objects-6.292.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
-bluer_objects-6.292.1.dist-info/METADATA,sha256=Csb3DeU3bKYrafXdeDaS1W6sk-sQpS5dnOiuVarb1Ns,3780
-bluer_objects-6.292.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bluer_objects-6.292.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
-bluer_objects-6.292.1.dist-info/RECORD,,
+bluer_objects-6.299.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
+bluer_objects-6.299.1.dist-info/METADATA,sha256=TDGDtXKcNnE_7CgTtPdYTSM5FYJDLOcX_ieOs6m7XKY,3780
+bluer_objects-6.299.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bluer_objects-6.299.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
+bluer_objects-6.299.1.dist-info/RECORD,,