NAME

  [1mtdda cat [22mâ Display rows from a dataset as a rich table

SYNOPSIS

  [1mtdda cat [22m[[1m‐h[22m] [[1mN [22m| [1m‐N [22m| [1m+N[22m] [[1m‐s [22m| [1m‐S[22m]
             [[1m‐‐fields [4m[22mFIELDS[24m] [[1m‐‐xfields [4m[22mFIELDS[24m]
             [[1m‐r [4m[22mN[24m [[1m‐‐seed [4m[22mSEED[24m]]
             [[1m‐‐pandas[22m] [[1m‐‐polars[22m] [[1m‐‐backend [4m[22mBACKEND[24m]
             [4mINPUT[24m [[4mFIELD[24m ...]

POSITIONAL ARGUMENTS

  [4mINPUT[24m is one of:
    ‐ a CSV file (or [1m.tsv[22m, [1m.psv[22m, [1m.txt[22m)
    ‐ a Parquet file ([1m.parquet[22m)
    ‐ a flat file with colon syntax to trigger metadata lookup
      (e.g. [1mfoo.csv:[22m)
    ‐ a flat file with an explicit metadata path
      (e.g. [1mfoo.csv:foo.serial[22m)

  [4mFIELD[24m ...  Field names (or [1mfnmatch [22mwildcard patterns) to display.
             Fields appear in the order given. Equivalent to [1m‐‐fields[22m;
             both may be combined. Wildcards must be quoted in the shell.

DESCRIPTION

  The [1mtdda cat [22mcommand displays rows from a dataset as a rich table.

  Without a row count, all rows are shown.

  [1mN [22mor [1m‐N    [22mFirst N rows
    [1m+N           [22mLast N rows

  Null values are shown as [1mâ[22m.

OPTIONS

  [1m‐h[22m, [1m‐?[22m, [1m‐‐help        [22mShow this help message and exit

  [1m‐‐fields [4m[22mFIELDS[24m         Show only these fields. [4mFIELDS[24m is a
                            comma‐ or space‐separated list of field names
                            or [1mfnmatch [22mwildcard patterns (e.g. [1meu_*[22m,
                            [1m[a‐z]*[22m). Fields appear in the order
                            specified. Requires quoting in the shell when
                            using spaces or wildcards.

  [1m‐‐xfields [4m[22mFIELDS[24m        Exclude these fields. Same format as
                            [1m‐‐fields[22m. Fields appear in dataset order.

  [1m‐s                        [22mShort headers: column width driven by data;
                            headers split at word boundaries (punctuation
                            and lowercaseâuppercase transitions) and packed
                            onto as few lines as possible.

  [1m‐S                        [22mShort headers: as [1m‐s [22mbut split anywhere
                            (mid‐word) to fit the data width.

  [1m‐r [4m[22mN[24m, [1m‐‐random [4m[22mN[24m      Show [4mN[24m random rows instead of a slice.

  [1m‐‐seed [4m[22mSEED[24m             Random seed for [1m‐r[22m. If omitted, a seed is
                            chosen automatically and printed.

  [1m‐‐pandas[22m, [1m‐‐pd          [22mUse Pandas as DataFrame engine (default)
  [1m‐‐polars[22m, [1m‐‐pl          [22mUse Polars as DataFrame engine
  [1m‐‐backend[22m, [1m‐B [4m[22mBACKEND[24m   Backend choice for Pandas
                            [1mn [22mfor numpy_nullable *
                            [1ma [22mfor pyarrow
                            [1mo [22mfor original

EXAMPLES

  1) [1mtdda cat accounts1k.parquet[0m

  Display all rows from [1maccounts1k.parquet[22m.

  2) [1mtdda cat ‐10 accounts1k.csv:[0m

  Display the first 10 rows, using any associated metadata file.

  3) [1mtdda cat +10 accounts1k.csv:[0m

  Display the last 10 rows.

  4) [1mtdda cat ‐‐fields ’name,balance’ accounts1k.csv:[0m

  Display only the [1mname [22mand [1mbalance [22mfields.

  5) [1mtdda cat ‐‐fields ’amount*’ ‐‐xfields ’*_raw’ accounts1k.csv:[0m

  Display fields matching [1mamount*[22m, excluding those ending in [1m_raw[22m.

  6) [1mtdda cat ‐r 20 ‐‐seed 42 accounts1k.csv:[0m

  Display 20 random rows with a fixed seed.

  7) [1mtdda cat ‐s accounts1k.csv:[0m

  Display all rows with compact multi‐line headers, splitting at word
  boundaries ([1mopen_date [22mâ [1mopen date[22m, [1maccountType [22mâ [1maccount Type[22m).

SEE ALSO

  [1mtdda head[0m
  [1mtdda tail[0m
  [1mtdda sample[0m
  [1mtdda ls[0m
  [1mtdda diff[0m
  [1mtdda serial[0m






















