Mh` UddlmZddlmZmZmZddlmZddlm Z m Z m Z m Z m Z ddlmZmZmZddlmZmZddlmZmZmZ ddlmZn#e$r ddlmZYnwxYwdd lmZdd lmZdd l m!Z!m"Z#m$Z$m%Z%m&Z&eZ'd e(d <eZ)de(d<GddeZ*e*j+Z,Gdde e$Z-d8dZ.d9dZ/GddZ0eGdde e$Z1e1d d!d"d#d$%e1_2eGd&d'e e$Z3d:d*Z4eGd+d,e%e!e3e$fZ5ed-e#e e3e e3e .Z6eGd/d0e e$e6fZ7eGd1d2e e$Z8eGd3d4e e$Z9eGd5d6e e$Z"d7S);) annotations)IterableIteratorSequence)Enum)AnyCallableClassVarGenericProtocol)unquote urldefragurljoin)evolvefield) HashTrieMap HashTrieSetList)TypeVar) exceptions)frozen)URIAnchorDMappingRetrieveHashTrieSet[URI]EMPTY_UNCRAWLED List[URI]EMPTY_PREVIOUS_RESOLVERSceZdZdZdZdS)_Unsetz What sillyness... N)__name__ __module__ __qualname____doc__SENTINELQ/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/referencing/_core.pyr"r"sHHHr*r"ceZdZd dZd S) _MaybeInSubresourcesegmentsSequence[int | str]resolver Resolver[D] subresource Resource[D]returncdSNr))selfr.r0r2s r+__call__z_MaybeInSubresource.__call__$s cr*N)r.r/r0r1r2r3r4r1)r$r%r&r8r)r*r+r-r-#s(r*r-contentsrr4Specification[D]ct|tstj||d}t|t stj|ddlm}||S)N$schemarspecification_with) isinstancerrCannotDetermineSpecificationgetstrreferencing.jsonschemar>)r9jsonschema_dialect_idr>s r+_detect_or_errorrE,s h ( (@5h???$LL33 +S 1 1@5h???999999  3 4 44r*defaultCallable[[D], Specification[D]]cdfd }|S)Nr9rr4r:ct|tsS|d}|Sddlm}||S)Nr<rr=rF)r?rrArCr>)r9rDr>rFs r+_detectz#_detect_or_default.._detect<si(G,, N ( Y 7 7 (N======!! !    r*r9rr4r:r))rFrKs` r+_detect_or_defaultrM9s(        Nr*ceZdZd dZdS) _SpecificationDetectorinstanceSpecification[D] | Noneclstype[Specification[D]]r4rGc2|tSt|Sr6)rErM)r7rPrRs r+__get__z_SpecificationDetector.__get__Os  # #%h// /r*N)rPrQrRrSr4rG)r$r%r&rUr)r*r+rOrONs(000000r*rOceZdZUdZded<ded<ded<ded <ed Zd ed <ded<eZddZ ddZ ddZ dS) Specificationz A specification which defines referencing behavior. The various methods of a `Specification` allow for varying referencing behavior across JSON Schema specification versions, etc. rBnamezCallable[[D], URI | None]id_ofzCallable[[D], Iterable[D]]subresources_ofz_MaybeInSubresource[D]maybe_in_subresource anchors_inaliasz8Callable[[Specification[D], D], Iterable[AnchorType[D]]] _anchors_inzClassVar[Specification[Any]]OPAQUEr4cd|jdS)Nz)rXr7s r+__repr__zSpecification.__repr__s4di4444r*r9rc.|||S)zG Retrieve the anchors contained in the given document. )r_r7r9s r+r\zSpecification.anchors_insh///r*r3c$t||S)zR Create a resource which is interpreted using this specification. )r9 specification)Resourcerfs r+create_resourcezSpecification.create_resources>>>>r*Nr4rB)r9rr9rr4r3) r$r%r&r'__annotations__rr_rOdetectrdr\rjr)r*r+rWrWZsIII%$$$0///1000 L!!!"""")(((B$ # % %F55550000 ??????r*rWopaquecdSr6r)r9s r+rrs4r*cgSr6r)rqs r+rrrrsRr*cgSr6r))rhr9s r+rrrrsrr*c|Sr6r)r.r0r2s r+rrrrsr*)rXrYrZr\r[ceZdZUdZded<edZded<eefdd Z edd Z ddZ ddZ ddZ d dZdS)!ria A document (deserialized JSON) with a concrete interpretation under a spec. In other words, a Python object, along with an instance of `Specification` which describes how the document interacts with referencing -- both internally (how it refers to other `Resource`\ s) and externally (how it should be identified such that it is referenceable by other documents). rr9rhr]r:_specificationdefault_specification)type[Specification[D]] | Specification[D]r4r3cX||}||S)aG Create a resource guessing which specification applies to the contents. Raises: `CannotDetermineSpecification` if the given contents don't have any discernible information which could be used to guess which specification they identify as rq)rnrj)rRr9ryrhs r+ from_contentszResource.from_contentss.(.44X>> ,,h,???r*cBtj|S)z Create an opaque `Resource` -- i.e. one with opaque specification. See `Specification.OPAQUE` for details. rq)rWr`rj)rRr9s r+rozResource.opaques#33X3FFFr* URI | Nonecr|j|j}|dS|dS)O Retrieve this resource's (specification-specific) identifier. N#)rxrYr9rstrip)r7ids r+rz Resource.ids6 & &t} 5 5 : Fyy~~r*Iterable[Resource[D]]cZfdjjDS)z8 Retrieve this resource's subresources. c3ZK|]%}t|jV&dS))ryN)rir|rx).0eachr7s r+ z(Resource.subresources..sW    " "&*&9 #        r*)rxrZr9rcs`r+ subresourceszResource.subresourcessC    +;;DMJJ     r*Iterable[AnchorType[D]]c@|j|jS)r)rxr\r9rcs r+anchorszResource.anchorss"--dm<<$>$>$>$>$>r*riurirc,tj|)Nr)rNoSuchResource)rs r+_fail_to_retriever%s  # , , ,,r*c&eZdZUdZeeejdZded<eZ ded<e Z ded <ee d Z d ed <d6dZd7dZd8dZd9dZd:dZd;dZdd#Zd?d$Zd@d&ZdAd)ZdBd-ZdCd/ZdDdEd3ZdFd4Zd5S)GRegistryab A registry of `Resource`\ s, each identified by their canonical URIs. Registries store a collection of in-memory resources, and optionally enable additional resources which may be stored elsewhere (e.g. in a database, a separate set of files, over the network, etc.). They also lazily walk their known resources, looking for subresources within them. In other words, subresources contained within any added resources will be retrievable via their own IDs (though this discovery of subresources will be delayed until necessary). Registries are immutable, and their methods return new instances of the registry with the additional resources added to them. The ``retrieve`` argument can be used to configure retrieval of resources dynamically, either over the network, from a database, or the like. Pass it a callable which will be called if any URI not present in the registry is accessed. It must either return a `Resource` or else raise a `NoSuchResource` exception indicating that the resource does not exist even according to the retrieval logic. resources)rF converterr^zHashTrieMap[URI, Resource[D]] _resourcesz+HashTrieMap[tuple[URI, str], AnchorType[D]]_anchorsr _uncrawledretrieve)rFr^z Retrieve[D] _retrieverrr4r3c |j|dS#t$rtj|dwxYw)zV Return the (already crawled) `Resource` identified by the given URI. rrN)rrKeyErrorrrr7rs r+ __getitem__zRegistry.__getitem__KsO ??3::c??3 3 ? ? ?+444$ > ?s "!A Iterator[URI]c*t|jS)z@ Iterate over all crawled URIs in the registry. )iterrrcs r+__iter__zRegistry.__iter__TsDO$$$r*rc*t|jS)zU Count the total number of fully crawled resources in this registry. )lenrrcs r+__len__zRegistry.__len__Zs4?###r*new#Resource[D] | Iterable[Resource[D]] Registry[D]c(t|tr|f}|j}|j}|D]X}|}|t j|||}|||}Yt|||S)a2 Create a new registry with resource(s) added using their internal IDs. Resources must have a internal IDs (e.g. the :kw:`$id` keyword in modern JSON Schema versions), otherwise an error will be raised. Both a single resource as well as an iterable of resources works, i.e.: * ``resource @ registry`` or * ``[iterable, of, multiple, resources] @ registry`` which -- again, assuming the resources have internal IDs -- is equivalent to calling `Registry.with_resources` as such: .. code:: python registry.with_resources( (resource.id(), resource) for resource in new_resources ) Raises: `NoInternalID` if the resource(s) in fact do not have IDs N)rr uncrawled) r?rirrrr NoInternalIDinsertr)r7rrrrrs r+ __rmatmul__zRegistry.__rmatmul__`s@ c8 $ $ &CO O  7 7HBz -x@@@@!((,,I!((X66IIdi9EEEEr*rBct|}|dkrdnd}|jr)t|j}||krd|}n |d|d}n|}d|d|d S) Nr#rrz uncrawled z, z uncrawledz )rr)r7size pluralizedrsummarys r+rdzRegistry.__repr__s4yy#'199ZZ+ ? &DO,,ID  3z33'@@9@@@#oG/T//G////r*Retrieved[D, Resource[D]]c|j|}|t||S|}|j|}|t||S ||}|||}t||S#t jt jf$rt$r}t j ||d}~wwxYw)aE Get a resource from the registry, crawling or retrieving if necessary. May involve crawling to find the given URI if it is not already known, so the returned object is a `Retrieved` object which contains both the resource value as well as the registry which ultimately contained it. N)registryvaluer) rrA Retrievedcrawlr with_resourcerr@r Exception Unretrievable)r7rrrrs r+get_or_retrievezRegistry.get_or_retrieves ?&&s++  d(;;; ;::<<&**3//  hh??? ? @))#..H --c8< ?s0B,,%C,C''C,c &|jvrtjt||j|jtfd|j DS)zX Return a registry with the resource identified by a given URI removed. rc3>K|]\}}|dk||fVdS)rNr))rkvrs r+rz"Registry.remove..s<  1aAaDCKKAKKKK  r*)rrr) rrrrremoverdiscardrritemsrs `r+rzRegistry.removes do % %+444 4 o,,S11o--c22    #'=#6#6#8#8        r*rXc|j||f}|t||S|}|j||f}|t||S||}|}|/|j||f}|t||Sd|vrt j|||t j|||)zX Retrieve a given anchor from a resource which must already be crawled. N)rrr)rranchor)rrArrrr InvalidAnchor NoSuchAnchor)r7rrXrrr canonical_uris r+rzRegistry.anchors  !!3+..  54888 8::<<!%%sDk22  58<<< <9  $%))=$*?@@E  ux@@@@ $;;*!  %#NNNNr*rc||jS)zV Retrieve the (already crawled) contents identified by the given URI. rqrs r+r9zRegistry.contentssCy!!r*c|j|j}fd|jD}|r|\}|}|&t |||D]}||jf|} | fd| D|t||tS)zF Crawl all added resources, discovering subresources. c$g|] }||f Sr)r))rrrs r+ z"Registry.crawl..s"FFFsc9S>*FFFr*Nc3 K|]}|fV dSr6r))rrrs r+rz!Registry.crawl..s'MMTc4[MMMMMMr*)rrr) rrrpoprrrrrXextendrrr)r7rrrrrrrs @@r+rzRegistry.crawlsO -FFFFdoFFF  N%MMOOMCB~c2&&%,,S(;;  ((** A A!..#ty)94@@   MMMMX5J5J5L5LMMM M M M N %     r*rc2|||fgS)zP Add the given `Resource` to the registry, without crawling it. with_resources)r7rrs r+rzRegistry.with_resources""S(O#4555r*pairs!Iterable[tuple[URI, Resource[D]]]c|j}|j}|D]E\}}|d}||}|||}Ft |||S)zU Add the given `Resource`\ s to the registry, without crawling them. rr)rrrrr)r7rrrrrs r+rzRegistry.with_resourcessuO O " 8 8MC**S//C!((--I!((h77IIdi9EEEEr*Iterable[tuple[URI, D]]kwargsrc F|fd|DS)zW Add the given contents to the registry, autodetecting when necessary. c3FK|]\}}|tj|fifVdSr6)rir|)rrrrs r+rz)Registry.with_contents..!sS# # T((8888 9# # # # # # r*r)r7rrs `r+ with_contentszRegistry.with_contentssC""# # # # "# # #    r* registriesc||fkr|S|j}|j}|j}|j}|D]}||j}||j}||j}|jt ur,|j|cxur t urnnt d|j}t|||||S)zY Combine together one or more other registries, producing a unified one. z?Cannot combine registries with conflicting retrieval functions.)rrrr)rrrrupdater ValueErrorr)r7rrrrrrs r+combinezRegistry.combine&s $ KO -O >" . .H!(()<==InnX%677G!(()<==I!):::%XNNNN=NNNNNN$%$-      r*base_urir1c$t||S)zV Return a `Resolver` which resolves references against this registry. rr)Resolver)r7rs r+r0zRegistry.resolverDsD9999r*cx|pd}t||||S)zD Return a `Resolver` with a specific root resource. rr)rrr)r7rrs r+resolver_with_rootzRegistry.resolver_with_rootJsCkkmm!r''X66    r*N)rrr4r3)r4r)r4r)rrr4rrk)rrr4rrr)rrrXrB)rrr4r)r4r)rrrr3)rrr4r)rrrrr4r)rrr4r)r)rrr4r1)rr3r4r1)r$r%r&r'rrconvertrrmrrrrrrrrrrdrrrr9rrrrrr0rr)r*r+rr)s.16 %111J =HKMMHIIII#2J2222"U+>#   D NCGCC%gdnc&B&BCCMC >66s;;II( = = =)c222 <' > > >)c222 = >   s # # P||Y-?#|NNH?**8h*OO O  >!*11#x@@I||Y-?#|NNH?**H*== =<<);c<JJ!9HMMMMsA))3B7B22B7r2r3r1cz|}||St|t|j|S)zV Create a resolver for a subresource (which may have a new base URI). N)r)rrrr)r7r2rs r+in_subresourcezResolver.in_subresources<^^   :KdWT^R%@%@AAAAr*!Iterable[tuple[URI, Registry[D]]]c#4K|jD] }||jfVdS)zT In specs with such a notion, return the URIs in the dynamic scope. N)rrrs r+ dynamic_scopezResolver.dynamic_scopes9> & &Ct~% % % % % & &r*rrc |j}|jr'|r ||jkr||j}t|f||d|S)z9 Evolve, appending to the dynamic scope. )rr)rr push_frontr)r7rrrs r+r zResolver._evolvesZ> > ;8 ;x4>/I/I**4>::HdKXKKFKKKr*N)rrr4r)r2r3r4r1)r4r)rrrr)r$r%r&r'rrrmrrrrrrr r)r*r+rrrs*U,,,I,,,,"U444I4444 5e:NNNINNNN-N-N-N-N^BBBB&&&&LLLLLLr*rc0eZdZUdZded<ded<d dZd S) rz* A simple anchor in a `Resource`. rBrXr3rr0r1c8t|jj|S)z6 Return the resource for this anchor. r)rrr9)r7r0s r+r zAnchor.resolves!7(KKKKr*N)r0r1)r$r%r&r'rmr r)r*r+rrsQIIILLLLLLr*rNrL)rFr:r4rGr): __future__rcollections.abcrrrenumrtypingrr r r r urllib.parser rrattrsrrrpdsrrrtyping_extensionsr ImportError referencingrreferencing._attrsrreferencing.typingrr AnchorTyperrrrrmr r"r(_UNSETr-rErMrOrWr`rirrrrrrr)r*r+r(s"""""""8888888888==============4444444444//////////)))))))#"""""%%%%%%NNNNNNNNNNNNNN$/KMM1111&*dff,,,,T (1+ 5 5 5 5* 0 0 0 0 0 0 0 0N?N?N?N?N?GAJN?N?N?b%}   ''11II  l>l>l>l>l>wqzl>l>l>^----h h h h h wsHQK'(h h h X 7sO SM SM ++,wqz`L`L`L`L`Lwqz`L`L`LF L L L L LWQZ L L L L LsA AA