docs/docs/cli/test/index.md
Snider a61000db6e feat: migrate docs site to Zensical with full nav and new sections
Replace Hugo+Docsy with Zensical (MkDocs Material). Restructure all
content under docs/ with explicit nav. Add 19 new Go package pages,
plus Agent, MCP, CoreTS, IDE, GUI, and AI (LEM) sections. PHP sidebar
restructured with collapsible Guides/Reference groups. Homepage now
has sidebar with Where to Start guide and Community links.

Tabs: Home | Go | PHP | TS | GUI | AI | Tools | Deploy | Publish

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-11 11:48:44 +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