[libcamera-devel,v2,08/19] py: MappedFrameBuffer: Add type hints & docs
diff mbox series

Message ID 20220524114610.41848-9-tomi.valkeinen@ideasonboard.com
State Accepted
Headers show
Series
  • More misc Python patches
Related show

Commit Message

Tomi Valkeinen May 24, 2022, 11:45 a.m. UTC
Add a few type hints and (minimal) docs to MappedFrameBuffer.

Signed-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
---
 src/py/libcamera/utils/MappedFrameBuffer.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

Comments

Laurent Pinchart May 26, 2022, 3:31 p.m. UTC | #1
Hi Tomi,

Thank you for the patch.

On Tue, May 24, 2022 at 02:45:59PM +0300, Tomi Valkeinen wrote:
> Add a few type hints and (minimal) docs to MappedFrameBuffer.
> 
> Signed-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

> ---
>  src/py/libcamera/utils/MappedFrameBuffer.py | 11 +++++++++--
>  1 file changed, 9 insertions(+), 2 deletions(-)
> 
> diff --git a/src/py/libcamera/utils/MappedFrameBuffer.py b/src/py/libcamera/utils/MappedFrameBuffer.py
> index e7dd16ec..fc2726b6 100644
> --- a/src/py/libcamera/utils/MappedFrameBuffer.py
> +++ b/src/py/libcamera/utils/MappedFrameBuffer.py
> @@ -1,8 +1,14 @@
>  # SPDX-License-Identifier: LGPL-2.1-or-later
>  # Copyright (C) 2022, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
>  
> +import libcamera
> +from typing import Tuple
> +
>  class MappedFrameBuffer:
> -    def __init__(self, fb):
> +    """
> +    Provides memoryviews for the FrameBuffer's planes
> +    """
> +    def __init__(self, fb: libcamera.FrameBuffer):
>          self.__fb = fb
>  
>      def __enter__(self):
> @@ -70,5 +76,6 @@ class MappedFrameBuffer:
>              mm.close()
>  
>      @property
> -    def planes(self):
> +    def planes(self) -> Tuple[memoryview, ...]:
> +        """memoryviews for the planes"""
>          return self.__planes

Patch
diff mbox series

diff --git a/src/py/libcamera/utils/MappedFrameBuffer.py b/src/py/libcamera/utils/MappedFrameBuffer.py
index e7dd16ec..fc2726b6 100644
--- a/src/py/libcamera/utils/MappedFrameBuffer.py
+++ b/src/py/libcamera/utils/MappedFrameBuffer.py
@@ -1,8 +1,14 @@ 
 # SPDX-License-Identifier: LGPL-2.1-or-later
 # Copyright (C) 2022, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>
 
+import libcamera
+from typing import Tuple
+
 class MappedFrameBuffer:
-    def __init__(self, fb):
+    """
+    Provides memoryviews for the FrameBuffer's planes
+    """
+    def __init__(self, fb: libcamera.FrameBuffer):
         self.__fb = fb
 
     def __enter__(self):
@@ -70,5 +76,6 @@  class MappedFrameBuffer:
             mm.close()
 
     @property
-    def planes(self):
+    def planes(self) -> Tuple[memoryview, ...]:
+        """memoryviews for the planes"""
         return self.__planes