bluer-ugv 7.359.1__py3-none-any.whl → 7.432.1__py3-none-any.whl

bluer_ugv/.abcli/swallow/dataset.sh

@@ -9,7 +9,7 @@ function bluer_ugv_swallow_dataset() {
         return
     fi
 
-    python3 - bluer_ugv.swallow.dataset "$@"
+    python3 -m bluer_ugv.swallow.dataset "$@"
 }
 
 bluer_ai_source_caller_suffix_path /dataset

bluer_ugv/.abcli/swallow/video/play.sh

@@ -0,0 +1,7 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_play() {
+    python3 -m bluer_ugv.swallow.session.classical.screen.video \
+        play \
+        "$@"
+}

bluer_ugv/.abcli/swallow/video/playlist/cat.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_playlist_cat() {
+    local options=$1
+    local do_download=$(bluer_ai_option_int "$options" download 0)
+
+    [[ "$do_download" == 1 ]] &&
+        bluer_ugv_swallow_video_playlist_download \
+            filename=void \
+            $RANGIN_VIDEO_LIST_OBJECT
+
+    bluer_ai_cat \
+        $ABCLI_OBJECT_ROOT/$RANGIN_VIDEO_LIST_OBJECT/metadata.yaml
+}

bluer_ugv/.abcli/swallow/video/playlist/download.sh

@@ -0,0 +1,18 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_playlist_download() {
+    local options=${1:-policy=doesnt_exist}
+
+    [[ "$abcli_is_rpi" == true ]] &&
+        sudo chown pi:pi \
+            $ABCLI_OBJECT_ROOT/$RANGIN_VIDEO_LIST_OBJECT
+
+    bluer_objects_download \
+        filename=metadata.yaml \
+        $RANGIN_VIDEO_LIST_OBJECT
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_objects_download \
+        ,$options \
+        $RANGIN_VIDEO_LIST_OBJECT
+}

bluer_ugv/.abcli/swallow/video/playlist/edit.sh

@@ -0,0 +1,14 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_playlist_edit() {
+    local options=$1
+    local do_download=$(bluer_ai_option_int "$options" download 0)
+
+    [[ "$do_download" == 1 ]] &&
+        bluer_ugv_swallow_video_playlist_download \
+            filename=void \
+            $RANGIN_VIDEO_LIST_OBJECT
+
+    bluer_ai_code \
+        $ABCLI_OBJECT_ROOT/$RANGIN_VIDEO_LIST_OBJECT/metadata.yaml
+}

bluer_ugv/.abcli/swallow/video/playlist/upload.sh

@@ -0,0 +1,9 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_playlist_upload() {
+    local options=${1:-filename=metadata.yaml}
+
+    bluer_objects_upload \
+        ,$options \
+        $RANGIN_VIDEO_LIST_OBJECT
+}

bluer_ugv/.abcli/swallow/video/playlist.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video_playlist() {
+    local task=$1
+
+    local function_name=bluer_ugv_swallow_video_playlist_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_ugv.swallow.session.classical.screen.video "$@"
+}
+
+bluer_ai_source_caller_suffix_path /playlist

bluer_ugv/.abcli/swallow/video.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_ugv_swallow_video() {
+    local task=$1
+
+    local function_name=bluer_ugv_swallow_video_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_ugv.swallow.session.classical.screen.video "$@"
+}
+
+bluer_ai_source_caller_suffix_path /video

bluer_ugv/.abcli/swallow.sh

@@ -9,7 +9,7 @@ function bluer_ugv_swallow() {
         return
     fi
 
-    python3 - bluer_ugv.swallow "$@"
+    python3 -m bluer_ugv.swallow "$@"
 }
 
 bluer_ai_source_caller_suffix_path /swallow

bluer_ugv/.abcli/tests/help.sh

@@ -29,6 +29,14 @@ function test_bluer_ugv_help() {
         "@swallow ultrasonic review" \
         "@swallow ultrasonic test" \
         \
+        "@swallow video" \
+        "@swallow video play" \
+        "@swallow video playlist" \
+        "@swallow video playlist cat" \
+        "@swallow video playlist download" \
+        "@swallow video playlist edit" \
+        "@swallow video playlist upload" \
+        \
         "@ugv" \
         \
         "@ugv git" \

bluer_ugv/.abcli/tests/swallow_video_play.sh

@@ -0,0 +1,11 @@
+#! /usr/bin/env bash
+
+function test_swallow_video_play() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_ugv \
+        swallow \
+        video \
+        play
+}

bluer_ugv/.abcli/tests/swallow_video_playlist.sh

