bluer-objects 6.294.1__py3-none-any.whl → 6.301.1__py3-none-any.whl

bluer_objects/.abcli/host.sh

@@ -12,15 +12,31 @@ function bluer_objects_host() {
         return
     fi
 
-    if [ $task == "reboot" ]; then
-        bluer_ai_eval ,$options \
-            sudo reboot
-        return
-    fi
+    if [[ "|reboot|shutdown|" == *"|$task|"* ]]; then
+        local command_line
+        [[ $task == "reboot" ]] &&
+            command_line="sudo reboot"
+        [[ $task == "shutdown" ]] &&
+            command_line="sudo shutdown -h now"
+
+        local rpi=$(bluer_ai_option_int "$options" rpi 0)
+        if [[ "$rpi" == 1 ]]; then
+            local machine_name=$3
+            if [[ -z "$machine_name" ]]; then
+                bluer_ai_log_error "machine_name not found."
+                return 1
+            fi
+
+            ssh \
+                pi@$machine_name.local \
+                $command_line
+
+            return
+        fi
 
-    if [ $task == "shutdown" ]; then
         bluer_ai_eval ,$options \
-            sudo shutdown -h now
+            $command_line
+
         return
     fi
 

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.294.1"
+VERSION = "6.301.1"
 
 REPO_NAME = "bluer-objects"
 

bluer_objects/help/host.py

@@ -24,15 +24,16 @@ def help_reboot(
     tokens: List[str],
     mono: bool,
 ) -> str:
-    options = xtra("dryrun", mono=mono)
+    options = xtra("dryrun,rpi", mono=mono)
 
     return show_usage(
         [
             "@host",
             "reboot",
             f"[{options}]",
+            "[<machine-name>]",
         ],
-        "reboot host.",
+        "reboot.",
         mono=mono,
     )
 
@@ -41,15 +42,16 @@ def help_shutdown(
     tokens: List[str],
     mono: bool,
 ) -> str:
-    options = xtra("dryrun", mono=mono)
+    options = xtra("dryrun,rpi", mono=mono)
 
     return show_usage(
         [
             "@host",
             "shutdown",
             f"[{options}]",
+            "[<machine-name>]",
         ],
-        "shutdown host.",
+        "shutdown.",
         mono=mono,
     )
 

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.294.1.dist-info → bluer_objects-6.301.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bluer_objects
-Version: 6.294.1
+Version: 6.301.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.294.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.301.1`](https://github.com/kamangir/bluer-objects).
 
 built by 🌀 [`blueness-3.118.1`](https://github.com/kamangir/blueness).

{bluer_objects-6.294.1.dist-info → bluer_objects-6.301.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-bluer_objects/__init__.py,sha256=T0m7CbSgb4diYPOJDK5SaBZ8lw8tC2fet76ANWG3g7w,315
+bluer_objects/__init__.py,sha256=IjOfbxdWL3O3us3yet8Uvep0AJEBdNyFRzZizCOoQ4Q,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
@@ -18,7 +18,7 @@ bluer_objects/.abcli/create_test_asset.sh,sha256=ONIdad_WRjZWdW6V2RalRW2qSJwybEw
 bluer_objects/.abcli/download.sh,sha256=SKv4JyjcWjOutK95-gurCqbRjpmcrmzxASEEdT23Ob4,650
 bluer_objects/.abcli/file.sh,sha256=djcHSFS8fqlCsoDyZKmimNTzd-jOUnxbOFpL7xq_hGk,150
 bluer_objects/.abcli/gif.sh,sha256=cskDoi_BJq5phOAqgJouxH2biC2z3LlDgd9JHAQqvM0,1363
-bluer_objects/.abcli/host.sh,sha256=N-Gdsk-mR2V2MvFlwlIVwaiGkQyV1DoM5UdhQrpUsls,573
+bluer_objects/.abcli/host.sh,sha256=rOTrxGEYk4ikJGSvqCzNNfJDVEvAebOqGutVqJpSRxs,1051
 bluer_objects/.abcli/ls.sh,sha256=9IGfGopZNdpkSwA31hXsRG7Ap0KzY3SGAM9takLQe24,639
 bluer_objects/.abcli/metadata.sh,sha256=EXBB39nn5PRRryIlfetIpR4fPQ-4eDg7Hnee9g1JXrI,377
 bluer_objects/.abcli/mlflow.sh,sha256=7ylwHrQas-QbAJ8SfDJiN3zbuU6ifLUBEAhPRw38Hpc,625
@@ -76,7 +76,7 @@ bluer_objects/.abcli/web/where_am_i.sh,sha256=QPBXFo6Ni4pZEoOx0rtuJUxk6tOlp0ESMy
 bluer_objects/README/__init__.py,sha256=AG9_REFcYVrfMbzK4y02Omie-fCjf6UBP4OnJyNSZ6w,1434
 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
@@ -102,7 +102,7 @@ bluer_objects/help/create_test_asset.py,sha256=oxJORm2qk4b_q7EC6-dEuNu1_pK9Ri60P
 bluer_objects/help/download.py,sha256=9zC_IvH4p2vMXb_qcAS176CBFp5fJe4Z9DFMPdSGBac,751
 bluer_objects/help/functions.py,sha256=wgHOtkhEv7oQYcRpiTH6J_70lGKqLbxoBOBV4_O8LIU,1213
 bluer_objects/help/gif.py,sha256=0yrTJ0U-vyqc94GH5xstAc_C9Ld0pxptdBusOpnbfzQ,1007
-bluer_objects/help/host.py,sha256=4t4yrPGjTbnFtODcuBjfIzpA5pmmvc5s4QrjIqPPVsM,988
+bluer_objects/help/host.py,sha256=cq4Y8mo71pqJ0AUjCGkj3smZ-MOTo9aqyxm8q2FWVAs,1050
 bluer_objects/help/ls.py,sha256=mD6QyMzR5YLnjmtumudVc7AoCPXkevZRexXyTazekGo,972
 bluer_objects/help/metadata.py,sha256=fk22NasBcZU1ffY4fu6AxrCzMQtTI28p_ghaSVRrrPM,2811
 bluer_objects/help/upload.py,sha256=kied2p7II-zCdme_GyDs_74n-15iwyS_RMh2SWLkw1I,460
@@ -149,6 +149,7 @@ bluer_objects/testing/functions.py,sha256=AXAfzWLcEPkbSYTehdahshjKJ45C4IJkRs_Tgr
 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=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.294.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
-bluer_objects-6.294.1.dist-info/METADATA,sha256=iYnCzZhVMBVjW7Ool7FCyDzKi_BKmvTrO7vvS2nkU9Y,3780
-bluer_objects-6.294.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bluer_objects-6.294.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
-bluer_objects-6.294.1.dist-info/RECORD,,
+bluer_objects-6.301.1.dist-info/licenses/LICENSE,sha256=ogEPNDSH0_dhiv_lT3ifVIdgIzHAqNA_SemnxUfPBJk,7048
+bluer_objects-6.301.1.dist-info/METADATA,sha256=y1OIzddcNMhyLM3IWqqXK13ajxzG-PDsJ37MFN-k55I,3780
+bluer_objects-6.301.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bluer_objects-6.301.1.dist-info/top_level.txt,sha256=RX2TpddbnRkurda3G_pAdyeTztP2IhhRPx949GlEvQo,14
+bluer_objects-6.301.1.dist-info/RECORD,,