Merge branch 'master' into ignore-files-qa-check-299

Author: aoutifrak

.github/actions/retry-command/action.yml

@@ -0,0 +1,37 @@
+name: "Retry Command"
+
+description: "Retries a shell command if it fails"
+
+inputs:
+  command:
+    description: "The shell command to run"
+    required: true
+  max_attempts:
+    description: "Number of retry attempts"
+    required: false
+    default: "3"
+  delay_seconds:
+    description: "Delay between retries in seconds"
+    required: false
+    default: "5"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Retry Command
+      shell: bash
+      run: |
+        attempts=0
+        until [ $attempts -ge ${{ inputs.max_attempts }} ]
+        do
+          echo "Attempt $((attempts+1)) of ${{ inputs.max_attempts }}..."
+          eval "${{ inputs.command }}" && break
+          attempts=$((attempts+1))
+          if [ $attempts -lt ${{ inputs.max_attempts }} ]; then
+            echo "Command failed. Waiting ${{ inputs.delay_seconds }}s before retry..."
+            sleep ${{ inputs.delay_seconds }}
+          else
+            echo "Command failed after $attempts attempts."
+            exit 1
+          fi
+        done

docs/developer/index.rst

@@ -16,7 +16,7 @@ Developer Docs
     ./admin-utilities.rst
     ./test-utilities.rst
     ./other-utilities.rst
-    ./reusable-workflows.rst
+    ./reusable-github-utils.rst
 
 Other useful resources:
 

docs/developer/reusable-workflows.rst docs/developer/reusable-github-utils.rstdocs/developer/reusable-workflows.rst renamed to docs/developer/reusable-github-utils.rst

@@ -1,8 +1,66 @@
-Re-usable GitHub Workflows
-==========================
+Re-usable GitHub Actions and Workflows
+======================================
+
+GitHub Actions
+--------------
+
+Retry Command
+~~~~~~~~~~~~~
+
+This GitHub Action retries a shell command if it fails. It is useful for
+handling flaky tests in CI/CD pipelines.
+
+**Inputs**
+
+- ``command`` (required): The shell command to run.
+- ``max_attempts`` (optional): The number of retry attempts. Defaults to
+  ``3``.
+- ``delay_seconds`` (optional): The delay between retries in seconds.
+  Defaults to ``5``.
+
+**Usage Example**
+
+You can use this action in your workflow as follows:
+
+.. code-block:: yaml
+
+    name: Retry Example
+
+    on:
+      push:
+        branches:
+          - main
+
+    jobs:
+      retry-command-example:
+        runs-on: ubuntu-latest
+        steps:
+          - name: Checkout code
+            uses: actions/checkout@v3
+
+          - name: Test
+            uses: openwisp/openwisp-utils/.github/actions/retry-command@master
+            with:
+              delay_seconds: 30
+              max_attempts: 5
+              command: ./runtests.py --parallel
+            env:
+              SELENIUM_HEADLESS: 1
+
+This example retries the ``./runtests.py --parallel`` command up to 5
+times with a 30 second delay between attempts.
+
+.. note::
+
+    If the command continues to fail after the specified number of
+    attempts, the action will exit with a non-zero status, causing the
+    workflow to fail.
+
+GitHub Workflows
+----------------
 
 Replicate Commits to Version Branch
------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This re-usable workflow replicates commits from the ``master`` branch to a
 version branch. The version branch name is derived from the version of the

openwisp_utils/tests/selenium.py

@@ -88,6 +88,10 @@ def get_chrome_webdriver(cls):
             options.binary_location = CHROME_BIN
         options.add_argument('--window-size=1366,768')
         options.add_argument('--ignore-certificate-errors')
+        options.add_argument('--no-sandbox')
+        options.add_argument('--disable-gpu')
+        options.add_argument('--disable-dev-shm-usage')
+        options.add_argument('--disable-features=VizDisplayCompositor')
         # When running Selenium tests with the "--parallel" flag,
         # each TestCase class requires its own browser instance.
         # If the same "remote-debugging-port" is used for all

setup.py

@@ -37,7 +37,7 @@
             'black~=23.12.1',
             'flake8~=7.1.0',
             'isort~=5.13.2',
-            'coverage~=7.6.1',
+            'coverage>=7.6.1,<7.9.0',
             'tblib~=3.0.0',
             'docstrfmt~=1.8.0',
         ],
@@ -46,6 +46,14 @@
             'django-filter~=23.2',  # django-filter uses CalVer
             'drf-yasg~=1.21.7',
         ],
+        'channels': [
+            'channels[daphne]~=4.2.0',
+            'channels_redis~=4.2.1',
+        ],
+        'channels-test': [
+            'pytest-asyncio~=0.24.0',
+            'pytest-django~=4.10.0',
+        ],
         'celery': ['celery~=5.4.0'],
         'selenium': ['selenium>=4.10,<4.30'],
     },