WIP: SWTBot test case: Debug flow Test

tests/com.espressif.idf.ui.test/src/com/espressif/idf/ui/test/executable/cases/project/IDFProjectDebugProcessTest.java

@@ -0,0 +1,265 @@
+/*******************************************************************************
+ * Copyright 2025 Espressif Systems (Shanghai) PTE LTD.
+ * All rights reserved. Use is subject to license terms.
+ *******************************************************************************/
+
+package com.espressif.idf.ui.test.executable.cases.project;
+
+import static org.eclipse.swtbot.swt.finder.waits.Conditions.widgetIsEnabled;
+import static org.junit.Assert.assertTrue;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Optional;
+
+import org.apache.commons.lang3.SystemUtils;
+import org.eclipse.swtbot.eclipse.finder.SWTWorkbenchBot;
+import org.eclipse.swtbot.eclipse.finder.widgets.SWTBotView;
+import org.eclipse.swtbot.swt.finder.junit.SWTBotJunit4ClassRunner;
+import org.eclipse.swtbot.swt.finder.widgets.SWTBotCheckBox;
+import org.eclipse.swtbot.swt.finder.widgets.SWTBotShell;
+import org.eclipse.swtbot.swt.finder.widgets.SWTBotTreeItem;
+import org.junit.After;
+import org.junit.BeforeClass;
+import org.junit.FixMethodOrder;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.MethodSorters;
+
+import com.espressif.idf.ui.test.common.WorkBenchSWTBot;
+import com.espressif.idf.ui.test.common.utility.TestWidgetWaitUtility;
+import com.espressif.idf.ui.test.operations.EnvSetupOperations;
+import com.espressif.idf.ui.test.operations.ProjectTestOperations;
+import com.espressif.idf.ui.test.operations.selectors.LaunchBarConfigSelector;
+import com.espressif.idf.ui.test.operations.selectors.LaunchBarTargetSelector;
+
+/**
+ * Test class to test Debug Process
+ * 
+ * @author Andrii Filippov
+ *
+ */
+
+@SuppressWarnings("restriction")
+@RunWith(SWTBotJunit4ClassRunner.class)
+@FixMethodOrder(MethodSorters.NAME_ASCENDING)
+public class IDFProjectDebugProcessTest
+{
+	@BeforeClass
+	public static void beforeTestClass() throws Exception
+	{
+		Fixture.loadEnv();
+	}
+
+	@After
+	public void afterEachTest()
+	{
+		try
+		{
+			Fixture.cleanTestEnv();
+		}
+		catch (Exception e)
+		{
+			System.err.println("Error during cleanup: " + e.getMessage());
+		}
+	}
+
+	@Test
+	public void givenNewProjectCreatedWhenFlashedAndDebuggedThenDebuggingWorks() throws Exception
+	{
+		if (SystemUtils.IS_OS_LINUX) // temporary solution until new ESP boards arrive for Windows
+		{
+			Fixture.givenNewEspressifIDFProjectIsSelected("EspressIf", "Espressif IDF Project");
+			Fixture.givenProjectNameIs("NewProjecDebugTest");
+			Fixture.whenNewProjectIsSelected();
+			Fixture.whenTurnOffOpenSerialMonitorAfterFlashingInLaunchConfig();
+			Fixture.whenSelectLaunchTargetSerialPort();
+			Fixture.whenProjectIsBuiltUsingContextMenu();
+			Fixture.whenFlashProject();
+			Fixture.thenVerifyFlashDoneSuccessfully();
+			Fixture.whenSelectDebugConfig();
+			Fixture.whenSelectLaunchTargetBoard();
+//			Fixture.whenDebugProject();
+//			Fixture.whenSwitchPerspective();
+//			Fixture.checkIfOpenOCDandGDBprocessesArePresent();
+//			Fixture.whenDebugStoppedUsingContextMenu();
+		}
+		else
+		{
+			assertTrue(true);
+		}
+	}
+
+	private static class Fixture
+	{
+		private static SWTWorkbenchBot bot;
+		private static String category;
+		private static String subCategory;
+		private static String projectName;
+
+		private static void loadEnv() throws Exception
+		{
+			bot = WorkBenchSWTBot.getBot();
+			EnvSetupOperations.setupEspressifEnv(bot);
+			bot.sleep(1000);
+			ProjectTestOperations.deleteAllProjects(bot);
+		}
+
+		private static void givenNewEspressifIDFProjectIsSelected(String category, String subCategory)
+		{
+			Fixture.category = category;
+			Fixture.subCategory = subCategory;
+		}
+
+		private static void givenProjectNameIs(String projectName)
+		{
+			Fixture.projectName = projectName;
+		}
+
+		private static void whenNewProjectIsSelected() throws Exception
+		{
+			ProjectTestOperations.setupProject(projectName, category, subCategory, bot);
+		}
+
+		private static void whenProjectIsBuiltUsingContextMenu() throws IOException
+		{
+			ProjectTestOperations.buildProjectUsingContextMenu(projectName, bot);
+			ProjectTestOperations.waitForProjectBuild(bot);
+			TestWidgetWaitUtility.waitForOperationsInProgressToFinishAsync(bot);
+		}
+
+		private static void whenDebugProject() throws IOException
+		{
+			ProjectTestOperations.launchCommandUsingContextMenu(projectName, bot, "Debug Configurations...");
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "Debug Configurations", 10000);
+			bot.tree().getTreeItem("ESP-IDF GDB OpenOCD Debugging").select();
+			bot.tree().getTreeItem("ESP-IDF GDB OpenOCD Debugging").expand();
+			bot.tree().getTreeItem("ESP-IDF GDB OpenOCD Debugging").getNode(projectName + " Debug").select();
+			bot.waitUntil(widgetIsEnabled(bot.button("Debug")), 5000);
+			bot.button("Debug").click();
+		}
+
+		private static void whenSelectDebugConfig() throws Exception
+		{
+			LaunchBarConfigSelector configSelector = new LaunchBarConfigSelector(bot);
+			configSelector.select(projectName + " Debug");
+		}
+
+		private static void whenSelectLaunchTargetBoard() throws Exception
+		{
+			LaunchBarTargetSelector targetSelector = new LaunchBarTargetSelector(bot);
+			targetSelector.clickEdit();
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "New ESP Target", 20000);
+			SWTBotShell shell = bot.shell("New ESP Target");
+			bot.comboBoxWithLabel("Board:").setSelection("ESP32-ETHERNET-KIT [usb://1-10]");
+			TestWidgetWaitUtility.waitForOperationsInProgressToFinishSync(bot);
+			shell.setFocus();
+			bot.button("Finish").click();
+		}
+
+		private static void whenSwitchPerspective() throws Exception
+		{
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "Confirm Perspective Switch", 20000);
+			bot.button("Switch").click();
+			bot.sleep(10000);
+		}
+
+		private static void whenTurnOffOpenSerialMonitorAfterFlashingInLaunchConfig() throws Exception
+		{
+			LaunchBarConfigSelector configSelector = new LaunchBarConfigSelector(bot);
+			configSelector.clickEdit();
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "Edit Configuration", 20000);
+			bot.cTabItem("Main").show();
+			bot.cTabItem("Main").setFocus();
+			SWTBotCheckBox checkBox = bot.checkBox("Open Serial Monitor After Flashing");
+			if (checkBox.isChecked())
+			{
+				checkBox.click();
+			}
+			bot.button("OK").click();
+		}
+
+		private static void whenSelectLaunchTargetSerialPort() throws Exception
+		{
+			LaunchBarTargetSelector targetSelector = new LaunchBarTargetSelector(bot);
+			targetSelector.clickEdit();
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "New ESP Target", 20000);
+			SWTBotShell shell = bot.shell("New ESP Target");
+			bot.comboBoxWithLabel("Serial Port:").setSelection("/dev/ttyUSB1 Dual RS232-HS");
+			TestWidgetWaitUtility.waitForOperationsInProgressToFinishSync(bot);
+			shell.setFocus();
+			bot.button("Finish").click();
+		}
+
+		private static void whenFlashProject() throws IOException
+		{
+			ProjectTestOperations.launchCommandUsingContextMenu(projectName, bot, "Run Configurations...");
+			TestWidgetWaitUtility.waitForDialogToAppear(bot, "Run Configurations", 10000);
+			bot.tree().getTreeItem("ESP-IDF Application").select();
+			bot.tree().getTreeItem("ESP-IDF Application").expand();
+			bot.tree().getTreeItem("ESP-IDF Application").getNode(projectName).select();
+			bot.waitUntil(widgetIsEnabled(bot.button("Run")), 5000);
+			bot.button("Run").click();
+		}
+
+		private static void thenVerifyFlashDoneSuccessfully() throws Exception
+		{
+			ProjectTestOperations.waitForProjectFlash(bot);
+		}
+
+		private static SWTBotTreeItem fetchProjectFromDebugView()
+		{
+			SWTBotView debugView = bot.viewByTitle("Debug");
+			debugView.show();
+			debugView.setFocus();
+			SWTBotTreeItem[] items = debugView.bot().tree().getAllItems();
+			Optional<SWTBotTreeItem> project = Arrays.asList(items).stream()
+					.filter(i -> i.getText().equals(projectName + "Debug [ESP-IDF GDB OpenOCD Debugging]")).findFirst();
+			if (project.isPresent())
+			{
+				return project.get();
+			}
+
+			return null;
+		}
+
+		private static boolean checkifOpenOCDandGDBprocessesArePresent()
+		{
+			SWTBotTreeItem projectItem = fetchProjectFromDebugView();
+			if (projectItem != null)
+			{
+				projectItem.select();
+
+				boolean openOCDexe = ProjectTestOperations.isFileAbsent(projectItem, "openocd.exe");
+				boolean GDBexe = ProjectTestOperations.isFileAbsent(projectItem, "riscv32-esp-elf-gdb.exe");
+				if (openOCDexe || GDBexe)
+				{
+					return false;
+				}
+				return true;
+			}
+			return false;
+		}
+
+		private static void checkIfOpenOCDandGDBprocessesArePresent() throws IOException
+		{
+			assertTrue("Debug process was not successfully started", checkifOpenOCDandGDBprocessesArePresent());
+		}
+
+		private static void whenDebugStoppedUsingContextMenu() throws IOException
+		{
+			ProjectTestOperations.launchCommandUsingContextMenu(projectName + "Debug [ESP-IDF GDB OpenOCD Debugging]",
+					bot, "Terminate/Disconnect All");
+			bot.sleep(10000);
+			ProjectTestOperations.findInConsole(bot, "IDF Process Console", "dropped 'gdb'");
+			TestWidgetWaitUtility.waitForOperationsInProgressToFinishSync(bot);
+		}
+
+		private static void cleanTestEnv()
+		{
+			TestWidgetWaitUtility.waitForOperationsInProgressToFinishAsync(bot);
+			ProjectTestOperations.closeAllProjects(bot);
+			ProjectTestOperations.deleteAllProjects(bot);
+		}
+	}
+}