CI Integration & Reporting — Selenium WebDriver Automation | Sabaoon Academy

Selenium tests should run automatically on every push. Headless Chrome works in any CI environment without a display server.

pytest-html Reports

pip install pytest-html
pytest tests/ --html=report.html --self-contained-html

Open report.html in a browser — you get a summary, pass/fail status per test, and captured logs.

Screenshots on Failure

# conftest.py
import pytest

@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
    outcome = yield
    report = outcome.get_result()
    if report.when == "call" and report.failed:
        driver = item.funcargs.get("driver")
        if driver:
            driver.save_screenshot(f"screenshots/{item.name}.png")

Now any failing test automatically saves a screenshot next to the report.

GitHub Actions Workflow

# .github/workflows/selenium.yml
name: Selenium Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install dependencies
        run: pip install selenium pytest pytest-html

      - name: Install Chrome
        uses: browser-actions/setup-chrome@v1

      - name: Run tests
        run: pytest tests/ --html=report.html --self-contained-html

      - name: Upload report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: selenium-report
          path: |
            report.html
            screenshots/

if: always() uploads the report even when tests fail — essential for debugging CI failures.

Parallel Execution with pytest-xdist

pip install pytest-xdist
pytest tests/ -n auto    # uses all available CPU cores

Each worker gets its own browser instance. Runs that took 10 minutes now finish in 2.

CI Pipeline Overview

CI pipeline stages

Ctrl+Enter

HTML

CSS

var stages = [
{ label: 'Checkout code',          time: '2s'  },
{ label: 'Set up Python 3.12',     time: '8s'  },
{ label: 'pip install dependencies','time': '12s' },
{ label: 'Install Chrome (headless)','time': '6s' },
{ label: 'pytest tests/ -n auto',  time: '48s' },
{ label: 'Upload HTML report',     time: '3s'  },
];

var container = document.getElementById('stages');
stages.forEach(function(s, i) {
var div = document.createElement('div');
div.className = 'stage';
div.id = 'stage' + i;
div.innerHTML =
  '<div class="dot"></div>' +
  '<span class="label">' + s.label + '</span>' +
  '<span class="time" id="t' + i + '">—</span>';
container.appendChild(div);
});

var current = 0;
var timer = null;

document.getElementById('runBtn').onclick = function() {
if (timer) return;
stages.forEach(function(_, i) {
  document.getElementById('stage' + i).className = 'stage';
  document.getElementById('t' + i).textContent = '—';
});
document.getElementById('status').textContent = '';
current = 0;
this.disabled = true;
runStage();
};

function runStage() {
if (current >= stages.length) {
  document.getElementById('status').textContent = '✓ All stages passed — report uploaded';
  console.log('Pipeline completed: 6/6 stages passed');
  document.getElementById('runBtn').disabled = false;
  return;
}
var el = document.getElementById('stage' + current);
el.className = 'stage running';
document.getElementById('status').textContent = 'Running: ' + stages[current].label;

var delay = 400 + Math.random() * 600;
timer = setTimeout(function() {
  el.className = 'stage passed';
  document.getElementById('t' + current).textContent = stages[current].time;
  console.log('✓ ' + stages[current].label + ' (' + stages[current].time + ')');
  current++;
  timer = setTimeout(runStage, 200);
}, delay);
}

Preview