Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A command-line interface that loads a CSV file and outputs a bar chart.

Project description

A small command-line utility to take a CSV file and print a bar chart in your terminal. Especially useful in combination with tools like CSVKit, q, and jq.

$ curl -s http://www.census.gov/popest/data/national/totals/2015/files/NST-EST2015-alldata.csv | head -n 6 | bars --label NAME --value POPESTIMATE2015 --width 72 -
NAME             POPESTIMATE2015
United States        321,418,820 ▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
Northeast Region      56,283,891 ▓░░░░░
Midwest Region        67,907,403 ▓░░░░░░
South Region         121,182,847 ▓░░░░░░░░░░░░
West Region           76,044,679 ▓░░░░░░░
                                 +---------+---------------------------+
                                 0    100,000,000            400,000,000

Installation

pip install -e git+https://github.com/flother/bars#egg=bars

Requirements

Usage

Usage: bars [OPTIONS] CSV

  Load a CSV file and output a bar chart.

Options:
  --label TEXT        Name or index of the column containing the label values.
                      Defaults to the first text column.
  --value TEXT        Name or index of the column containing the bar values.
                      Defaults to the first numeric column.
  --domain NUMBER...  Minimum and maximum values for the chart's x-axis.
  --width INTEGER     Width, in characters, to use to print the chart.
                      [default: 80]
  --skip INTEGER      Number of rows to skip.  [default: 0]
  --encoding TEXT     Character encoding of the CSV file.  [default: UTF-8]
  --no-header         Indicates the CSV file contains no header row.
  --printable         Only use printable characters to draw the bar chart.
  --help              Show this message and exit.

Project details


Release history Release notifications

Download files

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

Files for bars, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size bars-0.0.1-py3-none-any.whl (6.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size bars-0.0.1.tar.gz (4.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page