bpx-datatable

name	bpx-datatable
description	BPX `datatable` command skill. Read DataTable-family rows and update DataTable rows.

datatable

PREREQUISITE: Read bpx-shared.

Usage

bpx datatable read <file.uasset> [--export <n>] [--row <name>] [--format json|toml|csv|tsv] [--out path]
bpx datatable update-row <file.uasset> --row <name> --values '<json>' [--export <n>] [--dry-run] [--backup]
bpx datatable add-row <file.uasset> --row <name> [--values '<json>'] [--export <n>] [--dry-run] [--backup]
bpx datatable remove-row <file.uasset> --row <name> [--export <n>] [--dry-run] [--backup]

Behavior

• read: decodes DataTable/CurveTable/CompositeDataTable rows.
• update-row: patches fields in an existing row (DataTable exports only).
• add-row: appends a new row (DataTable only; row name must resolve in NameMap).
• remove-row: removes a row by name (DataTable only).
• read --format csv|tsv flattens rows for spreadsheet-style output.

[!CAUTION] This command includes write-capable operations. Confirm intent and run --dry-run first.

Command Matrix

Command	Use when	Notable defaults
read	decodes DataTable/CurveTable/CompositeDataTable rows.	Read-only path; safe for discovery.
update-row	patches fields in an existing row (DataTable exports only).	Run --dry-run first and use --backup for real writes.
add-row	appends a new row (DataTable only; row name must resolve in NameMap).	Run --dry-run first and use --backup for real writes.
remove-row	removes a row by name (DataTable only).	Run --dry-run first and use --backup for real writes.

Code-Aligned Caveats

• Row mutations target DataTable exports only; non-DataTable types are rejected.
• When using CSV/TSV output, confirm flattened values before patching rows.

High-Signal Examples

bpx datatable read ./Sample.uasset [--export 1] [--row SampleName] [--format json|toml|csv|tsv] [--out path]
bpx datatable update-row ./Sample.uasset --row SampleName --values '{"value":1}' [--export 1] [--dry-run] [--backup]
bpx datatable add-row ./Sample.uasset --row SampleName [--values '{"value":1}'] [--export 1] [--dry-run] [--backup]
bpx datatable remove-row ./Sample.uasset --row SampleName [--export 1] [--dry-run] [--backup]