sg` %SSKJr SSKJrJrJr SSKJr SSKJ r J r J r J r J r SSKJrJrJr SSKJrJr SSKJrJrJr SSKJr SS KJr SS KJr SS K J!r!J"r#J$r$J%r%J&r& \"5r'S \(S '\"5r)S\(S'"SS\5r*\*RVr,"SS\ \$5r-S0Sjr.S1Sjr/"SS5r0\"SS\ \$55r1\1"SSSSSS9\1l2\"S S!\ \$55r3S2S"jr4\"S#S$\%\!\3\$455r5\"S%\#\ \3\ \3\ S&9r6\"S'S(\ \$\6455r7\"S)S*\ \$55r8\"S+S,\ \$55r9\"S-S.\ \$55r"g/!\a SSKJr GN5f=f)3) annotations)IterableIteratorSequence)Enum)AnyCallableClassVarGenericProtocol)unquote urldefragurljoin)evolvefield) HashTrieMap HashTrieSetList)TypeVar) exceptions)frozen)URIAnchorDMappingRetrieveHashTrieSet[URI]EMPTY_UNCRAWLED List[URI]EMPTY_PREVIOUS_RESOLVERSc\rSrSrSrSrSrg)_Unsetz What sillyness... N)__name__ __module__ __qualname____firstlineno____doc__SENTINEL__static_attributes__r%3/usr/lib/python3/dist-packages/referencing/_core.pyr"r"sHr-r"c.\rSrSrSSjrSrg)_MaybeInSubresource#cgNr%)selfsegmentsresolver subresources r.__call___MaybeInSubresource.__call__$s r-r%N)r5zSequence[int | str]r6 Resolver[D]r7 Resource[D]returnr:)r&r'r(r)r8r,r%r-r.r0r0#s-%!   r-r0c[U[5(d[R"U5eUR S5n[U[ 5(d[R"U5eSSKJn U"U5$)N$schemarspecification_with) isinstancerrCannotDetermineSpecificationgetstrreferencing.jsonschemar@)contentsjsonschema_dialect_idr@s r._detect_or_errorrH,s] h ( (55h??$LL3 +S 1 155h??9 3 44r-c^SU4SjjnU$)Ncx>[U[5(dT$URS5nUcT$SSKJn U"UTS9$)Nr>rr?default)rArrCrEr@)rFrGr@rLs r._detect#_detect_or_default.._detect<sE(G,,N ( Y 7 (N=! !  r-rFrr<Specification[D]r%)rLrMs` r._detect_or_defaultrQ9s   Nr-c*\rSrSrSSjrSrg)_SpecificationDetectorNc*Uc[$[U5$r3)rHrQ)r4instanceclss r.__get___SpecificationDetector.__get__Os  # #%h/ /r-r%N)rVzSpecification[D] | NonerWztype[Specification[D]]r<Callable[[D], Specification[D]])r&r'r(r)rXr,r%r-r.rSrSNs#0)0$0 ) 0r-rSc\rSrSr%SrS\S'S\S'S\S'S \S '\"S S 9rS \S'S\S'\"5r SSjr SSjr SSjr Sr g) SpecificationZz A specification which defines referencing behavior. The various methods of a `Specification` allow for varying referencing behavior across JSON Schema specification versions, etc. rDnamezCallable[[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]]OPAQUEc$SUR<S3$)Nz)r^r4s r.__repr__Specification.__repr__s%dii]!44r-c$URX5$)z7 Retrieve the anchors contained in the given document. )rer4rFs r.rbSpecification.anchors_ins//r-c[XS9$)zB Create a resource which is interpreted using this specification. )rF specification)Resourcerms r.create_resourceSpecification.create_resources>>r-r%Nr<rD)rFrrFrr<r;)r&r'r(r)r*__annotations__rrerSdetectrjrbrrr,r%r-r.r\r\Zsa I %$0/10 L!" )(B$ %F50 ?r-r\opaquecgr3r%rFs r.r{s4r-c/$r3r%rzs r.r{r{sRr-c/$r3r%)rprFs r.r{r{srr-cU$r3r%r5r6r7s r.r{r{sr-)r^r_r`rbrac\rSrSr%SrS\S'\"SS9rS\S'\\ 4SS jj5r \SS j5r SS jr SS jr SS jrSSjrSrg)rqan 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). rrFrprcrP_specificationcBURU5nURUS9$)a 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 rz)rwrr)rWrFdefault_specificationrps r. from_contentsResource.from_contentss((.44X> ,,h,??r-c<[RRUS9$)zm Create an opaque `Resource` -- i.e. one with opaque specification. See `Specification.OPAQUE` for details. rz)r\rfrr)rWrFs r.rxResource.opaques##33X3FFr-cvURRUR5nUcgURS5$)? Retrieve this resource's (specification-specific) identifier. N#)rr_rFrstrip)r4ids r.r Resource.ids4 & &t}} 5 : yy~r-cb^U4SjTRRTR55$)z( Retrieve this resource's subresources. c3`># UH#n[RUTRS9v M% g7f))rN)rqrr).0eachr4s r. (Resource.subresources..s: K  " "&*&9&9 # Ks+.)rr`rFris`r. subresourcesResource.subresourcess, ++;;DMMJ   r-cLURRUR5$)r)rrbrFris r.anchorsResource.anchorss""--dmm<r-rqc*[R"US9e)Nr)rNoSuchResource)uris r._fail_to_retriever%s  # # ,,r-cP\rSrSr%Sr\"\"5\RSS9rS\ S'\"5r S\ S'\ r S \ S '\"\ S S 9rS \ S'S!SjrS"SjrS#SjrS$SjrS%SjrS&SjrS'SjrS(SjrS)SjrS*SjrS+SjrS,SjrS-SjrS.SjrS/S0SjjrS1SjrSrg )2Registryi)a 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)rL converterrdzHashTrieMap[URI, Resource[D]] _resourcesz+HashTrieMap[tuple[URI, str], AnchorType[D]]_anchorsr _uncrawledretrieve)rLrdz Retrieve[D] _retrievecURURS5$![a [R"US9Sef=f)zF Return the (already crawled) `Resource` identified by the given URI. rrN)rrKeyErrorrrr4rs r. __getitem__Registry.__getitem__Ks@ ???3::c?3 3 ?++4$ > ?s  Ac,[UR5$)z0 Iterate over all crawled URIs in the registry. )iterrris r.__iter__Registry.__iter__TsDOO$$r-c,[UR5$)zE Count the total number of fully crawled resources in this registry. )lenrris r.__len__Registry.__len__Zs4??##r-c[U[5(aU4nURnURnUHLnUR 5nUc[ R "US9eURU5nURXT5nMN [XUS9$)a 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 )rr uncrawled) rArqrrrr NoInternalIDinsertr)r4newrrrrs r. __rmatmul__Registry.__rmatmul__`s@ c8 $ $&COO OO HBz --x@@!((,I!((6I  d9EEr-c[U5nUS:XaSOSnUR(a)[UR5nX1:XaSU3nO USUS3nOUnSUSUS 3$) Nr$rrz uncrawled z, z uncrawledz )rr)r4size pluralizedrsummarys r.rjRegistry.__repr__sm4y#'19Z+ ??DOO,I &zl3'L9+Z@# GTF!G9B//r-cURRU5nUb [XS9$UR5nURRU5nUb [X2S9$UR U5nUR X5n[X2S9$![ R[ R4a e[an[ R"US9UeSnAff=f)a 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) rrC Retrievedcrawlr with_resourcerrBr Exception Unretrievable)r4rrrrs r.get_or_retrieveRegistry.get_or_retrieves??&&s+  d; ;::<&&**3/  h? ? @))#.H --c ?s B .C9CCc ^TUR;a[R"TS9e[UURR T5UR R T5[U4SjURR555S9$)zH Return a registry with the resource identified by a given URI removed. rc3D># UHupUST:wdMX4v M g7f)rNr%)rkvrs r.r"Registry.remove..s% #841AaDCK#8s  )rrr) rrrrremoverdiscardrritemsrs `r.rRegistry.removesx doo %++4 4 oo,,S1oo--c2 #'==#6#6#8    r-cURRX45nUb [X0S9$UR5nURRX45nUb [X4S9$XnUR 5nUb(URRXb45nUb [X4S9$SU;a[ R "UUUS9e[ R"XUS9e)zH Retrieve a given anchor from a resource which must already be crawled. )rrr)rranchor)rrCrrrr InvalidAnchor NoSuchAnchor)r4rr^rrr canonical_uris r.rRegistry.anchors !!3+.  58 8::<!!%%sk2  5< <9  $%%))=*?@E  u@@ $;**!  %%#NNr-cXR$)zF Retrieve the (already crawled) contents identified by the given URI. rzrs r.rFRegistry.contentssy!!!r-c^URnURnURVs/sHo3X4PM nnU(aUR5umnUR 5nUb[ TU5mUR TU5nUR5H!nUR TUR4U5nM# URU4SjUR555 U(aM[UUU[S9$s snf)z6 Crawl all added resources, discovering subresources. c3,># UH nTU4v M g7fr3r%)rrrs r.r!Registry.crawl..sM5LTc4[5Ls)rrr) rrrpoprrrrr^extendrrr)r4rrrrrrrs ` r.rRegistry.crawlsOO --6:ooFos9>*o F%MMOMCB~c2&%,,S(;  ((*!..#tyy)94@+   MX5J5J5LM Mi %   GsC;c(URX4/5$)z@ Add the given `Resource` to the registry, without crawling it. with_resources)r4rrs r.rRegistry.with_resources""SO#455r-cURnURnUH8upEURS5nURU5nURXE5nM: [ XUS9$)zE Add the given `Resource`\ s to the registry, without crawling them. rr)rrrrr)r4pairsrrrrs r.rRegistry.with_resourcess`OO OO "MC**S/C!((-I!((7I # d9EEr-c :^URU4SjU55$)zG Add the given contents to the registry, autodetecting when necessary. c3Z># UH upU[R"U40TD64v M" g7fr3)rqr)rrrkwargss r.r)Registry.with_contents..!s/# " (((88 9"s(+r)r4rrs `r. with_contentsRegistry.with_contentss%""# "#   r-cX4:XaU$URnURnURnURnUHnUR UR5nUR UR5nUR UR5nUR[ LdMiURUs=La [ LaO O [ S5eURnM [UUUUUS9$)zI Combine together one or more other registries, producing a unified one. z?Cannot combine registries with conflicting retrieval functions.)rrrr)rrrrupdater ValueErrorr)r4 registriesrrrrrs r.combineRegistry.combine&s  KOO --OO >>"H!(()<)<=InnX%6%67G!(()<)<=I!!)::%%XN=NN$%$--#    r-c[XS9$)zF Return a `Resolver` which resolves references against this registry. base_urir)Resolver)r4rs r.r6Registry.resolverDs99r-cfUR5=(d Sn[UURX!5S9$)z4 Return a `Resolver` with a specific root resource. r )rrr)r4rrs r.resolver_with_rootRegistry.resolver_with_rootJs2kkm!r''6  r-r%N)rrr<r;)r<z Iterator[URI])r<r)rz#Resource[D] | Iterable[Resource[D]]r< Registry[D]rt)rrr<zRetrieved[D, Resource[D]]rr)rrr^rD)rrr<r)r<r)rrrr;)rz!Iterable[tuple[URI, Resource[D]]]r<r)rzIterable[tuple[URI, D]]rrr<r)r rr<r)r)rrr<r:)rr;r<r:) r&r'r(r)r*rrconvertrrvrrrrrrrrrrjrrrrFrrrrr r6rr,r%r-r.rr)s.16 %%1J- =HMH9I#2J 2"+>#   NNCG%gdnnc&BCMC >66s;I   s # #||Y-?-?#|NH??**8*O O !**11#@I||Y-?-?#|NH??**H*= =<<););c<J!9!9HMM(( =))c2 <'' >))c2 = >s D;;>C~~% %"s$&c URnUR(a1U(aXR:waURUR5n[U4XS.UD6$)z) Evolve, appending to the dynamic scope. )rr)r!r push_frontr)r4rrrs r.r%Resolver._evolvesH>> >>8x>>/I**4>>:HdKXKFKKr-r%N)rrr<r)r7r;r<r:)r<z!Iterable[tuple[URI, Registry[D]]])rrrr)r&r'r(r)r*rrrvrrr!r)r,r/r%r,r%r-r.rrrsT*,Is,"4I{4 e:NIyN-N^B&Lr-rc8\rSrSr%SrS\S'S\S'S SjrSrg ) riz" A simple anchor in a `Resource`. rDr^r;rc>[URRUS9$)z& Return the resource for this anchor. r)rrrF)r4r6s r.r&Anchor.resolves!7!7(KKr-r%N)r6r:)r&r'r(r)r*rvr&r,r%r-r.rrs ILr-rNrO)rLrPr<rZr): __future__rcollections.abcrrrenumrtypingrr r r r urllib.parser rrattrsrrrpdsrrrtyping_extensionsr ImportError referencingrreferencing._attrsrreferencing.typingrr AnchorTyperrrrrvr r"r+_UNSETr0rHrQrSr\rfrqrrrrrrr%r-r.rEs"88==44//)#%NN$/M!1&*f),T (1+ 5 $* 0 0N?GAJN?N?b%  '1I  l>wqzl>l>^-h wsHQK'(h h X sO SM SM ++,wqz`Lwqz`L`LF LWQZ L LUsE// E?>E?