@atom-tech/report
v1.0.1
Published
Send a JUnit test report to asas from any CI pipeline.
Maintainers
Readme
@atom-tech/report
Sends a JUnit XML test report to asas, so automated results appear beside the ones people record by hand — same coverage figure, same history, same dashboard.
Nothing runs on the asas side. This posts a file your test runner already wrote.
Use it
- name: Send test results to asas
if: always()
run: npx --yes @atom-tech/report
env:
ASAS_URL: https://your-asas-host
ASAS_PROJECT: your-project-id
ASAS_TOKEN: ${{ secrets.ASAS_TOKEN }}if: always() matters — without it the step is skipped exactly when tests
failed, which is when the results are worth having.
Not on GitHub? It is the same command anywhere that runs node. GitLab, Jenkins, CircleCI, Buildkite and Vercel are all recognised.
It exits 0 when tests fail
On purpose. Your test runner already failed the build for that, one step
earlier, and a reporting step that fails it a second time is the first thing
anyone deletes. Pass --fail-on-test-failure if you would rather it did.
Settings
| Variable | |
|---|---|
| ASAS_TOKEN | Required. Create it in the project's Testing settings — it can only post results, it cannot read the project. |
| ASAS_PROJECT | Required. The project id. |
| ASAS_URL | Required. Your asas address. |
| ASAS_BUILD | Optional. Defaults to the commit your CI is on. |
| Flag | |
|---|---|
| [file...] | The report. Left out, it is found automatically. |
| --build <label> | What was under test. |
| --dry-run | Show what would happen, write nothing. |
| --fail-on-test-failure | Exit non-zero when a test failed. |
| --token / --project / --url | Override the environment. |
Finding the report
With no path, it tries the conventional names first — junit.xml,
test-results.xml, test-results/, reports/, build/test-results,
target/surefire-reports — and only then walks the directory, skipping
node_modules and friends. A sharded suite that writes several files has all of
them sent.
Which runners
Anything that writes JUnit XML: Vitest, Jest, Playwright, Cypress, Mocha, PHPUnit, pytest, gotestsum, Maven, Gradle, RSpec, Karma.
Licence
MIT