@@ -0,0 +1,45 @@
+#! /usr/bin/env bash
+
+function test_swallow_video_playlist_cat() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_ugv \
+        swallow \
+        video \
+        playlist \
+        cat
+}
+
+function test_swallow_video_playlist_download_upload() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_ugv \
+        swallow \
+        video \
+        playlist \
+        download \
+        policy=doesnt_exist
+    [[ $? -ne 0 ]] && return 1
+
+    bluer_ai_eval ,$options \
+        bluer_ugv \
+        swallow \
+        video \
+        playlist \
+        upload \
+        filename=metadata.yaml
+}
+
+function test_swallow_video_playlist_edit() {
+    local options=$1
+
+    bluer_ai_eval ,$options \
+        bluer_ugv \
+        swallow \
+        video \
+        playlist \
+        edit \
+        download
+}

bluer_ugv/README/build.py

@@ -17,7 +17,7 @@ from bluer_ugv.README import (
     releases,
     swallow,
 )
-from bluer_ugv.README.shield import docs as shield
+from bluer_ugv.README.computer import docs as computer
 from bluer_ugv.README.ugvs import docs as ugvs
 from bluer_ugv.README.ugvs.comparison.build import build as build_comparison
 
@@ -49,7 +49,7 @@ def build() -> bool:
             + rangin.docs
             + ravin.docs
             + releases.docs
-            + shield.docs
+            + computer.docs
             + ugvs.docs
             + swallow.docs
         )

bluer_ugv/README/{shield → computer}/box.py

