Next / Previous / Contents / Shipman's homepage

6.20. block(): The basic block element

block(s, *p, **kw)

This function starts a block element, and returns a sox.Elt token that you must use later to write the end tag. Between these operations you will generate the content of the block.

For a discussion of how positional and keyword arguments work in this function, refer to design-notes and also the reference documentation for Sequential Output of XML for Python. The idea is to allow a number of different kinds of arguments that give you easy ways to generate elements, attributes, and content.