De dZddlmZddlmZddlmZmZddlZddl m Z ddl m Z m Z mZedZdeje jfddZdS)z2 Helpers related to (dynamic) resource retrieval. ) annotations lru_cache)CallableTypeVarN)Resource)URIDRetrieve_Tcache+Callable[[Retrieve[D]], Retrieve[D]] | NoneloadsCallable[[_T], D] from_contentsCallable[[D], Resource[D]]return,Callable[[Callable[[URI], _T]], Retrieve[D]]c@tddfd }|S)a Create a retriever which caches its return values from a simpler callable. Takes a function which returns things like serialized JSON (strings) and returns something suitable for passing to `Registry` as a retrieve function. This decorator both reduces a small bit of boilerplate for a common case (deserializing JSON from strings and creating `Resource` objects from the result) as well as makes the probable need for caching a bit easier. Retrievers which otherwise do expensive operations (like hitting the network) might otherwise be called repeatedly. Examples -------- .. testcode:: from referencing import Registry import referencing.retrieval @referencing.retrieval.to_cached_resource() def retrieve(uri: str): print(f"Retrieved {uri}") # Normally, go get some expensive JSON from the network, a file ... return ''' { "$schema": "https://json-schema.org/draft/2020-12/schema", "foo": "bar" } ''' one = Registry(retrieve=retrieve).get_or_retrieve("urn:example:foo") print(one.value.contents["foo"]) # Retrieving the same URI again reuses the same value (and thus doesn't # print another retrieval message here) two = Registry(retrieve=retrieve).get_or_retrieve("urn:example:foo") print(two.value.contents["foo"]) .. testoutput:: Retrieved urn:example:foo bar bar N)maxsizeretrieveCallable[[URI], _T]c*dfd }|S)Nurir cF|}|}|S)N)rresponsecontentsrrrs 5lib/python3.11/site-packages/referencing/retrieval.pycached_retrievez>to_cached_resource..decorator..cached_retrieveKs-x}}HuXH =** *)rr r)rr r rrs` r decoratorz%to_cached_resource..decoratorJs>  + + + + + + +  + r!)rrr)r rrr"s``` rto_cached_resourcer#sMl }$''' r!)r rrrrrrr)__doc__ __future__r functoolsrtypingrrjson referencingrreferencing.typingr r r r rrr#rr!rr+s#"""""$$$$$$$$ ////////// WT]]:>#z080FBBBBBBBr!