Skip to content
Beta · version 0.8.1 · commands and the JSON format may still change.

Tabalyst Report

Tabalyst Report analyzes a CSV, JSON, JSONL or Excel file and produces an interactive, self-contained HTML report and a JSON profile of the same analysis. It reads the file once, as a stream, on your computer.

Terminal window
tabalyst report customers.csv

This creates customers.html (the report), customers.json (the profile) and executions.json (the run history) beside the source. Your data is never modified or sent anywhere.

Use caseCommandDestination
One file, automatic nametabalyst report data.csvdata.html beside the source
One file, custom nametabalyst report data.csv -o report.htmlThe file report.html
Several files, automatic namestabalyst report *.csvBeside each source
Several files, one directorytabalyst report *.csv -d reports/The directory reports/
One JSON filetabalyst report data.jsondata.report.html beside the source
One JSONL filetabalyst report events.jsonlevents.report.html beside the source
One Excel workbooktabalyst report sales.xlsxsales.report.html beside the source
One page per column, and the chartstabalyst report data.csv --detailsThe folder data/ beside the report
From a scan documenttabalyst report --scan data.scan.jsondata.html beside the scan
  • Dataset dimensions, missing cells, duplicates and quality observations.
  • A family and a type for each column (identifier, text, date, boolean…), with the evidence behind them, and the technical type with its error rates.
  • A summary table with one row per column: its type, a sentence about its values, the missing share, its Errors and Issues with a preview of each, and its details; above it, the Findings and Errors and Issues cards.
  • Numeric, date and string-length analysis, normalization and value distributions.
  • Distinct values, representative examples, date formats and detected meanings such as enumerations, email addresses, phone numbers and postal codes.
  • CSV record widths, quoting, encoding and delimiter configuration.
  • Findings classified as issues or remarks, with every count labelled exact, at least, estimated or sample.
  • Structural patterns of text columns.
  • A bounded sample of raw rows (start, sampled and end), while every record is analyzed.

The report is built on Tabalyst Scan. Values of sensitive fields, such as email addresses, are shown by default; the exposure settings mask or hide them. Ambiguous dates stay ambiguous: the report shows the evidence without applying it. The HTML works without a network connection or a CDN; only the chart pages of --details load a charting library from one.