Method from_xml

src/pptx/enum/base.py:54–79

Enumeration member corresponding to XML attribute value `xml_value`. Raises `ValueError` if `xml_value` is the empty string ("") or is not an XML attribute value registered on the enumeration. Note that enum members that do not correspond to one of the defined values for an

(cls, xml_value: str)

    @classmethod
    def from_xml(cls, xml_value: str) -> Self:
        """Enumeration member corresponding to XML attribute value `xml_value`.

        Raises `ValueError` if `xml_value` is the empty string ("") or is not an XML attribute
        value registered on the enumeration. Note that enum members that do not correspond to one
        of the defined values for an XML attribute have `xml_value == ""`. These
        "return-value only" members cannot be automatically mapped from an XML attribute value and
        must be selected explicitly by code, based on the appropriate conditions.

        Example::

            >>> WD_PARAGRAPH_ALIGNMENT.from_xml("center")
            WD_PARAGRAPH_ALIGNMENT.CENTER

        """
        # -- the empty string never maps to a member --
        member = (
            next((member for member in cls if member.xml_value == xml_value), None)
            if xml_value
            else None
        )

        if member is None:
            raise ValueError(f"{cls.__name__} has no XML mapping for {repr(xml_value)}")

        return member

    @classmethod
    def to_xml(cls: Type[_T], value: int | _T) -> str: