CLI Interface

// Available binary executables:
// brittle - Default Node.js runtime
// brittle-node - Explicit Node.js runtime  
// brittle-bare - Bare runtime
// brittle-pear - Pear runtime

# Run tests with default Node.js runtime
npx brittle test/*.js

# Explicit Node.js runtime
npx brittle-node test/*.js

# Bare runtime
npx brittle-bare test/*.js

# Pear runtime  
npx brittle-pear test/*.js

# Run with specific options
npx brittle --solo --timeout 10000 test/*.js

# Enable coverage with custom directory
npx brittle --coverage --cov-dir ./my-coverage test/*.js

# Generate test runner file
npx brittle --runner ./generated-runner.js test/*.js

# Run with tracing and bail on first failure
npx brittle --trace --bail test/*.js

// CLI Flags:
// --solo, -s             - Engage solo mode
// --bail, -b             - Bail out on first assert failure  
// --coverage, -c         - Turn on coverage
// --cov-dir <dir>        - Configure coverage output directory (default: ./coverage)
// --trace                - Trace all active promises and print them if the test fails
// --timeout, -t <timeout> - Set test timeout in milliseconds (default: 30000)
// --runner, -r <runner>  - Generate test runner file that contains all target tests
// --mine, -m <miners>    - Keep running tests in <miners> processes until they fail
// --unstealth, -u        - Show assertions even if stealth is used

// Environment Variables:
// BRITTLE - Space or comma-separated CLI flags applied to all runs

# Set default options via environment variable
export BRITTLE="--solo --timeout 10000"
npx brittle test/*.js  # Runs with solo mode and 10s timeout

# Combine environment and CLI flags
export BRITTLE="--coverage"
npx brittle --bail test/*.js  # Runs with coverage and bail mode

# Multiple options
export BRITTLE="--timeout 30000 --unstealth --trace"
npx brittle test/*.js

# Package.json with environment variable
{
  "scripts": {
    "test": "BRITTLE=\"--coverage --timeout 30000\" brittle test/*.js",
    "test:solo": "BRITTLE=\"--solo --bail\" brittle test/*.js"
  }
}

# Enable solo mode globally
npx brittle --solo test/*.js
npx brittle -s test/*.js

# Combine with other options
npx brittle --solo --timeout 10000 test/*.js

import { solo, test } from "brittle";

// This test will run
solo("focused test", (t) => {
  t.pass("only this runs when --solo is used");
});

// This test will be skipped
test("regular test", (t) => {
  t.pass("this is skipped in solo mode");
});

# Enable bail mode
npx brittle --bail test/*.js
npx brittle -b test/*.js

# Useful for CI environments
npx brittle --bail --coverage test/*.js

# Enable coverage with default directory
npx brittle --coverage test/*.js
npx brittle -c test/*.js

# Custom coverage directory
npx brittle --coverage --cov-dir ./my-coverage test/*.js

# Coverage with other options
npx brittle -c -b --timeout 30000 test/*.js

# Set 30 second timeout
npx brittle --timeout 30000 test/*.js
npx brittle -t 30000 test/*.js

# Useful for slow CI environments
npx brittle -t 60000 --bail test/*.js

# Enable promise tracing
npx brittle --trace test/*.js

# Combine with other debugging options
npx brittle --trace --unstealth test/*.js

# Generate runner file
npx brittle --runner my-runner.js test/*.js
npx brittle -r my-runner.js test/*.js

# Run tests 100 times or until failure
npx brittle --mine 100 test/*.js
npx brittle -m 100 test/*.js

# Infinite mining (until failure)
npx brittle --mine 0 test/*.js

# Override stealth mode
npx brittle --unstealth test/*.js
npx brittle -u test/*.js

# Useful for debugging stealth tests
npx brittle -u --trace test/*.js

# Explicit Node.js runtime
npx brittle-node test/*.js

# With Node.js specific options
npx brittle-node --coverage --trace test/*.js

# Package.json script
{
  "scripts": {
    "test": "brittle-node test/*.js",
    "test:coverage": "brittle-node --coverage test/*.js"
  }
}

# Bare runtime
npx brittle-bare test/*.js

# Bare with coverage
npx brittle-bare --coverage test/*.js

# Package.json for Bare
{
  "scripts": {
    "test:bare": "brittle-bare test/*.js"
  }
}

# Pear runtime
npx brittle-pear test/*.js

# Pear with specific options
npx brittle-pear --solo --timeout 15000 test/*.js

# Single file
npx brittle test/my-test.js

# Multiple files
npx brittle test/test1.js test/test2.js

# Glob patterns
npx brittle "test/**/*.js"
npx brittle "test/*.test.js"

# Mixed patterns
npx brittle test/*.js integration/*.test.js

# GitHub Actions
npx brittle --bail --coverage --timeout 30000 test/*.js

# GitLab CI
npx brittle -b -c -t 45000 test/*.js

# Jenkins
npx brittle --bail --cov-dir coverage test/*.js

{
  "scripts": {
    "test": "brittle test/*.js",
    "test:watch": "brittle --mine 0 test/*.js",
    "test:coverage": "brittle --coverage test/*.js", 
    "test:ci": "brittle --bail --coverage --timeout 30000 test/*.js",
    "test:debug": "brittle --trace --unstealth test/*.js",
    "test:solo": "brittle --solo test/*.js"
  }
}

# Using environment variables
BRITTLE_TIMEOUT=30000 npx brittle test/*.js
BRITTLE_COVERAGE=1 npx brittle test/*.js

# In package.json
{
  "scripts": {
    "test": "BRITTLE_TIMEOUT=10000 brittle test/*.js"
  }
}

# Standard TAP output
npx brittle test/*.js
# TAP version 13
# ok 1 - test name
# 1..1
# # tests = 1/1 pass
# # asserts = 1/1 pass
# # time = 5ms
# # ok

# Minimal output with coverage
npx brittle --coverage test/*.js > /dev/null
# Still generates coverage reports

# Use exit code in scripts
npx brittle test/*.js && echo "Tests passed" || echo "Tests failed"

# CI integration
npx brittle --bail test/*.js
if [ $? -eq 0 ]; then
  echo "Deployment ready"
else
  echo "Tests failed, stopping deployment"
  exit 1
fi