[Camera] Add a method in python testing framework for video and image (project-chip#39046)

* Adds a method to invoke video verification prompt in python TCs

Signed-off-by: s-gatti <[email protected]>
Signed-off-by: Charles Kim <[email protected]>

* Adds a method to invoke image verification prompt in python TCs

Signed-off-by: s-gatti <[email protected]>
Signed-off-by: Charles Kim <[email protected]>

* Restyled by autopep8

Signed-off-by: Charles Kim <[email protected]>

* Adds a method to invoke video verification prompt in python TCs

Signed-off-by: s-gatti <[email protected]>
Signed-off-by: Charles Kim <[email protected]>

* Update argument type in snapshot verification api

Signed-off-by: s-gatti <[email protected]>
Signed-off-by: Charles Kim <[email protected]>

* Update src/python_testing/matter_testing_infrastructure/chip/testing/matter_testing.py

Co-authored-by: Yufeng Wang <[email protected]>

* Remove redundant function to fix lint error

Signed-off-by: Charles Kim <[email protected]>

---------

Signed-off-by: s-gatti <[email protected]>
Signed-off-by: Charles Kim <[email protected]>
Co-authored-by: s-gatti <[email protected]>
Co-authored-by: Restyled.io <[email protected]>
Co-authored-by: Yufeng Wang <[email protected]>

Author: 4 people

src/python_testing/matter_testing_infrastructure/chip/testing/matter_testing.py

@@ -1682,6 +1682,59 @@ def wait_for_user_input(self,
             logging.info("========= EOF on STDIN =========")
             return None
 
+    def user_verify_snap_shot(self,
+                              prompt_msg: str,
+                              image: bytes) -> Optional[str]:
+        """Show Image Verification Prompt and wait for user validation.
+
+        Args:
+            prompt_msg (str): Message for TH UI prompt and input function.
+            Indicates what is expected from the user.
+            image (bytes): Image data as bytes.
+
+        Returns:
+            str: User input or none if input is closed.
+        """
+
+        # Convert bytes to comma separated hex string
+        hex_string = ', '.join(f'{byte:02x}' for byte in image)
+        if self.runner_hook:
+            self.runner_hook.show_image_prompt(
+                msg=prompt_msg,
+                img_hex_str=hex_string
+            )
+
+        logging.info("========= USER PROMPT for Image Verification =========")
+        logging.info(f">>> {prompt_msg.rstrip()} (press enter to confirm)")
+        try:
+            return input()
+        except EOFError:
+            logging.info("========= EOF on STDIN =========")
+            return None
+
+    def user_verify_video_stream(self,
+                                 prompt_msg: str) -> Optional[str]:
+        """Show Video Verification Prompt and wait for user validation.
+
+        Args:
+            prompt_msg (str): Message for TH UI prompt and input function.
+            Indicates what is expected from the user.
+
+        Returns:
+            str: User input or none if input is closed.
+        """
+
+        if self.runner_hook:
+            self.runner_hook.show_video_prompt(msg=prompt_msg)
+
+        logging.info("========= USER PROMPT for Video Stream Verification =========")
+        logging.info(f">>> {prompt_msg.rstrip()} (press enter to confirm)")
+        try:
+            return input()
+        except EOFError:
+            logging.info("========= EOF on STDIN =========")
+            return None
+
 
 def _find_test_class():
     """Finds the test class in a test script.