# `shellspec_test`

Runs ShellSpec files through Once's generic test capability and produces
normalized test results. Use it for shell-based end-to-end tests that belong
in the same test plan as compiled or language-native tests.

## Inputs and runner

Declare spec files with `srcs`. The `shellspec` executable defaults to
`shellspec` on the toolchain path. `args` supplies runner arguments, `env`
supplies declared environment, and `data` names additional input files.
Use `labels` for test metadata and `timeout_ms` to bound a run.

The `deps` role accepts `script_action`, `apple_linkable`, `apple_application`,
and `once_test_info` providers whose changes should affect the tests.

## Results

The target exposes `test` with `default`, `test_results`, and `logs` output
groups. The normalized result uses `once.test_results.v1`.

```sh
once query schema shellspec_test
once query example shellspec_test shellspec-test-minimal
```

Read [Testing and Scheduling](/guide/graph/testing) for selection, result
inspection, retries, and test-plan behavior.

`shellspec_test`

Runs ShellSpec files through Once's generic test capability and produces normalized test results. Use it for shell-based end-to-end tests that belong in the same test plan as compiled or language-native tests.

Inputs and runner#

Declare spec files with srcs. The shellspec executable defaults to shellspec on the toolchain path. args supplies runner arguments, env supplies declared environment, and data names additional input files. Use labels for test metadata and timeout_ms to bound a run.

The deps role accepts script_action, apple_linkable, apple_application, and once_test_info providers whose changes should affect the tests.

Results#

The target exposes test with default, test_results, and logs output groups. The normalized result uses once.test_results.v1.

bash

once query schema shellspec_test
once query example shellspec_test shellspec-test-minimal

Read Testing and Scheduling for selection, result inspection, retries, and test-plan behavior.