test-runner

Automate iOS test execution by running a Bash-based quality gate that invokes xcodebuild across full, quick, coverage, and affected modes. It enforces mandatory testing during workstation builds, PR checks, and feature releases, returning a non-zero exit code on failure to block merges.

Run affected iOS tests by passing the --affected option to execute only tests covering changed files. This targeted test mode improves iteration speed during development while still enforcing the quality gate before commits or deployments.

Generate code coverage reports by executing the test runner with the --coverage option. It drives xcodebuild invocations within an Xcode-enabled macOS workstation environment to produce coverage data alongside standard test execution results.

Yes, an Xcode-enabled macOS workstation with Bash support is required. The automated test runner leverages the forked Bash agent to drive xcodebuild invocations deterministically, ensuring consistent test execution across workstation builds and pull request checks.

Filter specific test cases by using the --filter=MyTestPattern option when executing the test runner. This passes the pattern directly to xcodebuild, allowing you to isolate and run targeted test suites during your workstation build or PR validation process.

The automated test gate fails with a non-zero exit code when xcodebuild test invocations encounter failing tests. This strict failure mechanism enforces mandatory quality standards, preventing code from passing the gate during workstation builds or feature releases until regressions are fixed.