xsdata.formats.dataclass.parsers package

Submodules

• xsdata.formats.dataclass.parsers.config module
• xsdata.formats.dataclass.parsers.json module
• xsdata.formats.dataclass.parsers.nodes module
• xsdata.formats.dataclass.parsers.utils module
• xsdata.formats.dataclass.parsers.xml module

Module contents

class xsdata.formats.dataclass.parsers.JsonParser(context=<factory>)

Bases: xsdata.formats.bindings.AbstractParser

Json parsing and binding for dataclasses.

Parameters

context (XmlContext) – Model metadata builder

context: XmlContext

from_path(path, clazz)

Parse the input file path and return the resulting object tree.

Parameters

• path (Path) –

• clazz (Type[~T]) –

Return type

~T

parse(source, clazz)

Parse the JSON input stream and return the resulting object tree.

Parameters

• source (BytesIO) –

• clazz (Type[~T]) –

Return type

~T

parse_context(data, clazz)

Recursively build the given model from the input dict data.

Raises

ParserError – When parsing fails for any reason

Parameters

• data (Dict) –

• clazz (Type[~T]) –

Return type

~T

bind_value(var, value)

Bind value according to the class var.

The return value can be: - a dataclass instance - a dictionary with unknown attributes - a list of unknown elements - an enumeration - a primitive value

Parameters

• var (XmlVar) –

• value (Any) –

Return type

Any

static get_value(data, var)

Find the var value in the given dictionary or return the default var value.

Parameters

• data (Dict) –

• var (XmlVar) –

Return type

Any

class xsdata.formats.dataclass.parsers.XmlParser(config=<factory>, context=<factory>)

Bases: xsdata.formats.dataclass.parsers.nodes.NodeParser, xsdata.formats.bindings.AbstractParser

Xml parsing and binding for dataclasses.

Parameters

• config (ParserConfig) –

• context (XmlContext) –

event_names: Dict

parse(source, clazz)

Parse the XML input stream and return the resulting object tree.

Parameters

• source (Any) –

• clazz (Type[~T]) –

Return type

~T

queue(element, queue, objects)

Queue the next xml node for parsing based on the given element qualified name.

Parameters

• element (Element) –

• queue (List[ForwardRef]) –

• objects (List[Tuple[QName, Any]]) –

dequeue(element, queue, objects)

Use the last xml node to parse the given element and bind any child objects.

Return type

Any

Returns

Any: A dataclass instance or a python primitive value or None

Parameters

• element (Element) –

• queue (List[ForwardRef]) –

• objects (List[Tuple[QName, Any]]) –

emit_event(event, name, **kwargs)

Call if exist the parser’s hook for the given element and event.

Parameters

• event (str) –

• name (str) –

• kwargs (Any) –