Main -> Master

.github/workflows/publish-ide-docs.yml

@@ -2,7 +2,7 @@ name: Release @pybricks/ide-docs
 
 on:
   push:
-    tags: 
+    tags:
     - '@pybricks/ide-docs/**'
 
 jobs:
@@ -16,10 +16,10 @@ jobs:
     - uses: actions/checkout@v3
       with:
         submodules: recursive
-    - name: Set up Python 3.8
+    - name: Set up Python 3.11
       uses: actions/setup-python@v4
       with:
-        python-version: 3.8
+        python-version: 3.11
     - name: Install dependencies
       run: |
         pip install poetry

.vscode/settings.json

@@ -1,4 +1,6 @@
 {
+    "editor.rulers": [88],
+
     "files.exclude": {
       "**/__pycache__": true,
     },

Makefile

@@ -0,0 +1,2 @@
+install-editable:
+	@ install/install-editable

install/install-editable

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+
+python3 -m pip install PEP517 PIP SetUpTools Wheel --upgrade
+
+python3 -m pip install -e . --upgrade --user

install/install-editable.bat

@@ -0,0 +1,3 @@
+python -m pip install PEP517 PIP SetUpTools Wheel --upgrade
+
+python -m pip install -e . --upgrade --user

pyproject.toml

@@ -26,7 +26,9 @@ packages = [
 ]
 
 [tool.poetry.dependencies]
-python = "^3.8"
+python = ">= 3.11"
+
+Agent-Behavior-Model = {url = "https://github.com/IoT-Robotics/Agent-Behavior-Model/archive/main.zip"}
 
 [tool.poetry.group.lint.dependencies]
 black = "^22.3.0"

src/pybricks/__init__.py

@@ -1,5 +1,7 @@
 from typing import Tuple
 
+from abm import interactive   # noqa: F401
+
 
 version: Tuple[str, str, str] = (
     "hub",

src/pybricks/abm/__init__.py

@@ -0,0 +1,4 @@
+"""ABM-decorating Pybricks actuating & sensing functions & class methods."""
+
+
+from . import _common, ev3, nxt, pup, io, msg, robotics, tools   # noqa: F401

src/pybricks/abm/_common/__init__.py

@@ -0,0 +1,13 @@
+"""ABM-decorating pybricks._common."""
+
+
+# _common
+# =======
+from . import (accelerometer,   # noqa: F401
+               battery,
+               color_light,
+               color_sensor,
+               motor,
+               key_pad,
+               speaker,
+               system)

src/pybricks/abm/_common/accelerometer/__init__.py

@@ -0,0 +1,15 @@
+"""ABM-decorating pybricks._common.Accelerometer."""
+
+
+from ...._common import Accelerometer
+from ...util import sense_decor
+from . import simple, imu   # noqa: F401
+
+
+# Accelerometer
+# -------------
+for s in (
+    'acceleration',
+    'tilt',
+):
+    sense_decor(Accelerometer, s)

src/pybricks/abm/_common/accelerometer/imu.py

@@ -0,0 +1,19 @@
+"""ABM-decorating pybricks._common.IMU."""
+
+
+from ...._common import IMU
+from ...util import act_decor, sense_decor
+
+
+# IMU
+# ---
+for a in (
+    'reset_heading',
+):
+    act_decor(IMU, a)
+
+for s in (
+    'heading',
+    'angular_velocity',
+):
+    sense_decor(IMU, s)

src/pybricks/abm/_common/accelerometer/simple.py

@@ -0,0 +1,14 @@
+"""ABM-decorating pybricks._common.SimpleAccelerometer."""
+
+
+from ...._common import SimpleAccelerometer
+from ...util import sense_decor
+
+
+# SimpleAccelerometer
+# -------------------
+for s in (
+    'acceleration',
+    'up',
+):
+    sense_decor(SimpleAccelerometer, s)

src/pybricks/abm/_common/battery/__init__.py

@@ -0,0 +1,15 @@
+"""ABM-decorating pybricks._common.Battery."""
+
+
+from ...._common import Battery
+from ...util import sense_decor
+from . import charger   # noqa: F401
+
+
+# Battery
+# -------
+for s in (
+    'voltage',
+    'current',
+):
+    sense_decor(Battery, s)

src/pybricks/abm/_common/battery/charger.py

@@ -0,0 +1,15 @@
+"""ABM-decorating pybricks._common.Charger."""
+
+
+from ...._common import Charger
+from ...util import sense_decor
+
+
+# Charger
+# -------
+for s in (
+    'connected',
+    'status',
+    'current',
+):
+    sense_decor(Charger, s)

src/pybricks/abm/_common/color_light/__init__.py

@@ -0,0 +1,17 @@
+"""ABM-decorating pybricks._common.ColorLight."""
+
+
+from ...._common import ColorLight
+from ...util import act_decor
+from . import light_array, light_matrix   # noqa: F401
+
+
+# ColorLight
+# ----------
+for a in (
+    'on',
+    'off',
+    'blink',
+    'animate',
+):
+    act_decor(ColorLight, a)

src/pybricks/abm/_common/color_light/light_array.py

@@ -0,0 +1,14 @@
+"""ABM-decorating pybricks._common.LightArray."""
+
+
+from ...._common import LightArray
+from ...util import act_decor
+
+
+# LightArray
+# ----------
+for a in (
+    'on',
+    'off',
+):
+    act_decor(LightArray, a)

src/pybricks/abm/_common/color_light/light_matrix.py

@@ -0,0 +1,20 @@
+"""ABM-decorating pybricks._common.LightMatrix."""
+
+
+from ...._common import LightMatrix
+from ...util import act_decor
+
+
+# LightMatrix
+# -----------
+for a in (
+    'orientation',
+    'image',
+    'animate',
+    'pixel',
+    'off',
+    'number',
+    'char',
+    'text',
+):
+    act_decor(LightMatrix, a)

src/pybricks/abm/_common/color_sensor/__init__.py

@@ -0,0 +1,4 @@
+"""ABM-decorating pybricks._common.ColorSensor."""
+
+
+from . import ambient, common   # noqa: F401

src/pybricks/abm/_common/color_sensor/ambient.py

@@ -0,0 +1,14 @@
+"""ABM-decorating pybricks._common.AmbientColorSensor."""
+
+
+from ...._common import AmbientColorSensor
+from ...util import sense_decor
+
+
+# AmbientColorSensor
+# ------------------
+for s in (
+    'color',
+    'hsv',
+):
+    sense_decor(AmbientColorSensor, s)

src/pybricks/abm/_common/color_sensor/common.py

@@ -0,0 +1,21 @@
+"""ABM-decorating pybricks._common.CommonColorSensor."""
+
+
+from ...._common import CommonColorSensor
+from ...util import act_decor, sense_decor
+
+
+# CommonColorSensor
+# -----------------
+for a in (
+    # 'detectable_colors',   # *** NOTE: OVERLOADED METHOD ***
+):
+    act_decor(CommonColorSensor, a)
+
+for s in (
+    'color',
+    'hsv',
+    'ambient',
+    'reflection',
+):
+    sense_decor(CommonColorSensor, s)

src/pybricks/abm/_common/key_pad.py

@@ -0,0 +1,13 @@
+"""ABM-decorating pybricks._common.Keypad."""
+
+
+from ..._common import Keypad
+from ..util import sense_decor
+
+
+# Keypad
+# ------
+for s in (
+    'pressed',
+):
+    sense_decor(Keypad, s)

src/pybricks/abm/_common/motor/__init__.py

@@ -0,0 +1,27 @@
+"""ABM-decorating pybricks._common.Motor."""
+
+
+from ...._common import Motor
+from ...util import act_decor, sense_decor
+from . import control, dc   # noqa: F401
+
+
+# Motor
+# -----
+for a in (
+    'reset_angle',
+    'hold',
+    'run',
+    'run_time',
+    'run_angle',
+    'run_target',
+    'run_until_stalled',
+    'track_target',
+):
+    act_decor(Motor, a)
+
+for s in (
+    'angle',
+    'speed',
+):
+    sense_decor(Motor, s)

src/pybricks/abm/_common/motor/control.py

@@ -0,0 +1,35 @@
+"""ABM-decorating pybricks._common.Control."""
+
+
+from ...._common import Control
+from ...util import act_decor, sense_decor
+
+
+# Control
+# -------
+for a in (
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.limits
+    # 'limits',   # *** NOTE: OVERLOADED METHOD ***
+
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.pid
+    # 'pid',   # *** NOTE: OVERLOADED METHOD ***
+
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.target_tolerances
+    # 'target_tolerances',   # *** NOTE: OVERLOADED METHOD ***
+
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.stall_tolerances
+    # 'stall_tolerances',   # *** NOTE: OVERLOADED METHOD ***
+):
+    act_decor(Control, a)
+
+for s in (
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.stalled
+    'stalled',
+
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.done
+    'done',
+
+    # docs.pybricks.com/en/latest/pupdevices/motor.html#pybricks.pupdevices.Motor.Motor.control.load
+    'load',
+):
+    sense_decor(Control, s)

src/pybricks/abm/_common/motor/dc.py

@@ -0,0 +1,16 @@
+"""ABM-decorating pybricks._common.DCMotor"""
+
+
+from ...._common import DCMotor
+from ...util import act_decor
+
+
+# DCMotor
+# -------
+for a in (
+    'dc',
+    'stop',
+    'brake',
+    # 'settings',   # *** NOTE: OVERLOADED METHOD ***
+):
+    act_decor(DCMotor, a)

src/pybricks/abm/_common/speaker.py

@@ -0,0 +1,16 @@
+"""ABM-decorating pybricks._common.Speaker."""
+
+
+from ..._common import Speaker
+from ..util import act_decor
+
+
+# Speaker
+# -------
+for a in (
+    'volume',
+    'beep',
+    'play_notes',
+
+):
+    act_decor(Speaker, a)

src/pybricks/abm/_common/system.py

@@ -0,0 +1,20 @@
+"""ABM-decorating pybricks._common.System."""
+
+
+from ..._common import System
+from ..util import act_decor, sense_decor
+
+
+# System
+# ------
+for a in (
+    'set_stop_button',
+    'shutdown',
+):
+    act_decor(System, a)
+
+for s in (
+    'reset_reason',
+    'name',
+):
+    sense_decor(System, s)