Skip to content

cdm_data_loaders.utils.xml_utils

Shared XML helper utilities used by XML readers and converters.

This module centralizes common operations: - Safe text extraction - Local (namespace-stripped) XML tag/attribute name extraction

get_text 

get_text(
    elem: Element | None, default: str | None = None
) -> str | None

Return elem.text if exists and non-empty.

Source code in src/cdm_data_loaders/utils/xml_utils.py 
11
12
13
14
15
16
17
18
def get_text(elem: Element | None, default: str | None = None) -> str | None:
    """Return elem.text if exists and non-empty."""
    if elem is None:
        return default
    if elem.text is None:
        return default
    text = elem.text.strip()
    return text or default

local_name 

local_name(tag: str) -> str

Return the local (namespace-stripped) part of an XML tag or attribute name.

Handles Clark notation ("{http://example.com}entry" -> "entry") and returns already-unprefixed names unchanged.

Source code in src/cdm_data_loaders/utils/xml_utils.py 
21
22
23
24
25
26
27
def local_name(tag: str) -> str:
    """Return the local (namespace-stripped) part of an XML tag or attribute name.

    Handles Clark notation (``"{http://example.com}entry"`` -> ``"entry"``) and returns
    already-unprefixed names unchanged.
    """
    return tag.rsplit("}", 1)[-1] if isinstance(tag, str) and "}" in tag else tag