doc: update docstrings

Author: robgee86

src/arduino/app_peripherals/camera/base_camera.py

@@ -24,19 +24,20 @@ class BaseCamera(ABC):
     """
 
     def __init__(self, resolution: Optional[Tuple[int, int]] = (640, 480), fps: int = 10, 
-                 adjuster: Optional[Callable[[np.ndarray], np.ndarray]] = None, **kwargs):
+                 adjustments: Optional[Callable[[np.ndarray], np.ndarray]] = None, **kwargs):
         """
         Initialize the camera base.
 
         Args:
             resolution (tuple, optional): Resolution as (width, height). None uses default resolution.
             fps (int): Frames per second for the camera.
-            adjuster (callable, optional): Function pipeline to adjust frames that takes a numpy array and returns a numpy array. Default: None
+            adjustments (callable, optional): Function or function pipeline to adjust frames that takes
+                a numpy array and returns a numpy array. Default: None
             **kwargs: Additional camera-specific parameters.
         """
         self.resolution = resolution
         self.fps = fps
-        self.adjuster = adjuster
+        self.adjustments = adjustments
         self._is_started = False
         self._cap_lock = threading.Lock()
         self._last_capture_time = time.monotonic()
@@ -100,11 +101,11 @@ def _extract_frame(self) -> Optional[np.ndarray]:
 
             self._last_capture_time = time.monotonic()
 
-            if self.adjuster is not None:
+            if self.adjustments is not None:
                 try:
-                    frame = self.adjuster(frame)
+                    frame = self.adjustments(frame)
                 except Exception as e:
-                    raise CameraTransformError(f"Frame transformation failed ({self.adjuster}): {e}")
+                    raise CameraTransformError(f"Frame transformation failed ({self.adjustments}): {e}")
 
             return frame
 

src/arduino/app_peripherals/camera/camera.py

@@ -32,7 +32,7 @@ def __new__(cls, source: Union[str, int] = 0, **kwargs) -> BaseCamera:
                     resolution (tuple, optional): Frame resolution as (width, height). 
                         Default: None (auto)
                     fps (int, optional): Target frames per second. Default: 10
-                    adjuster (callable, optional): Function pipeline to adjust frames that takes a
+                    adjustments (callable, optional): Function pipeline to adjust frames that takes a
                         numpy array and returns a numpy array. Default: None
                 V4L Camera Parameters:
                     device_index (int, optional): V4L device index override

src/arduino/app_peripherals/camera/ip_camera.py

@@ -34,7 +34,7 @@ def __init__(self, url: str, username: Optional[str] = None,
             username: Optional authentication username
             password: Optional authentication password  
             timeout: Connection timeout in seconds
-            **kwargs: Additional camera parameters
+            **kwargs: Additional camera parameters propagated to BaseCamera
         """
         super().__init__(**kwargs)
         self.url = url

src/arduino/app_peripherals/camera/v4l_camera.py

@@ -32,7 +32,7 @@ def __init__(self, camera: Union[str, int] = 0, **kwargs):
             camera: Camera identifier - can be:
                    - int: Camera index (e.g., 0, 1)  
                    - str: Camera index as string or device path
-            **kwargs: Additional camera parameters
+            **kwargs: Additional camera parameters propagated to BaseCamera
         """
         super().__init__(**kwargs)
         self.camera_id = self._resolve_camera_id(camera)

src/arduino/app_peripherals/camera/websocket_camera.py

@@ -42,7 +42,7 @@ def __init__(self, host: str = "0.0.0.0", port: int = 8080, timeout: int = 10,
             port: Port to bind the server to (default: 8080)
             timeout: Connection timeout in seconds (default: 10)
             frame_format: Expected frame format from clients ("base64", "json", "binary") (default: "base64")
-            **kwargs: Additional camera parameters
+            **kwargs: Additional camera parameters propagated to BaseCamera
         """
         super().__init__(**kwargs)
 

src/arduino/app_utils/image/__init__.py

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
 from .image import *
 from .image_editor import ImageEditor
 from .pipeable import PipeableFunction