o gd3e?d4<d5Z@Gd6d$d$eZAGd7d8d8eAZBGd9d:d:eBZCeCeA_DGd;d<dd>eAZGGd?d@d@eAZHGdAdBdBeBZIGdCdDdDeIZJGdEdFdFe e e fZKGdGdHdHeIZLerqdPdIdJZMdRdLdMZNdSe2d+ZMe2dNZNdS)Sz@Path tracking utilities, representing mapper graph traversals. ) annotations)reduce)chainN)Any)cast)Dict)Iterator)List)Optional)overload)Sequence)Tuple) TYPE_CHECKING)Union)base)insp_is_mapper_property)exc)util)visitors) HasCacheKey)_InternalEntityType)StrategizedProperty)Mapper)RelationshipProperty) AliasedInsp)_CacheKeyTraversalType) BindParameter)anon_map) _LiteralStar) TypeGuardpath PathRegistryreturnTypeGuard[RootRegistry]cCdSNr"r(r(X/var/www/html/flaskapp/venv/lib/python3.10/site-packages/sqlalchemy/orm/path_registry.pyis_root0r+!TypeGuard[AbstractEntityRegistry]cCr&r'r(r)r(r(r* is_entity2r,r._InternalEntityType[Any]StrategizedProperty[Any]._SerializedPathcCs t|Sr')r# deserializer)r(r(r*_unreduce_pathP r3*r _WILDCARD_TOKEN _sa_defaultc@seZdZUdZdZdZdZdZdZdZ de d<de d<de d<d e d <d e d <de j j fgZd e d<dgddZdgddZedhddZdiddZdjd#d$Zdjd%d&Z 'dkdld)d*Zdmd+d,Zdmd-d.Zednd2d3Zedod5d3Zedpd7d3Zedqd9d3Zedrd, "orders", , "items", ) These structures are generated by things like query options (joinedload(), subqueryload(), etc.) and are used to compose keys stored in the query._attributes dictionary for various options. They are then re-composed at query compile/result row time as the query is formed and as rows are fetched, where they again serve to compose keys to look up options in the context.attributes dictionary, which is copied from query._attributes. The path structure has a limited amount of caching, where each "root" ultimately pulls from a fixed registry associated with the first mapper, that also contains elements for each of its property keys. However paths longer than two elements, which are the exception rather than the rule, are generated on an as-needed basis. r(Fbool is_unnatural_PathRepresentationr" natural_pathzOptional[PathRegistry]parent RootRegistryrootr_cache_key_traversalotherrr$cCs>z |duo |j|jkWStytdt|YdSw)N1Comparison of PathRegistry to %r is not supportedFr"_path_for_compareAttributeErrorrwarntypeselfr@r(r(r*__eq__ zPathRegistry.__eq__cCs>z |dup |j|jkWStytdt|YdSw)NrATrBrGr(r(r*__ne__rJzPathRegistry.__ne__Optional[_PathRepresentation]cCs|jSr'r)rHr(r(r*rCszPathRegistry._path_for_compareindexintr/cCs |j|Sr'r))rHrNr(r(r* odd_elementr4zPathRegistry.odd_element attributesDict[Any, Any]keyvalueNonecCs"td|||||||jf<dS)Nzset '%s' on path '%s' to '%s')logdebugr;rHrQrSrTr(r(r*setszPathRegistry.setcCs&td||||||jf|dS)Nz$setdefault '%s' on path '%s' to '%s')rVrW setdefaultr;rXr(r(r*rZszPathRegistry.setdefaultN Optional[Any]cCs||jf}||vr ||S|Sr')r;rXr(r(r*gets zPathRegistry.getcC t|jSr'lenr"rMr(r(r*__len__r4zPathRegistry.__len__cCst|Sr')idrMr(r(r*__hash__zPathRegistry.__hash__entity _StrPathToken TokenRegistrycCr&r'r(rHrdr(r(r* __getitem__zPathRegistry.__getitem___PathElementTypecCr&r'r(rgr(r(r*rhrislicecCr&r'r(rgr(r(r*rhriAbstractEntityRegistrycCr&r'r(rgr(r(r*rhr0 PropRegistrycCr&r'r(rgr(r(r*rhrmTUnion[_StrPathToken, int, slice, _InternalEntityType[Any], StrategizedProperty[Any]]aUnion[TokenRegistry, _PathElementType, _PathRepresentation, PropRegistry, AbstractEntityRegistry]cCstr')NotImplementedErrorrgr(r(r*rhscCr]r'r^rMr(r(r*length zPathRegistry.lengthOIterator[Tuple[_InternalEntityType[Any], Union[str, StrategizedProperty[Any]]]]ccsHtt|j}tt|}tdt|dD] }||||dfVqdS)Nrrr)r_OddPathRepresentationr"_EvenPathRepresentationranger_)rHodd_path even_pathir(r(r*pairss   zPathRegistry.pairsmapper Mapper[Any]csFtt|jfddtdtdDD] }|j|r dSqdS)Ncg|]}|qSr(r(.0rz_m_pathr(r* z0PathRegistry.contains_mapper..rrTF)rrur"rwr_r|isa)rHr| path_mapperr(rr*contains_mappers " zPathRegistry.contains_mappercCs||jf|vSr'r))rHrQrSr(r(r*containszPathRegistry.containscCst|ffSr')r3 serializerMr(r(r* __reduce__rzPathRegistry.__reduce__r1c svtt|tt|tttddfddtdtdDDtddfddtd tdDDd S) Ncss*|]}|js |jr |jnt|VqdSr') is_mapperis_aliased_classclass_str)rmr(r(r* s  z/PathRegistry._serialize_path..cr~r(r(rrr(r*rrz0PathRegistry._serialize_path..rrcss&|]}t|r |jnt|VqdSr')rrSr)rpr(r(r*rs  cr~r(r(r)_p_pathr(r*rrrr')rrurvlistziptuplerwr_)clsr"r()rrr*_serialize_paths  zPathRegistry._serialize_pathcsPd dddddttfd d |D}|r&|d dur&|d d }|S)Nmclsrr$cSs"|tjvr tj|ddStj|SNT) configure) PathToken_internorm_base_inspect_mapped_class)rr(r(r*_deserialize_mapper_tokens  zAPathRegistry._deserialize_path.._deserialize_mapper_tokenrScSsD|durdS|tjvrtj|Stj|dd}|dusJ|j|Sr)rrrrattrs)rrSmpr(r(r*_deserialize_key_tokens    z>PathRegistry._deserialize_path.._deserialize_key_tokencs"g|] \}}|||fqSr(r()rrrSrrr(r*r%s z2PathRegistry._deserialize_path..r)rrr$r)rrrSrr$r)rrrr"rr(rr*_deserialize_paths     zPathRegistry._deserialize_pathcCs|j}||Sr')r"r)rHr"r(r(r*r2s zPathRegistry.serializecCs |dusJ||}||Sr')rcoercerr(r(r*r26s   zPathRegistry.deserializeCachingEntityRegistrycCr&r'r(rr|r(r(r* per_mapper<zPathRegistry.per_mapperAliasedInsp[Any]SlotsEntityRegistrycCr&r'r(rr(r(r*r@rcCs|jr t|j|St|j|Sr')rrr>rrr(r(r*rDs  rawcCsddd}t|||jS) Nprevr#next_rjr$cS||Sr'r(rrr(r(r*_redOrcz!PathRegistry.coerce.._redrr#rrjr$r#)rr>)rrrr(r(r*rMs zPathRegistry.coercecCsddd}t||j|S) Nrr#rrjr$cSrr'r(rr(r(r*rVrcz"PathRegistry.__add__.._redr)rr")rHr@rr(r(r*__add__Us zPathRegistry.__add__rcCsdddd|jDdS)Nz ORM Path[z -> css|]}t|VqdSr'r)relemr(r(r*r\sz'PathRegistry.__str__..])joinr"rMr(r(r*__str__[szPathRegistry.__str__cCs|jjd|jdS)N()) __class____name__r"rMr(r(r*__repr__^szPathRegistry.__repr__)r@rr$r8r$rL)rNrOr$r/)rQrRrSrrTrr$rUr')rQrRrSrrTr[r$r)r$rO)rdrer$rf)rdrOr$rj)rdrkr$r:)rdr/r$rl)rdr0r$rn)rdror$rp)r$rt)r|r}r$r8)rQrRrSrr$r8)r$r)r"r:r$r1)r"r1r$r:)r$r1r"r1r$r#)r|r}r$r)r|rr$r)r|r/r$rl)rr:r$r#)r@r#r$r#)r$r)*r __module__ __qualname____doc__ __slots__is_tokenr+ has_entity is_propertyr.__annotations__rExtendedInternalTraversaldp_has_cache_key_listr?rIrKpropertyrCrPrYrZr\r`rbr rhrrr{rrr classmethodrrrr2rrrrrr(r(r(r*r#Xs~                      #     c@s,eZdZUdZded<ded<d d d Zd S) CreatesTokenr(r8rr+tokenrer$rfcCsF|dtr t||S|dtrt|j|Std|)N:zinvalid token: )endswithr6rf_DEFAULT_TOKENr>r ArgumentError)rHrr(r(r*rhs   zCreatesToken.tokenN)rrer$rf)rrrrrrr(r(r(r*rbs rc@sPeZdZdZdZdZdZZdZdZ dZ dZ dd d Z dd d Z es&e Zd Sd S)r=zXRoot registry, defers to mappers so that paths are maintained per-root-mapper. r(TFrdrr$,Union[TokenRegistry, AbstractEntityRegistry]cCsR|tjvrtrt|tsJt|tj|Sz|jWSty(td|w)Nz/invalid argument for RootRegistry.__getitem__: ) rrr isinstancererf_path_registryrD IndexErrorrgr(r(r*_getitems  zRootRegistry._getitemcC|Sr'r(rMr(r(r*_truncate_recursiveriz RootRegistry._truncate_recursiveN)rdrr$r)r$r=)rrrrr inherit_cacher"r;rrr+r9rrrrhr(r(r(r*r=qs  r=c@sDeZdZUdZiZded<dd d Zedd d Ze dddZ dS)rzcacheable string tokenzDict[str, PathToken]rr bindparamsList[BindParameter[Any]]r$Tuple[Any, ...]cCs t|fSr'r)rHrrr(r(r*_gen_cache_keys zPathToken._gen_cache_keyrLcCr&r'r(rMr(r(r*rCrzPathToken._path_for_comparestrvaluercCs*||jvr |j|St||j|<}|Sr')rr)rrresultr(r(r*interns  zPathToken.internN)rrrrr$rr)rrr$r) rrrrrrrrrCrrr(r(r(r*rs    rc@sbeZdZUdZdZded<ded<dddZd ZdZdd d Z dddZ dddZ e s/e Z dSdS)rf)rr<r"r;Trerrr<cCs6t|}||_||_|j|f|_|j|f|_dSr')rrrr<r"r;)rHr<rr(r(r*__init__s zTokenRegistry.__init__Fr$Iterator[PathRegistry]ccs|j}t|r |VdStrt|tsJ|js-|jD] }t|j||j VqdS|jrPt d|j j rP|Vt d|j j D] }t|j||j VqAdS|VdSNr)r<r+rrrlrr|iterate_to_rootrfrrrd_is_with_polymorphic_with_polymorphic_entitiesrHr<mp_ententr(r(r*generate_for_superclassess8 z'TokenRegistry.generate_for_superclassesIterator[_PathRepresentation]ccs|j}t|r|jVdStrt|tsJ|jD] }t|j||j jVq|j rOt d|j j rO|jVt d|j jD] }t|j||j jVq?dS|jVdSr)r<r+r;rrrlr|rrfrrrrdrrrr(r(r*"_generate_natural_for_superclassess6 z0TokenRegistry._generate_natural_for_superclassesrdrc Cs2z|j|WSty}zt||d}~wwr')r" TypeErrorr)rHrderrr(r(r*rs   zTokenRegistry._getitemN)r<rrre)r$r)r$rrdrr$r)rrrrrrrrrrrrrrhr(r(r(r*rfs     rfc@sjeZdZUdZdZdZded<ded<ded<dd d ZdddZe dddZ dddZ e s3e Z dSdS)rn) propr<r"r;rrdr|_wildcard_path_loader_key_default_path_loader_key _loader_keyr9Tr0rzOptional[Mapper[Any]]r|z"Optional[_InternalEntityType[Any]]rdr<rlcCs^td|d}|}|jjpt|jj|_|jr|jr#|j|j}}nB|jrL|jrL|j|jvrL|d |j}|j|}|jrI|j|j}d|_n|}n|jre|jre|j|jure|j |jre|j|j}||_ ||_|j |f|_ |j |f|_ |j|_|jrtrt|tsJ|j|_|j|_nd|_d|_d|j |j jf|_|j j|_d|j f|_dS)Nr/rTloader)rr<r9r8r|inheritsr_use_mapper_pathwith_polymorphic_mappers_entity_for_mapperrrr"r;_links_to_entityr_is_relationshiprrrrd_wildcard_tokenrrr)rHr<rinspnatural_parentsubclass_entityr(r(r*rsZ          zPropRegistry.__init__r$cCsXd}tt|jddD] \}}||jur|}q |dur|S||jd|d S)Nrrr) enumeratereversedr"rr)rHearliestrzrr(r(r*rvs z PropRegistry._truncate_recursivecCs|jdusJ||jSr')rdrMr(r(r* entity_paths zPropRegistry.entity_path+Union[int, slice, _InternalEntityType[Any]]DUnion[AbstractEntityRegistry, _PathElementType, _PathRepresentation]cCs"t|ttfr |j|St||Sr')rrOrkr"rrgr(r(r*rs  zPropRegistry._getitemN)r<rlrr0)r$rnr$rl)rdrr$r)rrrrrrrrrrrrrrhr(r(r(r*rns    Z  rnc@seZdZUdZdZdZded<ded<ded<ded <dd d Zdd dZe d ddZ e d!ddZ e d"ddZ d#ddZ d$ddZesJeZdSdS)%rl)rSr<rr"rdr;T!Union[RootRegistry, PropRegistry]r<r/rSrdr8rcCs||_||_|j|_||_|j|f|_|jr>|js|jr>|j|jdjr1|j|jf|_dS|j|jdjf|_dS|j|_dS)Nr) rSr<rrdr"r9r|rr;rHr<rdr(r(r*rs  zAbstractEntityRegistry.__init__r$cCs|j|jSr')r<rrdrMr(r(r*rsz*AbstractEntityRegistry._truncate_recursivecCs |dS)Nr)rPrMr(r(r* root_entityrsz"AbstractEntityRegistry.root_entityr#cCrr'r(rMr(r(r*rrz"AbstractEntityRegistry.entity_pathr}cCs|jjSr')rdr|rMr(r(r*r|szAbstractEntityRegistry.mappercCsdS)NTr(rMr(r(r*__bool__rizAbstractEntityRegistry.__bool__r:Union[_PathElementType, _PathRepresentation, PathRegistry]cCs<t|ttfr |j|S|tjvrt|tj|St||Sr')rrOrkr"rrrfrnrgr(r(r*rs    zAbstractEntityRegistry._getitemNr<r rdr/r)r$r/)r$r#)r$r})r$r8)rdrr$r )rrrrrr.rrrrr rr|r rrrhr(r(r(r*rls*    .      rlc@seZdZdZdS)rTN)rrrrr(r(r(r*rsrc@s eZdZd ddZd d d Zd S)_ERDictregistryrcCs ||_dSr')r)rHrr(r(r*rr4z_ERDict.__init__rSrr$rncCst|j|||<}|Sr')rnr)rHrSitemr(r(r* __missing__sz_ERDict.__missing__N)rr)rSrr$rn)rrrrrr(r(r(r*rs rcsJeZdZdZdZdfdd Zdd dZdddZes!eZ Z SZ S)r)_cacheTr<r rdr/cst||t||_dSr')superrrrr rr(r*r szCachingEntityRegistry.__init__rSrdefaultr$cCs|j||Sr')rpop)rHrSrr(r(r*rrzCachingEntityRegistry.popcCs6t|ttfr |j|St|trt||S|j|Sr')rrOrkr"rrfrrgr(r(r*rs     zCachingEntityRegistry._getitemr)rSrrrr$rr) rrrrrrrrrrh __classcell__r(r(rr*rs   rcCr&r'r(r)r(r(r*path_is_entity#rrTypeGuard[PropRegistry]cCr&r'r(r)r(r(r*path_is_property'r,rr)r"r#r$r%)r"r#r$r-r)r"r#r$r)Or __future__r functoolsr itertoolsrloggingoperatortypingrrrrr r r r r rrrr_typingrrrsqlr sql.cache_keyrr interfacesrr|r relationshipsrrr sql.elementsr sql.visitorsr util.typingr r!r+r. attrgetterr1rrerjr:rurv getLoggerrrVr3r6rrr#rr=r>InspectionAttrrrfrnrlrrrrrr(r(r(r*s                                       &V `