Support for multiple bricks per model (#613)

Co-authored-by: lucarin91 <lucarin@protonmail.com>

Author: rjtokenring

Taskfile.yml

@@ -12,8 +12,8 @@ vars:
   GOLANGCI_LINT_VERSION: v2.4.0
   GOIMPORTS_VERSION: v0.29.0
   DPRINT_VERSION: 0.48.0
-  EXAMPLE_VERSION: "0.3.1"
-  RUNNER_VERSION: "0.3.1"
+  EXAMPLE_VERSION: "0.4.0"
+  RUNNER_VERSION: "0.4.0"
   VERSION: # if version is not passed we hack the semver by encoding the commit as pre-release
     sh: echo "${VERSION:-0.0.0-$(git rev-parse --short HEAD)}"
 

…no/app_bricks/air_quality_monitor/API.md …no/app_bricks/air_quality_monitor/API.mddebian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.3.1/api-docs/arduino/app_bricks/air_quality_monitor/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/air_quality_monitor/API.md debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.3.1/api-docs/arduino/app_bricks/air_quality_monitor/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/air_quality_monitor/API.md

@@ -1,27 +1,27 @@
-# arduino_iot_cloud API Reference
+# arduino_cloud API Reference
 
 ## Index
 
-- Class `ArduinoIoTCloud`
+- Class `ArduinoCloud`
 
 ---
 
-## `ArduinoIoTCloud` class
+## `ArduinoCloud` class
 
 ```python
-class ArduinoIoTCloud(device_id: str, secret: str, server: str, port: int)
+class ArduinoCloud(device_id: str, secret: str, server: str, port: int)
 ```
 
-Arduino IoT Cloud client for managing devices and data.
+Arduino Cloud client for managing devices and data.
 
 ### Parameters
 
 - **device_id** (*str*): The unique identifier for the device.
 If omitted, uses ARDUINO_DEVICE_ID environment variable.
-- **secret** (*str*): The password for Arduino IoT Cloud authentication.
+- **secret** (*str*): The password for Arduino Cloud authentication.
 If omitted, uses ARDUINO_SECRET environment variable.
-- **server** (*str*) (optional): The server address for Arduino IoT Cloud (default: "iot.arduino.cc").
-- **port** (*int*) (optional): The port to connect to the Arduino IoT Cloud server (default: 8884).
+- **server** (*str*) (optional): The server address for Arduino Cloud (default: "iot.arduino.cc").
+- **port** (*int*) (optional): The port to connect to the Arduino Cloud server (default: 8884).
 
 ### Raises
 
@@ -39,7 +39,7 @@ Run a single iteration of the Arduino IoT Cloud client loop, processing commands
 
 #### `register(aiotobj: str | Any)`
 
-Register a variable or object with the Arduino IoT Cloud client.
+Register a variable or object with the Arduino Cloud client.
 
 ##### Parameters
 

…uino/app_bricks/arduino_iot_cloud/API.md …/arduino/app_bricks/arduino_cloud/API.mdinternal/e2e/daemon/testdata/assets/0.3.1/api-docs/arduino/app_bricks/arduino_iot_cloud/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/arduino_cloud/API.md internal/e2e/daemon/testdata/assets/0.3.1/api-docs/arduino/app_bricks/arduino_iot_cloud/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/arduino_cloud/API.md

@@ -1,30 +1,30 @@
-# audio_classifier API Reference
+# audio_classification API Reference
 
 ## Index
 
-- Class `AudioClassifierException`
-- Class `AudioClassifier`
+- Class `AudioClassificationException`
+- Class `AudioClassification`
 
 ---
 
-## `AudioClassifierException` class
+## `AudioClassificationException` class
 
 ```python
-class AudioClassifierException()
+class AudioClassificationException()
 ```
 
-Custom exception for AudioClassifier errors.
+Custom exception for AudioClassification errors.
 
 
 ---
 
-## `AudioClassifier` class
+## `AudioClassification` class
 
 ```python
-class AudioClassifier(mic: Microphone, confidence: float)
+class AudioClassification(mic: Microphone, confidence: float)
 ```
 
-AudioClassifier module for detecting sounds and classifying audio using a specified model.
+AudioClassification module for detecting sounds and classifying audio using a specified model.
 
 ### Parameters
 
@@ -93,6 +93,6 @@ Returns None if no valid classification is found.
 
 ##### Raises
 
-- **AudioClassifierException**: If the file cannot be found, read, or processed.
+- **AudioClassificationException**: If the file cannot be found, read, or processed.
 - **ValueError**: If the file uses an unsupported sample width.
 

…duino/app_bricks/audio_classifier/API.md …o/app_bricks/audio_classification/API.mdinternal/e2e/daemon/testdata/assets/0.3.1/api-docs/arduino/app_bricks/audio_classifier/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/audio_classification/API.md internal/e2e/daemon/testdata/assets/0.3.1/api-docs/arduino/app_bricks/audio_classifier/API.md renamed to debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.4.0/api-docs/arduino/app_bricks/audio_classification/API.md

@@ -1,33 +1,46 @@
-# camera_code_detector API Reference
+# camera_code_detection API Reference
 
 ## Index
 
-- Class `CameraCodeDetector`
-- Class `CameraMultiCodeDetector`
+- Class `CameraCodeDetection`
 - Class `Detection`
 - Function `utils.draw_bounding_box`
 
 ---
 
-## `CameraCodeDetector` class
+## `CameraCodeDetection` class
 
 ```python
-class CameraCodeDetector(camera: USBCamera, detect_qr: bool, detect_barcode: bool)
+class CameraCodeDetection(camera: USBCamera, detect_qr: bool, detect_barcode: bool)
 ```
 
-Module for detecting a QR code and/or a traditional barcode using a USB camera feed.
+Scans a camera video feed for QR codes and/or barcodes.
 
 ### Methods
 
-#### `on_detect(callback: Callable[[Image, Detection], None] | None)`
+#### `start()`
+
+Start the detector and begin scanning for codes.
+
+#### `stop()`
+
+Stop the detector and release resources. 
+
+#### `on_detect(callback: Callable[[Image, list[Detection]], None] | Callable[[Image, Detection], None] | None)`
 
 Registers or removes a callback to be triggered on code detection.
 
-When a QR code or barcode is detected in the camera feed, the provided callback function will be invoked. The callback function should accept the Image frame and a Detection object. If None is provided, the callback is removed.
+When a QR code or barcode is detected in the camera feed, the provided callback function will be invoked.
+The callback function should accept the Image frame and a list[Detection] or Detection objects. If the former
+is used, it will receive all detections at once. If the latter is used, it will be called once for each
+detection. If None is provided, the callback will be removed.
 
 ##### Parameters
 
-- **callback** (*Callable[[Image, Detection], None]*): A callback that will be called every time a detection is made.
+- **callback** (*Callable[[Image, list[Detection]], None]*): A callback that will be called every time a detection
+is made with all the detections.
+- **callback** (*Callable[[Image, Detection], None]*): A callback that will be called every time a detection is
+made with a single detection.
 - **callback** (*None*): To unregister the current callback, if any.
 
 ##### Examples
@@ -40,40 +53,30 @@ def on_code_detected(frame: Image, detection: Detection):
 
 detector.on_detect(on_code_detected)
 ```
+#### `on_frame(callback: Callable[[Image], None] | None)`
 
----
-
-## `CameraMultiCodeDetector` class
+Registers a callback function to be called when a new camera frame is captured.
 
-```python
-class CameraMultiCodeDetector(camera: USBCamera, detect_qr: bool, detect_barcode: bool)
-```
+The callback function should accept the Image frame.
+If None is provided, the callback is removed.
 
-Module for detecting multiple QR codes and/or traditional barcodes using a USB camera feed.
+##### Parameters
 
-### Methods
+- **callback** (*Callable[[Image], None]*): A callback that will be called with each captured frame.
+- **callback** (*None*): Signals to remove the current callback, if any.
 
-#### `on_detect(callback: Callable[[Image, list[Detection]], None] | None)`
+#### `on_error(callback: Callable[[Exception], None] | None)`
 
-Registers or removes a callback to be triggered when one or more codes are detected.
+Registers a callback function to be called when an error occurs in the detector.
 
-The callback is invoked for each processed video frame that contains at least one detection. The callback function should accept the Image frame and a list of Detection objects, which may include multiple QR codes and/or barcodes. If None is provided, the callback is removed.
+The callback function should accept the exception as an argument.
+If None is provided, the callback is removed.
 
 ##### Parameters
 
-- **callback** (*Callable[[Image, list[Detection]], None] | None*): A function to be called with the current frame and all detections found in it
-- **callback** (*None*): To unregister the current callback, if any.
+- **callback** (*Callable*): A callback that will be called with the exception raised in the detector.
+- **callback** (*None*): Signals to remove the current callback, if any.
 
-##### Examples
-
-```python
-def on_codes_detected(frame: Image, detections: list[Detection]):
-    print(f"Detected {len(detections)} codes")
-    # Here you can add your code to process the detected codes,
-    # e.g., draw bounding boxes, save them to a database or log them.
-    
-detector.on_detect(on_codes_detected)
-```
 
 ---