Contents

Commands

vakna status: a task's boxes

Note
This page is generated from a mock CLI, and its numbers are placeholders.

Verified against vakna 0.0.0-mock on · generated from the CLI's own definitions

vakna status: a task's boxes: totals first, then the ones that need you. Proposed: the real CLI doesn't have this command yet.

Synopsis

sh
vakna status [task|box]

Flags

Flag Default What it does
--format <format> text text, or json: one JSON object per line
--json off the same as --format json
-h, --help off this help

Examples

Example

sh
vakna status
prints task prove-hypothesis-42 tsk_eu1a_4x5y6z7a 997 done · 2 stuck · 1 waiting on you · $4.11 so far 3m 12s stuck prove-hypothesis-42-0137 · waiting on port 5432 · quiet for 1m 40s stuck prove-hypothesis-42-0588 · waiting on port 5432 · quiet for 1m 38s waiting on you prove-hypothesis-42-0412 · asks "apply migration 0042? [y/N]" … 994 more done errors: 1 signature (OOM in test runner) ×3 next: vakna attach prove-hypothesis-42-0412 # it is waiting on you

Exit code 0.

Another example

sh
vakna status prove-flaky-retry --format json
prints {"v":1,"event":"status","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","name":"prove-flaky-retry","mocked":true} {"v":1,"event":"aggregate","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","done":50,"stuck":0,"waiting":0,"running":false,"costMicros":456944,"ms":131000,"mocked":true} {"v":1,"event":"more","done":42,"mocked":true} {"v":1,"event":"errors","task":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","signatures":[{"signature":"e3b0c442","label":"assertion in retry_test.go:88","count":6},{"signature":"9f86d081","label":"timeout after 30s","count":2}],"mocked":true} {"v":1,"event":"next","command":"vakna receipt prove-flaky-retry","reason":"the failures, grouped","mocked":true}

Exit code 0.

When it fails

sh
vakna status nope
prints vakna: no box "nope" hint: vakna list # it lists your boxes

Exit code 1.

Exit codes

Code Meaning
0 ok
1 vakna failed; under shell, run, try or fork, the command in the box failed
2 usage: a missing argument, an unknown flag or command

JSON output

With --format json (or --json) every line is one JSON object. v is the format's version; mocked marks numbers from the mock.

sh
vakna status prove-flaky-retry --format json
prints {"v":1,"event":"status","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","name":"prove-flaky-retry","mocked":true} {"v":1,"event":"aggregate","id":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","done":50,"stuck":0,"waiting":0,"running":false,"costMicros":456944,"ms":131000,"mocked":true} {"v":1,"event":"more","done":42,"mocked":true} {"v":1,"event":"errors","task":"tsk_eu1a_01JB7Y4D5E6F7G8H9J0K1M2N3P","signatures":[{"signature":"e3b0c442","label":"assertion in retry_test.go:88","count":6},{"signature":"9f86d081","label":"timeout after 30s","count":2}],"mocked":true} {"v":1,"event":"next","command":"vakna receipt prove-flaky-retry","reason":"the failures, grouped","mocked":true}

Errors

--help

This page and the help text come from one definition.

Output
vakna status · a task's boxes: totals first, then the ones that need you Proposed: the real CLI doesn't have this command yet. usage vakna status [task|box] flags --format <format> text, or json: one JSON object per line (default: text) --json the same as --format json (default: off) -h, --help this help (default: off) examples vakna status vakna status prove-flaky-retry --format json exit codes 0 ok 1 vakna failed; under shell, run, try or fork, the command in the box failed 2 usage: a missing argument, an unknown flag or command

View as Markdown