A GitHub Actions example for privately viewing self-contained pytest-html reports

[eloktev]

I maintain Artifact Relay, an MIT-licensed, self-hosted service for viewing standalone HTML behind a password. I added a copyable pytest-html workflow for cases where a report should be browser-viewable without making it public.

Workflow YAML, pinned to the example's commit

The useful part is preserving failure reports without hiding test failures:

1. Generate pytest-report.html with pytest --html=pytest-report.html --self-contained-html.
2. Let the publish step run even if pytest failed (continue-on-error on the test step, with an explicit publish condition).
3. Fail the job afterwards if steps.pytest.outcome == 'failure'.

The example runs manually with workflow_dispatch and uses the versioned eloktev/artifact-relay@v1.3.0 action. To try it, deploy a relay reachable by your runner, configure the ARTIFACT_RELAY_BASE_URL Actions variable and ARTIFACT_RELAY_API_TOKEN Actions secret, and adapt the dependency-install step to your project. The localhost-only default deployment is not reachable from a GitHub-hosted runner. Don't expose the publisher secret to untrusted pull-request code or print it in logs.

A few limits worth calling out: this is a single-user/password-protected viewer, not team SSO; the example publishes one HTML file, so images referenced as files or external links are not automatically bundled. It is an optional delivery step, not a replacement for pytest-html or your existing CI artifacts.