bluer-sbc 8.248.1__py3-none-any.whl → 9.31.1__py3-none-any.whl

bluer_sbc/.abcli/{blue_sbc.sh → bluer_sbc.sh}

@@ -9,3 +9,5 @@ function bluer_sbc() {
 }
 
 bluer_ai_log $(bluer_sbc version --show_icon 1)
+
+bluer_ai_source_caller_suffix_path /sbc

bluer_sbc/.abcli/sbc/parts/adjust.sh

@@ -0,0 +1,12 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts_adjust() {
+    local options=$1
+    local do_dryrun=$(bluer_ai_option_int "$options" dryrun 0)
+
+    bluer_ai_eval - \
+        python3 -m bluer_sbc.parts \
+        adjust \
+        --dryrun $do_dryrun \
+        "${@:2}"
+}

bluer_sbc/.abcli/sbc/parts/cd.sh

@@ -0,0 +1,5 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts_cd() {
+    cd $abcli_path_git/assets2/bluer-sbc/parts
+}

bluer_sbc/.abcli/sbc/parts.sh

@@ -0,0 +1,15 @@
+#! /usr/bin/env bash
+
+function bluer_sbc_parts() {
+    local task=$1
+
+    local function_name=bluer_sbc_parts_$task
+    if [[ $(type -t $function_name) == "function" ]]; then
+        $function_name "${@:2}"
+        return
+    fi
+
+    python3 -m bluer_sbc.parts "$@"
+}
+
+bluer_ai_source_caller_suffix_path /parts

bluer_sbc/.abcli/tests/help.sh

@@ -25,6 +25,10 @@ function test_bluer_sbc_help() {
         "@sbc lepton capture" \
         "@sbc lepton preview" \
         \
+        "@sbc parts" \
+        "@sbc parts adjust" \
+        "@sbc parts cd" \
+        \
         "@sbc pypi" \
         "@sbc pypi browse" \
         "@sbc pypi build" \

bluer_sbc/.abcli/tests/parts_adjust.sh

@@ -0,0 +1,13 @@
+#! /usr/bin/env bash
+
+function test_bluer_sbc_parts_adjust() {
+    local options=$1
+
+    [[ "$abcli_is_github_workflow" == true ]] &&
+        return 0
+
+    bluer_ai_eval ,$options \
+        bluer_sbc_parts_adjust \
+        - \
+        --verbose 1
+}

bluer_sbc/README/__init__.py

@@ -1,28 +0,0 @@
-import os
-
-from bluer_options.help.functions import get_help
-from bluer_objects import file, README
-
-from bluer_sbc import NAME, VERSION, ICON, REPO_NAME
-from bluer_sbc.help.functions import help_functions
-from bluer_sbc.README import aliases, designs, root
-
-
-def build():
-    return all(
-        README.build(
-            items=readme.get("items", []),
-            cols=readme.get("cols", 3),
-            path=os.path.join(file.path(__file__), readme["path"]),
-            ICON=ICON,
-            NAME=NAME,
-            VERSION=VERSION,
-            REPO_NAME=REPO_NAME,
-            help_function=lambda tokens: get_help(
-                tokens,
-                help_functions,
-                mono=True,
-            ),
-        )
-        for readme in root.docs + designs.docs + aliases.docs
-    )

bluer_sbc/README/aliases.py

@@ -6,5 +6,6 @@ docs = [
         "camera",
         "hardware",
         "rpi",
+        "sbc",
     ]
 ]

bluer_sbc/README/build.py

