Updates on py files test files readme file and github actions

.github/workflows/auto-tests-mac.yml

@@ -0,0 +1,40 @@
+---
+name: Auto Run Tests For Mac with all push
+
+on:
+  push:
+    branches:
+      - '*'
+  pull_request:
+    branches:
+      - '*'
+  workflow_dispatch:
+jobs:
+  test:
+    runs-on: macos-latest
+
+    steps:
+      # Step 1: Checkout the repository codes
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      # Step 2: Install SDL2 (for pygame) 
+      - name: Install SDL2 (for pygame)
+        run: |
+          brew install sdl2 sdl2_image sdl2_mixer sdl2_ttf
+
+      # Step 3: Set up Python environment
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+
+      - name: Run all pytests suite
+        run: |
+          python -m pytest tests/ -vv --maxfail=1 --disable-warnings

.github/workflows/auto-tests-ubu.yml

@@ -0,0 +1,37 @@
+---
+name: Auto Run Tests For Ubuntu with all push
+
+on:
+  push:
+    branches:
+      - '*'
+  pull_request:
+    branches:
+      - '*'
+  workflow_dispatch:
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update --fix-missing
+          sudo apt-get install -y libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libfreetype6-dev libportmidi-dev libjpeg-dev python3-setuptools python3-tk python3-dev pulseaudio xvfb
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          python -m pip install sphinx numpy>=1.21.0 "Cython>=3.0,<3.1"
+
+      - name: Run all pytests suite with Xvfb (auto-detect video driver) and PulseAudio in tests
+        run: |
+          export SDL_AUDIODRIVER=disk  # Use disk-based audio driver
+          export PULSE_SERVER=unix:/run/user/1000/pulse/native  # Optional, in case PulseAudio is needed
+          xvfb-run --auto-servernum python -m pytest tests/ -vv --maxfail=1 --disable-warnings

.github/workflows/auto-tests-win.yml

@@ -0,0 +1,73 @@
+---
+name: Auto Run Tests For Windows with all push
+
+on:
+  push:
+    branches:
+      - '*'
+  pull_request:
+    branches:
+      - '*'
+  workflow_dispatch:
+jobs:
+  # 1) WINDOWS JOB (Runs only Windows-safe tests from GitHub Win Runner)
+  windows-tests:
+    name: Windows Tests (Algorithms + DB + Export)
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+
+      # Prevent pygame/tkinter to open a window & GUI mocks to run in CI
+      - name: Configure headless SDL / GUI
+        run: |
+          echo "SDL_VIDEODRIVER=dummy" >> $GITHUB_ENV
+          echo "SDL_AUDIODRIVER=dummy" >> $GITHUB_ENV
+          echo "PYGAME_HIDE_SUPPORT_PROMPT=1" >> $GITHUB_ENV
+
+      # Run ONLY Windows tests as gitHub dislikes test_gui, test_system, test_integrations, test_translation, etc.
+      - name: Run all pytests suite
+        run: |
+          $env:SDL_VIDEODRIVER="dummy"
+          $env:SDL_AUDIODRIVER="dummy"
+          python -m pytest -vv --maxfail=1 --disable-warnings tests/test_algorithms.py tests/test_database.py tests/test_email.py tests/test_export_json.py tests/test_export_pdf.py tests/test_validation.py
+
+  # 2) UBUNTU JOB (Runs ALL tests with missing: test_gui, test_system, test_integration, test_settings, test_translation anything gui/tk/vm tk)
+  ubuntu-tests:
+    name: Ubuntu Full Test Suite
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update --fix-missing
+          sudo apt-get install -y libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libfreetype6-dev libportmidi-dev libjpeg-dev python3-setuptools python3-tk python3-dev pulseaudio xvfb
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          python -m pip install sphinx numpy>=1.21.0 "Cython>=3.0,<3.1"
+
+      - name: Run all pytests suite with Xvfb (auto-detect video driver) and PulseAudio in tests
+        run: |
+          export SDL_AUDIODRIVER=disk  # Use disk-based audio driver
+          export PULSE_SERVER=unix:/run/user/1000/pulse/native  # Optional, in case PulseAudio is needed
+          xvfb-run --auto-servernum python -m pytest tests/ -vv --maxfail=1 --disable-warnings