NAME

csvq - CSV query command for Developer Dashboard

SYNOPSIS

dashboard csvq [path] [file]

DESCRIPTION

This command provides CSV row and column extraction for Developer Dashboard.

PURPOSE

This staged helper owns the public dashboard csvq command. It accepts an optional row-and-column 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 the dashboard ships a private, repo-local CSV inspection tool instead of depending on a globally installed parser binary. Keeping csvq as a staged helper also preserves the thin-switchboard contract in bin/dashboard.

WHEN TO USE

Use this file when you are changing how dashboard csvq chooses between STDIN and files, how it reports parse errors, or how the staged helper is wired into the shared query implementation.

HOW TO USE

Users run dashboard csvq [path] [file]. The staged helper selects the CSV backend in the shared query runtime, which accepts the file and path in either order, reads STDIN when no file is given, and treats the dotted path as row.column indexes such as 1.1. Use $d or . to print the entire parsed row array as JSON.

WHAT USES IT

It is used by the public dashboard csvq command, by shell snippets that want a runtime-local CSV query tool, by integration smoke runs, and by the focused query-helper coverage under t/.

EXAMPLES

printf 'alpha,beta\n7,8\n' | dashboard csvq 1.1
dashboard csvq data.csv '$d'
dashboard csvq '$d' data.csv
printf 'name,status\ndemo,ok\n' | dashboard csvq 1.0