xml_ – XML handling

Methods for creating, parsing, and dealing with XML and ElementTree objects.

exception ncclient.xml_.XMLError

Bases: NCClientError

Namespaces

ncclient.xml_.BASE_NS_1_0 = 'urn:ietf:params:xml:ns:netconf:base:1.0'

Base NETCONF namespace

ncclient.xml_.TAILF_AAA_1_1 = 'http://tail-f.com/ns/aaa/1.1'

Namespace for Tail-f core data model

ncclient.xml_.TAILF_EXECD_1_1 = 'http://tail-f.com/ns/execd/1.1'

Namespace for Tail-f execd data model

ncclient.xml_.CISCO_CPI_1_0 = 'http://www.cisco.com/cpi_10/schema'

Namespace for Cisco data model

ncclient.xml_.JUNIPER_1_1 = 'http://xml.juniper.net/xnm/1.1/xnm'

Namespace for Juniper 9.6R4. Tested with Junos 9.6R4+

ncclient.xml_.FLOWMON_1_0 = 'http://www.liberouter.org/ns/netopeer/flowmon/1.0'

Namespace for Flowmon data model

ncclient.xml_.register_namespace(prefix, uri)

Registers a namespace prefix that newly created Elements in that namespace will use. The registry is global, and any existing mapping for either the given prefix or the namespace URI will be removed.

ncclient.xml_.qualify(tag, ns='urn:ietf:params:xml:ns:netconf:base:1.0')

Qualify a tag name with a namespace, in ElementTree fashion i.e. {namespace}tagname.

Conversion

ncclient.xml_.to_xml(ele, encoding='UTF-8', pretty_print=False)

Convert and return the XML for an ele (Element) with specified encoding.

ncclient.xml_.to_ele(x, huge_tree=False)

Convert and return the Element for the XML document x. If x is already an Element simply returns that.

huge_tree: parse XML with very deep trees and very long text content

ncclient.xml_.parse_root(raw)

Efficiently parses the root element of a raw XML document, returning a tuple of its qualified name and attribute dictionary.

ncclient.xml_.validated_element(x, tags=None, attrs=None)

Checks if the root element of an XML document or Element meets the supplied criteria.

tags if specified is either a single allowable tag name or sequence of allowable alternatives

attrs if specified is a sequence of required attributes, each of which may be a sequence of several allowable alternatives

Raises XMLError if the requirements are not met.