o 'fu@sVdZddlmZddlmZmZddlmZGdddeedfZ GdddZ d S) zRelationship-related objects.) annotations)AnyDict)CT_Relationshipscs~eZdZdZd!fdd Z d"d#ddZddZddZddZe ddZ e ddZ d"ddZ ddZ e dd ZZS)$ RelationshipszGCollection object for |_Relationship| instances, having list semantics.baseURIstrcstt|||_i|_dSN)superr__init___baseURI_target_parts_by_rId)selfr __class__D/home/ubuntu/flask/venv/lib/python3.10/site-packages/docx/opc/rel.pyr s zRelationships.__init__Freltypetarget str | AnyrId is_externalboolreturn'_Relationship'cCs,t||||j|}|||<|s||j|<|S)z.Return a newly added |_Relationship| instance.) _Relationshipr r )rrrrrrelrrradd_relationships  zRelationships.add_relationshipcCs,|||}|dur|j}||||}|S)zlReturn relationship of `reltype` to `target_part`, newly added if not already present in collection.N) _get_matching _next_rIdr)rr target_partrrrrr get_or_adds zRelationships.get_or_addcCs6|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)rrrr)rr target_refrrrrrget_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_reltype.s zRelationships.part_with_reltypecC|jS)z_Dict mapping rIds to target parts for all the internal relationships in the collection.)r rrrr related_parts4szRelationships.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.xmlcCs0dd}|D] }|||||r|SqdS)zuReturn relationship of matching `reltype`, `target`, and `is_external` from collection, or None if not found.cSs>|j|krdS|j|krdS|jr|jn|j}||krdSdS)NFT)rrr"r )rrrr rel_targetrrrmatchesGs  z,Relationships._get_matching..matchesN)r*)rrrrr/rrrrrCs  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).0rr0rr \sz2Relationships._get_rel_of_type..rz*no relationship of type '%s' in collectionz1multiple relationships of type '%s' in collection)r*lenKeyError ValueError)rrmatchingtmplrr0rr$Vs    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'].r3zrId%dN)ranger4)rn rId_candidaterrrres zRelationships._next_rId)rrF) rrrrrrrrrr)__name__ __module__ __qualname____doc__r rr!r#r%propertyr(r,rr$r __classcell__rrrrr s        rrcsbeZdZdZddfdd ZeddZed d Zed d Zed dZ edddZ Z S)rz&Value object for relationship to part.Frrcs4tt|||_||_||_||_t||_dSr ) r rr _rId_reltype_targetr r _is_external)rrrrrexternalrrrr rs z_Relationship.__init__cCr&r )rGr'rrrrzz_Relationship.is_externalcCr&r )rEr'rrrr~rIz_Relationship.reltypecCr&r )rDr'rrrrrIz_Relationship.rIdcCs|jrtd|jS)NzOtarget_part property on _Relationship is undefined when target mode is External)rGr6rFr'rrrr s z_Relationship.target_partrcCs|jr|jS|jj|jSr )rGrFpartname relative_refr r'rrrr"sz_Relationship.target_refr=)rr)rr) r>r?r@rAr rBrrrr r"rCrrrrros    N) rA __future__rtypingrr docx.opc.oxmlrrrrrrrrs   e