@@ -0,0 +1,29 @@
+import os
+
+from bluer_options.help.functions import get_help
+from bluer_objects import file, README
+
+from bluer_sbc import NAME, VERSION, ICON, REPO_NAME
+from bluer_sbc.help.functions import help_functions
+from bluer_sbc.README import aliases, designs, parts, root
+
+
+def build():
+    return all(
+        README.build(
+            items=readme.get("items", []),
+            cols=readme.get("cols", 3),
+            path=os.path.join(file.path(__file__), readme["path"]),
+            ICON=ICON,
+            NAME=NAME,
+            VERSION=VERSION,
+            REPO_NAME=REPO_NAME,
+            help_function=lambda tokens: get_help(
+                tokens,
+                help_functions,
+                mono=True,
+            ),
+            macros=readme.get("macros", {}),
+        )
+        for readme in root.docs + parts.docs + designs.docs + aliases.docs
+    )

bluer_sbc/README/design.py

@@ -0,0 +1,32 @@
+from typing import List, Dict
+
+from bluer_objects import markdown
+
+from bluer_sbc.parts.db import db_of_parts
+
+
+def design(
+    items: List[str],
+    dict_of_parts: Dict = {},
+) -> Dict:
+    output = {
+        "items": items,
+    }
+
+    if dict_of_parts:
+        output["macros"] = {
+            "parts_images:::": markdown.generate_table(
+                db_of_parts.as_images(
+                    dict_of_parts,
+                    reference="../../../parts",
+                ),
+                cols=10,
+            ),
+            "parts_list:::": db_of_parts.as_list(
+                dict_of_parts,
+                reference="../../../parts",
+                log=False,
+            ),
+        }
+
+    return output

bluer_sbc/README/designs/__init__.py

@@ -1,3 +1,4 @@
+from bluer_sbc.README.design import design
 from bluer_sbc.README.designs.cheshmak import items as cheshmak_items
 from bluer_sbc.README.designs.battery_bus import items as battery_bus_items
 from bluer_sbc.README.designs.swallow import items as swallow_items
@@ -9,22 +10,45 @@ from bluer_sbc.README.designs.x import items as x_items
 from bluer_sbc.README.designs.ultrasonic_sensor_tester import (
     items as ultrasonic_sensor_tester_items,
 )
