-#!/usr/bin/python\r
-# -*- coding: iso-8859-1 -*-\r
-"""\r
-HTML.py - v0.04 2009-07-28 Philippe Lagadec\r
-\r
-This module provides a few classes to easily generate HTML code such as tables\r
-and lists.\r
-\r
-Project website: http://www.decalage.info/python/html\r
-\r
-License: CeCILL (open-source GPL compatible), see source code for details.\r
- http://www.cecill.info\r
-"""\r
-\r
-__version__ = '0.04'\r
-__date__ = '2009-07-28'\r
-__author__ = 'Philippe Lagadec'\r
-\r
-#--- LICENSE ------------------------------------------------------------------\r
-\r
-# Copyright Philippe Lagadec - see http://www.decalage.info/contact for contact info\r
-#\r
-# This module provides a few classes to easily generate HTML tables and lists.\r
-#\r
-# This software is governed by the CeCILL license under French law and\r
-# abiding by the rules of distribution of free software. You can use,\r
-# modify and/or redistribute the software under the terms of the CeCILL\r
-# license as circulated by CEA, CNRS and INRIA at the following URL\r
-# "http://www.cecill.info".\r
-#\r
-# A copy of the CeCILL license is also provided in these attached files:\r
-# Licence_CeCILL_V2-en.html and Licence_CeCILL_V2-fr.html\r
-#\r
-# As a counterpart to the access to the source code and rights to copy,\r
-# modify and redistribute granted by the license, users are provided only\r
-# with a limited warranty and the software's author, the holder of the\r
-# economic rights, and the successive licensors have only limited\r
-# liability.\r
-#\r
-# In this respect, the user's attention is drawn to the risks associated\r
-# with loading, using, modifying and/or developing or reproducing the\r
-# software by the user in light of its specific status of free software,\r
-# that may mean that it is complicated to manipulate, and that also\r
-# therefore means that it is reserved for developers and experienced\r
-# professionals having in-depth computer knowledge. Users are therefore\r
-# encouraged to load and test the software's suitability as regards their\r
-# requirements in conditions enabling the security of their systems and/or\r
-# data to be ensured and, more generally, to use and operate it in the\r
-# same conditions as regards security.\r
-#\r
-# The fact that you are presently reading this means that you have had\r
-# knowledge of the CeCILL license and that you accept its terms.\r
-\r
-\r
-#--- CHANGES ------------------------------------------------------------------\r
-\r
-# 2008-10-06 v0.01 PL: - First version\r
-# 2008-10-13 v0.02 PL: - added cellspacing and cellpadding to table\r
-# - added functions to ease one-step creation of tables\r
-# and lists\r
-# 2009-07-21 v0.03 PL: - added column attributes and styles (first attempt)\r
-# (thanks to an idea submitted by Michal Cernoevic)\r
-# 2009-07-28 v0.04 PL: - improved column styles, workaround for Mozilla\r
-\r
-\r
-#-------------------------------------------------------------------------------\r
-#TODO:\r
-# - method to return a generator (yield each row) instead of a single string\r
-# - unicode support (input and output)\r
-# - escape text in cells (optional)\r
-# - constants for standard colors\r
-# - use lxml to generate well-formed HTML ?\r
-# - add classes/functions to generate a HTML page, paragraphs, headings, etc...\r
-\r
-\r
-#--- THANKS --------------------------------------------------------------------\r
-\r
-# - Michal Cernoevic, for the idea of column styles.\r
-\r
-#--- REFERENCES ----------------------------------------------------------------\r
-\r
-# HTML 4.01 specs: http://www.w3.org/TR/html4/struct/tables.html\r
-\r
-# Colors: http://www.w3.org/TR/html4/types.html#type-color\r
-\r
-# Columns alignement and style, one of the oldest and trickiest bugs in Mozilla:\r
-# https://bugzilla.mozilla.org/show_bug.cgi?id=915\r
-\r
-\r
-#--- CONSTANTS -----------------------------------------------------------------\r
-\r
-# Table style to get thin black lines in Mozilla/Firefox instead of 3D borders\r
-TABLE_STYLE_THINBORDER = "border: 1px solid #000000; border-collapse: collapse;"\r
-#TABLE_STYLE_THINBORDER = "border: 1px solid #000000;"\r
-\r
-\r
-#=== CLASSES ===================================================================\r
-\r
-class TableCell (object):\r
- """\r
- a TableCell object is used to create a cell in a HTML table. (TD or TH)\r
-\r
- Attributes:\r
- - text: text in the cell (may contain HTML tags). May be any object which\r
- can be converted to a string using str().\r
- - header: bool, false for a normal data cell (TD), true for a header cell (TH)\r
- - bgcolor: str, background color\r
- - width: str, width\r
- - align: str, horizontal alignement (left, center, right, justify or char)\r
- - char: str, alignment character, decimal point if not specified\r
- - charoff: str, see HTML specs\r
- - valign: str, vertical alignment (top|middle|bottom|baseline)\r
- - style: str, CSS style\r
- - attribs: dict, additional attributes for the TD/TH tag\r
-\r
- Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.6\r
- """\r
-\r
- def __init__(self, text="", bgcolor=None, header=False, width=None,\r
- align=None, char=None, charoff=None, valign=None, style=None,\r
- attribs=None):\r
- """TableCell constructor"""\r
- self.text = text\r
- self.bgcolor = bgcolor\r
- self.header = header\r
- self.width = width\r
- self.align = align\r
- self.char = char\r
- self.charoff = charoff\r
- self.valign = valign\r
- self.style = style\r
- self.attribs = attribs\r
- if attribs==None:\r
- self.attribs = {}\r
-\r
- def __str__(self):\r
- """return the HTML code for the table cell as a string"""\r
- attribs_str = ""\r
- if self.bgcolor: self.attribs['bgcolor'] = self.bgcolor\r
- if self.width: self.attribs['width'] = self.width\r
- if self.align: self.attribs['align'] = self.align\r
- if self.char: self.attribs['char'] = self.char\r
- if self.charoff: self.attribs['charoff'] = self.charoff\r
- if self.valign: self.attribs['valign'] = self.valign\r
- if self.style: self.attribs['style'] = self.style\r
- for attr in self.attribs:\r
- attribs_str += ' %s="%s"' % (attr, self.attribs[attr])\r
- if self.text:\r
- text = str(self.text)\r
- else:\r
- # An empty cell should at least contain a non-breaking space\r
- text = ' '\r
- if self.header:\r
- return ' <TH%s>%s</TH>\n' % (attribs_str, text)\r
- else:\r
- return ' <TD%s>%s</TD>\n' % (attribs_str, text)\r
-\r
-#-------------------------------------------------------------------------------\r
-\r
-class TableRow (object):\r
- """\r
- a TableRow object is used to create a row in a HTML table. (TR tag)\r
-\r
- Attributes:\r
- - cells: list, tuple or any iterable, containing one string or TableCell\r
- object for each cell\r
- - header: bool, true for a header row (TH), false for a normal data row (TD)\r
- - bgcolor: str, background color\r
- - col_align, col_valign, col_char, col_charoff, col_styles: see Table class\r
- - attribs: dict, additional attributes for the TR tag\r
-\r
- Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.5\r
- """\r
-\r
- def __init__(self, cells=None, bgcolor=None, header=False, attribs=None,\r
- col_align=None, col_valign=None, col_char=None,\r
- col_charoff=None, col_styles=None):\r
- """TableCell constructor"""\r
- self.bgcolor = bgcolor\r
- self.cells = cells\r
- self.header = header\r
- self.col_align = col_align\r
- self.col_valign = col_valign\r
- self.col_char = col_char\r
- self.col_charoff = col_charoff\r
- self.col_styles = col_styles\r
- self.attribs = attribs\r
- if attribs==None:\r
- self.attribs = {}\r
-\r
- def __str__(self):\r
- """return the HTML code for the table row as a string"""\r
- attribs_str = ""\r
- if self.bgcolor: self.attribs['bgcolor'] = self.bgcolor\r
- for attr in self.attribs:\r
- attribs_str += ' %s="%s"' % (attr, self.attribs[attr])\r
- result = ' <TR%s>\n' % attribs_str\r
- for cell in self.cells:\r
- col = self.cells.index(cell) # cell column index\r
- if not isinstance(cell, TableCell):\r
- cell = TableCell(cell, header=self.header)\r
- # apply column alignment if specified:\r
- if self.col_align and cell.align==None:\r
- cell.align = self.col_align[col]\r
- if self.col_char and cell.char==None:\r
- cell.char = self.col_char[col]\r
- if self.col_charoff and cell.charoff==None:\r
- cell.charoff = self.col_charoff[col]\r
- if self.col_valign and cell.valign==None:\r
- cell.valign = self.col_valign[col]\r
- # apply column style if specified:\r
- if self.col_styles and cell.style==None:\r
- cell.style = self.col_styles[col]\r
- result += str(cell)\r
- result += ' </TR>\n'\r
- return result\r
-\r
-#-------------------------------------------------------------------------------\r
-\r
-class Table (object):\r
- """\r
- a Table object is used to create a HTML table. (TABLE tag)\r
-\r
- Attributes:\r
- - rows: list, tuple or any iterable, containing one iterable or TableRow\r
- object for each row\r
- - header_row: list, tuple or any iterable, containing the header row (optional)\r
- - border: str or int, border width\r
- - style: str, table style in CSS syntax (thin black borders by default)\r
- - width: str, width of the table on the page\r
- - attribs: dict, additional attributes for the TABLE tag\r
- - col_width: list or tuple defining width for each column\r
- - col_align: list or tuple defining horizontal alignment for each column\r
- - col_char: list or tuple defining alignment character for each column\r
- - col_charoff: list or tuple defining charoff attribute for each column\r
- - col_valign: list or tuple defining vertical alignment for each column\r
- - col_styles: list or tuple of HTML styles for each column\r
-\r
- Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.1\r
- """\r
-\r
- def __init__(self, rows=None, border='1', style=None, width=None,\r
- cellspacing=None, cellpadding=4, attribs=None, header_row=None,\r
- col_width=None, col_align=None, col_valign=None,\r
- col_char=None, col_charoff=None, col_styles=None):\r
- """TableCell constructor"""\r
- self.border = border\r
- self.style = style\r
- # style for thin borders by default\r
- if style == None: self.style = TABLE_STYLE_THINBORDER\r
- self.width = width\r
- self.cellspacing = cellspacing\r
- self.cellpadding = cellpadding\r
- self.header_row = header_row\r
- self.rows = rows\r
- if not rows: self.rows = []\r
- self.attribs = attribs\r
- if not attribs: self.attribs = {}\r
- self.col_width = col_width\r
- self.col_align = col_align\r
- self.col_char = col_char\r
- self.col_charoff = col_charoff\r
- self.col_valign = col_valign\r
- self.col_styles = col_styles\r
-\r
- def __str__(self):\r
- """return the HTML code for the table as a string"""\r
- attribs_str = ""\r
- if self.border: self.attribs['border'] = self.border\r
- if self.style: self.attribs['style'] = self.style\r
- if self.width: self.attribs['width'] = self.width\r
- if self.cellspacing: self.attribs['cellspacing'] = self.cellspacing\r
- if self.cellpadding: self.attribs['cellpadding'] = self.cellpadding\r
- for attr in self.attribs:\r
- attribs_str += ' %s="%s"' % (attr, self.attribs[attr])\r
- result = '<TABLE%s>\n' % attribs_str\r
- # insert column tags and attributes if specified:\r
- if self.col_width:\r
- for width in self.col_width:\r
- result += ' <COL width="%s">\n' % width\r
- # The following code would also generate column attributes for style\r
- # and alignement according to HTML4 specs,\r
- # BUT it is not supported completely (only width) on Mozilla Firefox:\r
- # see https://bugzilla.mozilla.org/show_bug.cgi?id=915\r
-## n_cols = max(len(self.col_styles), len(self.col_width),\r
-## len(self.col_align), len(self.col_valign))\r
-## for i in range(n_cols):\r
-## col = ''\r
-## try:\r
-## if self.col_styles[i]:\r
-## col += ' style="%s"' % self.col_styles[i]\r
-## except: pass\r
-## try:\r
-## if self.col_width[i]:\r
-## col += ' width="%s"' % self.col_width[i]\r
-## except: pass\r
-## try:\r
-## if self.col_align[i]:\r
-## col += ' align="%s"' % self.col_align[i]\r
-## except: pass\r
-## try:\r
-## if self.col_valign[i]:\r
-## col += ' valign="%s"' % self.col_valign[i]\r
-## except: pass\r
-## result += '<COL%s>\n' % col\r
- # First insert a header row if specified:\r
- if self.header_row:\r
- if not isinstance(self.header_row, TableRow):\r
- result += str(TableRow(self.header_row, header=True))\r
- else:\r
- result += str(self.header_row)\r
- # Then all data rows:\r
- for row in self.rows:\r
- if not isinstance(row, TableRow):\r
- row = TableRow(row)\r
- # apply column alignments and styles to each row if specified:\r
- # (Mozilla bug workaround)\r
- if self.col_align and not row.col_align:\r
- row.col_align = self.col_align\r
- if self.col_char and not row.col_char:\r
- row.col_char = self.col_char\r
- if self.col_charoff and not row.col_charoff:\r
- row.col_charoff = self.col_charoff\r
- if self.col_valign and not row.col_valign:\r
- row.col_valign = self.col_valign\r
- if self.col_styles and not row.col_styles:\r
- row.col_styles = self.col_styles\r
- result += str(row)\r
- result += '</TABLE>'\r
- return result\r
-\r
-\r
-#-------------------------------------------------------------------------------\r
-\r
-class List (object):\r
- """\r
- a List object is used to create an ordered or unordered list in HTML.\r
- (UL/OL tag)\r
-\r
- Attributes:\r
- - lines: list, tuple or any iterable, containing one string for each line\r
- - ordered: bool, choice between an ordered (OL) or unordered list (UL)\r
- - attribs: dict, additional attributes for the OL/UL tag\r
-\r
- Reference: http://www.w3.org/TR/html4/struct/lists.html\r
- """\r
-\r
- def __init__(self, lines=None, ordered=False, start=None, attribs=None):\r
- """List constructor"""\r
- if lines:\r
- self.lines = lines\r
- else:\r
- self.lines = []\r
- self.ordered = ordered\r
- self.start = start\r
- if attribs:\r
- self.attribs = attribs\r
- else:\r
- self.attribs = {}\r
-\r
- def __str__(self):\r
- """return the HTML code for the list as a string"""\r
- attribs_str = ""\r
- if self.start: self.attribs['start'] = self.start\r
- for attr in self.attribs:\r
- attribs_str += ' %s="%s"' % (attr, self.attribs[attr])\r
- if self.ordered: tag = 'OL'\r
- else: tag = 'UL'\r
- result = '<%s%s>\n' % (tag, attribs_str)\r
- for line in self.lines:\r
- result += ' <LI>%s\n' % str(line)\r
- result += '</%s>\n' % tag\r
- return result\r
-\r
-\r
-##class Link (object):\r
-## """\r
-## a Link object is used to create link in HTML. (<a> tag)\r
-##\r
-## Attributes:\r
-## - text: str, text of the link\r
-## - url: str, URL of the link\r
-## - attribs: dict, additional attributes for the A tag\r
-##\r
-## Reference: http://www.w3.org/TR/html4\r
-## """\r
-##\r
-## def __init__(self, text, url=None, attribs=None):\r
-## """Link constructor"""\r
-## self.text = text\r
-## self.url = url\r
-## if attribs:\r
-## self.attribs = attribs\r
-## else:\r
-## self.attribs = {}\r
-##\r
-## def __str__(self):\r
-## """return the HTML code for the link as a string"""\r
-## attribs_str = ""\r
-## if self.url: self.attribs['href'] = self.url\r
-## for attr in self.attribs:\r
-## attribs_str += ' %s="%s"' % (attr, self.attribs[attr])\r
-## return '<a%s>%s</a>' % (attribs_str, text)\r
-\r
-\r
-#=== FUNCTIONS ================================================================\r
-\r
-# much simpler definition of a link as a function:\r
-def Link(text, url):\r
- return '<a href="%s">%s</a>' % (url, text)\r
-\r
-def link(text, url):\r
- return '<a href="%s">%s</a>' % (url, text)\r
-\r
-def table(*args, **kwargs):\r
- 'return HTML code for a table as a string. See Table class for parameters.'\r
- return str(Table(*args, **kwargs))\r
-\r
-def list(*args, **kwargs):\r
- 'return HTML code for a list as a string. See List class for parameters.'\r
- return str(List(*args, **kwargs))\r
-\r
-\r
-#=== MAIN =====================================================================\r
-\r
-# Show sample usage when this file is launched as a script.\r
-\r
-if __name__ == '__main__':\r
-\r
- # open an HTML file to show output in a browser\r
- f = open('test.html', 'w')\r
-\r
- t = Table()\r
- t.rows.append(TableRow(['A', 'B', 'C'], header=True))\r
- t.rows.append(TableRow(['D', 'E', 'F']))\r
- t.rows.append(('i', 'j', 'k'))\r
- f.write(str(t) + '<p>\n')\r
- print str(t)\r
- print '-'*79\r
-\r
- t2 = Table([\r
- ('1', '2'),\r
- ['3', '4']\r
- ], width='100%', header_row=('col1', 'col2'),\r
- col_width=('', '75%'))\r
- f.write(str(t2) + '<p>\n')\r
- print t2\r
- print '-'*79\r
-\r
- t2.rows.append(['5', '6'])\r
- t2.rows[1][1] = TableCell('new', bgcolor='red')\r
- t2.rows.append(TableRow(['7', '8'], attribs={'align': 'center'}))\r
- f.write(str(t2) + '<p>\n')\r
- print t2\r
- print '-'*79\r
-\r
- # sample table with column attributes and styles:\r
- table_data = [\r
- ['Smith', 'John', 30, 4.5],\r
- ['Carpenter', 'Jack', 47, 7],\r
- ['Johnson', 'Paul', 62, 10.55],\r
- ]\r
- htmlcode = HTML.table(table_data,\r
- header_row = ['Last name', 'First name', 'Age', 'Score'],\r
- col_width=['', '20%', '10%', '10%'],\r
- col_align=['left', 'center', 'right', 'char'],\r
- col_styles=['font-size: large', '', 'font-size: small', 'background-color:yellow'])\r
- f.write(htmlcode + '<p>\n')\r
- print htmlcode\r
- print '-'*79\r
-\r
- def gen_table_squares(n):\r
- """\r
- Generator to create table rows for integers from 1 to n\r
- """\r
-## # First, header row:\r
-## yield TableRow(('x', 'square(x)'), header=True, bgcolor='blue')\r
-## # Then all rows:\r
- for x in range(1, n+1):\r
- yield (x, x*x)\r
-\r
- t = Table(rows=gen_table_squares(10), header_row=('x', 'square(x)'))\r
- f.write(str(t) + '<p>\n')\r
-\r
- print '-'*79\r
- l = List(['aaa', 'bbb', 'ccc'])\r
- f.write(str(l) + '<p>\n')\r
- l.ordered = True\r
- f.write(str(l) + '<p>\n')\r
- l.start=10\r
- f.write(str(l) + '<p>\n')\r
-\r
- f.close()\r
+# -*- coding: utf-8 -*-
+#modification pour python 3 : Laurent Mérat, 6x7 - mai 2020
+
+"""
+HTML.py - v0.04 2009-07-28 Philippe Lagadec
+
+This module provides a few classes to easily generate HTML code such as tables
+and lists.
+
+Project website: http://www.decalage.info/python/html
+
+License: CeCILL (open-source GPL compatible), see source code for details.
+ http://www.cecill.info
+"""
+
+__version__ = '0.04'
+__date__ = '2009-07-28'
+__author__ = 'Philippe Lagadec'
+
+#--- LICENSE ------------------------------------------------------------------
+
+# Copyright Philippe Lagadec - see http://www.decalage.info/contact for contact info
+#
+# This module provides a few classes to easily generate HTML tables and lists.
+#
+# This software is governed by the CeCILL license under French law and
+# abiding by the rules of distribution of free software. You can use,
+# modify and/or redistribute the software under the terms of the CeCILL
+# license as circulated by CEA, CNRS and INRIA at the following URL
+# "http://www.cecill.info".
+#
+# A copy of the CeCILL license is also provided in these attached files:
+# Licence_CeCILL_V2-en.html and Licence_CeCILL_V2-fr.html
+#
+# As a counterpart to the access to the source code and rights to copy,
+# modify and redistribute granted by the license, users are provided only
+# with a limited warranty and the software's author, the holder of the
+# economic rights, and the successive licensors have only limited
+# liability.
+#
+# In this respect, the user's attention is drawn to the risks associated
+# with loading, using, modifying and/or developing or reproducing the
+# software by the user in light of its specific status of free software,
+# that may mean that it is complicated to manipulate, and that also
+# therefore means that it is reserved for developers and experienced
+# professionals having in-depth computer knowledge. Users are therefore
+# encouraged to load and test the software's suitability as regards their
+# requirements in conditions enabling the security of their systems and/or
+# data to be ensured and, more generally, to use and operate it in the
+# same conditions as regards security.
+#
+# The fact that you are presently reading this means that you have had
+# knowledge of the CeCILL license and that you accept its terms.
+
+
+#--- CHANGES ------------------------------------------------------------------
+
+# 2008-10-06 v0.01 PL: - First version
+# 2008-10-13 v0.02 PL: - added cellspacing and cellpadding to table
+# - added functions to ease one-step creation of tables
+# and lists
+# 2009-07-21 v0.03 PL: - added column attributes and styles (first attempt)
+# (thanks to an idea submitted by Michal Cernoevic)
+# 2009-07-28 v0.04 PL: - improved column styles, workaround for Mozilla
+
+
+#-------------------------------------------------------------------------------
+#TODO:
+# - method to return a generator (yield each row) instead of a single string
+# - unicode support (input and output)
+# - escape text in cells (optional)
+# - constants for standard colors
+# - use lxml to generate well-formed HTML ?
+# - add classes/functions to generate a HTML page, paragraphs, headings, etc...
+
+
+#--- THANKS --------------------------------------------------------------------
+
+# - Michal Cernoevic, for the idea of column styles.
+
+#--- REFERENCES ----------------------------------------------------------------
+
+# HTML 4.01 specs: http://www.w3.org/TR/html4/struct/tables.html
+
+# Colors: http://www.w3.org/TR/html4/types.html#type-color
+
+# Columns alignement and style, one of the oldest and trickiest bugs in Mozilla:
+# https://bugzilla.mozilla.org/show_bug.cgi?id=915
+
+
+#--- CONSTANTS -----------------------------------------------------------------
+
+# Table style to get thin black lines in Mozilla/Firefox instead of 3D borders
+TABLE_STYLE_THINBORDER = "border: 1px solid #000000; border-collapse: collapse;"
+#TABLE_STYLE_THINBORDER = "border: 1px solid #000000;"
+
+
+#=== CLASSES ===================================================================
+
+class TableCell (object):
+ """
+ a TableCell object is used to create a cell in a HTML table. (TD or TH)
+
+ Attributes:
+ - text: text in the cell (may contain HTML tags). May be any object which
+ can be converted to a string using str().
+ - header: bool, false for a normal data cell (TD), true for a header cell (TH)
+ - bgcolor: str, background color
+ - width: str, width
+ - align: str, horizontal alignement (left, center, right, justify or char)
+ - char: str, alignment character, decimal point if not specified
+ - charoff: str, see HTML specs
+ - valign: str, vertical alignment (top|middle|bottom|baseline)
+ - style: str, CSS style
+ - attribs: dict, additional attributes for the TD/TH tag
+
+ Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.6
+ """
+
+ def __init__(self, text="", bgcolor=None, header=False, width=None,
+ align=None, char=None, charoff=None, valign=None, style=None,
+ attribs=None):
+ """TableCell constructor"""
+ self.text = text
+ self.bgcolor = bgcolor
+ self.header = header
+ self.width = width
+ self.align = align
+ self.char = char
+ self.charoff = charoff
+ self.valign = valign
+ self.style = style
+ self.attribs = attribs
+ if attribs==None:
+ self.attribs = {}
+
+ def __str__(self):
+ """return the HTML code for the table cell as a string"""
+ attribs_str = ""
+ if self.bgcolor: self.attribs['bgcolor'] = self.bgcolor
+ if self.width: self.attribs['width'] = self.width
+ if self.align: self.attribs['align'] = self.align
+ if self.char: self.attribs['char'] = self.char
+ if self.charoff: self.attribs['charoff'] = self.charoff
+ if self.valign: self.attribs['valign'] = self.valign
+ if self.style: self.attribs['style'] = self.style
+ for attr in self.attribs:
+ attribs_str += ' %s="%s"' % (attr, self.attribs[attr])
+ if self.text:
+ text = str(self.text)
+ else:
+ # An empty cell should at least contain a non-breaking space
+ text = ' '
+ if self.header:
+ return ' <TH%s>%s</TH>\n' % (attribs_str, text)
+ else:
+ return ' <TD%s>%s</TD>\n' % (attribs_str, text)
+
+#-------------------------------------------------------------------------------
+
+class TableRow (object):
+ """
+ a TableRow object is used to create a row in a HTML table. (TR tag)
+
+ Attributes:
+ - cells: list, tuple or any iterable, containing one string or TableCell
+ object for each cell
+ - header: bool, true for a header row (TH), false for a normal data row (TD)
+ - bgcolor: str, background color
+ - col_align, col_valign, col_char, col_charoff, col_styles: see Table class
+ - attribs: dict, additional attributes for the TR tag
+
+ Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.5
+ """
+
+ def __init__(self, cells=None, bgcolor=None, header=False, attribs=None,
+ col_align=None, col_valign=None, col_char=None,
+ col_charoff=None, col_styles=None):
+ """TableCell constructor"""
+ self.bgcolor = bgcolor
+ self.cells = cells
+ self.header = header
+ self.col_align = col_align
+ self.col_valign = col_valign
+ self.col_char = col_char
+ self.col_charoff = col_charoff
+ self.col_styles = col_styles
+ self.attribs = attribs
+ if attribs==None:
+ self.attribs = {}
+
+ def __str__(self):
+ """return the HTML code for the table row as a string"""
+ attribs_str = ""
+ if self.bgcolor: self.attribs['bgcolor'] = self.bgcolor
+ for attr in self.attribs:
+ attribs_str += ' %s="%s"' % (attr, self.attribs[attr])
+ result = ' <TR%s>\n' % attribs_str
+ for cell in self.cells:
+ col = self.cells.index(cell) # cell column index
+ if not isinstance(cell, TableCell):
+ cell = TableCell(cell, header=self.header)
+ # apply column alignment if specified:
+ if self.col_align and cell.align==None:
+ cell.align = self.col_align[col]
+ if self.col_char and cell.char==None:
+ cell.char = self.col_char[col]
+ if self.col_charoff and cell.charoff==None:
+ cell.charoff = self.col_charoff[col]
+ if self.col_valign and cell.valign==None:
+ cell.valign = self.col_valign[col]
+ # apply column style if specified:
+ if self.col_styles and cell.style==None:
+ cell.style = self.col_styles[col]
+ result += str(cell)
+ result += ' </TR>\n'
+ return result
+
+#-------------------------------------------------------------------------------
+
+class Table (object):
+ """
+ a Table object is used to create a HTML table. (TABLE tag)
+
+ Attributes:
+ - rows: list, tuple or any iterable, containing one iterable or TableRow
+ object for each row
+ - header_row: list, tuple or any iterable, containing the header row (optional)
+ - border: str or int, border width
+ - style: str, table style in CSS syntax (thin black borders by default)
+ - width: str, width of the table on the page
+ - attribs: dict, additional attributes for the TABLE tag
+ - col_width: list or tuple defining width for each column
+ - col_align: list or tuple defining horizontal alignment for each column
+ - col_char: list or tuple defining alignment character for each column
+ - col_charoff: list or tuple defining charoff attribute for each column
+ - col_valign: list or tuple defining vertical alignment for each column
+ - col_styles: list or tuple of HTML styles for each column
+
+ Reference: http://www.w3.org/TR/html4/struct/tables.html#h-11.2.1
+ """
+
+ def __init__(self, rows=None, border='1', style=None, width=None,
+ cellspacing=None, cellpadding=4, attribs=None, header_row=None,
+ col_width=None, col_align=None, col_valign=None,
+ col_char=None, col_charoff=None, col_styles=None):
+ """TableCell constructor"""
+ self.border = border
+ self.style = style
+ # style for thin borders by default
+ if style == None: self.style = TABLE_STYLE_THINBORDER
+ self.width = width
+ self.cellspacing = cellspacing
+ self.cellpadding = cellpadding
+ self.header_row = header_row
+ self.rows = rows
+ if not rows: self.rows = []
+ self.attribs = attribs
+ if not attribs: self.attribs = {}
+ self.col_width = col_width
+ self.col_align = col_align
+ self.col_char = col_char
+ self.col_charoff = col_charoff
+ self.col_valign = col_valign
+ self.col_styles = col_styles
+
+ def __str__(self):
+ """return the HTML code for the table as a string"""
+ attribs_str = ""
+ if self.border: self.attribs['border'] = self.border
+ if self.style: self.attribs['style'] = self.style
+ if self.width: self.attribs['width'] = self.width
+ if self.cellspacing: self.attribs['cellspacing'] = self.cellspacing
+ if self.cellpadding: self.attribs['cellpadding'] = self.cellpadding
+ for attr in self.attribs:
+ attribs_str += ' %s="%s"' % (attr, self.attribs[attr])
+ result = '<TABLE%s>\n' % attribs_str
+ # insert column tags and attributes if specified:
+ if self.col_width:
+ for width in self.col_width:
+ result += ' <COL width="%s">\n' % width
+ # The following code would also generate column attributes for style
+ # and alignement according to HTML4 specs,
+ # BUT it is not supported completely (only width) on Mozilla Firefox:
+ # see https://bugzilla.mozilla.org/show_bug.cgi?id=915
+## n_cols = max(len(self.col_styles), len(self.col_width),
+## len(self.col_align), len(self.col_valign))
+## for i in range(n_cols):
+## col = ''
+## try:
+## if self.col_styles[i]:
+## col += ' style="%s"' % self.col_styles[i]
+## except: pass
+## try:
+## if self.col_width[i]:
+## col += ' width="%s"' % self.col_width[i]
+## except: pass
+## try:
+## if self.col_align[i]:
+## col += ' align="%s"' % self.col_align[i]
+## except: pass
+## try:
+## if self.col_valign[i]:
+## col += ' valign="%s"' % self.col_valign[i]
+## except: pass
+## result += '<COL%s>\n' % col
+ # First insert a header row if specified:
+ if self.header_row:
+ if not isinstance(self.header_row, TableRow):
+ result += str(TableRow(self.header_row, header=True))
+ else:
+ result += str(self.header_row)
+ # Then all data rows:
+ for row in self.rows:
+ if not isinstance(row, TableRow):
+ row = TableRow(row)
+ # apply column alignments and styles to each row if specified:
+ # (Mozilla bug workaround)
+ if self.col_align and not row.col_align:
+ row.col_align = self.col_align
+ if self.col_char and not row.col_char:
+ row.col_char = self.col_char
+ if self.col_charoff and not row.col_charoff:
+ row.col_charoff = self.col_charoff
+ if self.col_valign and not row.col_valign:
+ row.col_valign = self.col_valign
+ if self.col_styles and not row.col_styles:
+ row.col_styles = self.col_styles
+ result += str(row)
+ result += '</TABLE>'
+ return result
+
+
+#-------------------------------------------------------------------------------
+
+class List (object):
+ """
+ a List object is used to create an ordered or unordered list in HTML.
+ (UL/OL tag)
+
+ Attributes:
+ - lines: list, tuple or any iterable, containing one string for each line
+ - ordered: bool, choice between an ordered (OL) or unordered list (UL)
+ - attribs: dict, additional attributes for the OL/UL tag
+
+ Reference: http://www.w3.org/TR/html4/struct/lists.html
+ """
+
+ def __init__(self, lines=None, ordered=False, start=None, attribs=None):
+ """List constructor"""
+ if lines:
+ self.lines = lines
+ else:
+ self.lines = []
+ self.ordered = ordered
+ self.start = start
+ if attribs:
+ self.attribs = attribs
+ else:
+ self.attribs = {}
+
+ def __str__(self):
+ """return the HTML code for the list as a string"""
+ attribs_str = ""
+ if self.start: self.attribs['start'] = self.start
+ for attr in self.attribs:
+ attribs_str += ' %s="%s"' % (attr, self.attribs[attr])
+ if self.ordered: tag = 'OL'
+ else: tag = 'UL'
+ result = '<%s%s>\n' % (tag, attribs_str)
+ for line in self.lines:
+ result += ' <LI>%s\n' % str(line)
+ result += '</%s>\n' % tag
+ return result
+
+
+##class Link (object):
+## """
+## a Link object is used to create link in HTML. (<a> tag)
+##
+## Attributes:
+## - text: str, text of the link
+## - url: str, URL of the link
+## - attribs: dict, additional attributes for the A tag
+##
+## Reference: http://www.w3.org/TR/html4
+## """
+##
+## def __init__(self, text, url=None, attribs=None):
+## """Link constructor"""
+## self.text = text
+## self.url = url
+## if attribs:
+## self.attribs = attribs
+## else:
+## self.attribs = {}
+##
+## def __str__(self):
+## """return the HTML code for the link as a string"""
+## attribs_str = ""
+## if self.url: self.attribs['href'] = self.url
+## for attr in self.attribs:
+## attribs_str += ' %s="%s"' % (attr, self.attribs[attr])
+## return '<a%s>%s</a>' % (attribs_str, text)
+
+
+#=== FUNCTIONS ================================================================
+
+# much simpler definition of a link as a function:
+def Link(text, url):
+ return '<a href="%s">%s</a>' % (url, text)
+
+def link(text, url):
+ return '<a href="%s">%s</a>' % (url, text)
+
+def table(*args, **kwargs):
+ 'return HTML code for a table as a string. See Table class for parameters.'
+ return str(Table(*args, **kwargs))
+
+def list(*args, **kwargs):
+ 'return HTML code for a list as a string. See List class for parameters.'
+ return str(List(*args, **kwargs))
+
+
+#=== MAIN =====================================================================
+
+# Show sample usage when this file is launched as a script.
+
+if __name__ == '__main__':
+
+ # open an HTML file to show output in a browser
+ f = open('test.html', 'w')
+
+ t = Table()
+ t.rows.append(TableRow(['A', 'B', 'C'], header=True))
+ t.rows.append(TableRow(['D', 'E', 'F']))
+ t.rows.append(('i', 'j', 'k'))
+ f.write(str(t) + '<p>\n')
+ print(str(t))
+ print('-'*79)
+
+ t2 = Table([
+ ('1', '2'),
+ ['3', '4']
+ ], width='100%', header_row=('col1', 'col2'),
+ col_width=('', '75%'))
+ f.write(str(t2) + '<p>\n')
+ print(t2)
+ print('-'*79)
+
+ t2.rows.append(['5', '6'])
+ t2.rows[1][1] = TableCell('new', bgcolor='red')
+ t2.rows.append(TableRow(['7', '8'], attribs={'align': 'center'}))
+ f.write(str(t2) + '<p>\n')
+ print(t2)
+ print('-'*79)
+
+ # sample table with column attributes and styles:
+ table_data = [
+ ['Smith', 'John', 30, 4.5],
+ ['Carpenter', 'Jack', 47, 7],
+ ['Johnson', 'Paul', 62, 10.55],
+ ]
+ htmlcode = HTML.table(table_data,
+ header_row = ['Last name', 'First name', 'Age', 'Score'],
+ col_width=['', '20%', '10%', '10%'],
+ col_align=['left', 'center', 'right', 'char'],
+ col_styles=['font-size: large', '', 'font-size: small', 'background-color:yellow'])
+ f.write(htmlcode + '<p>\n')
+ print(htmlcode)
+ print('-'*79)
+
+ def gen_table_squares(n):
+ """
+ Generator to create table rows for integers from 1 to n
+ """
+## # First, header row:
+## yield TableRow(('x', 'square(x)'), header=True, bgcolor='blue')
+## # Then all rows:
+ for x in range(1, n+1):
+ yield (x, x*x)
+
+ t = Table(rows=gen_table_squares(10), header_row=('x', 'square(x)'))
+ f.write(str(t) + '<p>\n')
+
+ print('-'*79)
+ l = List(['aaa', 'bbb', 'ccc'])
+ f.write(str(l) + '<p>\n')
+ l.ordered = True
+ f.write(str(l) + '<p>\n')
+ l.start=10
+ f.write(str(l) + '<p>\n')
+
+ f.close()