Ñò
ûãtHc @ sâ d Z d d k l Z y e Wn# e j
o d d k l Z n Xd d k Z d d k l Z l
Z
l Z l Z l
Z
l Z d d k l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z l Z d d d d
d d d
g Z d Z d d d d „ Z d d „ Z d e f d „ ƒ YZ! d
e f d „ ƒ YZ" d e" f d „ ƒ YZ# d e# f d „ ƒ YZ$ d
e f d „ ƒ YZ% d e f d „ ƒ YZ& e& i' Z' d e f d „ ƒ YZ( d e f d „ ƒ YZ) d e f d „ ƒ YZ* d S( sU This module provides different kinds of serialization methods for XML event
streams.
iÿÿÿÿ( t chain( t ImmutableSetN( t escapet Attrst Markupt Namespacet QNamet StreamEventKind( t STARTt ENDt TEXTt XML_DECLt DOCTYPEt START_NSt END_NSt START_CDATAt END_CDATAt PIt COMMENTt
XML_NAMESPACEt encodet get_serializert DocTypet
XMLSerializert XHTMLSerializert HTMLSerializert TextSerializers restructuredtext ent xmls utf-8c s© ˆ d j oD d ‰ | d j o t | t ƒ o
d ‰ n ‡ ‡ f d † } n
d „ } | d j o | d i t | ƒ ƒ ƒ Sx! | D] } | i | | ƒ ƒ qˆ Wd S( sß Encode serializer output into a string.
:param iterator: the iterator returned from serializing a stream (basically
any iterator that yields unicode objects)
:param method: the serialization method; determines how characters not
representable in the specified encoding are treated
:param encoding: how the output string should be encoded; if set to `None`,
this method returns a `unicode` object
:param out: a file-like object that the output should be written to
instead of being returned as one big string; note that if
this is a file or socket (or similar), the `encoding` must
not be `None` (that is, the output must be encoded)
:return: a `str` or `unicode` object (depending on the `encoding`
parameter), or `None` if the `out` parameter is provided
:since: version 0.4.1
:note: Changed in 0.5: added the `out` parameter
t replacet textt xmlcharrefreplacec s | i ˆ ˆ ƒ S( ( R ( t string( t errorst encoding( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt 8 s c S s | S( ( ( R ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR" : s u N( t Nonet
isinstanceR t joint listt write( t iteratort methodR! t outt _encodet chunk( ( R R! s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR ! s
c K sJ t | t ƒ o0 h t d 6t d 6t d 6t d 6| i ƒ } n | | S( s® Return a serializer object for the given method.
:param method: the serialization method; can be either "xml", "xhtml",
"html", "text", or a custom serializer class
Any additional keyword arguments are passed to the serializer, and thus
depend on the `method` parameter value.
:see: `XMLSerializer`, `XHTMLSerializer`, `HTMLSerializer`, `TextSerializer`
:since: version 0.4.1
R t xhtmlt htmlR ( R$ t
basestringR R R R t lower( R) t kwargs( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR @ s
c B sw e Z d Z d Z d Z d Z e Z d Z d Z d Z
d Z e Z d Z
d! Z d" Z d# Z e Z d „ Z e e ƒ Z RS($ sD Defines a number of commonly used DOCTYPE declarations as constants.R. s -//W3C//DTD HTML 4.01//ENs% http://www.w3.org/TR/html4/strict.dtds& -//W3C//DTD HTML 4.01 Transitional//ENs$ http://www.w3.org/TR/html4/loose.dtds" -//W3C//DTD HTML 4.01 Frameset//ENs' http://www.w3.org/TR/html4/frameset.dtds -//W3C//DTD XHTML 1.0 Strict//ENs1 http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtds& -//W3C//DTD XHTML 1.0 Transitional//ENs7 http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtds" -//W3C//DTD XHTML 1.0 Frameset//ENs3 http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtds -//W3C//DTD XHTML 1.1//ENs, http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtdt svgs -//W3C//DTD SVG 1.1//ENs0 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtds -//W3C//DTD SVG Basic 1.1//ENs6 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtds -//W3C//DTD SVG Tiny 1.1//ENs5 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtdc C sŸ h | i d 6| i d 6t i d 6t i d 6| i d 6| i d 6| i d 6| i d 6| i d 6| i
d
6| i d 6| i d 6| i
d
6| i d 6i | i ƒ ƒ S( s Return the ``(name, pubid, sysid)`` tuple of the ``DOCTYPE``
declaration for the specified name.
The following names are recognized in this version:
* "html" or "html-strict" for the HTML 4.01 strict DTD
* "html-transitional" for the HTML 4.01 transitional DTD
* "html-frameset" for the HTML 4.01 frameset DTD
* "html5" for the ``DOCTYPE`` proposed for HTML5
* "xhtml" or "xhtml-strict" for the XHTML 1.0 strict DTD
* "xhtml-transitional" for the XHTML 1.0 transitional DTD
* "xhtml-frameset" for the XHTML 1.0 frameset DTD
* "xhtml11" for the XHTML 1.1 DTD
* "svg" or "svg-full" for the SVG 1.1 DTD
* "svg-basic" for the SVG Basic 1.1 DTD
* "svg-tiny" for the SVG Tiny 1.1 DTD
:param name: the name of the ``DOCTYPE``
:return: the ``(name, pubid, sysid)`` tuple for the requested
``DOCTYPE``, or ``None`` if the name is not recognized
:since: version 0.4.1
R. s html-stricts html-transitionals
html-framesett html5R- s xhtml-stricts xhtml-transitionals xhtml-framesett xhtml11R2 s svg-fulls svg-basics svg-tiny( t HTMLt HTML_STRICTR t HTML_TRANSITIONALt
HTML_FRAMESETt HTML5t XHTMLt XHTML_STRICTt XHTML_TRANSITIONALt XHTML_FRAMESETt XHTML11t SVGt SVG_FULLt SVG_BASICt SVG_TINYt getR0 ( t clst name( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRC ˆ s
( s htmls -//W3C//DTD HTML 4.01//ENs% http://www.w3.org/TR/html4/strict.dtd( s htmls& -//W3C//DTD HTML 4.01 Transitional//ENs$ http://www.w3.org/TR/html4/loose.dtd( s htmls" -//W3C//DTD HTML 4.01 Frameset//ENs' http://www.w3.org/TR/html4/frameset.dtdN( s htmlNN( s htmls -//W3C//DTD XHTML 1.0 Strict//ENs1 http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd( s htmls& -//W3C//DTD XHTML 1.0 Transitional//ENs7 http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd( s htmls" -//W3C//DTD XHTML 1.0 Frameset//ENs3 http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd( s htmls -//W3C//DTD XHTML 1.1//ENs, http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd( s svgs -//W3C//DTD SVG 1.1//ENs0 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd( s svgs -//W3C//DTD SVG Basic 1.1//ENs6 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd( s svgs -//W3C//DTD SVG Tiny 1.1//ENs5 http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd( t __name__t
__module__t __doc__R6 R7 R8 R5 R# R9 R; R< R= R: R> R@ RA RB R? RC t classmethod( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR T s6 #c B s2 e Z d Z e ƒ Z d e d d „ Z d „ Z RS( s Produces XML text from an event stream.
>>> from genshi.builder import tag
>>> elem = tag.div(tag.a(href='foo'), tag.br, tag.hr(noshade=True))
>>> print ''.join(XMLSerializer()(elem.generate()))
c C sq t ƒ g | _ | o | i i t | i ƒ ƒ n | i i t d | ƒ ƒ | o | i i t | ƒ ƒ n d S( s Initialize the XML serializer.
:param doctype: a ``(name, pubid, sysid)`` tuple that represents the
DOCTYPE declaration that should be included at the top
of the generated output, or the name of a DOCTYPE as
defined in `DocType.get`
:param strip_whitespace: whether extraneous whitespace should be
stripped from the output
:note: Changed in 0.4.2: The `doctype` parameter can now be a string.
t prefixesN( t EmptyTagFiltert filterst appendt WhitespaceFiltert _PRESERVE_SPACEt NamespaceFlattenert DocTypeInserter( t selft doctypet strip_whitespacet namespace_prefixes( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt __init__¹ s c
c s t } } t } x | i D] } | | ƒ } q Wxé| D]á\ } } } | t j p
| t j o‡ | \ } }
d | g } x3 |
D]+ \ } }
| d | d t |
ƒ d g 7} q W| i | t j o d p d ƒ t d i | ƒ ƒ Vq7 | t j o t d | ƒ Vq7 | t j o% | o | Vqt | d t ƒVq7 | t
j o t d
| ƒ Vq7 | t j o¡ | o™ | \ } } } d | g } | o | i d | ƒ n | d
j o) | o d p d } | i d | ƒ n | i d ƒ t d i | ƒ ƒ Vt } q7 | t
j o | o˜ | \ } } } d g } | o | i d ƒ n | o | i d ƒ n | o | i d ƒ n | i d ƒ t d i | ƒ ƒ t d | ƒ Vt } q7 | t j o t d ƒ Vt } q7 | t j o t d ƒ Vt } q7 | t j o t d | ƒ Vq7 q7 Wd S( Nt t >u s t quotess s
s
s s ( t FalseRL R t EMPTYR RM R R% R R
R R t TrueR t filterR# R R R ( RR t streamt have_declt have_doctypet in_cdatat filter_t kindt datat post tagt attribt buft attrt valuet versionR! t
standaloneRE t pubidt sysid( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt __call__Ì sl
#!
!
N( RF RG RH t frozensetRO R# R` RV Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR ® s
c B s¿ e Z d Z e d d d d d d d d d d
d d d
g
ƒ Z e d d d d d d d d d d d d g ƒ Z e e d ƒ e d ƒ e d ƒ e d ƒ g ƒ Z d e d e d „ Z
d „ Z RS(! s Produces XHTML text from an event stream.
>>> from genshi.builder import tag
>>> elem = tag.div(tag.a(href='foo'), tag.br, tag.hr(noshade=True))
>>> print ''.join(XHTMLSerializer()(elem.generate()))
t areat baset basefontt brt colt framet hrt imgt inputt isindext linkt metat paramt selectedt checkedt compactt declaret defert disabledt ismapt multiplet nohreft noresizet noshadet nowrapt pres http://www.w3.org/1999/xhtml}pret textareas% http://www.w3.org/1999/xhtml}textareac C sª t t | ƒ i | t ƒ t ƒ g | _ | o | i i t | i ƒ ƒ n | p h } d | d <| i i t d | ƒ ƒ | o | i i t
| ƒ ƒ n | | _ d S( Nt s http://www.w3.org/1999/xhtmlRJ ( t superR RV R^ RK RL RM RN RO RP RQ t
drop_xml_decl( RR RS RT RU R’ ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRV ! s
c
c sÑ | i } | i } | i } t } } t } x | i D] } | | ƒ } q5 Wx| D]w\ } }
} | t j p
| t j o|
\ } }
d | g } x• |
D] \ } } | | j o
| } nL | d j o* d |
j o | d t | ƒ d g 7} n | d j o qš n | d | d t | ƒ d g 7} qš W| t j o3 | | j o | i d ƒ qx| i d
| ƒ n | i d ƒ t d i
| ƒ ƒ VqR | t j o t d
|
ƒ VqR | t j o% | o |
VqÉt |
d t ƒVqR | t
j o t d |
ƒ VqR | t j o | o˜ |
\ } } } d g } | o | i d ƒ n | o | i d ƒ n | o | i d ƒ n | i d ƒ t d i
| ƒ ƒ t d |
ƒ Vt } qR | t j o© | o¡ | o™ |
\ } } } d | g } | o | i d | ƒ n | d j o) | o d p d } | i d | ƒ n | i d ƒ t d i
| ƒ ƒ Vt } qR | t j o t d ƒ Vt } qR | t j o t d ƒ Vt } qR | t j o t d |
ƒ VqR qR Wd S( NRW u xml:langu langs lang="RY u xml:spaceRX s ="s />s >RZ u s R[ s s
s
s s ( t _BOOLEAN_ATTRSt _EMPTY_ELEMSR’ R^ RL R R_ R RM R R% R R
R R Ra R# R` R R R R ( RR Rb t
boolean_attrst empty_elemsR’ Rc Rd Re Rf Rg Rh Ri Rj Rk Rl Rm Rn RE Rq Rr Ro R! Rp ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRs . s†
#
!
N( RF RG RH Rt R” R“ R RO R# R` RV Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR
s c B sV e Z d Z e e d ƒ e d ƒ e d ƒ e d ƒ g ƒ Z d e d „ Z d „ Z RS( s Produces HTML text from an event stream.
>>> from genshi.builder import tag
>>> elem = tag.div(tag.a(href='foo'), tag.br, tag.hr(noshade=True))
>>> print ''.join(HTMLSerializer()(elem.generate()))
t scripts# http://www.w3.org/1999/xhtml}scriptt styles" http://www.w3.org/1999/xhtml}stylec C s— t t | ƒ i | t ƒ t ƒ g | _ | o# | i i t | i | i ƒ ƒ n | i i t
d h d d 6ƒ ƒ | o | i i t | ƒ ƒ n d S( s€ Initialize the HTML serializer.
:param doctype: a ``(name, pubid, sysid)`` tuple that represents the
DOCTYPE declaration that should be included at the top
of the generated output
:param strip_whitespace: whether extraneous whitespace should be
stripped from the output
RJ R s http://www.w3.org/1999/xhtmlN( R‘ R RV R^ RK RL RM RN RO t _NOESCAPE_ELEMSRP RQ ( RR RS RT ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRV Œ s c
c s | i } | i } | i } t } t } x | i D] } | | ƒ } q1 Wx¸| D]°\ } } }
| t j p
| t j oB| \ } } d | g }
x¸ | D]° \ } } | | j o | o |
d | g 7}
qFq– d | j o; | d j o* d | j o |
d t | ƒ d g 7}
qFq– | d j o# |
d | d t | ƒ d g 7}
q– q– W|
i d
ƒ | t j o& | | j o |
i d | ƒ qŠn t d i
|
ƒ ƒ V| | j o
t } qþqN | t j o t d | ƒ Vt } qN | t
j o% | o | Vqþt | d
t ƒVqN | t j o t d | ƒ VqN | t j o | o˜ | \ } } } d g }
| o |
i d ƒ n | o |
i d ƒ n | o |
i d ƒ n |
i d ƒ t d i
|
ƒ ƒ t d | ƒ Vt } qN | t j o t d | ƒ VqN qN Wd S( NRW RX t :s xml:langu langs lang="RY t xmlnss ="RZ s u R[ s s
s ( R“ R” R™ R^ RL R R_ R RM R R% R` R R
R R Ra R# R ( RR Rb R• R– t noescape_elemsRd t noescapeRf Rg Rh Ri Rj Rk Rl Rm Rn RE Rq Rr ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRs sj
!
'
!
N(
RF RG RH Rt R R™ R# R` RV Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR ~ s c B s# e Z d Z e d „ Z d „ Z RS( sý Produces plain text from an event stream.
Only text events are included in the output. Unlike the other serializer,
special XML characters are not escaped:
>>> from genshi.builder import tag
>>> elem = tag.div(tag.a('', href='foo'), tag.br)
>>> print elem
>>> print ''.join(TextSerializer()(elem.generate()))
If text events contain literal markup (instances of the `Markup` class),
that markup is by default passed through unchanged:
>>> elem = tag.div(Markup('Hello & Bye!
'))
>>> print elem.generate().render(TextSerializer)
Hello & Bye!
You can use the ``strip_markup`` to change this behavior, so that tags and
entities are stripped from the output (or in the case of entities,
replaced with the equivalent character):
>>> print elem.generate().render(TextSerializer, strip_markup=True)
Hello & Bye!
c C s
| | _ d S( s³ Create the serializer.
:param strip_markup: whether markup (tags and encoded characters) found
in the text should be removed
N( t strip_markup( RR Rž ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRV ù s c c sx | i } xh | D]` } | d t j oI | d } | o) t | ƒ t j o | i ƒ i ƒ } n t | ƒ Vq q Wd S( Ni i ( Rž R
t typeR t striptagst
stripentitiest unicode( RR Rb Rž t eventRh ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRs s
( RF RG RH R^ RV Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyR Ý s RK c B s# e Z d Z e d ƒ Z d „ Z RS( sc Combines `START` and `STOP` events into `EMPTY` events for elements that
have no contents.
R_ c c s‰ d } x| | D]t } | d t j o= | d t j o# t | d | d f } | Vq
qa | Vn | d t j o | Vn | } q
Wd S( Ni i i ( NNN( R# R R R_ ( RR Rb t prevt ev( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRs s ( RF RG RH R R_ Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRK s RP c B s# e Z d Z d d „ Z d „ Z RS( si Output stream filter that removes namespace information from the stream,
instead adding namespace attributes and prefixes as needed.
:param prefixes: optional mapping of namespace URIs to prefixes
>>> from genshi.input import XML
>>> xml = XML('''
...
... ''')
>>> for kind, data, pos in NamespaceFlattener()(xml):
... print kind, repr(data)
START (u'doc', Attrs([(u'xmlns', u'NS1'), (u'xmlns:two', u'NS2')]))
TEXT u'\n '
START (u'two:item', Attrs())
END u'two:item'
TEXT u'\n'
END u'doc'
c C s8 h d t i 6| _ | d j o | i i | ƒ n d S( NR ( R t uriRJ R# t update( RR RJ ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRV 8 s
c # sÉ t g } | i i ƒ D] \ } } | | | g f q ~ ƒ ‰ h d g t i 6‰ ‡ ‡ f d † } g } | i } d „ } d „ } | ƒ i } x1| D])\ }
} } |
t j p
|
t j oW| \ }
} |
i } |
i
} | o[ | ˆ j o- ˆ | d } | o d | | f } q=qA| d | f ƒ | d | ƒ n g } x¨ | D] \ } } | i } | i
} | oh | ˆ j o. | ƒ } | | | ƒ | d | | f ƒ n ˆ | d } | o d | | f } qÛn | i | | f ƒ qNW|
| t | | ƒ f | f V| 2q˜ |
t j oX | i } | i
} | o- ˆ | d } | o d | | f } qkn |
| | f Vq˜ |
t
j oZ | \ } } | ˆ j o0 ˆ i | | g ƒ d } | | | | ƒ ƒ n | | | ƒ q˜ |
t j o | ˆ j o± ˆ i | ƒ } | i ƒ } | p ˆ | =n | | j p | | d j o* ˆ | } | i ƒ | p ˆ | =qsn | o1 | | | ƒ } | | j o | i | ƒ q«q¯qÁq˜ |
| | f Vq˜ Wd S(
NR c s6 ˆ i | g ƒ i | ƒ ˆ i | g ƒ i | ƒ d S( N( t
setdefaultRM ( t prefixR¦ ( RJ t
namespaces( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt _push_ns@ s c S s d | o d | p d | f S( Nu xmlns%ss :%sR ( ( R© R¦ ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt
_make_ns_attrF s c s s# d } x | d 7} d | Vq d S( Ni i s ns%d( ( t val( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyt _gen_prefixI s
iÿÿÿÿu %s:%su xmlnsR s xmlns:%s( t dictRJ t itemsR R¦ RM t nextR R_ t localnamet namespaceR R R
RC R t popt remove( RR Rb t _[1]t kt vR« t ns_attrst
_push_ns_attrR¬ R® Rg Rh Ri Rj t attrst tagnamet tagnsR© t new_attrsRm Rn t attrnamet attrnsR¦ t urist uri_prefixes( ( RJ Rª s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRs = s† ?
N( RF RG RH R# RV Rs ( ( ( s3 /usr/lib64/python2.6/site-packages/genshi/output.pyRP $ s RN c B sN e Z d Z d d d „ Z d e d e i d ƒ i e i d ƒ i d „ Z RS( sP A filter that removes extraneous ignorable white space from the
stream.
c C sP | d j o
g } n t | ƒ | _ | d j o
g } n t | ƒ | _ d S( sÚ Initialize the filter.
:param preserve: a set or sequence of tag names for which white-space
should be preserved
:param noescape: a set or sequence of tag names for which text content
should not be escaped
The `noescape` set is expected to refer to elements that cannot contain
further child elements (such as ``