Add Gstreamer video decoder md5 checksum scenario

Ref:
  - https://warthogs.atlassian.net/browse/PEB-513
  - https://docs.google.com/document/d/1yuAdse3u64QZGCL2VQ4_PpuPIC0i1yXqHxKI6660WFg/edit#heading=h.rh805u3vq3ig

contrib/checkbox-ce-oem/checkbox-provider-ce-oem/bin/gst_resources_generator.py

@@ -0,0 +1,174 @@
+#!/usr/bin/env python3
+# This file is part of Checkbox.
+#
+# Copyright 2024 Canonical Ltd.
+# Written by:
+#   Patrick Chang <[email protected]>
+#
+# Checkbox is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3,
+# as published by the Free Software Foundation.
+#
+# Checkbox is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Checkbox. If not, see <http://www.gnu.org/licenses/>.
+
+import argparse
+import os
+import json
+import logging
+from pathlib import Path
+from typing import Dict, Any, List
+
+logging.basicConfig(level=logging.INFO)
+
+
+def load_json_config(file_path: str) -> Dict:
+    """
+    Reads a JSON file from the specified file path.
+
+    :param file_path:
+        The path to the JSON file.
+    :returns:
+        dict: The loaded configuration dictionary.
+    :raises FileNotFoundError:
+    """
+    file_path = Path(file_path)
+    if not file_path.exists():
+        raise FileNotFoundError(
+            "The file '{}' does not exist.".format(file_path)
+        )
+
+    with file_path.open("r") as f:
+        data = json.load(f)
+
+    return data
+
+
+def register_arguments():
+    parser = argparse.ArgumentParser(
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        description=(
+            "Script helps verify the MD5 checksum from specific Gstreamer"
+            " Decoder with different resolutions and color spaces is exactly"
+            " match golden reference"
+        ),
+    )
+
+    parser.add_argument(
+        "gst_conf_name",
+        type=str,
+        help="Path of the specified test configuration file.",
+    )
+
+    parser.add_argument(
+        "-gtdp",
+        "--gst_testing_data_path",
+        type=str,
+        help="Path of the testing data.",
+    )
+
+    args = parser.parse_args()
+    return args
+
+
+class GstResources:
+    def __init__(self, args: Any, scenarios: dict):
+        self._scenarios = scenarios
+        self._current_scenario_name = ""
+        self._args = args
+        self._resource_items = []
+
+    def _gst_v4l2_video_decoder_md5_checksum_comparison_helper(
+        self,
+        decoder_plugin: str,
+        width: dict,
+        height: dict,
+        color_space: str,
+        source_format: str,
+    ) -> dict:
+        """
+        Generate a resource item dictionary for
+        gst_v4l2_video_decoder_md5_checksum_comparison scenario
+        """
+        name = "{}x{}-{}-{}".format(width, height, decoder_plugin, color_space)
+        golden_sample_file = "{}/video_golden_samples/{}.{}".format(
+            self._args.gst_testing_data_path, name, source_format
+        )
+        golden_md5_checkum_file = "{}/{}/golden_md5_checksum/{}/{}.md5".format(
+            self._args.gst_testing_data_path,
+            self._current_scenario_name,
+            self._args.gst_conf_name,
+            name,
+        )
+
+        returned_dict = {
+            "scenario": self._current_scenario_name,
+            "decoder_plugin": decoder_plugin,
+            "width": width,
+            "height": height,
+            "color_space": color_space,
+            "golden_sample_file": golden_sample_file,
+            "golden_md5_checkum_file": golden_md5_checkum_file,
+        }
+
+        return returned_dict
+
+    def gst_v4l2_video_decoder_md5_checksum_comparison(
+        self, scenario_data: List[Dict]
+    ) -> None:
+        for item in scenario_data:
+            self._resource_items.extend([
+                self._gst_v4l2_video_decoder_md5_checksum_comparison_helper(
+                    decoder_plugin=item["decoder_plugin"],
+                    width=resolution["width"],
+                    height=resolution["height"],
+                    color_space=color_space,
+                    source_format=item["source_format"],
+                )
+                for resolution in item["resolutions"]
+                for color_space in item["color_spaces"]
+            ])
+
+    def main(self):
+        for scenario in self._scenarios:
+            self._current_scenario_name = scenario
+            getattr(self, scenario)(self._scenarios[scenario])
+            self._dump_resources()
+
+    def _dump_resources(self):
+        """
+        Prints each key-value pair from the self._resource_items in the format
+        "key": "value".
+        """
+        for item in self._resource_items:
+            for key, value in item.items():
+                print("{}: {}".format(key, value))
+            print()
+        print()
+        # Renew for next scenario
+        self._resource_items = []
+
+
+def main() -> None:
+    try:
+        data_dir = os.environ["PLAINBOX_PROVIDER_DATA"]
+    except KeyError:
+        raise SystemExit("PLAINBOX_PROVIDER_DATA variable not set")
+    args = register_arguments()
+
+    # All gstreamer related configs should be put into gstreamer-test-confs
+    # direcotry by design
+    conf_path = os.path.join(
+        data_dir, "gstreamer-test-confs", "{}.json".format(args.gst_conf_name)
+    )
+    scenarios = load_json_config(file_path=conf_path)
+    GstResources(args, scenarios).main()
+
+
+if __name__ == "__main__":
+    main()