[WIP] Updated documentation for `camera.pi`.

docs/source/backends.rst

@@ -7,7 +7,6 @@ Backends
     :caption: Backends:
 
     platypush/backend/button.flic.rst
-    platypush/backend/camera.pi.rst
     platypush/backend/chat.telegram.rst
     platypush/backend/http.rst
     platypush/backend/midi.rst

docs/source/platypush/backend/camera.pi.rst

@@ -1,6 +0,0 @@
-``camera.pi``
-===============================
-
-.. automodule:: platypush.backend.camera.pi
-    :members:
-

docs/source/platypush/plugins/camera.pi.legacy.rst

@@ -0,0 +1,5 @@
+``camera.pi.legacy``
+====================
+
+.. automodule:: platypush.plugins.camera.pi.legacy
+    :members:

docs/source/plugins.rst

@@ -21,6 +21,7 @@ Plugins
     platypush/plugins/camera.gstreamer.rst
     platypush/plugins/camera.ir.mlx90640.rst
     platypush/plugins/camera.pi.rst
+    platypush/plugins/camera.pi.legacy.rst
     platypush/plugins/chat.irc.rst
     platypush/plugins/chat.telegram.rst
     platypush/plugins/clipboard.rst

platypush/plugins/camera/__init__.py

@@ -845,7 +845,7 @@ class CameraPlugin(RunnablePlugin, ABC):
             **camera,
         )
 
-        return self._start_streaming(camera, duration, stream_format)  # type: ignore
+        return self._start_streaming(camera, duration, camera.info.stream_format)  # type: ignore
 
     def _start_streaming(
         self, camera: Camera, duration: Optional[float], stream_format: str

platypush/plugins/camera/pi/__init__.py

@@ -19,7 +19,7 @@ class CameraPiPlugin(CameraPlugin):
     If you are running a very old OS that only provides the deprecated
     `picamera <https://github.com/waveform80/picamera>`_ module, or you rely on
     features that are currently only supported by the old module, you should
-    use :class:`platypush.plugins.camera.pi_legacy.CameraPiLegacyPlugin`
+    use :class:`platypush.plugins.camera.pi.legacy.CameraPiLegacyPlugin`
     instead.
     """
 
@@ -63,8 +63,6 @@ class CameraPiPlugin(CameraPlugin):
             1.0 is the default value, and higher values are mapped to higher
             contrast levels.
         :param brightness: Brightness level, as a float between -1.0 and 1.0.
-        :param video_stabilization: Enable video stabilization (default: False).
-            Only available on the old picamera module for now.
         :param iso: ISO level (default: 0).
         :param exposure_compensation: Exposure compensation level, as a float
             between -8.0 and 8.0.

platypush/plugins/camera/pi/legacy/manifest.yaml

@@ -21,5 +21,5 @@ manifest:
       - picamera
       - numpy
       - Pillow
-  package: platypush.plugins.camera.pi
+  package: platypush.plugins.camera.pi.legacy
   type: plugin