go/docs/cmd/test/index.md
Snider 78cb2b3507 docs: sync php, pkg, setup, doctor, test with CLI
- php: add serve flags, packages subcommands, all commands
- pkg: fix description (GitHub repos not Go modules), add --add flag
- setup: replace --path/--ssh with --dry-run/--only
- doctor: add --verbose flag
- test: full documentation with all flags and JSON output
- Cleaned up TODO.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:26:27 +00:00

1.3 KiB

core test

Run Go tests with coverage reporting.

Sets MACOSX_DEPLOYMENT_TARGET=26.0 to suppress linker warnings on macOS.

Usage

core test [flags]

Flags

Flag Description
--coverage Show detailed per-package coverage
--json Output JSON for CI/agents
--pkg Package pattern to test (default: ./...)
--race Enable race detector
--run Run only tests matching this regex
--short Skip long-running tests
--verbose Show test output as it runs

Examples

# Run all tests with coverage summary
core test

# Show test output as it runs
core test --verbose

# Detailed per-package coverage
core test --coverage

# Test specific packages
core test --pkg ./pkg/...

# Run specific test by name
core test --run TestName

# Run tests matching pattern
core test --run "Test.*Good"

# Skip long-running tests
core test --short

# Enable race detector
core test --race

# Output JSON for CI/agents
core test --json

JSON Output

With --json, outputs structured results:

{
  "passed": 14,
  "failed": 0,
  "skipped": 0,
  "coverage": 75.1,
  "exit_code": 0,
  "failed_packages": []
}

See Also