Skip to content

Update C++ tsfile-cli command surface and data workflows - #915

Open
SpriCoder wants to merge 16 commits into
apache:developfrom
SpriCoder:codex-tsfile-cli-requirements-v07
Open

Update C++ tsfile-cli command surface and data workflows#915
SpriCoder wants to merge 16 commits into
apache:developfrom
SpriCoder:codex-tsfile-cli-requirements-v07

Conversation

@SpriCoder

@SpriCoder SpriCoder commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • ls: lists model/object rows for current files; example: tsfile-cli ls -f csv data.tsfile
  • schema: reports model,object,column,category,data_type,encoding,compression; example: tsfile-cli schema -t sensors -f csv data.tsfile
  • meta: reports file summary fields; example: tsfile-cli meta data.tsfile
  • stats: reports FIELD statistics with counts, null counts, time range, values, and source fields; example: tsfile-cli stats -t sensors -m temperature -f csv data.tsfile
  • count: reports per-column counts without synthetic summary rows; example: tsfile-cli count -t sensors -f csv data.tsfile
  • sketch: prints the physical file sketch; example: tsfile-cli sketch data.tsfile
  • head: reads the first rows with offset/limit/filter support; example: tsfile-cli head -t sensors -m temperature -n 20 -f csv data.tsfile
  • cat: streams all matching rows with the same row filters; example: tsfile-cli cat -t sensors --tag-filter site eq north -m temperature -f ndjson data.tsfile
  • export: exports one object or multiple objects with numbered outputs and a manifest; example: tsfile-cli export -t sensors --type csv -o sensors.csv data.tsfile
  • write: imports strict CSV into a new table-model TsFile with explicit --tag / --field declarations; example: printf 'time,site,temperature\n0,north,21.5\n1,north,21.7\n' | tsfile-cli write --table sensors --tag site STRING --field temperature DOUBLE --stdin -o sensors.tsfile

Tests

  • C++ Spotless check
  • C++ CLI contract and end-to-end tests
  • Full C++ TsFile_Test binary
  • Git whitespace check

Appendix

@SpriCoder SpriCoder changed the title Align C++ tsfile-cli with V0.7 command contract Update C++ tsfile-cli command surface and data workflows Aug 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant