A simple python lib to print data as ascii histograms.
Project description
py-ascii-graph
A simple python lib to print data as ascii histograms
License
py-ascii-graph is released under the MIT License.
Description
py-ascii-graph is a simple python library to build ascii histograms. Just give it a label and a list of tuples (description, value) and it will automaticaly creates a nice histogram, with all the stuff aligned and fitting in a fixed width line (if possible).
py-asciigraph although comes with a command line utility.
Examples
code:
from ascii_graph import Pyasciigraph
test = [('long_label', 423), ('sl', 1234), ('line3', 531), ('line4', 200), ('line5', 834)]
graph = Pyasciigraph()
for line in graph.graph('test print', test):
print(line)
result:
test print
###############################################################################
████████████████████ 423 long_label
█████████████████████████████████████████████████████████████ 1234 sl
██████████████████████████ 531 line3
█████████ 200 line4
█████████████████████████████████████████ 834 line5
command line:
$ asciigraph -h
Usage: asciigraph [-l <label>] [-f file] [-s inc|dec] [-w <number of char>] [-m <min len of char>]
examples:
printf 'label1:10\nlabel2:100\n' | asciigraph -l 'my graph'
printf 'l1:10\nl2:100\n' > ./mf; asciigraph -l 'my graph' -f ./mf
asciigraph -l 'my graph' -f mf -s inc
asciigraph -l 'my graph' -f mf -s dec -w 60 -m 10
Options:
-h, --help show this help message and exit
-f FILE, --file=FILE import data from FILE (one data per line,
format: <label>:<value>)
-s SORT, --sort=SORT sort type: inc (increasing) or dec (decreasing)
-l LAB, --label=LAB label of the graph
-w WIDTH, --width=WIDTH
width of the graph
-m LEN, --min_graph=LEN
minimum length of the graph bar
$ printf "ced:1000\nasd:123\nyu:890\n" | asciigraph -l test -s dec
test
###############################################################################
██████████████████████████████████████████████████████████████████ 1000.0 ced
██████████████████████████████████████████████████████████ 890.0 yu
████████ 123.0 asd
See the examples/ directory for more examples.
Installation
$ pip install ascii_graph
or
$ easy_install ascii_graph
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ascii_graph-0.2.1.tar.gz
(5.8 kB
view hashes)