FEATURE: Add tests

unittests/frontend_tkinter_parameter_editor_documentation_frame_test.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+
+"""
+Unittests for the frontend_tkinter_parameter_editor_documentation_frame.py file.
+
+This file is part of Ardupilot methodic configurator. https://github.com/ArduPilot/MethodicConfigurator
+
+SPDX-FileCopyrightText: 2024 Amilcar do Carmo Lucas <[email protected]>
+
+SPDX-License-Identifier: GPL-3.0-or-later
+"""
+
+import os
+import tkinter as tk
+import unittest
+from tkinter import ttk
+from unittest.mock import Mock, patch
+
+from ardupilot_methodic_configurator.frontend_tkinter_parameter_editor_documentation_frame import DocumentationFrame
+
+
+class TestDocumentationFrame(unittest.TestCase):
+    """Test the DocumentationFrame class."""
+
+    def setUp(self) -> None:
+        os.environ["DISPLAY"] = ":0"  # Set DISPLAY environment variable for headless mode
+        self.root = tk.Tk()
+        self.local_filesystem = Mock()
+        self.local_filesystem.get_documentation_text_and_url.return_value = ("Sample blog text", "http://example.com/blog")
+        self.current_file = "test_file"
+        self.local_filesystem.get_seq_tooltip_text.side_effect = ["Why text", "Why now text"]
+        self.doc_frame = DocumentationFrame(self.root, self.local_filesystem, self.current_file)
+
+    def test_create_documentation_frame(self) -> None:
+        """Test the creation of the documentation frame."""
+        self.assertIsInstance(self.doc_frame.documentation_frame, ttk.LabelFrame)
+        self.assertEqual(self.doc_frame.documentation_frame.cget("text"), "test_file Documentation")
+
+        expected_labels = ["Forum Blog:", "Wiki:", "External tool:", "Mandatory:"]
+        for label in expected_labels:
+            self.assertIn(label, self.doc_frame.documentation_labels)
+
+    @patch("ardupilot_methodic_configurator.frontend_tkinter_parameter_editor_documentation_frame.webbrowser_open")
+    def test_auto_open_documentation_links(self, mock_webbrowser_open) -> None:
+        """Test the automatic opening of documentation links."""
+        self.local_filesystem.get_documentation_text_and_url.side_effect = [
+            ("Blog text", "http://blog.url"),
+            ("Wiki text", "http://wiki.url"),
+            ("External tool text", "http://external_tool.url"),
+            ("Mandatory text", None),
+        ]
+        self.doc_frame.auto_open_var.set(True)
+
+        self.doc_frame.update_documentation_labels(self.current_file)
+
+        mock_webbrowser_open.assert_any_call(url="http://wiki.url", new=0, autoraise=False)
+        mock_webbrowser_open.assert_any_call(url="http://external_tool.url", new=0, autoraise=False)
+        mock_webbrowser_open.assert_any_call(url="http://blog.url", new=0, autoraise=True)
+
+    @patch("ardupilot_methodic_configurator.frontend_tkinter_parameter_editor_documentation_frame.show_tooltip")
+    def test_update_why_why_now_tooltip(self, _mock_show_tooltip) -> None:
+        """Test the update_why_why_now_tooltip method."""
+        self.local_filesystem.get_seq_tooltip_text.side_effect = ["Why text", "Why now text"]
+
+        self.doc_frame.update_why_why_now_tooltip(self.current_file)
+
+    @patch("ardupilot_methodic_configurator.frontend_tkinter_parameter_editor_documentation_frame.webbrowser_open")
+    @patch("ardupilot_methodic_configurator.frontend_tkinter_parameter_editor_documentation_frame.show_tooltip")
+    def test_update_documentation_labels(self, mock_show_tooltip, _mock_webbrowser_open) -> None:
+        """Test the update_documentation_labels method."""
+        self.local_filesystem.get_documentation_text_and_url.side_effect = lambda _file, key: {
+            "blog": ("Blog text", "http://blog.url"),
+            "wiki": ("Wiki text", "http://wiki.url"),
+            "external_tool": ("External tool text", "http://external_tool.url"),
+            "mandatory": ("Mandatory text", None),
+        }[key]
+
+        self.doc_frame.update_documentation_labels(self.current_file)
+
+        self.assertEqual(self.doc_frame.documentation_labels["Forum Blog:"].cget("text"), "Blog text")
+        self.assertEqual(self.doc_frame.documentation_labels["Wiki:"].cget("text"), "Wiki text")
+        self.assertEqual(self.doc_frame.documentation_labels["External tool:"].cget("text"), "External tool text")
+        self.assertEqual(self.doc_frame.documentation_labels["Mandatory:"].cget("text"), "Mandatory text")
+
+        mock_show_tooltip.assert_any_call(self.doc_frame.documentation_labels["Forum Blog:"], "http://blog.url")
+        mock_show_tooltip.assert_any_call(self.doc_frame.documentation_labels["Wiki:"], "http://wiki.url")
+        mock_show_tooltip.assert_any_call(self.doc_frame.documentation_labels["External tool:"], "http://external_tool.url")
+        # mock_show_tooltip.assert_any_call(self.doc_frame.documentation_labels["Mandatory:"],
+        # "Documentation URL not available")
+
+
+if __name__ == "__main__":
+    unittest.main()