U cqeu@sVdZddlmZddlmZmZddlmZGdddeedfZ GdddZ d S) zRelationship-related objects.) annotations)AnyDict)CT_RelationshipscseZdZdZddfdd Zdddddd d d d Zd dZddZddZe ddZ e ddZ dddZ ddZ e ddZZS) RelationshipszGCollection object for |_Relationship| instances, having list semantics.str)baseURIcstt|||_i|_dSN)superr__init___baseURI_target_parts_by_rId)selfr __class__0/tmp/pip-unpacked-wheel-gx5hpqp3/docx/opc/rel.pyr szRelationships.__init__Fz str | Anyboolz'_Relationship')reltypetargetrId is_externalreturncCs,t||||j|}|||<|s(||j|<|S)z.Return a newly added |_Relationship| instance.) _Relationshipr r )rrrrrrelrrradd_relationships  zRelationships.add_relationshipcCs,|||}|dkr(|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}|dkr0|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_reltypecCs|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.) rnewvaluesZadd_relrrr rxml)rZrels_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}||kr:dSdS)NFT)rrr r)rrrrZ rel_targetrrrmatchesGs  z,Relationships._get_matching..matchesN)r')rrrrr)rrrrrCs   zRelationships._get_matchingcsVfdd|D}t|dkr2d}t|t|dkrNd}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).0rr*rr \s z2Relationships._get_rel_of_type..rz*no relationship of type '%s' in collectionz1multiple relationships of type '%s' in collection)r'lenKeyError ValueError)rrZmatchingtmplrr*rr"Vs    zRelationships._get_rel_of_typecCs4tdt|dD]}d|}||kr|SqdS)zNext available rId in collection, starting from 'rId1' and making use of any gaps in numbering, e.g. 'rId2' for rIds ['rId1', 'rId3'].r-zrId%dN)ranger.)rnZ rId_candidaterrrreszRelationships._next_rId)F)F)__name__ __module__ __qualname____doc__r rrr!r#propertyr%r(rr"r __classcell__rrrrr s      rrcsjeZdZdZdddfdd ZeddZed d Zed d Zed dZ eddddZ Z S)rz&Value object for relationship to part.Fr)rcs4tt|||_||_||_||_t||_dSr ) r rr _rId_reltype_targetr r _is_external)rrrrrZexternalrrrr rs z_Relationship.__init__cCs|jSr )r>r$rrrrzsz_Relationship.is_externalcCs|jSr )r<r$rrrr~sz_Relationship.reltypecCs|jSr )r;r$rrrrsz_Relationship.rIdcCs|jrtd|jS)NzOtarget_part property on _Relationship is undefined when target mode is External)r>r0r=r$rrrrs z_Relationship.target_part)rcCs |jr |jS|jj|jSdSr )r>r=ZpartnameZ relative_refr r$rrrr sz_Relationship.target_ref)F) r5r6r7r8r r9rrrrr r:rrrrros    N) r8 __future__rtypingrrZ docx.opc.oxmlrrrrrrrrs   e