fancyTab Namespace Reference

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

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

Function Documentation

align_cell_content()

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 93 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()

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

Returns one column from the given matrix.

Definition at line 74 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()

fancyTab.max_cell_length

(

cells

)

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

Definition at line 84 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()

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 43 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()

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 10 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__

str fancyTab.__author__ = "rottmrei"

private

Definition at line 7 of file fancyTab.py.

__date__

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

private

Definition at line 8 of file fancyTab.py.