Skip to main content

csv files printer

Project description

tbl - cat for csv files

tbl lets you print out csv files to your terminal, formatted and "prettified".

A lot of the hard work is done with the rapidtables package, check it out!

cat tbl

Check out this recorded example: asciicast


  • Python 3.4+


pip install --user clitbl

Usage options

Use tbl -h / tbl --help to see help.

  • The most common use it to just print the table
tbl file.csv
  • --headers
    The headers options lets you explicitly specify the headers for the table. Use this option when you csv files does not include headers, (e.g exampleFile
tbl file.csv --headers '#Index#Item#Cost#Tax#Total'
  • --select
    The select options lets you select what columns to print (similar to SQL SELECT)
tbl file.csv --select '#Item#Tax'

:exclamation: Both headers and select use the first charcter as a separator, it can be any character (kinda like a sed expressions)
:exclamation: The headers specified with this option are case-sensitive
:star2: The headers and select headers can be used together

  • --format (defualt: rstgrid)
    The format options lets you specify the format used when printing the table.
    The available formats are:
rstgrid rst md simple


There are several cases tbl does not support:

  • Duplicated headers, all headers must be distinct
  • Very long headers, while tbl can wrap long paragraph of text in a cell, it cannot wrap text in the headers, which may lead to disfigured output

:exclamation: This is not the use case for tbl anyway, but dont try to print huge tables (several GBs), as tbl (and rapidtable) read the entire table to memory before printing

* Example csv were downloaded from here

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clitbl-0.0.1.tar.gz (3.8 kB view hashes)

Uploaded source

Built Distribution

clitbl-0.0.1-py3-none-any.whl (5.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page