Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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

This version
History Node

0.0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
bars-0.0.1-py3-none-any.whl (6.3 kB) Copy SHA256 hash SHA256 Wheel py3 Apr 17, 2016
bars-0.0.1.tar.gz (4.0 kB) Copy SHA256 hash SHA256 Source None Apr 17, 2016

Supported by

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