2009-03-04 21:25:18 +00:00
|
|
|
#
|
2009-03-03 17:53:35 +00:00
|
|
|
# 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
|
|
|
|
|
#
|
|
|
|
|
|
2009-03-23 15:57:59 +00:00
|
|
|
# $Id: libhtml.py 10874 2009-03-03 18:00:00Z gbritton $
|
2009-03-03 17:53:35 +00:00
|
|
|
|
2009-03-20 16:22:12 +00:00
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# Html
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
2009-03-03 17:53:35 +00:00
|
|
|
"""
|
|
|
|
|
HTML operations.
|
|
|
|
|
|
2009-04-02 19:53:30 +00:00
|
|
|
This module exports the Html class
|
2009-03-03 17:53:35 +00:00
|
|
|
|
|
|
|
|
"""
|
|
|
|
|
|
2009-04-02 19:53:30 +00:00
|
|
|
__all__ = ['Html']
|
2009-03-20 16:22:12 +00:00
|
|
|
|
2009-03-23 14:42:37 +00:00
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# GRAMPS modules
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
2009-04-02 19:53:30 +00:00
|
|
|
try:
|
|
|
|
|
from gen.plug import PluginManager, Plugin
|
|
|
|
|
from gettext import gettext as _
|
|
|
|
|
except ImportError:
|
|
|
|
|
print 'Plugin manager not imported.'
|
2009-03-23 14:42:37 +00:00
|
|
|
|
2009-03-03 17:53:35 +00:00
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
2009-03-16 16:17:44 +00:00
|
|
|
# Constants
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
2009-03-16 16:17:44 +00:00
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# XHTML DOCTYPE constants to be used in <!DOCTYPE ... > statements
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
2009-04-02 19:53:30 +00:00
|
|
|
|
|
|
|
|
_XHTML10_STRICT = '"-//W3C//DTD XHTML 1.0 Strict//EN"\n' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"'
|
2009-04-02 19:53:30 +00:00
|
|
|
_XTHML10_TRANS = '"-//W3C//DTD XHTML 1.0 Transitional//EN"\n' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"'
|
2009-04-02 19:53:30 +00:00
|
|
|
_XHTML10_FRAME = '"-//W3C//DTD XHTML 1.0 Frameset//EN"\n' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\t"http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd"'
|
2009-04-02 19:53:30 +00:00
|
|
|
_XHTML11 = '"-//W3C//DTD XHTML 1.1//EN"\n' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\t"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"'
|
2009-04-02 19:53:30 +00:00
|
|
|
_XHTML10_BASIC = '"-//W3C//DTD XHTML Basic 1.0//EN"\n' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\t"http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd"'
|
2009-04-02 19:53:30 +00:00
|
|
|
_XHTML11_BASIC = '"-//W3C//DTD XHTML Basic 1.1//EN"\n ' \
|
2009-03-16 16:17:44 +00:00
|
|
|
'\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"
|
|
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
# Local constants.
|
2009-03-16 16:17:44 +00:00
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
_START_CLOSE = (
|
|
|
|
|
'area',
|
|
|
|
|
'base',
|
|
|
|
|
'br',
|
|
|
|
|
'frame',
|
|
|
|
|
'hr',
|
|
|
|
|
'img',
|
|
|
|
|
'input',
|
|
|
|
|
'link',
|
|
|
|
|
'meta',
|
|
|
|
|
'param'
|
|
|
|
|
)
|
2009-03-20 16:22:12 +00:00
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
# Helper functions.
|
2009-03-16 16:17:44 +00:00
|
|
|
#
|
2009-03-20 16:22:12 +00:00
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
def print_(line):
|
|
|
|
|
"""
|
|
|
|
|
Print function
|
|
|
|
|
"""
|
|
|
|
|
print line
|
|
|
|
|
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# Html class.
|
|
|
|
|
#
|
|
|
|
|
#------------------------------------------------------------------------
|
|
|
|
|
|
2009-03-04 21:25:18 +00:00
|
|
|
class Html(list):
|
2009-03-03 17:53:35 +00:00
|
|
|
"""
|
2009-03-20 16:22:12 +00:00
|
|
|
HTML class: Manages a rooted tree of HTML objects
|
2009-03-03 17:53:35 +00:00
|
|
|
"""
|
2009-03-20 16:22:12 +00:00
|
|
|
__slots__ = ['items', 'indent', 'inline', 'end']
|
2009-04-02 19:53:30 +00:00
|
|
|
#
|
|
|
|
|
@staticmethod
|
|
|
|
|
def xmldecl(version=1.0, encoding="UTF-8", standalone="no"):
|
|
|
|
|
"""
|
|
|
|
|
Build and return an XML declaration statement
|
|
|
|
|
|
|
|
|
|
@type version: decimal number
|
|
|
|
|
@param version: version of XML to be used. Defaults to 1.0
|
|
|
|
|
@type encoding: string
|
|
|
|
|
@param encoding: encoding method to be used. Defaults to "UTF-8"
|
|
|
|
|
@type standalone: string
|
|
|
|
|
@param standalone: "yes" or "no". Defaults to "no"
|
|
|
|
|
"""
|
|
|
|
|
return '<?xml %s %s %s?>' % (
|
|
|
|
|
'version="%s"' % version,
|
|
|
|
|
'encoding="%s"' % encoding,
|
|
|
|
|
'standalone="%s"' % standalone
|
|
|
|
|
)
|
|
|
|
|
#
|
|
|
|
|
@staticmethod
|
|
|
|
|
def doctype(name='html', public='PUBLIC', external_id=_XHTML10_STRICT):
|
|
|
|
|
"""
|
|
|
|
|
Build and return a DOCTYPE statement
|
|
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
|
@param name: name of this DOCTYPE. Defaults to "html"
|
|
|
|
|
@type public: string
|
|
|
|
|
@param public: class of this DOCTYPE. Defaults to 'PUBLIC
|
|
|
|
|
@type external_id: string
|
|
|
|
|
@param external_id: external identifier of this DOCTYPE.
|
|
|
|
|
Defaults to XHTML 1.0 STRICT
|
|
|
|
|
@type args: object
|
|
|
|
|
@param args: 0 or more positional parameters to be added to this
|
|
|
|
|
DOCTYPE.
|
|
|
|
|
"""
|
|
|
|
|
return '<!DOCTYPE %s %s %s>' % (
|
|
|
|
|
name,
|
|
|
|
|
public,
|
|
|
|
|
external_id,
|
|
|
|
|
)
|
|
|
|
|
#
|
|
|
|
|
@staticmethod
|
|
|
|
|
def html(xmlns=_XMLNS, lang='en', *args, **keywargs):
|
|
|
|
|
"""
|
|
|
|
|
Build and return a properly-formated <html> object
|
|
|
|
|
|
|
|
|
|
@type xmlns: string
|
|
|
|
|
@param xmlns: XML namespace string. Default = 'http://www.w3.org/1999/xhtml'
|
|
|
|
|
@type lang: string
|
|
|
|
|
@param lang: language to be used. Defaul = 'en'
|
|
|
|
|
@rtype: reference to new Html instance
|
|
|
|
|
@return: reference to the newly-created Html instances for <html> object
|
|
|
|
|
"""
|
|
|
|
|
return Html('html',
|
|
|
|
|
indent=False,
|
|
|
|
|
xmlns=xmlns,
|
|
|
|
|
attr='xml:lang="%s" lang="%s"' % ((lang,)*2),
|
|
|
|
|
*args, **keywargs
|
|
|
|
|
)
|
|
|
|
|
#
|
|
|
|
|
@staticmethod
|
|
|
|
|
def head(title='Title', encoding='utf-8', *args, **keywargs):
|
|
|
|
|
"""
|
|
|
|
|
Build and return a properly-formated <head> object
|
|
|
|
|
|
|
|
|
|
@type title: string
|
|
|
|
|
@param title: title for HTML page. Default='Title'
|
|
|
|
|
@type encoding: string
|
|
|
|
|
@param encoding: encoding to be used. Default = 'utf-8'
|
|
|
|
|
@rtype reference to new Html instance
|
|
|
|
|
@return reference to the newly-created Html instances for <head> object
|
|
|
|
|
"""
|
|
|
|
|
meta1 = 'http-equiv="content-type" content="text/html;charset=%s"'
|
|
|
|
|
meta2 = 'http-equiv="Content-Style-Type" content="text/css"'
|
|
|
|
|
head = Html('head', *args, **keywargs) + (
|
|
|
|
|
Html('title', title, inline=True, indent=True),
|
|
|
|
|
Html('meta', attr=meta1 % encoding, indent=True),
|
|
|
|
|
Html('meta', attr=meta2, indent=True)
|
|
|
|
|
)
|
|
|
|
|
return head
|
|
|
|
|
#
|
|
|
|
|
@staticmethod
|
|
|
|
|
def page(title='Title', encoding='utf-8', lang='en', *args, **keywargs):
|
|
|
|
|
"""
|
|
|
|
|
This function prepares a new Html class based page and returns
|
|
|
|
|
|
|
|
|
|
@type title: string
|
|
|
|
|
@param title: title for HTML page. Default='Title'
|
|
|
|
|
@type encoding: string
|
|
|
|
|
@param encoding: encoding to be used. Default = 'utf-8'
|
|
|
|
|
@type lang: string
|
|
|
|
|
@param lang: language to be used. Defaul = 'en'
|
|
|
|
|
@rtype: three object references
|
|
|
|
|
@return: references to the newly-created Html instances for
|
|
|
|
|
page, head and body
|
|
|
|
|
"""
|
|
|
|
|
page = Html.html(lang=lang, *args, **keywargs)
|
|
|
|
|
page.addXML(encoding=encoding)
|
|
|
|
|
page.addDOCTYPE()
|
|
|
|
|
#
|
|
|
|
|
head = Html.head(title=title,
|
|
|
|
|
encoding=encoding,
|
|
|
|
|
lang=lang,
|
|
|
|
|
indent=False,
|
|
|
|
|
*args, **keywargs
|
|
|
|
|
)
|
|
|
|
|
#
|
|
|
|
|
body = Html('body', indent=False, *args, **keywargs)
|
|
|
|
|
page += (head, body)
|
|
|
|
|
return page, head, body
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
|
|
|
|
def __init__(self, tag='html', *args, **keywargs):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Class Constructor: Returns a new instance of the Html class
|
|
|
|
|
|
|
|
|
|
@type tag: string
|
|
|
|
|
@param tag: The HTML tag. Default is 'html'
|
|
|
|
|
@type args: optional positional parameters
|
|
|
|
|
@param args: 0 more positional arguments to be inserted between
|
|
|
|
|
opening and closing HTML tags.
|
|
|
|
|
@type indent: boolean
|
|
|
|
|
@param indent: True ==> indent this object with respect to its parent
|
|
|
|
|
False ==> do not indent this object
|
|
|
|
|
Defauls to False
|
|
|
|
|
@type inline: boolean
|
|
|
|
|
@param inline: True ==> instructs the write() method to output this
|
|
|
|
|
object and any child objects as a single string
|
|
|
|
|
False ==> output this object and its contents one string
|
|
|
|
|
at a time
|
|
|
|
|
Defaults to False
|
|
|
|
|
@type close: boolean or None
|
|
|
|
|
@param close: True ==> this tag should be closed normally
|
|
|
|
|
e.g. <tag>...</tag>
|
|
|
|
|
False ==> this tag should be automatically closed
|
|
|
|
|
e.g. <tag />
|
|
|
|
|
None ==> do not provide any closing for this tag
|
|
|
|
|
@type keywargs: optional keyword parameters
|
|
|
|
|
@param keywargs: 0 or more keyword=argument pairs that should be
|
|
|
|
|
copied into the opening tag as keyword="argument"
|
|
|
|
|
attributes
|
|
|
|
|
@rtype: object reference
|
|
|
|
|
@return: reference to the newly-created Html instance
|
|
|
|
|
"""
|
2009-04-02 19:53:30 +00:00
|
|
|
super(Html, self).__init__([]) # instantiate object
|
|
|
|
|
attr, indent, close, inline = '', True, True, False
|
2009-03-16 16:17:44 +00:00
|
|
|
#
|
|
|
|
|
# Handle keyword arguments passed to this constructor.
|
|
|
|
|
# Keywords that we process directly are handled.
|
2009-04-02 19:53:30 +00:00
|
|
|
# Keywords we don't recognize are saved for later
|
|
|
|
|
# addition to the opening tag as attributes.
|
2009-03-16 16:17:44 +00:00
|
|
|
#
|
2009-03-03 17:53:35 +00:00
|
|
|
for keyw, arg in keywargs.iteritems():
|
2009-03-16 16:17:44 +00:00
|
|
|
if keyw in ['indent', 'close', 'inline'] and \
|
|
|
|
|
arg in [True, False, None]:
|
2009-03-20 16:22:12 +00:00
|
|
|
exec '%s = %s' % (keyw, arg) # keep these settings
|
|
|
|
|
elif keyw == 'attr': # pass attributes along
|
2009-03-03 17:53:35 +00:00
|
|
|
attr += ' ' + arg
|
2009-03-20 16:22:12 +00:00
|
|
|
elif keyw[-1] == '_': # avoid Python conflicts
|
|
|
|
|
attr += ' %s="%s"' % (keyw[:-1], arg) # pass keyword arg along
|
2009-03-03 17:53:35 +00:00
|
|
|
else:
|
2009-03-20 16:22:12 +00:00
|
|
|
attr += ' %s="%s"' % (keyw, arg) # pass keyword arg along
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-03-16 16:17:44 +00:00
|
|
|
self.indent = indent
|
2009-03-03 17:53:35 +00:00
|
|
|
self.inline = inline
|
2009-03-04 21:25:18 +00:00
|
|
|
self.end = close
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
if tag[0] == '<': # if caller provided preformatted tag?
|
|
|
|
|
self[0:] = [tag] # add it in
|
2009-03-04 21:25:18 +00:00
|
|
|
self.end = None
|
2009-03-09 15:18:51 +00:00
|
|
|
else:
|
2009-03-20 16:22:12 +00:00
|
|
|
if tag in _START_CLOSE: # if tag in special list
|
|
|
|
|
self.end = close = False # it needs no closing tag
|
2009-04-02 19:53:30 +00:00
|
|
|
begin = '<%s%s%s>' % ( # build opening tag with attributes
|
2009-03-04 21:25:18 +00:00
|
|
|
tag,
|
|
|
|
|
attr,
|
|
|
|
|
('' if close or close is None else ' /')
|
|
|
|
|
)
|
|
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
self[0:] = [begin] + list(args) # add beginning tag
|
|
|
|
|
if close: # if need closing tab
|
|
|
|
|
self[len(self):] = ['</%s>' % tag] # add it on the end
|
|
|
|
|
#
|
|
|
|
|
def __add(self, value):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
2009-04-02 19:53:30 +00:00
|
|
|
Helper function for +, +=, operators and append() and extend()
|
|
|
|
|
methods
|
2009-03-20 16:22:12 +00:00
|
|
|
|
|
|
|
|
@type value: object
|
|
|
|
|
@param value: object to be added
|
|
|
|
|
|
|
|
|
|
@rtype: object reference
|
|
|
|
|
@return: reference to object with new value added
|
|
|
|
|
"""
|
2009-03-04 21:25:18 +00:00
|
|
|
if isinstance(value, Html) or not hasattr(value, '__iter__'):
|
|
|
|
|
value = [value]
|
2009-03-09 17:27:06 +00:00
|
|
|
index = len(self) - (1 if self.end else 0)
|
2009-03-04 21:25:18 +00:00
|
|
|
self[index:index] = value
|
2009-03-03 17:53:35 +00:00
|
|
|
return self
|
|
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
def __add__(self, value):
|
|
|
|
|
"""
|
|
|
|
|
Overload method for + and += operators
|
|
|
|
|
"""
|
|
|
|
|
return self.__add(value)
|
|
|
|
|
__iadd__ = __add__
|
|
|
|
|
#
|
|
|
|
|
def append(self, value):
|
|
|
|
|
"""
|
|
|
|
|
Append a new value
|
|
|
|
|
"""
|
|
|
|
|
self.__add(value)
|
|
|
|
|
extend = append
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-03-04 21:25:18 +00:00
|
|
|
def replace(self, cur_value, value):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Replace current value with new value
|
|
|
|
|
|
|
|
|
|
@type cur_value: object
|
|
|
|
|
@param cur_value: value of object to be replaced
|
|
|
|
|
@type value: object
|
|
|
|
|
@param value: replacement value
|
|
|
|
|
|
|
|
|
|
@rtype: object reference
|
|
|
|
|
@return: reference to object with new value added
|
|
|
|
|
"""
|
2009-03-04 21:25:18 +00:00
|
|
|
self[self.index(cur_value)] = value
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-03-04 21:25:18 +00:00
|
|
|
def __sub__(self, value):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Overload function for - and -= operators
|
|
|
|
|
@type value: object
|
|
|
|
|
@param value: object to be removed
|
|
|
|
|
|
|
|
|
|
@rtype: object reference
|
|
|
|
|
@return: reference to object with value removed
|
|
|
|
|
"""
|
2009-03-04 21:25:18 +00:00
|
|
|
del self[self.index(value)]
|
2009-03-03 17:53:35 +00:00
|
|
|
return self
|
2009-03-04 21:25:18 +00:00
|
|
|
#
|
|
|
|
|
__isub__ = remove = __sub__
|
|
|
|
|
#
|
|
|
|
|
def __str__(self):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Returns string representation
|
|
|
|
|
|
|
|
|
|
@rtype: string
|
2009-04-02 19:53:30 +00:00
|
|
|
@return: string representation of object
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
2009-03-04 21:25:18 +00:00
|
|
|
return '%s'*len(self) % tuple(self[:])
|
|
|
|
|
#
|
|
|
|
|
def __iter__(self):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Iterator function: returns a generator that performs an
|
|
|
|
|
insertion-order tree traversal and yields each item found.
|
|
|
|
|
"""
|
2009-03-16 16:17:44 +00:00
|
|
|
for item in self[:]: # loop through all list elements
|
2009-03-20 16:22:12 +00:00
|
|
|
if isinstance(item, Html): # if nested list found
|
2009-03-16 16:17:44 +00:00
|
|
|
for sub_item in item: # recurse
|
2009-03-04 21:25:18 +00:00
|
|
|
yield sub_item
|
|
|
|
|
else:
|
|
|
|
|
yield item
|
|
|
|
|
#
|
|
|
|
|
iterkeys = itervalues = iteritems = __iter__
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-04-02 19:53:30 +00:00
|
|
|
def write(self, method=print_, indent='\t', tabs=''):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Output function: performs an insertion-order tree traversal
|
|
|
|
|
and calls supplied method for each item found.
|
|
|
|
|
|
|
|
|
|
@type method: function reference
|
|
|
|
|
@param method: function to call with each item found
|
2009-04-02 19:53:30 +00:00
|
|
|
@type indent: string
|
|
|
|
|
@param indenf: string to use for indentation. Default = '\t' (tab)
|
2009-03-20 16:22:12 +00:00
|
|
|
@type tabs: string
|
|
|
|
|
@oaram tabs: starting indentation
|
|
|
|
|
"""
|
2009-04-02 19:53:30 +00:00
|
|
|
if self.indent:
|
|
|
|
|
tabs += indent
|
2009-03-16 16:17:44 +00:00
|
|
|
if self.inline: # if inline, write all list and
|
2009-03-20 16:22:12 +00:00
|
|
|
method('%s%s' % (tabs, self)) # nested list elements
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
|
|
|
|
else:
|
2009-03-20 16:22:12 +00:00
|
|
|
for item in self[:]: # else write one at a time
|
2009-04-02 19:53:30 +00:00
|
|
|
if isinstance(item, Html): # recurse if nested Html class
|
|
|
|
|
item.write(method=method, indent=indent, tabs=tabs)
|
2009-03-03 17:53:35 +00:00
|
|
|
else:
|
2009-03-20 16:22:12 +00:00
|
|
|
method('%s%s' % (tabs, item)) # else write the line
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-03-04 21:25:18 +00:00
|
|
|
def addXML(self, version=1.0, encoding="UTF-8", standalone="no"):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Add an XML statement to the start of the list for this object
|
|
|
|
|
|
|
|
|
|
@type version: decimal number
|
|
|
|
|
@param version: version of XML to be used. Defaults to 1.0
|
|
|
|
|
@type encoding: string
|
|
|
|
|
@param encoding: encoding method to be used. Defaults to "UTF-8"
|
|
|
|
|
@type standalone: string
|
|
|
|
|
@param standalone: "yes" or "no". Defaults to "no"
|
|
|
|
|
"""
|
2009-04-02 19:53:30 +00:00
|
|
|
xmldecl = Html.xmldecl(
|
|
|
|
|
version=version,
|
|
|
|
|
encoding=encoding,
|
|
|
|
|
standalone=standalone
|
2009-03-20 16:22:12 +00:00
|
|
|
)
|
2009-04-02 19:53:30 +00:00
|
|
|
self[0:0] = [xmldecl]
|
2009-03-03 17:53:35 +00:00
|
|
|
#
|
2009-03-16 16:17:44 +00:00
|
|
|
def addDOCTYPE(self, name='html', external_id=_XHTML10_STRICT, *args):
|
2009-03-20 16:22:12 +00:00
|
|
|
"""
|
|
|
|
|
Add a DOCTYPE statement to the start of the list
|
|
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
|
@param name: name of this DOCTYPE. Defaults to "html"
|
|
|
|
|
@type external_id: string
|
|
|
|
|
@param external_id: external identifier of this DOCTYPE.
|
|
|
|
|
Defaults to XHTML 1.0 STRICT
|
|
|
|
|
@type args: object
|
|
|
|
|
@param args: 0 or more positional parameters to be added to this
|
|
|
|
|
DOCTYPE.
|
|
|
|
|
"""
|
|
|
|
|
doctype = '<!DOCTYPE %s %s%s>' % (
|
|
|
|
|
name,
|
|
|
|
|
external_id,
|
|
|
|
|
' %s'*len(args) % args
|
|
|
|
|
)
|
2009-04-02 19:53:30 +00:00
|
|
|
# Note: DOCTYPE declaration must follow XML declaration
|
|
|
|
|
|
2009-03-04 21:25:18 +00:00
|
|
|
if len(self) and self[0][:6] == '<?xml ':
|
2009-04-02 19:53:30 +00:00
|
|
|
self[1:1] = [doctype]
|
2009-03-03 17:53:35 +00:00
|
|
|
else:
|
2009-04-02 19:53:30 +00:00
|
|
|
self[0:0] = [doctype]
|
|
|
|
|
#
|
|
|
|
|
def __gettag(self):
|
|
|
|
|
"""
|
|
|
|
|
Returns HTML tag for this object
|
|
|
|
|
|
|
|
|
|
@rtype: string
|
|
|
|
|
@return: HTML tag
|
|
|
|
|
"""
|
|
|
|
|
return self[0].split()[0].strip('< >')
|
|
|
|
|
#
|
|
|
|
|
def __settag(self, newtag):
|
|
|
|
|
"""
|
|
|
|
|
Sets a new HTML tag for this object
|
|
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
|
@param name: new HTML tag
|
|
|
|
|
"""
|
|
|
|
|
curtag = self.tag
|
|
|
|
|
if self[-1] == '</%s>' % curtag:
|
|
|
|
|
self[-1] = '</%s>' % newtag
|
|
|
|
|
self[0] = self[0].replace('<' + curtag, '<' + newtag)
|
|
|
|
|
tag = property(__gettag, __settag)
|
|
|
|
|
#
|
|
|
|
|
def __getattr(self):
|
|
|
|
|
"""
|
|
|
|
|
Returns HTML attributes for this object
|
|
|
|
|
|
|
|
|
|
@rtype: string
|
|
|
|
|
@return: HTML attributes
|
|
|
|
|
"""
|
|
|
|
|
attr = self[0].strip('<!?>').split(None, 1)
|
|
|
|
|
return attr[1] if len(attr) > 1 else ''
|
|
|
|
|
#
|
|
|
|
|
def __setattr(self, value):
|
|
|
|
|
"""
|
|
|
|
|
Sets new HTML attributes for this object
|
|
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
|
@param name: new HTML attributes
|
|
|
|
|
"""
|
|
|
|
|
self[0] = self[0][:len(self.tag)+1] + ' ' + value + self[0][-1:]
|
|
|
|
|
#
|
|
|
|
|
def __delattr(self):
|
|
|
|
|
"""
|
|
|
|
|
Removes HTML attributes for this object
|
|
|
|
|
"""
|
|
|
|
|
self[0] = '<' + self.tag + '>'
|
|
|
|
|
attr = property(__getattr, __setattr, __delattr)
|
|
|
|
|
#
|
|
|
|
|
def __getinside(self):
|
|
|
|
|
"""
|
|
|
|
|
Returns list of items between opening and closing tags
|
|
|
|
|
|
|
|
|
|
@rtype: list
|
|
|
|
|
@return: list of items between opening and closing HTML tags
|
|
|
|
|
"""
|
|
|
|
|
return self[1:-1]
|
|
|
|
|
#
|
|
|
|
|
def __setinside(self, value):
|
|
|
|
|
"""
|
|
|
|
|
Sets new contents between opening and closing tags
|
|
|
|
|
|
|
|
|
|
@type name: list
|
|
|
|
|
@param name: new HTML contents
|
|
|
|
|
"""
|
|
|
|
|
if len(self) < 2:
|
|
|
|
|
raise AttributeError, 'No closing tag. Cannot set inside value'
|
|
|
|
|
if isinstance(value, Html) or not hasattr(value, '__iter__'):
|
|
|
|
|
value = [value]
|
|
|
|
|
self[1:-1] = value
|
|
|
|
|
#
|
|
|
|
|
def __delinside(self):
|
|
|
|
|
"""
|
|
|
|
|
Removes contents between opening and closing tag
|
|
|
|
|
"""
|
|
|
|
|
if len(self) > 2:
|
|
|
|
|
self[:] = self[:1] + self[-1:]
|
|
|
|
|
inside = property(__getinside, __setinside, __delinside)
|
2009-06-02 19:23:38 +00:00
|
|
|
#
|
|
|
|
|
def __enter__(self):
|
|
|
|
|
return self
|
|
|
|
|
#
|
|
|
|
|
def __exit__(self, exc_type, exc_val, exc_tb):
|
|
|
|
|
return exc_type is None
|
2009-03-03 17:53:35 +00:00
|
|
|
|
2009-03-23 14:42:37 +00:00
|
|
|
# ------------------------------------------
|
|
|
|
|
#
|
|
|
|
|
# Register Plugin
|
|
|
|
|
#
|
|
|
|
|
# -------------------------------------------
|
|
|
|
|
|
2009-04-02 19:53:30 +00:00
|
|
|
try:
|
|
|
|
|
PluginManager.get_instance().register_plugin(
|
|
|
|
|
Plugin(
|
|
|
|
|
name = __name__,
|
|
|
|
|
description = _("Manages an HTML DOM tree."),
|
|
|
|
|
module_name = __name__
|
|
|
|
|
)
|
|
|
|
|
)
|
|
|
|
|
except NameError:
|
|
|
|
|
print 'Plugin not registered.'
|
