Parsing XML with Namespaces in Python's ElementTree

Using namespace dictionary is the recommended method for handling XML namespaces in ElementTree, which can improve code readability and maintainability; 2. Element matching can be performed through the format of the {namespace URI} tag name, but repeated input of a complete URI will reduce efficiency; 3. For the default namespace, prefixes must be explicitly defined during search, even if there is no prefix in XML; 4. The namespace URI must be exactly matched, including case and slashes; 5. During debugging, you can view the actual namespace qualified names by traversing the element's tag attributes. Correctly using namespace mapping and precisely matching URIs is the key to successful parsing, and ultimately, you can effectively locate elements with namespaces and obtain the required data.

When parsing XML with namespaces in Python using xml.etree.ElementTree (commonly called ElementTree), things can get tricky because namespaces change how element names are matched. If you don't handle them correctly, your find() , findall() , or iter() calls might return nothing — even when the elements exist.

Here's how to work with XML namespaces effectively in ElementTree.

Understanding XML Namespaces

Consider this XML snippet:

 <root xmlns:ns="http://example.com/ns">
  <ns:child id="1">Content</ns:child>
  <ns:child id="2">More content</ns:child>
</root>

Here, the ns prefix refers to the namespace http://example.com/ns . The actual name of the <ns:child> element is not just "child" — it's a combination of the namespace URI and the local name.

In ElementTree, you must include the full namespace URI when searching for such elements.

Method 1: Using Namespace Dictionaries

The cleanest and most readable way is to define a namespace map:

 import xml.etree.ElementTree as ET

# Example XML string
xml_data = &#39;&#39;&#39;<root xmlns:ns="http://example.com/ns">
                <ns:child id="1">Content</ns:child>
                <ns:child id="2">More content</ns:child>
              </root>&#39;&#39;&#39;

# Parse the XML
root = ET.fromstring(xml_data)

# Define namespace dictionary
namespaces = {&#39;ns&#39;: &#39;http://example.com/ns&#39;}

# Find all ns:child elements
children = root.findall(&#39;ns:child&#39;, namespaces)

for child in children:
    print(child.text, child.get(&#39;id&#39;))

Output:

 Content 1
More content 2

✅ This method is recommended because it's clear, reusable, and avoids repetition.

? You can use any prefix in the dictionary (eg, 'x' instead of 'ns' ) as long as the URI matches. ElementTree matches the URI, not the prefix.

Method 2: Full Namespace Syntax (Curly Braces)

ElementTree also supports "universal" namespace matching using the format {namespace}tagname :

 children = root.findall('{http://example.com/ns}child')

This avoids passing a namespace dictionary but is less readable and harder to maintain if the namespace appears multiple times.

Example:

 children = root.findall('{http://example.com/ns}child')
for child in children:
    print(child.text)

This works, but imagine typing that full URI every time — not ideal.

Handling Default Namespaces

Default namespaces (without a prefix) are common and slightly more confusing:

 <root xmlns="http://example.com/default">
  <child>Default content</child>
</root>

Here, both root and child belong to the default namespace.

You still need to use a prefix in the lookup , even though the XML doesn't have one:

 xml_data = &#39;&#39;&#39;<root xmlns="http://example.com/default">
                <child>Default content</child>
              </root>&#39;&#39;&#39;

root = ET.fromstring(xml_data)
namespaces = {&#39;default&#39;: &#39;http://example.com/default&#39;}

child = root.find(&#39;default:child&#39;, namespaces)
print(child.text) # Output: Default content

? You cannot do find('child') — it won't match.

Tips and Gotchas

• Namespace URIs must be exactly — even a trailing slash difference will break matching.
• Use consistent namespace prefixes in your code for clarity.
• If you're unsure about the structure, inspect tags directly:

 for elem in root.iter():
    print(elem.tag)

This will print something like {http://example.com/ns}child , showing you the full namespace tag format.

• When working with files:

 tree = ET.parse('data.xml')
root = tree.getroot()

Same rules apply.

Summary

To parse XML with namespaces in ElementTree:

1. ✅ Always use a namespace dictionary for readability.
2. ✅ Match using {uri}localname or prefix:localname with a namespace map.
3. ❌ Never assume unprefixed tag names will work if a default namespace is present.
4. ? Inspect elem.tag values ​​during debugging to see actual namespace-qualified names.

Basically, namespaces add verbosity, but once you use a consistent map, it's manageable.

The above is the detailed content of Parsing XML with Namespaces in Python's ElementTree. For more information, please follow other related articles on the PHP Chinese website!