printio 0.0.2

printio is a pretty printing library implemented in Python.

Format a value, list of lists, or list of dictionaries for printing or display using Python's built-in String Format library.

Most of the string formatting options from the Format Specification Mini-Language are available. See the formatting options here: http://docs.python.org/release/3.1.2/library/string.html#format-specification-mini-language

Overview

The major functions of printio:

- PrettyValue():

 Formats a single value to a string.

- PrettySeries():

 Formats a series of data to a list of list of strings.
 format: will return a list of list of strings including the header.
 text: will return a string similar to MySQL's console display format.

Usage

First, some housekeeping items...

Import the library

>>> from printio import PrettyValue
>>> from printio import PrettySeries

Create a series of values you wish to format.

>>> lol = []
>>> lol.append([0, 'yhoo', 23.45])
>>> lol.append([1, 'goog', 200.4565])
>>> lol.append([2, 't', 1.00])

Let's also create a list of dictionaries to format as well.

>>> keys = ['bar', 'symbol', 'close']
>>> lod = [dict(zip(keys, x)) for x in lol]

Now, let's get down to business...

 Format a string with a width of 10, center-aligned, and filled with '-'.

 >>> value = 'yhoo'
 >>> pv = PrettyValue('^10', fill='-')
 >>> pv.format(value)
 ---yhoo---

 Format a float with a decimal precision of 1.

 >>> value = 23.45599
 >>> pv = PrettyValue('.1f')
 >>> pv.format(value)
 23.5

 Format a float into a percentage.

 >>> value = 0.025
 >>> pv = PrettyValue('.2%')
 >>> pv.format(value)
 2.50%

 Format a list of lists with default options.

 >>> ps = PrettySeries()
 >>> for row in ps.format(lol): print row
 ['0', '1 ', '2 ']
 ['0', 'yhoo', '23.45 ']
 ['1', 'goog', '200.4565']
 ['2', 't ', '1.0 ']

 Same as above but this time in text.

 >>> results = ps.text(lol)
 >>> print results
 +---+------+----------+
 | 0 | 1 | 2 |
 +---+------+----------+
 | 0 | yhoo | 23.45 |
 | 1 | goog | 200.4565 |
 | 2 | t | 1.0 |
 +---+------+----------+

 Want to add better column names?

 >>> ps.addcolumn(0, cname='Bar')
 >>> ps.addcolumn(1, cname='Symbol')
 >>> ps.addcolumn(2, cname='Close')
 >>> print ps.text(lol)
 +-----+--------+----------+
 | Bar | Symbol | Close |
 +-----+--------+----------+
 | 0 | yhoo | 23.45 |
 | 1 | goog | 200.4565 |
 | 2 | t | 1.0 |
 +-----+--------+----------+

 Only print the Close column, always show sign, and format with decimal precision of 2?

 >>> ps = PrettySeries()
 >>> ps.addcolumn(2, '+.2f', cname='Close')
 >>> print ps.text(lol)
 +---------+
 | Close |
 +---------+
 | + 23.45 |
 | +200.46 |
 | + 1.00 |
 +---------+

 Print the list of dictionaries with the numerical settings for the bar & close.

 >>> ps = PrettySeries()
 >>> ps.addcolumn('bar', 'i')
 >>> ps.addcolumn('symbol')
 >>> ps.addcolumn('close', '.2f')
 >>> print ps.text(lod)
 +-----+--------+--------+
 | bar | symbol | close |
 +-----+--------+--------+
 | 0 | yhoo | 23.45 |
 | 1 | goog | 200.46 |
 | 2 | t | 1.00 |
 +-----+--------+--------+


Product's homepage

Here are some key features of "printio":

· Align values to the left, right, or center.
· Pad and fill values.
· Sign numerical values.
· Convert integers to float.
· Specify precision for floating values - values are rounded up.
· Convert numbers to percentage formats. Ex. 0.10 ~ 10.0000%
· Add column headers or utilize default headers of a series.
· Column widths are automatically sized based on maximum width of the values in the series.
· Choose which columns to format in a series.
· Ability to print to 'text' similar to how MySQL displays output to the console.

Requirements:

· Python