NAME

xmlq - XML query command for Developer Dashboard

SYNOPSIS

dashboard xmlq [path] [file]

DESCRIPTION

This command provides XML extraction for Developer Dashboard.

PURPOSE

This staged helper owns the public dashboard xmlq command. It accepts a path plus an optional input file, then hands the request to the shared query runtime so parsing, file-vs-STDIN handling, and output formatting stay consistent with the rest of the dashboard toolchain.

WHY IT EXISTS

It exists because XML inspection is part of the dashboard query family, but the current XML behavior is intentionally minimal and should still stay behind the same staged-helper and shared-runtime contract as the other query helpers.

WHEN TO USE

Use this file when changing the public dashboard xmlq argv contract, the XML helper examples, or the staged handoff into the shared query runtime.

HOW TO USE

Users run dashboard xmlq [path] [file]. The staged helper selects the XML backend in the shared query runtime, which accepts the file and path in either order, reads STDIN when no file is given, and currently exposes the raw XML payload under the _raw key instead of pretending to support a full XML tree query language. Use _raw, $d, or . when you need the whole payload.

WHAT USES IT

It is used by the public dashboard xmlq command, by shell snippets that want a runtime-local XML inspection tool, and by query-helper coverage under t/ that locks in the current minimal raw-payload contract.

EXAMPLES

printf '<root><value>demo</value></root>' | dashboard xmlq _raw
dashboard xmlq feed.xml '$d'
dashboard xmlq '$d' feed.xml
cat feed.xml | dashboard xmlq _raw