uv run-cached
Run a build with a parquet cache inside a uv-managed environment.
Mirrors xorq run-cached (including its cache strategies), but executes with the build’s packaged sdist so the runtime matches the dependencies recorded at build time.
Usage
xorq uv run-cached BUILD_PATH [OPTIONS]Arguments
BUILD_PATH—Path to the build directory produced byxorq uv build.
Options
| Option | Default | Description |
|---|---|---|
--cache-dir |
$XORQ_CACHE_DIR or ~/.cache/xorq |
Directory for parquet cache files. |
-o, --output-path |
/dev/null (discard) |
Path to write output. Use ‘-’ for stdout. |
-f, --format |
parquet |
Output format. |
--limit |
unlimited | Maximum number of rows to output. |
--cache-type |
modification-time |
Cache strategy: ‘modification-time’ (ParquetCache) or ‘snapshot’ (ParquetSnapshotCache). |
--ttl |
none | TTL in seconds for snapshot cache (uses ParquetTTLSnapshotCache when set). |
-p, --params |
none | Override an expression parameter as key=value (repeatable, for example –params threshold=0.5). |
Examples
# Default modification-time cache
xorq uv run-cached builds/7061dd65ff3c --cache-dir ./cache -o results.parquetSee also
run-cached—same semantics, in the current environment