2009-03-05 02:55:18 +05:30
|
|
|
#
|
2009-03-03 23:23:35 +05:30
|
|
|
# Gramps - a GTK+/GNOME based genealogy program
|
|
|
|
|
#
|
|
|
|
|
# Copyright (C) 2009 Gerald Britton <gerald.britton@gmail.com>
|
|
|
|
|
#
|
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
|
|
|
# (at your option) any later version.
|
|
|
|
|
#
|
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
|
#
|
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
# $Id: html.py 10874 2009-03-03 18:00:00Z gbritton $
|
|
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
HTML operations.
|
|
|
|
|
|
2009-03-05 02:55:18 +05:30
|
|
|
This module exports one class and two functions.
|
2009-03-03 23:23:35 +05:30
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
# Constants
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
2009-03-16 21:47:44 +05:30
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# XHTML DOCTYPE constants to be used in <!DOCTYPE ... > statements
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
_XHTML10_STRICT = 'PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\n' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"'
|
|
|
|
|
_XTHML10_TRANS = 'PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"\n' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"'
|
|
|
|
|
_XHTML10_FRAME = 'PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"\n' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd"'
|
|
|
|
|
_XHTML11 = 'PUBLIC "-//W3C//DTD XHTML 1.1//EN"\n' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"'
|
|
|
|
|
_XHTML10_BASIC = 'PUBLIC "-//W3C//DTD XHTML Basic 1.0//EN"\n' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd"'
|
|
|
|
|
_XHTML11_BASIC = 'PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN"\n ' \
|
|
|
|
|
'\t"http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd"'
|
|
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# XML Namespace constant for use in <html xmlns=...> tags
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
_XMLNS = "http://www.w3.org/1999/xhtml"
|
|
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# local constants.
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
_START_CLOSE = (
|
|
|
|
|
'area',
|
|
|
|
|
'base',
|
|
|
|
|
'br',
|
|
|
|
|
'frame',
|
|
|
|
|
'hr',
|
|
|
|
|
'img',
|
|
|
|
|
'input',
|
|
|
|
|
'link',
|
|
|
|
|
'meta',
|
|
|
|
|
'param'
|
|
|
|
|
)
|
|
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
class Html(list):
|
2009-03-03 23:23:35 +05:30
|
|
|
"""
|
|
|
|
|
HTML class.
|
|
|
|
|
"""
|
|
|
|
|
__slots__ = ['items','indent','inline','end']
|
|
|
|
|
#
|
|
|
|
|
def __init__(self, tag='html', *args, **keywargs):
|
2009-03-05 02:55:18 +05:30
|
|
|
super(Html, self).__init__([])
|
2009-03-03 23:23:35 +05:30
|
|
|
attr, indent, close, inline = '', False, True, False
|
2009-03-16 21:47:44 +05:30
|
|
|
#
|
|
|
|
|
# Handle keyword arguments passed to this constructor.
|
|
|
|
|
# Keywords that we process directly are handled.
|
|
|
|
|
# Keywords we don't recognize are passed into the
|
|
|
|
|
# opening tag.
|
|
|
|
|
#
|
2009-03-03 23:23:35 +05:30
|
|
|
for keyw, arg in keywargs.iteritems():
|
2009-03-16 21:47:44 +05:30
|
|
|
if keyw in ['indent', 'close', 'inline'] and \
|
|
|
|
|
arg in [True, False, None]:
|
|
|
|
|
exec '%s = %s' % (keyw, arg) # keep these settings
|
|
|
|
|
elif keyw == 'attr': # pass attributes along
|
2009-03-03 23:23:35 +05:30
|
|
|
attr += ' ' + arg
|
2009-03-16 21:47:44 +05:30
|
|
|
elif keyw[-1] == '_': # avoid Python conflicts
|
|
|
|
|
attr += ' %s="%s"' % (keyw[:-1], arg) # pass keyword arg along
|
2009-03-03 23:23:35 +05:30
|
|
|
else:
|
2009-03-16 21:47:44 +05:30
|
|
|
attr += ' %s="%s"' % (keyw, arg) # pass keyword arg along
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
self.indent = indent
|
2009-03-03 23:23:35 +05:30
|
|
|
self.inline = inline
|
2009-03-05 02:55:18 +05:30
|
|
|
self.end = close
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
if tag[0] == '<': # did caller provide preformatted tag?
|
2009-03-05 02:55:18 +05:30
|
|
|
self += [tag]
|
|
|
|
|
self.end = None
|
2009-03-09 20:48:51 +05:30
|
|
|
else:
|
2009-03-16 21:47:44 +05:30
|
|
|
if tag in _START_CLOSE: # is tag in special list that need no closer?
|
2009-03-09 22:57:06 +05:30
|
|
|
self.end = close = False
|
2009-03-16 21:47:44 +05:30
|
|
|
begin = '<%s%s%s>' % ( # build opening tag, passing in attributes
|
2009-03-05 02:55:18 +05:30
|
|
|
tag,
|
|
|
|
|
attr,
|
|
|
|
|
('' if close or close is None else ' /')
|
|
|
|
|
)
|
2009-03-16 21:47:44 +05:30
|
|
|
self += [begin] + list(args) # add beginning tag to list
|
|
|
|
|
super(Html, self).extend( # add closing tag if necessary
|
|
|
|
|
['</%s>' % tag] if close else []
|
|
|
|
|
)
|
2009-03-05 02:55:18 +05:30
|
|
|
#
|
|
|
|
|
def __add__(self, value):
|
|
|
|
|
if isinstance(value, Html) or not hasattr(value, '__iter__'):
|
|
|
|
|
value = [value]
|
2009-03-09 22:57:06 +05:30
|
|
|
index = len(self) - (1 if self.end else 0)
|
2009-03-05 02:55:18 +05:30
|
|
|
self[index:index] = value
|
2009-03-03 23:23:35 +05:30
|
|
|
return self
|
|
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
__iadd__ = append = extend = __add__
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
def replace(self, cur_value, value):
|
|
|
|
|
self[self.index(cur_value)] = value
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
def __sub__(self, value):
|
|
|
|
|
del self[self.index(value)]
|
2009-03-03 23:23:35 +05:30
|
|
|
return self
|
2009-03-05 02:55:18 +05:30
|
|
|
#
|
|
|
|
|
__isub__ = remove = __sub__
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
def print_(data):
|
2009-03-03 23:23:35 +05:30
|
|
|
print data
|
2009-03-05 02:55:18 +05:30
|
|
|
#
|
|
|
|
|
def __str__(self):
|
|
|
|
|
return '%s'*len(self) % tuple(self[:])
|
|
|
|
|
#
|
|
|
|
|
def __iter__(self):
|
2009-03-16 21:47:44 +05:30
|
|
|
for item in self[:]: # loop through all list elements
|
|
|
|
|
if isinstance(item, self.Html): # if nested list found
|
|
|
|
|
for sub_item in item: # recurse
|
2009-03-05 02:55:18 +05:30
|
|
|
yield sub_item
|
|
|
|
|
else:
|
|
|
|
|
yield item
|
|
|
|
|
#
|
|
|
|
|
iterkeys = itervalues = iteritems = __iter__
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
def write(self, method=print_, tabs=''):
|
2009-03-03 23:23:35 +05:30
|
|
|
tabs += '\t' if self.indent else ''
|
2009-03-16 21:47:44 +05:30
|
|
|
if self.inline: # if inline, write all list and
|
|
|
|
|
method('%s%s' % (tabs,self)) # nested list elements
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
|
|
|
|
else:
|
2009-03-16 21:47:44 +05:30
|
|
|
for item in self[:]: # not inline: write one at a time
|
2009-03-05 02:55:18 +05:30
|
|
|
if isinstance(item, Html):
|
2009-03-16 21:47:44 +05:30
|
|
|
item.write(method=method, tabs=tabs) # recurse if nested
|
2009-03-03 23:23:35 +05:30
|
|
|
else:
|
2009-03-16 21:47:44 +05:30
|
|
|
method('%s%s' % (tabs, item)) # write the line if not
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
def addXML(self, version=1.0, encoding="UTF-8", standalone="no"):
|
|
|
|
|
xml = XML(version=version, encoding=encoding, standalone=standalone)
|
|
|
|
|
self.insert(0, xml)
|
2009-03-03 23:23:35 +05:30
|
|
|
#
|
2009-03-16 21:47:44 +05:30
|
|
|
def addDOCTYPE(self, name='html', external_id=_XHTML10_STRICT, *args):
|
|
|
|
|
doctype = DOCTYPE(name='html', external_id=external_id, *args)
|
2009-03-05 02:55:18 +05:30
|
|
|
if len(self) and self[0][:6] == '<?xml ':
|
|
|
|
|
self.insert(1, doctype)
|
2009-03-03 23:23:35 +05:30
|
|
|
else:
|
2009-03-05 02:55:18 +05:30
|
|
|
self.insert(0, doctype)
|
2009-03-16 21:47:44 +05:30
|
|
|
#
|
2009-03-05 02:55:18 +05:30
|
|
|
def XML(version=1.0, encoding="UTF-8", standalone="no"):
|
|
|
|
|
return '<?xml %s %s %s?>' % (
|
|
|
|
|
'version="%s"' % version,
|
|
|
|
|
'encoding="%s"' % encoding,
|
|
|
|
|
'standalone="%s"' % standalone
|
|
|
|
|
)
|
2009-03-16 21:47:44 +05:30
|
|
|
#
|
|
|
|
|
def DOCTYPE(name='html', external_id=_XHTML10_STRICT, *args):
|
2009-03-05 02:55:18 +05:30
|
|
|
return '<!DOCTYPE %s %s%s>' % (
|
|
|
|
|
name,
|
|
|
|
|
external_id,
|
|
|
|
|
' %s'*len(args) % args
|
|
|
|
|
)
|
2009-03-03 23:23:35 +05:30
|
|
|
|
