View Source Report format

Every suite writes ex_unit_atlas_report/report.json. The top-level schema_version allows consumers to detect breaking schema changes.

Schema version 2

Schema version 2 adds show items with a bounded string value.

{
  "schema_version": 2,
  "generated_at": "2026-07-27T10:00:00Z",
  "summary": {
    "total": 1,
    "passed": 1,
    "failed": 0,
    "duration_us": 42000
  },
  "tests": [
    {
      "module": "Shop.SaleTest",
      "file": "test/shop/sale_test.exs",
      "line": 8,
      "describe": "Sales",
      "name": "cash sales are fiscalized",
      "status": "passed",
      "duration_us": 42000,
      "items": [
        {
          "type": "show",
          "name": "Created sale",
          "value": "%{payment_type: :cash, status: :completed}",
          "status": "passed",
          "duration_us": 0,
          "error": null
        },
        {
          "type": "check",
          "name": "The completed cash sale is fiscalized",
          "status": "passed",
          "duration_us": 25,
          "error": null
        }
      ],
      "error": null
    }
  ]
}

Guarantees

• schema_version is the integer 2.
• generated_at is an ISO 8601 UTC timestamp.
• Durations are non-negative integers in microseconds.
• Test status is passed or failed.
• Item type is step, show, or check.
• Item status is passed, failed, or interrupted.
• Only show items contain value.
• A shown value is a bounded UTF-8 string preview, not a serialized Elixir term.
• Tests are sorted by file, module, describe block, line, and name.
• Items preserve execution order.
• describe and error may be null.
• Skipped and excluded tests are omitted.
• Internal ownership keys are never published.

Errors

A normalized failure has this shape:

{
  "kind": "error",
  "message": "Assertion with == failed",
  "stacktrace": [
    "test/shop/sale_test.exs:18: Shop.SaleTest.\"test ...\"/1"
  ]
}

A test may contain more than one ExUnit failure, so the test-level error field is an array. An item represents one block and therefore contains one error object or null.

Compatibility

Schema version 1 was produced by ExUnit Atlas 0.1 and contains only step and check items. Schema version 2 is produced from 0.2 onward and adds show items plus their value field.

Consumers should ignore unknown fields for forward compatibility and reject unsupported schema_version values.