-Phr DUdZddlmZddlmZddlmZerYddlmZddlm Z m Z m Z m Z ddl mZddlmZeZeZed zZeeeefZd ed <eeeeeeeed ffffZejd Zded<GddZGddZd S)z=This module contains code shared between intersphinx modules.) annotations) TYPE_CHECKING)logging)Sequence)AnyFinalNoReturn TypeAlias)BuildEnvironment) InventoryNr InventoryCacheEntry.zsphinx.ext.intersphinxz"Final[logging.SphinxLoggerAdapter]LOGGERcjeZdZUded<ded<ded<ddd d ZddZddZd dZd!dZd"dZ d#dZ dS)$_IntersphinxProject InventoryNamename InventoryURI target_uriztuple[InventoryLocation, ...] locationszOThe inventory name. It is unique and in bijection with an remote inventory URL.zlThe inventory project URL to which links are resolved. It is unique and in bijection with an inventory name.zzA tuple of local or remote targets containing the inventory data to fetch. None indicates the default inventory file name.)rrrSequence[InventoryLocation]returnNonec |rt|tsd}t||rt|tsd}t||rt|tsd}t|t d|Drd}t|t |d|t |d|t |dt|dS) Nzname must be a non-empty stringz%target_uri must be a non-empty stringz#locations must be a non-empty tuplec3PK|]!}|duo| pt|t V"dSN) isinstancestr).0locations ^/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/ext/intersphinx/_shared.py z/_IntersphinxProject.__init__..KsT   D T(l&S*Xs:S:S6S      z,locations must be a tuple of strings or Nonerrr)rr ValueErrortupleanyobject __setattr__)selfrrrmsgs r __init__z_IntersphinxProject.__init__;s ":dC00 "3CS// ! "J!.>?????r"rcP|jjd|jd|jd|jdS)Nz(name=z , target_uri=z , locations=)) __class____name__rrrr(s r __repr__z_IntersphinxProject.__repr__UsM~& - -I - -/ - - - - - r"otherr&boolct|tstS|j|jko|j|jko|j|jkSr)rrNotImplementedrrr)r(r1s r __eq__z_IntersphinxProject.__eq__]sO%!455 "! ! I # 25#33 2%/1 r"intcDt|j|j|jfSr)hashrrrr/s r __hash__z_IntersphinxProject.__hash__fsTY@AAAr"keyvaluerr c>|jjd}t|Nz is immutabler-r.AttributeError)r(r:r;r)s r r'z_IntersphinxProject.__setattr__i#(777S!!!r"c>|jjd}t|r=r>)r(r:r)s r __delattr__z_IntersphinxProject.__delattr__mr@r"N)rrrrrrrr)rr)r1r&rr2)rr6)r:rr;rrr )r:rrr ) r. __module__ __qualname____annotations__ __slots__r*r0r5r9r'rBr"r rr,s,,,,TNH I@@@@4        BBBB""""""""""r"rcjeZdZdZddZeddZedd Zedd Zdd Z dS)InventoryAdapterz!Inventory adapter for environmentenvr rrc||_t|ds&i|j_i|j_i|j_dSdS)Nintersphinx_cache)rJhasattrrLintersphinx_inventoryintersphinx_named_inventory)r(rJs r r*zInventoryAdapter.__init__usJs/00 6)+DH &-/DH *35DH 0 0 0  6 6r"'dict[InventoryURI, InventoryCacheEntry]c|jjS)aAIntersphinx cache. - Key is the URI of the remote inventory. - Element one is the key given in the Sphinx :confval:`intersphinx_mapping`. - Element two is a time value for cache invalidation, an integer. - Element three is the loaded remote inventory of type :class:`!Inventory`. )rJrLr/s r cachezInventoryAdapter.cachesx))r"r c|jjSr)rJrNr/s r main_inventoryzInventoryAdapter.main_inventorys x--r"dict[InventoryName, Inventory]c|jjSr)rJrOr/s r named_inventoryz InventoryAdapter.named_inventorys x33r"c~|jj|jjdSr)rJrNclearrOr/s r rYzInventoryAdapter.clears6 &,,... ,2244444r"N)rJr rr)rrP)rr )rrU)rr) r.rCrD__doc__r*propertyrRrTrWrYrGr"r rIrIrs++6666***X*...X.444X4555555r"rI)rZ __future__rtypingr sphinx.utilrcollections.abcrrrr r sphinx.environmentr sphinx.util.typingr rrrInventoryLocationr$r6r rEdictIntersphinxMapping getLoggerrrrIrGr"r rfsCCC"""""" ((((((666666666666333333,,,,,, L M d &+=#y+H%IIIII mU<7H#7M1N#NOOP R .?W->?W-X-XXXXXC"C"C"C"C"C"C"C"L"5"5"5"5"5"5"5"5"5"5r"