7 SrSSKrSSKrSSKrSSKrSSKJr SSKJr SSK J r Sr S\ S\ S \ S \ S \R4 S jrS\ S\ S \ S \ S \\ 4 S jrS\ S\ S \ S \ S\ S S4 Sjrg)zRProvides Logic for Fetching and Storing Discovery Documents from an on-disc cache.N)Optional)logging) stringutilzapi_discovery.json cache_root discovery_urlapi_name api_versionreturnc[R"URS55R5n[R "UUUU[ 5$)z:Returns the cache file name for the given api and version.utf-8)hashlibsha1encode hexdigestpathlibPath_DISCOVERY_CACHE_FILE)rrrr url_hashs ;platform/bq/discovery_documents/discovery_document_cache.py_get_cache_file_namersF \\-..w7 8 B B D(   c~[XX#5n[RRU5(d[R "SU5 g[ US5nUR5nSSS5 WRS5$!,(df  N=f![a!n[R"SXG5 SnAgSnAff=f)aLoads a discovery document from the on-disc cache using key `api` and `version`. Args: cache_root: [str], a directory where all cache files are stored. discovery_url: [str], URL where the discovery document was fetched from. api_name: [str], Name of api `discovery_document` to be saved. api_version: [str], Version of document to get Returns: Discovery document as a dict. None if any errors occur during loading, or parsing the document zDiscovery doc not in cache. %sNrbr z'Error loading discovery document %s: %s) rospathisfilerinfoopenreaddecode Exceptionwarning)rrrr filefcontentses rget_from_cacher'!s j O$    LL148  dD Qh  ??7 ##    OO=tG s0 BB'B B B B<B77B<discovery_documentc:[XX#5nURnUR5(agURSSS9 [R "US9n[ R"U5S- nURS5n U R[R"US55 U R5 [R"U R55 SSS5 UR!U5 SSS5 g!,(df  N(=f!,(df  g=f)aSaves a discovery document to the on-disc cache with key `api` and `version`. Args: cache_root: [str], a directory where all cache files are stored. discovery_url: [str], URL where the discovery document was fetched from. api_name: [str], Name of api `discovery_document` to be saved. api_version: [str], Version of `discovery_document`. discovery_document: [str]. Discovery document as a json string. Raises: OSError: If an error occurs when the file is written. NT)parentsexist_ok)dirztmp.jsonwbutf8)rparentexistsmkdirtempfileTemporaryDirectoryrrrwriter ensure_binaryflushrfsyncfilenorename) rrrr r(r# directorytmpdirtemp_file_pathr$s r save_to_cacher=As( j O$kk) [[]]  //$/.""y1V\\&)J6N   T "aggj&&'96BCggihhqxxz #$21 " "21s%+D >AC;D ; D D  D)__doc__r rrr2typingrabslrpyglibrrstrrrr'r=rrrDsX -  $' 36 EH  \\ $'36EH c]@. . . .  .  .  . r