+from bluer_sbc.designs.swallow.parts import dict_of_parts as swallow_parts
+from bluer_sbc.designs.swallow_head.parts import dict_of_parts as swallow_head_parts
 
 docs = [
     {
         "cols": 4,
-        "items": design_items,
+        "items": design_info["items"],
         "path": f"../docs/{design_name}.md",
+        "macros": design_info.get("macros", {}),
     }
-    for design_name, design_items in {
-        "battery-bus": battery_bus_items,
-        "bryce": bryce_items,
-        "cheshmak": cheshmak_items,
-        "nafha": nafha_items,
-        "shelter": shelter_items,
-        "swallow-head": swallow_head_items,
-        "swallow": swallow_items,
-        "ultrasonic-sensor-tester": ultrasonic_sensor_tester_items,
-        "x": x_items,
+    for design_name, design_info in {
+        "battery-bus": design(
+            battery_bus_items,
+        ),
+        "bryce": design(
+            bryce_items,
+        ),
+        "cheshmak": design(
+            cheshmak_items,
+        ),
+        "nafha": design(
+            nafha_items,
+        ),
+        "shelter": design(
+            shelter_items,
+        ),
+        "swallow-head": design(
+            swallow_head_items,
+            swallow_head_parts,
+        ),
+        "swallow": design(
+            swallow_items,
+            swallow_parts,
+        ),
+        "ultrasonic-sensor-tester": design(
+            ultrasonic_sensor_tester_items,
+        ),
+        "x": design(
+            x_items,
+        ),
     }.items()
 ]

bluer_sbc/README/designs/battery_bus.py

@@ -1,10 +1,10 @@
 from bluer_objects import README
 from bluer_objects.README.items import ImageItems
-from bluer_objects.README.consts import assets_path
+from bluer_objects.README.consts import assets_url
 
 from bluer_sbc.README.designs.consts import assets2
 
-assets2_battery_bus = assets_path(
+assets2_battery_bus = assets_url(
     suffix="battery-bus",
     volume=2,
 )

bluer_sbc/README/designs/shelter.py

@@ -1,12 +1,12 @@
 from bluer_objects import README
 from bluer_objects.README.items import ImageItems
-from bluer_objects.README.consts import assets_path
+from bluer_objects.README.consts import assets_url
 
 from bluer_sbc.README.designs.consts import assets2
 
 image_template = assets2 + "shelter/{}?raw=true"
 
-assets2_shelter = assets_path(
+assets2_shelter = assets_url(
     suffix="shelter",
     volume=2,
 )

bluer_sbc/README/designs/swallow_head.py

@@ -17,5 +17,5 @@ marquee = README.Items(
 )
 
 items = ImageItems(
-    {"marquee": image_template.format(f"{index+1:02}.jpg") for index in range(6)}
+    {image_template.format(f"{index+1:02}.jpg"): "" for index in range(6)}
 )

bluer_sbc/README/designs/x.py

@@ -1,12 +1,9 @@
 from bluer_objects import README
 from bluer_objects.README.items import ImageItems
-from bluer_objects.README.consts import assets_path
+from bluer_objects.README.consts import assets_url
 
-from bluer_sbc.README.designs.consts import assets2
 
-image_template = assets2 + "x/{}?raw=true"
-
-assets2_x = assets_path(
+assets2_x = assets_url(
     suffix="x",
     volume=2,
 )

bluer_sbc/README/parts.py

@@ -0,0 +1,15 @@
+from bluer_sbc.parts.db import db_of_parts
+
+docs = [
+    {
+        "path": "../docs/parts",
+        "macros": {"list:::": db_of_parts.README},
+    }
+] + [
+    {
+        "path": part.filename(create=True),
+        "macros": {"info:::": part.README(db_of_parts.url_prefix)},
+    }
+    for part_name, part in db_of_parts.items()
+    if part_name != "template"
+]

bluer_sbc/README/root.py

@@ -9,6 +9,7 @@ from bluer_sbc.README.designs.battery_bus import marquee as battery_bus_marquee
 from bluer_sbc.README.designs.ultrasonic_sensor_tester import (
     marquee as ultrasonic_sensor_tester_marquee,
 )
+from bluer_sbc.README.shortcuts import items as shortcuts_items
 
 docs = [
     {
@@ -22,5 +23,8 @@ docs = [
         + shelter_marquee
         + blue_bracket_items,
         "path": "../..",
+        "macros": {
+            "shortcuts:::": shortcuts_items,
+        },
     },
 ]

bluer_sbc/README/shortcuts.py

@@ -0,0 +1,17 @@
+from bluer_objects.README.items import Items
+from bluer_objects import markdown
+
+from bluer_sbc.parts.db import db_of_parts
+
+
+items = markdown.generate_table(
+    Items(
+        [
+            {
+                "name": "parts",
+                "url": "./bluer_sbc/docs/parts",
+                "marquee": f"{db_of_parts.url_prefix}/XL4015.png",
+            },
+        ]
+    ),
+)

bluer_sbc/__init__.py

@@ -2,9 +2,9 @@ NAME = "bluer_sbc"
 
 ICON = "🌀"
 
-DESCRIPTION = f"{ICON} AI for single board computers and other designs."
+DESCRIPTION = f"{ICON} AI for single board computers and related designs."
 
-VERSION = "8.248.1"
+VERSION = "9.31.1"
 
 REPO_NAME = "bluer-sbc"
 

bluer_sbc/__main__.py

@@ -1,6 +1,7 @@
 from blueness.argparse.generic import main
 
-from bluer_sbc import NAME, VERSION, DESCRIPTION, ICON, README
+from bluer_sbc import NAME, VERSION, DESCRIPTION, ICON
+from bluer_sbc.README.build import build
 from bluer_sbc.logger import logger
 
 main(
@@ -10,7 +11,7 @@ main(
     VERSION=VERSION,
     main_filename=__file__,
     tasks={
-        "build_README": lambda _: README.build(),
+        "build_README": lambda _: build(),
     },
     logger=logger,
 )

bluer_sbc/designs/swallow/parts.py

@@ -0,0 +1,3 @@
+dict_of_parts = {
+    "BTS7960": "2 x",
+}

bluer_sbc/designs/swallow_head/parts.py

@@ -0,0 +1,15 @@
+dict_of_parts = {
+    "rpi3bp": "",
+    "XL4015": "",
+    "470-mF": "",
+    "Polyfuse": "optional",
+    "TVS-diode": "",
+    "resistor": "7 x 330-470 Ω + N x 2.2 kΩ + N x 3.3 kΩ",
+    "LED": "green + red + yellow + 4 x blue",
+    "rpi-camera": "",
+    "PCB-single-14x9_5": "2 x",
+    "PCB-double-9x7": "2 x",
+    "pushbutton": "",
+    "ultrasonic-sensor": "4 x",
+    "connector": "3 pairs",
+}

bluer_sbc/help/functions.py

@@ -10,6 +10,7 @@ from bluer_sbc.help.camera import help_functions as help_camera
 from bluer_sbc.help.grove import help_functions as help_grove
 from bluer_sbc.help.hat import help_functions as help_hat
 from bluer_sbc.help.lepton import help_functions as help_lepton
+from bluer_sbc.help.parts import help_functions as help_parts
 from bluer_sbc.help.rpi import help_functions as help_rpi
 from bluer_sbc.help.scroll_phat_hd import help_functions as help_scroll_phat_hd
 from bluer_sbc.help.sparkfun_top_phat import help_functions as help_sparkfun_top_phat
@@ -26,6 +27,7 @@ help_functions.update(
         "grove": help_grove,
         "hat": help_hat,
         "lepton": help_lepton,
+        "parts": help_parts,
         "rpi": help_rpi,
         "scroll_phat_hd": help_scroll_phat_hd,
         "sparkfun_top_phat": help_sparkfun_top_phat,

bluer_sbc/help/parts.py

@@ -0,0 +1,49 @@
+from typing import List
+
+from bluer_options.terminal import show_usage
+
+from bluer_sbc import ALIAS
+
+
+def help_cd(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    return show_usage(
+        [
+            "@sbc",
+            "parts",
+            "cd",
+        ],
+        "cd to part images.",
+        mono=mono,
+    )
+
+
+def help_adjust(
+    tokens: List[str],
+    mono: bool,
+) -> str:
+    options = "dryrun"
+
+    args = [
+        "[--verbose 1]",
+    ]
+
+    return show_usage(
+        [
+            "@sbc",
+            "parts",
+            "adjust",
+            f"[{options}]",
+        ]
+        + args,
+        "adjust part images.",
+        mono=mono,
+    )
+
+
+help_functions = {
+    "adjust": help_adjust,
+    "cd": help_cd,
+}

bluer_sbc/parts/__main__.py

@@ -0,0 +1,41 @@
+import argparse
+
+from blueness import module
+from blueness.argparse.generic import sys_exit
+
+from bluer_sbc import NAME
+from bluer_sbc.parts.db import db_of_parts
+from bluer_sbc.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+parser = argparse.ArgumentParser(NAME)
+parser.add_argument(
+    "task",
+    type=str,
+    help="adjust",
+)
+parser.add_argument(
+    "--dryrun",
+    type=int,
+    default=1,
+    help="0 | 1",
+)
+parser.add_argument(
+    "--verbose",
+    type=int,
+    default=0,
+    help="0 | 1",
+)
+args = parser.parse_args()
+
+success = False
+if args.task == "adjust":
+    success = db_of_parts.adjust(
+        dryrun=args.dryrun == 1,
+        verbose=args.verbose == 1,
+    )
+else:
+    success = None
+
+sys_exit(logger, NAME, args.task, success)