refactor: centralize module testing

[Copilot]

Migrates to the NS8 standard testing infrastructure via NethServer/ns8-github-actions reusable workflows, replacing the bespoke test-module.sh-based setup.

Changes

• .github/workflows/test-module.yml — replaced with reusable workflow call (ns8-github-actions/.github/workflows/test-module.yml@v1), ui_tests_strategy: always
• tests/15_ui.robot — new UI screenshot test; runs after install (10_install_mail.robot) and before functional tests (20_imapsync.robot), using the ${MID} global variable set during install
• test-module.sh — deleted
• tests/pythonreq.txt — deleted
• .gitignore — added tests/outputs/
• README.md — ## Testing section replaced with ## Running tests locally pointing to the ns8-github-actions docs

Ref: NethServer/dev#7281

Original prompt

refactor: centralize module testing

Ref:

• Improve Automated Tests maintenance dev#7281

Please make the following changes:

1. Replace .github/workflows/test-module.yml

Replace the entire content of .github/workflows/test-module.yml with:

name: Test module

on:
  workflow_dispatch:
    inputs:
      debug_shell:
        description: "Debug shell"
        required: true
        type: boolean
  workflow_run:
    workflows: ["Publish images"]
    types: [completed]

jobs:
  run:
    name: "Run tests"
    uses: NethServer/ns8-github-actions/.github/workflows/test-module.yml@v1
    with:
      ui_tests_strategy: always
      debug_shell: ${{ github.event.inputs.debug_shell == 'true' }}
    secrets:
      do_token: ${{ secrets.do_token }}

(Note: ui_tests_strategy: always must be at line 19.)

2. Update .gitignore

Add tests/outputs/ to .gitignore if it's not already present.

3. Update README.md

Replace the existing ## Testing section (currently contains references to test-module.sh and Robot Framework) with the following section. Use ## Running tests locally as the new header:

## Running tests locally

This module uses the NS8 standard testing infrastructure. For instructions on how to run the test suite locally, refer to the [Running tests locally](https://github.com/NethServer/ns8-github-actions/blob/v1/README.md#running-tests-locally) section of the ns8-github-actions repository.

4. Delete test-module.sh

Delete the file test-module.sh from the root of the repository.

5. Delete tests/pythonreq.txt

Delete the file tests/pythonreq.txt.

6. Add UI tests robot file

The file ui/src/App.vue exists, so UI tests must be added.

The tests directory has multiple robot files (excluding __init__.robot):

• tests/10_install_mail.robot — installs the module (contains add-module), uses Set Global Variable ${MID} ${output.module_id}
• tests/20_imapsync.robot — tests imapsync
• tests/90_uninstall.robot — uninstalls

Robot files use single underscore naming (e.g. 10_install_mail.robot).

Create a new file tests/15_ui.robot for UI tests. The module ID variable is ${MID} (set as a Global Variable in 10_install_mail.robot).

The content of tests/15_ui.robot should be:

*** Settings ***
Library           Browser

*** Variables ***
${ADMIN_USER}    admin
${ADMIN_PASSWORD}    Nethesis,1234
${MID}    ${EMPTY}

*** Keywords ***

Login to cluster-admin
    New Page    https://${NODE_ADDR}/cluster-admin/
    Fill Text    text="Username"    ${ADMIN_USER}
    Click    button >> text="Continue"
    Fill Text    text="Password"    ${ADMIN_PASSWORD}
    Click    button >> text="Log in"
    Wait For Elements State    css=#main-content    visible    timeout=10s

*** Test Cases ***

Take screenshots
    [Tags]    ui
    New Browser    chromium    headless=True
    New Context    ignoreHTTPSErrors=True
    Login to cluster-admin
    Go To    https://${NODE_ADDR}/cluster-admin/#/apps/${MID}
    Wait For Elements State    iframe >>> h2 >> text="Status"    visible    timeout=10s
    Sleep    5s
    Take Screenshot    filename=${OUTPUT DIR}/browser/screenshot/1._Status.png
    Go To    https://${NODE_ADDR}/cluster-admin/#/apps/${MID}?page=settings
    Wait For Elements State    iframe >>> h2 >> text="Settings"    visible    timeout=10s
    Sleep    5s
    Take Screenshot    filename=${OUTPUT DIR}/browser/screenshot/2._Settings.png
    Close Browser

Commit message

Use refactor: centralize module testing as the commit message.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Create a PR for the following repositories:

• Nethserver/ns8-ejabberd
• Nethserver/ns8-imapsync

PR title and commit message are "refactor: centralize module testing"

PR description is the following:
Ref:

• Improve Automated Tests maintenance dev#7281

The changes to perform are the following:

• substitute the content of .github/workflows/test-module.yml with this: https://raw.githubusercontent.com/NethServer/ns8-mail/d034d052cb0205da95a4947e2ccd4a20a031a1a9/.github/workflows/test-module.yml, but make sure to set ui_tests_strategy: always at line 19
• Make sure that .gitignore contains tests/outputs/
• README.md: replace the "Testing" section with exacltly this short section: https://github.com/NethServer/ns8-mail/blob/d034d052cb0205da95a4947e2ccd4a20a031a1a9/README.md?plain=1#L299-L301. Add this section anyway if "Testing" section does not exist. Make sure to use ## Running tests locally as header
• Delete test-module.sh if present
• Delete tests/pythonreq.txt if present
• if and only if ui/src/App.vue exists, then add the robot file for ui tests by doing the following. Inside the tests directory, check how many robots file are present (excluding __init__.robot):
  • If there is only one (excluding __init__.robot) and it contains a test with "Execute Command ...

This pull request was created from Copilot chat.

[github-actions]

UI Test Screenshots rl1

1. Status

2. Settings