(ph'SrSSKrSSKrSSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ r SS K J r S S /r "S S 5r\"5r\ "SS55r\ "SS\55r"SS5r"SS\\5r\"\ 5"SS \55r"SS\\5r\"\ 5"SS \55rSrSrSrSrg)zAdapter management N Interface) implementer) providedBy)ro)_normalize_name) _use_c_impl)IAdapterRegistryAdapterRegistryVerifyingAdapterRegistryc\rSrSrSrSrSrSSjrSr\ "SS5r S r \ r \r\r\rS rS rS rS rSrSSjr\SSj5rSrSrSSjrSrSrSr SSjr!Sr"Sr#Sr$g)BaseAdapterRegistry@a A basic implementation of the data storage and algorithms required for a :class:`zope.interface.interfaces.IAdapterRegistry`. Subclasses can set the following attributes to control how the data is stored; in particular, these hooks can be helpful for ZODB persistence. They can be class attributes that are the named (or similar) type, or they can be methods that act as a constructor for an object that behaves like the types defined here; this object will not assume that they are type objects, but subclasses are free to do so: _sequenceType = list This is the type used for our two mutable top-level "byorder" sequences. Must support mutation operations like ``append()`` and ``del seq[index]``. These are usually small (< 10). Although at least one of them is accessed when performing lookups or queries on this object, the other is untouched. In many common scenarios, both are only required when mutating registrations and subscriptions (like what :meth:`zope.interface.interfaces.IComponents.registerUtility` does). This use pattern makes it an ideal candidate to be a :class:`~persistent.list.PersistentList`. _leafSequenceType = tuple This is the type used for the leaf sequences of subscribers. It could be set to a ``PersistentList`` to avoid many unnecessary data loads when subscribers aren't being used. Mutation operations are directed through :meth:`_addValueToLeaf` and :meth:`_removeValueFromLeaf`; if you use a mutable type, you'll need to override those. _mappingType = dict This is the mutable mapping type used for the keyed mappings. A :class:`~persistent.mapping.PersistentMapping` could be used to help reduce the number of data loads when the registry is large and parts of it are rarely used. Further reductions in data loads can come from using a :class:`~BTrees.OOBTree.OOBTree`, but care is required to be sure that all required/provided values are fully ordered (e.g., no required or provided values that are classes can be used). _providedType = dict This is the mutable mapping type used for the ``_provided`` mapping. This is separate from the generic mapping type because the values are always integers, so one might choose to use a more optimized data structure such as a :class:`~BTrees.OIBTree.OIBTree`. The same caveats regarding key types apply as for ``_mappingType``. It is possible to also set these on an instance, but because of the need to potentially also override :meth:`_addValueToLeaf` and :meth:`_removeValueFromLeaf`, this may be less useful in a persistent scenario; using a subclass is recommended. .. versionchanged:: 5.3.0 Add support for customizing the way internal data structures are created. .. versionchanged:: 5.3.0 Add methods :meth:`rebuild`, :meth:`allRegistrations` and :meth:`allSubscriptions`. ) lookupqueryMultiAdapterlookup1 queryAdapter adapter_hook lookupAllnames subscriptions subscribersrcUR5UlUR5UlUR5UlUR 5 XlgN) _sequenceType _adapters _subscribers _providedType _provided _createLookup __bases__selfbasess I/var/www/html/venv/lib/python3.13/site-packages/zope/interface/adapter.py__init__BaseAdapterRegistry.__init__sN++-!..0++-  cxXRS'[R"U5UlURU5 g)z If subclasses need to track when ``__bases__`` changes, they can override this method. Subclasses must still call this method. r!N)__dict__rchangedr"s r% _setBasesBaseAdapterRegistry._setBasess+&+ k"%%+ Tr(c URS$)Nr!)r*r#s r%BaseAdapterRegistry.s dmmK&@r(c$URU5$r)r,r"s r%r0r1s T^^E-Br(cURU5UlURH&n[URU5URU'M( gr) LookupClass _v_lookup _delegatedgetattrr*)r#names r%r !BaseAdapterRegistry._createLookups;))$/OOD")$..$"?DMM$ $r(cUcU4$X4-$)a Add the value *new_item* to the *existing_leaf_sequence*, which may be ``None``. Subclasses that redefine `_leafSequenceType` should override this method. :param existing_leaf_sequence: If *existing_leaf_sequence* is not *None*, it will be an instance of `_leafSequenceType`. (Unless the object has been unpickled from an old pickle and the class definition has changed, in which case it may be an instance of a previous definition, commonly a `tuple`.) :return: This method returns the new value to be stored. It may mutate the sequence in place if it was not ``None`` and the type is mutable, but it must also return it. .. versionadded:: 5.3.0 )r#existing_leaf_sequencenew_items r%_addValueToLeaf#BaseAdapterRegistry._addValueToLeafs, " ); % 33r(cR[UVs/sH o3U:wdM UPM sn5$s snf)a Remove the item *to_remove* from the (non-``None``, non-empty) *existing_leaf_sequence* and return the mutated sequence. If there is more than one item that is equal to *to_remove* they must all be removed. Subclasses that redefine `_leafSequenceType` should override this method. Note that they can call this method to help in their implementation; this implementation will always return a new tuple constructed by iterating across the *existing_leaf_sequence* and omitting items equal to *to_remove*. :param existing_leaf_sequence: As for `_addValueToLeaf`, probably an instance of `_leafSequenceType` but possibly an older type; never `None`. :return: A version of *existing_leaf_sequence* with all items equal to *to_remove* removed. Must not return `None`. However, returning an empty object, even of another type such as the empty tuple, ``()`` is explicitly allowed; such an object will never be stored. .. versionadded:: 5.3.0 )tuple)r#r< to_removevs r%_removeValueFromLeaf(BaseAdapterRegistry._removeValueFromLeafs(4!7J!7A >a!7JKKJs $$cdU=RS- slURRU5 gN) _generationr5r+)r#originally_changeds r%r+BaseAdapterRegistry.changed s& A 12r(c[U[5(d [S5eUcURXX45 g[ UVs/sHn[ U5PM sn5n[ U5n[U5nURn[U5U::a0URUR55 [U5U::aM0XvnX4-n U H-n URU 5n U cUR5n XU 'U nM/ URU5ULagXHU'URRUS5S-n XRU'U S:XaURRU5 URU5 gs snf)Nname is not a stringrrH) isinstancestr ValueError unregisterrA_convert_None_to_Interfacerlenrappend _mappingTypegetrr5 add_extendorr+) r#requiredprovidedr8valuerorderbyorder componentskeykdns r%registerBaseAdapterRegistry.registersS$$$34 4 = OOH < JA4Q7JKt$H ..'le# NN4,,. /'le#^ $Aq!Ay%%' !1 J  >>$ 5 (  4 NN  x +a /#$x 6 NN ' ' 1 T5KsE2c[UVs/sHn[U5PM sn5n[U5n[U5U::agXnX#4-nUHn URU 5n U c gU nM URU5$s snfr)rArRrSrV) r#r]rXrYr8r[r\r^r_r`ras r% _find_leafBaseAdapterRegistry._find_leaf1s JA4Q7JKH  w<5 ^ $Aq!AyJ  ~~d##KsA<cPURURUU[U55$r)rfrr)r#rXrYr8s r% registeredBaseAdapterRegistry.registeredGs( NN   D !   r(c## US:Xa#UR5HupEX44-U4v M gUR5H'upEX44-nURXRS- U5ShvN M) gN 7f)NrrH)items_allKeys)clsr^iparent_kr`rC new_parent_ks r%rmBaseAdapterRegistry._allKeysOsk 6"((*oq((+#((*'$ <<q5,???+?sAA*A( A*c## [U5HKup#URX2S-5H.upE[U5US-:XdeUSUnUSnUSnXgX4v M0 MM g7f)NrH) enumeratermrS) r#r]ror^r_rZrXrYr8s r% _all_entries BaseAdapterRegistry._all_entriesYsq'w/MA#mmJA> 3x1q5(((r7r72w477 ?0sAAc#V# URUR5ShvN gN7f)a Yields tuples ``(required, provided, name, value)`` for all the registrations that this object holds. These tuples could be passed as the arguments to the :meth:`register` method on another adapter registry to duplicate the registrations this object holds. .. versionadded:: 5.3.0 N)rxrr/s r%allRegistrations$BaseAdapterRegistry.allRegistrationsks$$T^^444s )')Nc[UVs/sHn[U5PM sn5n[U5nURnU[U5:agXvnX4-n /n U H-n UR U 5n U c gU R X45 U nM/ UR U5n U cgUbXLagX U(dJ[ U 5HupXn U (a OX M U(a US(dUS U(a US(dMURUS- nUS:Xa)URU URRU5 OXRU'URU5 gs snf)NFrvrHr) rArRrSrrVrTreversedrr5remove_extendorr+)r#rXrYr8rZr[r\r]r^r_lookupsr`raoldcomprbs r%rQBaseAdapterRegistry.unregisterxsWJA4Q7JKH .. CL ^ $Aq!Ay NNJ? +J nnT" ;   C$4    $G,G - '"+BK'"++ NN8 $q ( 6x( NN * *8 4'(NN8 $ T[KsEc[UVs/sHn[U5PM sn5nSn[U5nURn[U5U::a0UR UR 55 [U5U::aM0XvnX4-n U H-n UR U 5n U cUR 5n XU 'U nM/ URUR U5U5X'UbNURR US5S-n XRU'U S:XaURRU5 URU5 gs snf)NrrH) rArRrSrrTrUrVr>rr5rWr+) r#rXrYrZr[r8r\r]r^r_r`rarbs r% subscribeBaseAdapterRegistry.subscribes)JA4Q7JKH ##'le# NN4,,. /'le#^ $Aq!Ay%%' !1 J  // t0DeL   ""8Q/!3A'(NN8 $Av++H5 T1KsEcbURURUUS5=(d SnX4;aU$S$)Nrr;)rfr)r#rXrY subscriberrs r% subscribedBaseAdapterRegistry.subscribedsAoo           (6z@D@r(c#t# URUR5Hupp4UH nXU4v M M g7f)a Yields tuples ``(required, provided, value)`` for all the subscribers that this object holds. These tuples could be passed as the arguments to the :meth:`subscribe` method on another adapter registry to duplicate the registrations this object holds. .. versionadded:: 5.3.0 N)rxr)r#rXrY_namerZrCs r%allSubscriptions$BaseAdapterRegistry.allSubscriptionssA150A0A   1 ,H1--1 s68cL[UVs/sHn[U5PM sn5n[U5nURnU[U5:agXenX4-n/n UH-n UR U 5n U c gU R Xz45 U nM/ UR S5n U (dg[U 5n UcSnOUR X5nA [U5U :XagU(aXS'OMUS [U 5HupXn U (a OX M U(a US(dUS U(a US(dMUb\URU[U5-U - nUS:Xa)URU URRU5 OUURU'URU5 gs snf)Nrr;rvr) rArRrSrrVrTrDr~rr5rr+)r#rXrYrZr[r\r]r^r_rr`rarlen_oldnewrrbs r% unsubscribeBaseAdapterRegistry.unsubscribesJA4Q7JKH ## CL ^ $Aq!Ay NNJ? +J nnR  c( = C++C7C  s8w    rN2#G,G - '"+BK'"++  x(3s83g=AAvNN8,..x8+,x( TEKsF!cUR5nUR5nSnU"U5nU"U5nURUR5 UHnUR"U6 M UHnUR "U6 M g)a Rebuild (and replace) all the internal data structures of this object. This is useful, especially for persistent implementations, if you suspect an issue with reference counts keeping interfaces alive even though they are no longer used. It is also useful if you or a subclass change the data types (``_mappingType`` and friends) that are to be used. This method replaces all internal data structures with new objects; it specifically does not re-use any storage. .. versionadded:: 5.3.0 c[U5n[R"U4U5$![a [S5s$f=fNr;)next StopIterationiter itertoolschain)itfirsts r%buffer+BaseAdapterRegistry.rebuild..buffer8s? R??E8R0 0! Bx s %==N)r{rr&r!rcr)r# registrationsrrargss r%rebuildBaseAdapterRegistry.rebuild"s}&--/ --/  1}- }-  dnn%"D MM4 ""D NND !"r(c"SS5nU$)Nc\rSrSr0rSrg)2BaseAdapterRegistry.get..XXXTwistedFakeOutiZr;N)__name__ __module__ __qualname____firstlineno__ selfImplied__static_attributes__r;r(r%XXXTwistedFakeOutrZsKr(rr;)r#_rs r%rVBaseAdapterRegistry.getYs    r()r!rrrr5rr;rr)%rrrr__doc__r6rIr&r,propertyr!r listrrA_leafSequenceTypedictrUrr>rDr+rcrfri classmethodrmrxr{rQrrrrrrVrr;r(r%rr@s;|2J K-^ @BI@MLM44L83!F$, @@8$ 5.`6A."CJ3"n!r(rcl^\rSrSrSrS SjrSrS SjrS SjrS Sjr S U4Sjjr S r S r S r U=r$) LookupBaseibc.0Ul0Ul0Ulgr_cache_mcache_scacher/s r%r&LookupBase.__init__es   r(cURR5 URR5 URR5 gr)rclearrr)r#ignoreds r%r+LookupBase.changedjs2   r(cURRU5nUc0nX0RU'U(aURU5nUc0nXCU'UnU$r)rrV)r#rYr8cachecs r% _getcacheLookupBase._getcacheosU ) =E$)KK !  $Ayd E r(c[U[5(d [S5eURX#5n[ U5n[ U5S:XaUR US[5nOUR [ U5[5nU[La6URXU5n[ U5S:XaXeUS'O Xe[ U5'UcU$U$)NrMrHr) rNrOrPrrArSrV_not_in_mapping_uncached_lookupr#rXrYr8defaultrresults r%rLookupBase.lookup|s$$$34 4x.? x=A YYx{ON r(c[U[5(d [S5eURX#5nUR U[ 5nU[ LaUR U4X#U5$UcU$U$NrM)rNrOrPrrVrrrs r%rLookupBase.lookup1se$$$34 4x.8_5 _ $;;|XWE E >N r(c&URX!X45$r)r)r#objectrYr8rs r%rLookupBase.queryAdapters  4AAr(cF>[U[5(d [S5e[U5nUR X5nUR U[ 5nU[ LaURU4X5nUb.[U[5(a URnU"U5nUbU$U$r) rNrOrPrrrVrrsuper__self__) r#rYrr8rrXrfactoryr __class__s r%rLookupBase.adapter_hooks$$$34 4f%x.))Ho6 o %kk8,?G  &%((V_F! r(cURRU5nUc0nX0RU'[U5nURU[5nU[LaUR X5nXCU'U$r)rrVrAr_uncached_lookupAllr#rXrYrrs r%rLookupBase.lookupAllsi   * =E%*LL "?8_5 _ $--hAF$(O r(cURRU5nUc0nX0RU'[U5nURU[5nU[LaUR X5nXCU'U$r)rrVrAr_uncached_subscriptionsrs r%rLookupBase.subscriptionssi   * =E%*LL "?8_5 _ $11(EF$(O r(rrrN)rrrrr&r+rrrrrrrr __classcell__rs@r%rrbs6  , B$   r(rc2\rSrSrSrSrSrSrSrSr g) VerifyingBaseic[RX5 URRSSUlURVs/sHo"R PM snUlgs snfrG)LookupBaseFallbackr+ _registryr _verify_rorI_verify_generations)r#rJr[s r%r+VerifyingBase.changedsH""4<..++AB/;???#K?aMM?#K #KsA cURVs/sHoRPM snUR:waURS5 ggs snfr)rrIrr+r#r[s r%_verifyVerifyingBase._verifysG(, '6!  )) * LL   * sAcNUR5 [RXU5$r)rrr)r#rYr8s r%rVerifyingBase._getcaches# !++ D  r(cNUR5 [RXU5$r)rrrr#rXrYs r%rVerifyingBase.lookupAlls# !++ H  r(cNUR5 [RXU5$r)rrrrs r%rVerifyingBase.subscriptionss# !// H  r()rrN) rrrrr+rrrrrr;r(r%rrsL    r(rc^\rSrSrU4SjrSU4SjjrSrSrSrSr SSjr SU4S jjr S r S r S rS rSrU=r$)AdapterLookupBaseic\>Xl0UlUR5 [TU]5 gr)r _requiredinit_extendorsrr&)r#registryrs r%r&AdapterLookupBase.__init__s&!  r(c>[TU]S5 URR5H nU"5nUcMUR U5 M" URR 5 gr)rr+rkeysrr)r#rr[rs r%r+AdapterLookupBase.changedsP $$&AA} d#' r(cn0UlURRHnURU5 M gr) _extendorsrrrW)r#ps r%r AdapterLookupBase.init_extendorss+))A   a *r(c0URnURHpnURUS5nUVs/sHoQRU5(dMUPM snU/-UVs/sHoQRU5(aMUPM sn-X#'Mr gs snfs snfr)r__iro__rV isOrExtends)r#rYrro extendorses r%rWAdapterLookupBase.add_extendor#s__ !!A"q"-I )(!,@,@,CAy )(!0D0DQ0GAy  M"sBBB<BcURnURH/nURUS5Vs/sH nXA:wdM UPM snX#'M1 gs snfr)rr rV)r#rYrror s r%r!AdapterLookupBase.remove_extendor1sO__ !!A(2q"(=/(=1 ! (=/JM"/s A A cURnUH/nUR5nXB;dMURU5 SX$'M1 grG)rweakrefr)r#rX_refsr[refs r% _subscribeAdapterLookupBase._subscribe7s9A))+C D! r(c R[U5nSn[U5nURRHenURnU[U5:aM UR R RU5nU(dMNXun [XXSU5nUcMe O UR"U6 U$Nr) rArSrrrr5rrV_lookupr) r#rXrYr8rr\rr]r r^s r%r"AdapterLookupBase._uncached_lookup?s?H ))H((GG $ **5599(CI JZ9A"$F!* " r(c >URUVs/sHn[U5PM snX#5nUcU$U"UVs/sH&n[U[5(a UROUPM( sn6nUcU$U$s snfs snfr)rrrNrr) r#objectsrYr8rorrrs r%r#AdapterLookupBase.queryMultiAdapterVs++g>gz!}g>O ?N?F ?F!*Q..AJJA 5w   >N ? s A1-A6c [U5n[U5n0n[URR5H`nUR nU[U5:aM UR RRU5nU(dMNXcn[XXtSU5 Mb UR"U6 [UR55$r) rArSr~rrrr5rrV _lookupAllrrl) r#rXrYr\rrr]r r^s r%r%AdapterLookupBase._uncached_lookupAllcs?H  !2!23H((GG $ **5599(CI J zY5 I4 "V\\^$$r(cTURX5Vs/sHo3SPM sn$s snfr)r)r#rXrYrs r%rAdapterLookupBase.namesus'"nnX@A@!@AAAs%c `[U5n[U5n/n[URR5HcnUR nU[U5:aM UcU4nO*UR RRU5nUcMQ[XcXSUSU5 Me UR"U6 U$)Nrr) rArSr~rrrr5rrV_subscriptionsr)r#rXrYr\rrr]r s r%r)AdapterLookupBase._uncached_subscriptionsxs?H  !2!23H++GG $%L $..99==hG $ 7>8!1e -4 " r(cURUVs/sHn[U5PM snU5nUcSnUHnU"U6 M U$/nUHnU"U6nUcM URU5 M U$s snfr)rrrT)r#rrYrrr subscriptionrs r%rAdapterLookupBase.subscriberss**$+ ,GqZ]G ,h   F - g&!. F - )73 )MM*-!.  -sA*)rrrrrr)rrrrr&r+rrWrrrrrrrrrrrs@r%rrsE <! / . %$B.r(rc\rSrSrSrg) AdapterLookupir;Nrrrrrr;r(r%r*r*r(r*cX^\rSrSrSr\rS U4SjjrSrSr U4Sjr U4Sjr Sr U=r $) r izU A full implementation of ``IAdapterRegistry`` that adds support for sub-registries. cX>[R"5Ul[TU]U5 gr)rWeakKeyDictionary_v_subregistriesrr&)r#r$rs r%r&AdapterRegistry.__init__s#!( 9 9 ; r(c"SURU'grGr0rs r%_addSubregistryAdapterRegistry._addSubregistrys#$a r(c>XR;aURU ggrr3rs r%_removeSubregistry"AdapterRegistry._removeSubregistrys! %% %%%a( &r(c>URRSS5nUHnX1;dM URU5 M UHnX2;dM URU5 M [TU]U5 g)Nr!r;)r*rVr7r4rr,)r#r$rr[rs r%r,AdapterRegistry._setBasessdmm R0A~$$T*A|!!$' % r(c>[TU]U5 URR5HnURU5 M gr)rr+r0r)r#rJsubrs r%r+AdapterRegistry.changeds6 *+((--/C KK* +0r(r3r)rrrrrr*r4r&r4r7r,r+rrrs@r%r r s-  K %) !,,r(c\rSrSrSrg)VerifyingAdapterLookupir;Nr+r;r(r%r?r?r,r(r?c\rSrSrSr\rSrg)r iz* The most commonly-used adapter registry. r;N)rrrrrr?r4rr;r(r%r r s)Kr(cUc[$U$rr)xs r%rRrRsyr(c URnXE:a?XRH,nU"U5nU(dM[XX#US-U5n U cM*U s $ gUH,n U"U 5nU(dMURU5n U cM*U s $ grG)rV__sro__r) r^specsrYr8rolcomponents_getspeccompsr[ifaces r%rrs  ^^NuH$$D"4(EuE(!a%C=H % E"5)EuIIdO=H  r(c URnXE:aA[XR5H%nU"U5nU(dM[XX#US-U5 M' g[U5H%n U"U 5nU(dMUR U5 M' grG)rVr~rDrupdate) r^rErYrrorFrGrHrIrJs r%rrst^^NuUX--.D"4(Eu51q5!D/ h'E"5)Eu e$(r(c DURnXV:aA[XR5H%nU"U5n U (dM[XX#XES-U5 M' g[U5H?n U"U 5n U (dMU RU5n U (dM.UR U 5 MA grG)rVr~rDr$extend) r^rErYr8rrorFrGrHrIrJs r%r$r$s ^^NuUX--.D"4(Eu(&a%/h'E"5)Eu $5MM%( (r()rrrzope.interfacerrrrzope.interface._compatrr zope.interface.interfacesr __all__rrrrrrrr*r r?r rRrrr$r;r(r%rSs $&%2.6 H\!\!~( kk k\ # &#  # LeeP %z  %,)%,%,P .   )2))0 %)r(