uv run-unbound

Run an unbound expression over Arrow IPC inside a uv-managed environment.

Mirrors xorq run-unbound, but executes with the build’s packaged sdist so the runtime matches the dependencies recorded at build time.

Usage

xorq uv run-unbound BUILD_PATH [OPTIONS]

Arguments

  • BUILD_PATH—Path to the build directory produced by xorq uv build.

Options

Option Default Description
--to-unbind-hash inferred Hash of the node to unbind.
--to-unbind-tag inferred Tag of the node to unbind (alternative to –to-unbind-hash).
--typ none Type of the node to unbind.
-o, --output-path stdout (arrow) / discard (other) Path to write output. Use ‘-’ for stdout.
-f, --format parquet Output format.
--limit unlimited Maximum number of rows to output.
--batch-size table default Batch size for Arrow streaming output.
--cache-dir $XORQ_CACHE_DIR or ~/.cache/xorq Directory for parquet cache files.
-i, --instream stdin Path to a file with Arrow IPC data.

Examples

# Stream input from a file
xorq uv run-unbound builds/transform --to-unbind-tag source_input -i input.arrow -o results.parquet

See also

  • run-unbound—same semantics, in the current environment