From 294149b029d85395519e54872251d771546bf76f Mon Sep 17 00:00:00 2001 From: Bindea Cristian Date: Tue, 21 Jan 2025 15:44:06 +0200 Subject: [PATCH] docs/tests: add install test cases and about page test cases Signed-off-by: Bindea Cristian --- .../tests/general/core/license_about_page.rst | 75 ++++++ docs/tests/general/index.rst | 2 + docs/tests/general/install/index.rst | 14 ++ docs/tests/general/install/install_tests.rst | 229 ++++++++++++++++++ 4 files changed, 320 insertions(+) create mode 100644 docs/tests/general/core/license_about_page.rst create mode 100644 docs/tests/general/install/index.rst create mode 100644 docs/tests/general/install/install_tests.rst diff --git a/docs/tests/general/core/license_about_page.rst b/docs/tests/general/core/license_about_page.rst new file mode 100644 index 000000000..753737888 --- /dev/null +++ b/docs/tests/general/core/license_about_page.rst @@ -0,0 +1,75 @@ +.. _license_and_about_page_tests: + +Scopy license and about page test cases +======================================== + + +Test 1 - Check license pop-up +----------------------------- + +**UID:** TST.LICENSE.POPUP + +**Preconditions:** + - OS: Any + +**Description:** This test verifies if the license pop-up appears at the start of the application. + +**Steps:** + 1. Start the Scopy application. + 2. Click on **Preferences** + 3. Scroll down, click on **Reset** and after that on **Restart** + - **Expected result:** The application should restart and the first thing + that appears on the screen is a pop-up regarding the license used in Scopy. + 4. Click on the highlighted text **"GPLv3"** + - **Expected result:** A web browser window will open containing the GPLv3 + license used by Scopy. + 5. Click on **Continue** + - **Expected result:** The application will display the home screen with + the text "Welcome to Scopy!". + +**RESULT:** PASS/FAIL + + +Test 2 - Check links from About Page +------------------------------------- + +**UID:** TST.ABOUT.PAGE + +**Preconditions:** + - OS: Any + +**Description:** This test verifies if all the links from **About Page** work correctly. + +**Steps:** + 1. Start the Scopy application. + 2. Click on the **About** button from the bottom left side of the application. + - **Expected result:** The application will display a screen containing + textual information about the current version. + 3. Click on the underlined word **here** from the line **Build info: here** + - **Expected result:** The displayed text will change, and it now shows + more detailed information about the building process. + 4. Click on the **Home** buttom from the top right side of the application. + - **Expected result:** The application will display the initial screen + of the About page. + 5. Click on the highlighted text **Scopy open source project** + - **Expected result:** The application will display more information about + the Scopy project. + 6. Click on the **Home** buttom from the top right side of the application. + 7. Click on the highlighted text **other open source software** + - **Expected result:** The application will display a list of open source + libraries included or linked to Scopy. + 8. Click on the **Home** buttom from the top right side of the application. + 9. Click on the highlighted text **Latest Release** + - **Expected result:** A web browser window will open containing the latest + release of Scopy. + 10. Click on the **Home** buttom from the top right side of the application. + 11. Click on the highlighted text **Documentation** + - **Expected result:** A web browser window will open containing the + documentation for Scopy. + 12. Click on the **Home** buttom from the top right side of the application. + 13. Click on the highlighted text **Support Forum** + - **Expected result:** A web browser window will open containing a forum + named `ADI EngineerZone`. + + +**RESULT:** PASS/FAIL \ No newline at end of file diff --git a/docs/tests/general/index.rst b/docs/tests/general/index.rst index 0ba20e877..5d685dd9f 100644 --- a/docs/tests/general/index.rst +++ b/docs/tests/general/index.rst @@ -11,10 +11,12 @@ Contents :maxdepth: 3 core/hp_tests + core/license_about_page core/add_dev_tests core/connection_tests core/emu_tests core/dev_tests + install/index .. add the path to each core feature test case here diff --git a/docs/tests/general/install/index.rst b/docs/tests/general/install/index.rst new file mode 100644 index 000000000..389adffcc --- /dev/null +++ b/docs/tests/general/install/index.rst @@ -0,0 +1,14 @@ +.. _tests_install: + +Scopy Install Test Cases +=============================================================================== + +Contents +--------------------------------------------------------------------- + +.. toctree:: + :includehidden: + :maxdepth: 3 + + install_tests + diff --git a/docs/tests/general/install/install_tests.rst b/docs/tests/general/install/install_tests.rst new file mode 100644 index 000000000..d88de4e15 --- /dev/null +++ b/docs/tests/general/install/install_tests.rst @@ -0,0 +1,229 @@ +.. _install_tests: + +Scopy AppImage installer test cases +=================================== + + +Test 1 - Check if Scopy AppImage x86_64 opens correctly +------------------------------------------------------- + +**UID:** TST.START.APPIMAGE.X86_64 + +**Description:** This test verifies if the Scopy AppImage starts correctly on an +Linux Operating System with x86_64 architecture. + +**Preconditions:** + - OS: Linux intel x86_64 + - libfuse2 is required in order to execute an AppImage, install it using + **sudo apt-get install** + +**Steps:** + 1. Download Scopy Linux AppImage x86_64 from the `release page `_. + 2. Unzip the archive. + - **Expected result:** a file named **Scopy-x86_64.AppImage** should be extracted. + 3. Grant execution permission to the file using the terminal. + + .. code-block:: shell + + chmod +x Scopy-x86_64.AppImage + + 4. To start the application execute the .AppImage file. + + .. code-block:: shell + + ./Scopy-x86_64.AppImage + + Or double-click from the GUI. + + - **Expected result:** A window containing the GUI of the application + should open and if opened from the terminal, the logs generated by the + application should be displayed inside the terminal. Inside the application, + a window containing the license agreement should appear with 2 buttons + "Exit" and "Continue". + 5. Press "Exit". + - **Expected result:** Scopy should gracefully close. + 6. Start again the application, just like in step 4. + 7. Press "Continue". + - **Expected result:** The window containing the license agreement + should close and Scopy should be still running. + +**RESULT:** PASS/FAIL + + +Test 2 - Check if Scopy AppImage arm32 opens correctly +------------------------------------------------------- + +**UID:** TST.START.APPIMAGE.X86_64 + +**Description:** This test verifies if the Scopy AppImage starts correctly on an +Linux Operating System with arm32 architecture. + +**Preconditions:** + - OS: Linux intel arm32 + - libfuse2 is required in order to execute an AppImage, install it using + **sudo apt-get install** + +**Steps:** + 1. Download Scopy Linux AppImage arm32 from the `release page `_. + 2. Unzip the archive. + - **Expected result:** a file named **Scopy-armhf.AppImage** should be extracted. + 3. Grant execution permission to the file using the terminal. + + .. code-block:: shell + + chmod +x Scopy-armhf.AppImage + + 4. To start the application execute the .AppImage file. + + .. code-block:: shell + + ./Scopy-armhf.AppImage + + Or double-click from the GUI. + + - **Expected result:** A window containing the GUI of the application + should open and if opened from the terminal, the logs generated by the + application should be displayed inside the terminal. Inside the application, + a window containing the license agreement should appear with 2 buttons + "Exit" and "Continue". + 5. Press "Exit". + - **Expected result:** Scopy should gracefully close. + 6. Start again the application, just like in step 4. + 7. Press "Continue". + - **Expected result:** The window containing the license agreement + should close and Scopy should be still running. + +**RESULT:** PASS/FAIL + +Test 3 - Check if Scopy AppImage arm64 opens correctly +------------------------------------------------------- + +**UID:** TST.START.APPIMAGE.X86_64 + +**Description:** This test verifies if the Scopy AppImage starts correctly on an +Linux Operating System with arm64 architecture. + +**Preconditions:** + - OS: Linux intel arm64 + - libfuse2 is required in order to execute an AppImage, install it using + **sudo apt-get install** + +**Steps:** + 1. Download Scopy Linux AppImage arm64 from the `release page `_. + 2. Unzip the archive. + - **Expected result:** a file named **Scopy-arm64.AppImage** should be extracted. + 3. Grant execution permission to the file using the terminal. + + .. code-block:: shell + + chmod +x Scopy-arm64.AppImage + + 4. To start the application execute the .AppImage file. + + .. code-block:: shell + + ./Scopy-arm64.AppImage + + Or double-click from the GUI. + + - **Expected result:** A window containing the GUI of the application + should open and if opened from the terminal, the logs generated by the + application should be displayed inside the terminal. Inside the application, + a window containing the license agreement should appear with 2 buttons + "Exit" and "Continue". + 5. Press "Exit". + - **Expected result:** Scopy should gracefully close. + 6. Start again the application, just like in step 4. + 7. Press "Continue". + - **Expected result:** The window containing the license agreement + should close and Scopy should be still running. + +**RESULT:** PASS/FAIL + + +Scopy macOS installer test case +=============================== + +Test 1 - Check if Scopy macOS installer opens correctly +------------------------------------------------------- + +**UID:** TST.START.MACOS + +**Precondition:** + - OS: macOS intel + +**Description:** This test checks whether the Scopy macOS installer successfully +installs the application and ensures it launches correctly on a macOS operating +system with an x86_64 architecture. + +**Steps:** + 1. Download Scopy macOS installer from the release page. + + 2. Unzip the archive. + - **Expected result:** A DMG file named **Scopy-macos** should be extracted. + (the file name will also contain the macOS version and the commit hash) + 3. Double-click the file. + - **Expected result:** A pop-up that contains the Scopy icon will appear + 4. Install the application by right clicking the file and click on **Open**. + - **Expected result:** A error pop-up will appear. + 5. Click on **Cancel** and after that repeat the step 4, right click on the file, and click on **Open**. + - **Expected result** A warning pop-up will appear. Different than + the first one by including an Open button. + 6. Click on **Open** + - **Expected result:** After a while, a window with the GUI of the application + should open. Inside the application, a window containing the license + agreement should appear with 2 buttons "Exit" and "Continue". + 7. Press "Exit". + - **Expected result:** Scopy should gracefully close. + 8. Start again the application by right-clicking and click on **Open**. + 9. Press "Continue". + - **Expected result:** The window containing the license agreement + should close and Scopy should be still running. + +**RESULT:** PASS/FAIL + +Scopy Windows installer test case +================================= + +Test 1 - Check if Scopy Windows installer opens and installs Scopy properly +--------------------------------------------------------------------------- + +**UID:** + TST.START.WINDOWS + +**Precondition:** + - OS: Windows + +**Description:** This test checks whether the Scopy Windows installer successfully +installs the application and ensures it launches correctly on a Windows operating +system with an x86_64 architecture. + +**Steps:** + 1. Download Scopy Windows installer from the release page. + 2. Double-click the installer. + - **Expected result:** A window containing the installation wizard + should open. It should contain a drop-down menu from which can be + selected the language during the installation. + 3. Click on **OK** + - **Expected result:** The installer continues with the `License Agreement` tab. + 4. Click on **I accept the agreement** and on **Next**. + - **Expected result:** The installer continues with the location where + the application will be installed. + 5. Select a location and click on **Next**. + - **Expected result:** The installer continues with the list of components + that will be installed. + 6. Click on **Next**. + - **Expected result:** The installer continues with the `Additional Tasks` tab. + 7. Check the `"Install drivers for ADALM2000 - Requires Administrative Rights"` box and click on **Next**. + - **Expected result:** The installer continues with the installation summary. + 8. Click on **Install**. + - **Expected result:** The application should start installing. At the end of + the installation, it should ask for Administrative Rights in order to install + ADALM2000 drivers. + 9. Inside the newly opened window. Follow the ADALM2000 drivers installation by clicking **Next** and **Finish**. + - **Expected result:** Both the application and the ADALM2000 drivers + installed successfully. And optionally, you can check to restart the + computer or not. + 10. Click on **Finish**. + +**RESULT:** PASS/FAIL \ No newline at end of file