lxml.objectify

Package lxml :: Module objectify

[show private | hide private]

Module lxml.objectify

Function Summary
	`annotate(...)` Recursively annotates the elements of an XML tree with 'pytype' attributes.
	`DataElement(...)` Create a new element with a Python value and XML attributes taken from keyword arguments or a dictionary passed as second argument.
	`deannotate(...)` Recursively de-annotate the elements of an XML tree by removing 'pytype' and/or 'type' attributes.
	`dump(...)` Return a recursively generated string representation of an element.
	`Element(...)` Objectify specific version of the lxml.etree Element() factory that always creates a structural (tree) element.
	`enableRecursiveStr(...)` Enable a recursively generated tree representation for str(element), based on objectify.dump(element).
	`fromstring(...)` Objectify specific version of the lxml.etree fromstring() function.
	`getRegisteredTypes(...)` Returns a list of the currently registered PyType objects.
	`parse(...)`
	`set_default_parser(...)` Replace the default parser used by objectify's Element() and fromstring() functions.
	`setDefaultParser(...)`
	`setPytypeAttributeTag(...)` Changes name and namespace of the XML attribute that holds Python type information.
	`XML(...)` Objectify specific version of the lxml.etree fromstring() function.

Variable Summary
`str`	`__version__` = `'1.3.3-45352'`
`ElementMaker`	`E` = `<objectify.ElementMaker object at 0x8207bac>`
`str`	`PYTYPE_ATTRIBUTE` = `'{http://codespeak.net/lxml/objectify...`

Function Details

annotate(...)

Recursively annotates the elements of an XML tree with 'pytype' attributes.

If the 'ignore_old' keyword argument is True (the default), current 'pytype' attributes will be ignored and replaced. Otherwise, they will be checked and only replaced if they no longer fit the current text value.

DataElement(...)

Create a new element with a Python value and XML attributes taken from keyword arguments or a dictionary passed as second argument.

Automatically adds a 'pytype' attribute for the Python type of the value, if the type can be identified. If '_pytype' or '_xsi' are among the keyword arguments, they will be used instead.

deannotate(...)

Recursively de-annotate the elements of an XML tree by removing 'pytype' and/or 'type' attributes.

If the 'pytype' keyword argument is True (the default), 'pytype' attributes will be removed. If the 'xsi' keyword argument is True (the default), 'xsi:type' attributes will be removed.

dump(...)

Return a recursively generated string representation of an element.

Element(...)

Objectify specific version of the lxml.etree Element() factory that always creates a structural (tree) element.

NOTE: requires parser based element class lookup activated in lxml.etree!

enableRecursiveStr(...)

Enable a recursively generated tree representation for str(element), based on objectify.dump(element).

fromstring(...)

Objectify specific version of the lxml.etree fromstring() function.

NOTE: requires parser based element class lookup activated in lxml.etree!

getRegisteredTypes(...)

Returns a list of the currently registered PyType objects.

To add a new type, retrieve this list and call unregister() for all entries. Then add the new type at a suitable position (possibly replacing an existing one) and call register() for all entries.

This is necessary if the new type interferes with the type check functions of existing ones (normally only int/float/bool) and must the tried before other types. To add a type that is not yet parsable by the current type check functions, you can simply register() it, which will append it to the end of the type list.

set_default_parser(...)

Replace the default parser used by objectify's Element() and fromstring() functions.

The new parser must be an etree.XMLParser.

Call without arguments to reset to the original parser.

setPytypeAttributeTag(...)

Changes name and namespace of the XML attribute that holds Python type information.

Reset by calling without argument.

Default: "{http://codespeak.net/lxml/objectify/pytype}pytype"

XML(...)

Objectify specific version of the lxml.etree fromstring() function.

NOTE: requires parser based element class lookup activated in lxml.etree!

Variable Details

version

Type:: str
Value:: '1.3.3-45352'

E

Type:: ElementMaker
Value:: <objectify.ElementMaker object at 0x8207bac>

PYTYPE_ATTRIBUTE

Type:: str
Value:: '{http://codespeak.net/lxml/objectify/pytype}pytype'

Generated by Epydoc 2.1 on Thu Jul 26 19:14:08 2007

http://epydoc.sf.net

Module lxml.objectify

annotate(...)

DataElement(...)

deannotate(...)

dump(...)

Element(...)

enableRecursiveStr(...)

fromstring(...)

getRegisteredTypes(...)

set_default_parser(...)

setPytypeAttributeTag(...)

XML(...)

__version__

E

PYTYPE_ATTRIBUTE

version