o Z2h@sndZddlmZddlmZmZmZmZddlm Z er"ddl m Z Gdddee dfZ Gd ddZd S) zRelationship-related objects.) annotations) TYPE_CHECKINGAnyDictcast)CT_Relationships)PartcseZdZdZd&fdd Z d'd(ddZd)ddZd*ddZd+ddZe ddZ e d,ddZ d'd-d d!Z d.d"d#Z e d,d$d%ZZS)/ RelationshipszGCollection object for |_Relationship| instances, having list semantics.baseURIstrcstt|||_i|_dSN)superr __init___baseURI_target_parts_by_rId)selfr  __class__]/home/skpark/git/infrasmart_work/infrasmart/venv/lib/python3.10/site-packages/docx/opc/rel.pyrs zRelationships.__init__Freltypetarget Part | strrId is_externalboolreturn'_Relationship'cCs,t||||j|}|||<|s||j|<|S)z.Return a newly added |_Relationship| instance.) _Relationshiprr)rrrrrrelrrradd_relationships  zRelationships.add_relationship target_partrrcCs,|||}|dur|j}||||}|S)zlReturn relationship of `reltype` to `target_part`, newly added if not already present in collection.N) _get_matching _next_rIdr )rrr!rrrrr get_or_adds zRelationships.get_or_add target_refcCs6|j||dd}|dur|j}|j|||dd}|jS)z{Return rId of external relationship of `reltype` to `target_ref`, newly added if not already present in collection.T)rN)r"r#r r)rrr%rrrrrget_or_add_ext_rel(s z Relationships.get_or_add_ext_relcCs||}|jS)zReturn target part of rel with matching `reltype`, raising |KeyError| if not found and |ValueError| if more than one matching relationship is found.)_get_rel_of_typer!)rrrrrrpart_with_reltype1s zRelationships.part_with_reltypecC|jS)z_Dict mapping rIds to target parts for all the internal relationships in the collection.)rrrrr related_parts7szRelationships.related_partscCs4t}|D]}||j|j|j|jq|jS)zoSerialize this relationship collection into XML suitable for storage as a .rels file in an OPC package.) rnewvaluesadd_relrrr%rxml)rrels_elmrrrrr/=s zRelationships.xml_Relationship | NonecCs2d d d }|D] }|||||r|Sq d S) zuReturn relationship of matching `reltype`, `target`, and `is_external` from collection, or None if not found.rrrr rrrrcSs>|j|krdS|j|krdS|jr|jn|j}||krdSdS)NFT)rrr%r!)rrrr rel_targetrrrmatchesLs  z,Relationships._get_matching..matchesN)rrrr rrrr)r-)rrrrr3rrrrr"Fs  zRelationships._get_matchingcsVfdd|D}t|dkrd}t|t|dkr'd}t||dS)zReturn single relationship of type `reltype` from the collection. Raises |KeyError| if no matching relationship is found. Raises |ValueError| if more than one matching relationship is found. csg|] }|jkr|qSrr).0rr4rr asz2Relationships._get_rel_of_type..rz*no relationship of type '%s' in collectionz1multiple relationships of type '%s' in collection)r-lenKeyError ValueError)rrmatchingtmplrr4rr'[s    zRelationships._get_rel_of_typecCs4tdt|dD]}d|}||vr|Sq dS)zNext available rId in collection, starting from 'rId1' and making use of any gaps in numbering, e.g. 'rId2' for rIds ['rId1', 'rId3'].r7zrId%dN)ranger8)rn rId_candidaterrrr#js zRelationships._next_rId)r r F) rr rrrr rrrr)rr r!rrr)rr r%r rr )rr rrrr )rr rrrrrr1)rr )__name__ __module__ __qualname____doc__rr r$r&r(propertyr+r/r"r'r# __classcell__rrrrr s"    r rcsleZdZdZ ddfd d ZedddZedddZedddZedddZ edddZ Z S)rz&Value object for relationship to part.Frr rrrr externalrcs4tt|||_||_||_||_t||_dSr ) r rr_rId_reltype_targetrr _is_external)rrrrr rIrrrrws z_Relationship.__init__rcCr)r )rMr*rrrrz_Relationship.is_externalcCr)r )rKr*rrrrrNz_Relationship.reltypecCr)r )rJr*rrrrrNz_Relationship.rIdrcCs|jrtdtd|jS)NzOtarget_part property on _Relationship is undefined when target mode is Externalr)rMr:rrLr*rrrr!s  z_Relationship.target_partcCs,|jr tt|jStd|j}|j|jS)Nr)rMrr rLpartname relative_refr)rrrrrr%s  z_Relationship.target_refrA) rr rr rrr r rIr)rrrB)rr) rCrDrErFrrGrrrr!r%rHrrrrrts    N)rF __future__rtypingrrrr docx.opc.oxmlr docx.opc.partrr r rrrrrs   g