Skip to content
axxbetadocs
nextv0.2.26
GitHub
These are the docs of main, not released yet. See the docs of v0.2.26, the latest release.

axx lint

View .mdOpen in Claude

Run the test-data isolation rules from the lint section of axx.yaml: each rule extracts values (ids, keys, names) from the files it selects, with a regular expression or a JSON path, and reports values that repeat where they must be unique, so scenarios sharing a database can run in parallel. Builtin checks also warn about SQL selection and trigger ordinals that cannot work.

With paths, only findings touching those files or directories are reported (every file is still scanned: a value collides with occurrences anywhere).

Formats (repeatable, NAME or NAME:FILE; FILE is relative to axx.yaml): human grouped by rule, with file:line and the colliding value (default) json the –json envelope junit one test case per rule sarif SARIF 2.1.0 for code scanning (paths relative to the repository) github GitHub Actions ::error/::warning annotations

Exit codes: 0 clean (or only warnings, e.g. rules in warn mode), 2 invalid configuration, 3 violations.

Usage:
axx lint [paths...] [flags]
Examples:
axx lint
axx lint seeds/manifest-kestrel.yaml
axx lint --format github --format sarif:build/axx/lint.sarif
axx lint --mode warn
Flags:
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-f, --format stringArray output NAME or NAME:FILE (repeatable): human, json, junit, sarif, github
-h, --help help for lint
--mode string override the mode of every rule, the built-in feature checks included: error or warn
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)