Class CT_Relationship

src/pptx/opc/oxml.py:92–120

` ` element. Represents a single relationship from a source to a target part.

class CT_Relationship(BaseOxmlElement):
    """`<Relationship>` element.

    Represents a single relationship from a source to a target part.
    """

    rId: str = RequiredAttribute("Id", XsdId)  # pyright: ignore[reportAssignmentType]
    reltype: str = RequiredAttribute("Type", XsdAnyUri)  # pyright: ignore[reportAssignmentType]
    target_ref: str = RequiredAttribute(  # pyright: ignore[reportAssignmentType]
        "Target", XsdAnyUri
    )
    targetMode: str = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
        "TargetMode", ST_TargetMode, default=RTM.INTERNAL
    )

    @classmethod
    def new(
        cls, rId: str, reltype: str, target_ref: str, target_mode: str = RTM.INTERNAL
    ) -> CT_Relationship:
        """Return a new `<Relationship>` element.

        `target_ref` is either a partname or a URI.
        """
        relationship = cast(CT_Relationship, parse_xml(f'<Relationship xmlns="{nsmap["pr"]}"/>'))
        relationship.rId = rId
        relationship.reltype = reltype
        relationship.target_ref = target_ref
        relationship.targetMode = target_mode
        return relationship


class CT_Relationships(BaseOxmlElement):