spug.web.html
index
/home/mmuller/w/spug/web/html.py

This is yet another Python wrapper around HTML.
 
This solution aims for simplicity and consistency above all else.
All of the tag classes accept sequence and keyword arguments
in their constructors: the sequence arguments are always placed in the 
contents of the tag, the keyword arguments are always used as attributes
to the tag.
 
If a sequence argument is a list or tuple, it is recursively flattened 
into a string.  All other arguments are stringified.
 
Classes prefaced by the letter "X" are extensions to the basic html
classes and do not neccessarily correspond to the rule identified above.
Typically, they try to adhere to these rules as much as possible, and offer
exceptions so that these objects can be easier to use.
 
This module currently include lowercase functional forms of many of these
classes: they exist only for backwards compatibility and their use is
deprecated.

 
Modules
       
re
string

 
Classes
       
web.html.Tag
web.html.A
web.html.B
web.html.Body
web.html.Br
web.html.Center
web.html.Div
web.html.Font
web.html.Form
web.html.H1
web.html.H2
web.html.H3
web.html.H4
web.html.H5
web.html.H6
web.html.H7
web.html.H8
web.html.H9
web.html.HTML
web.html.XDoc
web.html.Head
web.html.I
web.html.Img
web.html.Input
web.html.XSubmit
web.html.XText
web.html.LI
web.html.OL
web.html.Option
web.html.P
web.html.Pre
web.html.Script
web.html.XScript
web.html.Select
web.html.XSelect
web.html.Span
web.html.TD
web.html.TR
web.html.Table
web.html.XTable
web.html.TextArea
web.html.Title
web.html.U
web.html.UL
web.html.XUL
web.html.XNull

 
class A(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class B(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Body(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Br(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Center(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Div(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Font(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Form(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H1(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H2(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H3(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H4(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H5(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H6(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H7(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H8(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class H9(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class HTML(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Head(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class I(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Img(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Input(Tag)
    Attributes:
 
   type::
      'entry' (text entryfield), 'submit' (submit button), 'reset'
      (reset button), 'password' (password entry field), 
   name::
      Control id
   size::
      For 'entry' and 'password' types, this is the width of the field
      in columns.
   value::
      For 'entry' and 'password' types, this is the initial text.  For
      buttons, it is the button label.
 
  Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class LI(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class OL(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Option(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class P(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Pre(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Script(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Select(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Span(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class TD(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class TR(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Table(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Tag
    This is, IMHO, the ultimate representation of an HTML (or XML) construct.
 
An HTML tag can be represented by the tag itself, its attributes,
and its contents.
 
It is up to the derived classes to provide the tag by defining the
#`_tag`# variable at the class level.
 
Attributes and contents (which we are calling /items/) can be
manipulated using the types of methods that we normally use to 
manipulate dictionaries and lists.
 
Attributes and items can be passed in at the time of construction using
the keyword parameters and positional parameters, respectively.
 
The bracket operators (#`__setitem__`#, #`__getitem__`# and 
#`__delitem__`#) refer to either an attribute or an item depending
on whether the value in the brackets is a string or an integer.
 
If the value is an integer, then the operator is being used to index
an item.  If it is a string, then it refers to an attribute.
 
Normally, attribute values are quoted and emitted as part of the
attribute list of the tag when @writeOn() or @__str__() is invoked.
However, as a special exception, if the value is *None*, neither
the attribute name or value is emitted.  This allows you to "turn off"
boolean attributes by specifying a value of *None*.
 
  Methods defined here:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class TextArea(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class Title(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class U(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class UL(Tag)
     Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XDoc(HTML)
    A complete html document.  Consists of the outer HTML tag with an
embedded HEAD tag and BODY tag, both of which are available as
public variables:
 
/head/::
   An instance of @Head which represents the HEAD tag of the
   document.
/body/::
   An instance of @Body which represents the BODY tag of the
   document.
 
All sequence and keyword arguments are passed to the BODY tag, 
except for the following special attributes:
 
/title/::
   A string representing the title of the document.  This will cause
   a TITLE tag to be added to the contents of the HEAD tag.
 
 
Method resolution order:
XDoc
HTML
Tag

Methods defined here:
__init__(self, *parms, **kw)
__str__(self)
Overrides @Tag.__str__() so as to prefix the return value with the
special DOCTYPE tag.
writeOn(self, out)
Overrides @Tag.writeOn() so as to prefix the output with the
special DOCTYPE tag.

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)

 
class XNull(Tag)
    This is a tag that simply writes out it's contents with no enclosing
element.
 
For the most part, this function can be served by passing lists into
the constructor parameters and element insert methods.  The XNull
class is mainly to allow derived classes to do funky things.
 
  Methods defined here:
__str__(self)
writeOn(self, out)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__init__(self, *parms, **kw)
__len__(self)
__setitem__(self, key, val)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)

 
class XScript(Script)
    Generates a true JavaScript Script (complete with the *language*
attribute and beginning and ending comment delimiters).
 
These should be constructed with a single string containing the 
java script.
 
 
Method resolution order:
XScript
Script
Tag

Methods defined here:
__init__(self, script)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XSelect(Select)
    Just like *Select* except that all constructor parameters that
are strings are automatically translated to Option instances.
 
No such transformations are attempted on the append and 
`__setitem__` methods.
 
 
Method resolution order:
XSelect
Select
Tag

Methods defined here:
__init__(self, *parms, **kw)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XSubmit(Input)
    
Method resolution order:
XSubmit
Input
Tag

Methods defined here:
__init__(self, *parms, **kw)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XTable(Table)
    Just like a *Table* except that all constructor parameters that are
lists or tuples are automatically converted to rows, and all items in
those lists that are not *TD*'s are converted to *TD*'s.
 
 
Method resolution order:
XTable
Table
Tag

Methods defined here:
__init__(self, *parms, **kw)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XText(Input)
    
Method resolution order:
XText
Input
Tag

Methods defined here:
__init__(self, *parms, **kw)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
class XUL(UL)
    Like an unordered list, but automatically wraps all sequence
parameters that are not list items (LI) in list items.
 
 
Method resolution order:
XUL
UL
Tag

Methods defined here:
__init__(self, *parms, **kw)

Methods inherited from Tag:
__delitem__(self, key)
__delslice__(self, start, end)
__getitem__(self, key)
__len__(self)
__setitem__(self, key, val)
__str__(self)
append(self, item)
getValue(self, dict)
If the tag has a "name" attribute, and there is a key in the 
dictionary /dict/ of this name, this method will assign
the value in the dictionary to the value of the Tag.
 
"Value of the tag" means whatever is appropriate for the tag, 
usually it means setting the tags "value" attribute, so that
is the default behavior.  Tags wishing to override this behavior
should override the @_setValue() method.
 
The recommended use of this is to easily extract information
from a CGIRequest's "query" dictionary.
 
This method will recurse through all nested html objects.
has_key(self, key)
writeOn(self, writeable)

 
Functions
       
a(*parms, **kw)
body(*parms, **kw)
center(*parms, **kw)
doc(*parms, **kw)
encode(data)
Encodes the string: replacing characters that have special meaning
within HTML.  Returns the encoded string.
 
parms:
   data::
      [string] data to encode
font(*parms, **kw)
form(*parms, **kw)
h1(*parms, **kw)
h2(*parms, **kw)
h3(*parms, **kw)
h4(*parms, **kw)
h5(*parms, **kw)
h6(*parms, **kw)
h7(*parms, **kw)
h8(*parms, **kw)
h9(*parms, **kw)
head(*parms, **kw)
html(*parms, **kw)
input(*parms, **kw)
li(*parms, **kw)
ol(*parms, **kw)
p(*parms, **kw)
table(*parms, **kw)
tag(tag, parms, kw)
td(*parms, **kw)
title(*parms, **kw)
tr(*parms, **kw)
ul(*parms, **kw)
x_htmldoc(*parms, **kw)
Returns a complete HTML document.  Keyword arguments all go into
the body tag, except for the following special arguments:
 
*title*::
   Becomes the title of the document.
x_ol(*parms, **kw)
Like "ol" only converts each positional parameter to a list item.
x_submit(*parms, **kw)
x_text(*parms, **kw)
x_ul(*parms, **kw)
Like "ul" only converts each positional parameter to a list item.

 
Data
        doctype = '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">\n'