@@ -19,7 +19,7 @@ items = ImageItems(
 
 docs = [
     {
-        "path": "../docs/swallow/digital/design/shield/box.md",
+        "path": "../docs/swallow/digital/design/computer/box.md",
         "items": items,
     }
 ]

bluer_ugv/README/computer/docs.py

@@ -0,0 +1,21 @@
+from bluer_ugv.README.computer import box, pcb, power, schematics, testing
+
+
+docs = (
+    [
+        {
+            "path": "../docs/swallow/digital/design/computer",
+        },
+        {
+            "path": "../docs/swallow/digital/design/computer/naming.md",
+        },
+        {
+            "path": "../docs/swallow/digital/design/computer/connectors-v1.md",
+        },
+    ]
+    + box.docs
+    + pcb.docs
+    + power.docs
+    + schematics.docs
+    + testing.docs
+)

bluer_ugv/README/{shield → computer}/pcb.py

@@ -35,15 +35,15 @@ v2_items = ImageItems(
 
 docs = [
     {
-        "path": "../docs/swallow/digital/design/shield/pcb.md",
+        "path": "../docs/swallow/digital/design/computer/pcb.md",
         "items": items,
     },
     {
-        "path": "../docs/swallow/digital/design/shield/v1.md",
+        "path": "../docs/swallow/digital/design/computer/v1.md",
         "items": v1_items,
     },
     {
-        "path": "../docs/swallow/digital/design/shield/v2.md",
+        "path": "../docs/swallow/digital/design/computer/v2.md",
         "items": v2_items,
     },
 ]

bluer_ugv/README/computer/power.py

@@ -0,0 +1,19 @@
+from bluer_objects.README.items import ImageItems
+
+from bluer_ugv.README.swallow.consts import swallow_assets2, swallow_designs
+
+
+items = ImageItems(
+    {
+        f"{swallow_assets2}/20251119_193930.jpg": "",
+        f"{swallow_assets2}/20251119_193954.jpg": "",
+    }
+)
+
+
+docs = [
+    {
+        "path": "../docs/swallow/digital/design/computer/power.md",
+        "items": items,
+    },
+]

bluer_ugv/README/{shield → computer}/schematics.py

@@ -11,7 +11,7 @@ items = ImageItems(
 
 docs = [
     {
-        "path": "../docs/swallow/digital/design/shield/schematics.md",
+        "path": "../docs/swallow/digital/design/computer/schematics.md",
         "items": items,
     },
 ]

bluer_ugv/README/{shield → computer}/testing.py

@@ -12,7 +12,7 @@ items = ImageItems(
 
 docs = [
     {
-        "path": "../docs/swallow/digital/design/shield/testing.md",
+        "path": "../docs/swallow/digital/design/computer/testing.md",
         "items": items,
     },
 ]

bluer_ugv/README/rangin/__init__.py

@@ -78,7 +78,4 @@ docs = [
             ]
         ),
     },
-    {
-        "path": "../docs/rangin/computers.md",
-    },
 ]

bluer_ugv/README/shortcuts.py

@@ -11,8 +11,8 @@ items = markdown.generate_table(
     Items(
         [
             {
-                "name": "shield",
-                "url": "./bluer_ugv/docs/swallow/digital/design/shield",
+                "name": "computer",
+                "url": "./bluer_ugv/docs/swallow/digital/design/computer",
                 "marquee": f"{swallow_electrical_designs}/digital.png?raw=true",
             },
             {

bluer_ugv/README/swallow/digital/design/__init__.py

@@ -7,7 +7,10 @@ from bluer_ugv.README.swallow.consts import (
     swallow_electrical_designs,
 )
 from bluer_ugv.designs.swallow.parts import dict_of_parts
-from bluer_ugv.README.swallow.digital.design import mechanical, ultrasonic_sensor
+from bluer_ugv.README.swallow.digital.design import (
+    mechanical,
+    ultrasonic_sensor,
+)
 from bluer_ugv.swallow.session.classical.keyboard.keys import ControlKeys
 
 
@@ -16,9 +19,6 @@ docs = (
         {
             "path": "../docs/swallow/digital/design",
         },
-        {
-            "path": "../docs/swallow/digital/design/computers.md",
-        },
         {
             "path": "../docs/swallow/digital/design/operation.md",
             "cols": 2,

bluer_ugv/__init__.py

@@ -4,7 +4,7 @@ ICON = "🐬"
 
 DESCRIPTION = f"{ICON} AI x UGV."
 
-VERSION = "7.359.1"
+VERSION = "7.432.1"
 
 REPO_NAME = "bluer-ugv"
 

bluer_ugv/config.env

@@ -27,4 +27,6 @@ BLUER_UGV_ULTRASONIC_SENSOR_MAX_M=0.8
 
 BLUER_UGV_ULTRASONIC_SENSOR_KEEP_LOG=1
 
-BLUER_UGV_ULTRASONIC_SENSOR_LOG=0
+BLUER_UGV_ULTRASONIC_SENSOR_LOG=0
+
+RANGIN_VIDEO_LIST_OBJECT=rangin-video-list-1

bluer_ugv/env.py

@@ -81,3 +81,5 @@ BLUER_UGV_ULTRASONIC_SENSOR_LOG = get_env(
     "BLUER_UGV_ULTRASONIC_SENSOR_LOG",
     1,
 )
+
+RANGIN_VIDEO_LIST_OBJECT = get_env("RANGIN_VIDEO_LIST_OBJECT")

bluer_ugv/help/swallow/__init__.py

@@ -6,6 +6,7 @@ from bluer_ugv.help.swallow.select_target import help_select_target
 from bluer_ugv.help.swallow.ultrasonic_sensor import (
     help_functions as help_ultrasonic_sensor,
 )
+from bluer_ugv.help.swallow.video.functions import help_functions as help_video
 
 help_functions = {
     "dataset": help_dataset,
@@ -14,4 +15,5 @@ help_functions = {
     "keyboard": help_keyboard,
     "select_target": help_select_target,
     "ultrasonic": help_ultrasonic_sensor,
+    "video": help_video,
 }

bluer_ugv/help/swallow/video/functions.py

@@ -0,0 +1,41 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+
+from bluer_ugv import env
+from bluer_ugv.help.swallow.video.playlist import help_functions as help_playlist
+from bluer_ugv.swallow.session.classical.screen.video.engine import VideoEngine
+
+
+def help_play(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    args = [
+        "[--dryrun 1]",
+        "[--download 0]",
+        "[--engine {}]".format(
+            " | ".join(sorted([engine.name.lower() for engine in VideoEngine]))
+        ),
+        "[--loop 0]",
+        f"[--object_name <{env.RANGIN_VIDEO_LIST_OBJECT}>]",
+        "[--timeout <-1 | 10>]",
+        "[--video <loading|1>]",
+    ]
+
+    return show_usage(
+        [
+            "@swallow",
+            "video",
+            "play",
+        ]
+        + args,
+        "play <object-name>/<video>.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "play": help_play,
+    "playlist": help_playlist,
+}

bluer_ugv/help/swallow/video/playlist.py

@@ -0,0 +1,89 @@
+from typing import List
+
+from bluer_options.terminal import show_usage, xtra
+from bluer_objects.help.download import options as download_options
+from bluer_objects.help.upload import options as upload_options
+
+
+def help_cat(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("download", mono=mono)
+
+    return show_usage(
+        [
+            "@swallow",
+            "video",
+            "playlist",
+            "cat",
+            f"[{options}]",
+        ],
+        "cat swallow playlist.",
+        mono=mono,
+    )
+
+
+def help_download(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = download_options(mono=mono)
+
+    return show_usage(
+        [
+            "@swallow",
+            "video",
+            "playlist",
+            "download",
+            f"[{options}]",
+        ],
+        "download swallow playlist.",
+        mono=mono,
+    )
+
+
+def help_edit(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = xtra("download", mono=mono)
+
+    return show_usage(
+        [
+            "@swallow",
+            "video",
+            "playlist",
+            "edit",
+            f"[{options}]",
+        ],
+        "edit swallow playlist.",
+        mono=mono,
+    )
+
+
+def help_upload(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = upload_options(mono=mono)
+
+    return show_usage(
+        [
+            "@swallow",
+            "video",
+            "playlist",
+            "upload",
+            f"[{options}]",
+        ],
+        "upload swallow playlist.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "cat": help_cat,
+    "download": help_download,
+    "edit": help_edit,
+    "upload": help_upload,
+}

bluer_ugv/swallow/session/classical/screen/classes.py

@@ -0,0 +1,42 @@
+from bluer_options.host.functions import is_headless
+
+from bluer_ugv import env
+from bluer_ugv.swallow.session.classical.screen.video.player import VideoPlayer
+from bluer_ugv.swallow.session.classical.screen.video.playlist import PlayList
+from bluer_ugv.logger import logger
+
+
+class ClassicalScreen:
+    def __init__(self):
+        self.video_player = None if is_headless() else VideoPlayer()
+
+        self.playlist = PlayList(env.RANGIN_VIDEO_LIST_OBJECT)
+
+        logger.info(f"{self.__class__.__name__} created.")
+
+    def cleanup(self):
+        logger.info(f"{self.__class__.__name__}.cleanup")
+        self.video_player.stop()
+
+    def initialize(self) -> bool:
+        if self.video_player is None:
+            return True
+
+        return self.video_player.play(
+            self.playlist.get("loading"),
+            loop=True,
+        )
+
+    def update(self) -> bool:
+        if self.video_player is None:
+            return True
+
+        if self.video_player.process:
+            return True
+
+        self.playlist.next()
+
+        return self.video_player.play(
+            self.playlist.get(self.playlist.index),
+            loop=False,
+        )

bluer_ugv/swallow/session/classical/screen/video/__main__.py

@@ -0,0 +1,99 @@
+import argparse
+import time
+
+from blueness import module
+from blueness.argparse.generic import sys_exit
+from bluer_options.host import is_rpi, is_headless
+from bluer_options import string
+
+from bluer_ugv import NAME, env
+from bluer_ugv.swallow.session.classical.screen.video.playlist import PlayList
+from bluer_ugv.swallow.session.classical.screen.video.player import VideoPlayer
+from bluer_ugv.swallow.session.classical.screen.video.engine import VideoEngine
+from bluer_ugv.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+parser = argparse.ArgumentParser(NAME)
+parser.add_argument(
+    "task",
+    type=str,
+    help="play",
+)
+parser.add_argument(
+    "--download",
+    type=int,
+    default=1,
+    help="0|1",
+)
+parser.add_argument(
+    "--dryrun",
+    type=int,
+    default=int(not is_rpi() or is_headless()),
+    help="0|1",
+)
+parser.add_argument(
+    "--engine",
+    type=str,
+    default=VideoEngine.VLC.name.lower(),
+    help=" | ".join(sorted([engine.name.lower() for engine in VideoEngine])),
+)
+parser.add_argument(
+    "--loop",
+    type=int,
+    default=1,
+    help="0|1",
+)
+parser.add_argument(
+    "--object_name",
+    type=str,
+    default=env.RANGIN_VIDEO_LIST_OBJECT,
+)
+parser.add_argument(
+    "--timeout",
+    type=int,
+    default=-1,
+    help="in seconds, -1: never",
+)
+parser.add_argument(
+    "--video",
+    type=str,
+    default="loading",
+)
+args = parser.parse_args()
+
+
+success = False
+if args.task == "play":
+    playlist = PlayList(
+        args.object_name,
+        download=args.download == 1,
+    )
+
+    video_player = VideoPlayer(
+        args.dryrun == 1,
+        engine=VideoEngine[args.engine.upper()],
+    )
+
+    success = video_player.play(
+        filename=playlist.get(args.video),
+        loop=args.loop == 1,
+    )
+
+    if success and args.timeout > 0:
+        logger.info(
+            "waiting for {}".format(
+                string.pretty_duration(
+                    args.timeout,
+                )
+            )
+        )
+        time.sleep(args.timeout)
+        success = video_player.stop()
+
+        logger.info('💡 type in "reset" if the prompt is invisible.')
+
+else:
+    success = None
+
+sys_exit(logger, NAME, args.task, success)