DevTools

GitHub Actions

Run DevTools YAML flows in GitHub Actions and publish JUnit results for PR checks. Great for smoke and regression suites that run on pushes and pull requests.

For the full setup (PR checks, artifacts, caching, smoke vs regression), see the API regression testing guide.

Required env vars

Depends on your flows. Common examples:

How to run it

Create .github/workflows/api-tests.yml:

name: API tests
on: [push]

Commit and push to trigger the workflow.

TODO:
name: API tests
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install DevTools CLI
        run: curl -fsSL https://sh.dev.tools/install.sh | bash
      - name: Run flows (JUnit)
        run: devtools flow run --report junit:test-results.xml tests.yaml

What to change

Common variations

Links