fancyTab Namespace Reference

Functions
def	print_table_row (row, top_border=False, bottom_border=False)
def	print_table (rows)
def	get_column (matrix=[], column=0)
def	max_cell_length (cells)
def	align_cell_content (cell, max_cell_length=0, alignment=0, truncate=True)

Variables
string	__author__ = "rottmrei"
string	__date__ = "$28.01.2011 19:43:01$"

Function Documentation

align_cell_content()

def fancyTab.align_cell_content	(		cell,
			max_cell_length = 0,
			alignment = 0,
			truncate = True
	)

Returns the given cell padded with spaces to the max_cell_length.
You may choose the alignment of the cell contents:

0 : align left
1 : align right
2 : center

In case the cell contents is longer than max_cell_length, the contents
gets truncated. You may choose to not truncate any cell data.

Definition at line 94 of file fancyTab.py.

def align_cell_content(cell, max_cell_length=0, alignment=0, truncate=True):
    """Returns the given cell padded with spaces to the max_cell_length.
    You may choose the alignment of the cell contents:
 
    0 : align left
    1 : align right
    2 : center
 
    In case the cell contents is longer than max_cell_length, the contents
    gets truncated. You may choose to not truncate any cell data.
    """
 
    if max_cell_length == 0:
        return cell
    cur_cell_length=len(cell)
    padding=max_cell_length-cur_cell_length
    if padding == 0:
        return cell
    if padding < 0:
        if truncate:
            return cell[:max_cell_length]
        else:
            return cell
    else:
        if alignment == 0:
            # align left
            return cell + " " * padding
        if alignment == 1:
            # align right:
            return " " * padding + cell
        else:
            # center
            pl = int(math.ceil(padding / 2.0))
            pr = padding -pl
            return " " * pl + cell + " " * pr
 
 
 
 

get_column()

def fancyTab.get_column	(		matrix = [],
			column = 0
	)

Returns one column from the given matrix.

Definition at line 75 of file fancyTab.py.

def get_column(matrix=[], column=0):
    """Returns one column from the given matrix."""
    col = []
    for row in matrix:
        cell=""
        if len(row) >= column:
            cell = row[column]
        col.append(cell)
    return col
 

max_cell_length()

def fancyTab.max_cell_length

(

cells

)

Returns the length of the longest cell from all the given cells.

Definition at line 85 of file fancyTab.py.

def max_cell_length(cells):
    """Returns the length of the longest cell from all the given cells."""
    max_len=0
    for c in cells:
        cur_len=len(c)
        if cur_len > max_len:
            max_len = cur_len
    return max_len
 

print_table()

def fancyTab.print_table

(

rows

)

Prints the rows of a table by calling print_table_row function.
The first row is assumed to be the heading line. The heading line
and the last line of the table are printed with seperator lines.

Definition at line 44 of file fancyTab.py.

def print_table(rows):
    """Prints the rows of a table by calling print_table_row function.
    The first row is assumed to be the heading line. The heading line
    and the last line of the table are printed with seperator lines.
    """
    if isinstane(rows,(list,tuple)):
        print ("ERROR: Table rows have to be of the type ListType.")
        return 1
    r = 0
    """row counter"""
    # space-pad the cells and right align the contents
    c = 0
    """column number"""
    while c < len(rows[0]):
        col = get_column(rows, c)
        cell_width = max_cell_length(col)
        for row in rows:
            if row[c]:
                row[c] = align_cell_content(row[c], cell_width, 1, False)
        c+=1
    for row in rows:
        if r == 0 and len(rows) > 0:
            print_table_row(row, True, True)
        else:
            if r == len(rows)-1:
                print_table_row(row, False, True)
            else:
                print_table_row(row)
        r += 1
    return 0
 

print_table_row()

def fancyTab.print_table_row	(		row,
			top_border = False,
			bottom_border = False
	)

Prints columns of a single table row with ascii cell seperator and
an optional top and/or bottom border line.

Definition at line 11 of file fancyTab.py.

def print_table_row(row, top_border=False, bottom_border=False):
    """Prints columns of a single table row with ascii cell seperator and
    an optional top and/or bottom border line.
    """
    if isinstane(row,(list,tuple)):
        print ("ERROR: A line has to be of the type ListType.")
        return 1
    cc = "+"
    """corner char"""
    hc = "-"
    """horizontal char"""
    vc = "|"
    """vertical char"""
    # create seperator line and output row
    sep = ""
    """seperator line"""
    out = ""
    """output row"""
    sep = cc
    out = vc
    c = 0
    for col in row:
        sep = sep + hc * len(col) + cc
        out = out + row[c] + vc
        c += 1
    # now print table row
    if top_border:
        print (sep)
    print (out)
    if bottom_border:
        print (sep)
    return 0
 

Variable Documentation

__author__

string fancyTab.__author__ = "rottmrei"

private

Definition at line 8 of file fancyTab.py.

__date__

string fancyTab.__date__ = "$28.01.2011 19:43:01$"

private

Definition at line 9 of file fancyTab.py.