p202 rotator test

Show where a rotator routes traffic per geo (local rule evaluation)

All commands

p202 CLI reference

Back to the docs

01Run it

Replace the <placeholders> with your own values, or use the builder below.

p202 rotator test <rotator_id>

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 rotator test

Set flags below; the command updates as you type.

04Flags

2 flags, plus the global flags every command takes.

FlagWhat it does
--explainboolShow per-criteria pass/fail for each geo
--geostringComma-separated country codes to evaluate (default: a tier-1+rest sample)

05How it works

Evaluates the rotator's active rules locally and prints the destination a visitor from each --geo would reach. --explain shows per-criteria pass/fail, which surfaces the Name(CC) country-format mismatches that silently break rules.

06For agents

Running this from an agent

  • Read the same facts as JSON: p202 commands rotator test --json.
  • With AI_AGENT, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure.
p202 commands rotator test --json
{
  "path": "p202 rotator test",
  "use": "test <rotator_id>",
  "short": "Show where a rotator routes traffic per geo (local rule evaluation)",
  "long": "Evaluates the rotator's active rules locally and prints the destination a\nvisitor from each --geo would reach. --explain shows per-criteria pass/fail,\nwhich surfaces the Name(CC) country-format mismatches that silently break rules.",
  "runnable": true,
  "flags": [
    {
      "name": "explain",
      "type": "bool",
      "default": "false",
      "usage": "Show per-criteria pass/fail for each geo",
      "required": false
    },
    {
      "name": "geo",
      "type": "string",
      "default": "",
      "usage": "Comma-separated country codes to evaluate (default: a tier-1+rest sample)",
      "required": false
    }
  ]
}