o Ni8@s`dZddlmZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZddlmZdd lmZdd lmZmZmZdd lmZdd lmZdd lmZe rddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddlm&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,m-Z-dd'd(Z0d?d.d/Z1d@d2d3Z2dAd5d6Z3dAd7d8Z4dBd:d;Z5dS)CzBThis module contains the code for loading intersphinx inventories.) annotationsN) itemgetter)path) TYPE_CHECKING)urlsplit urlunsplit)INVENTORY_FILENAME) ConfigError)LOGGERInventoryAdapter_IntersphinxProject)__)requests) InventoryFile)Path) HTTPResponse)Sphinx)Config)IntersphinxMappingInventoryCacheEntryInventoryLocation InventoryName InventoryURI) Inventory_ReadableStreamapprconfigrreturnNonec Csi}d}|jD]\}}t|tr|s)|d7}td}t|||j|=q t|tt BsD|d7}td}t||||j|=q z|\}}Wnt t t fyi|d7}td}t||||j|=Yq w|rqt|ts|d7}td}t||||j|=q ||vr|d7}td}t||||||j|=q |||<t|tt Bs|f}g} |D]&} | dus| rt| tr| | q|d7}td }t|| ||j|=q||t| ff|j|<q |dkrtd }t||dkrtd }t||dS) ahValidate and normalise :confval:`intersphinx_mapping`. Ensure that: * Keys are non-empty strings. * Values are two-element tuples or lists. * The first element of each value pair (the target URI) is a non-empty string. * The second element of each value pair (inventory locations) is a tuple of non-empty strings or None. rzrInvalid intersphinx project identifier `%r` in intersphinx_mapping. Project identifiers must be non-empty strings.zTInvalid value `%r` in intersphinx_mapping[%r]. Expected a two-element tuple or list.zgInvalid value `%r` in intersphinx_mapping[%r]. Values must be a (target URI, inventory locations) pair.zjInvalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs must be unique non-empty strings.zInvalid target URI value `%r` in intersphinx_mapping[%r][0]. Target URIs must be unique (other instance in intersphinx_mapping[%r]).Nz{Invalid inventory location value `%r` in intersphinx_mapping[%r][1]. Inventory locations must be non-empty strings or None.z6Invalid `intersphinx_mapping` configuration (1 error).z8Invalid `intersphinx_mapping` configuration (%s errors).)intersphinx_mappingcopyitems isinstancestrr r errortuplelist TypeError ValueError Exceptionappendr ) rrseenerrorsnamevaluemsguriinvtargetstargetr5P/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/ext/intersphinx/_load.pyvalidate_intersphinx_mapping%s     r7c stttjj}|jjj}g}|D]*\}\}}z t |||d}Wnt y=}z t d} t | |d}~ww| |qdd|D} tD]}|d|vr]|=qO|| vrd|=qOtjfdd|D} d dtj| D} Wdn1swYt| r|tdd } t| d }|D]\}}}||j|<|D]\}}|j|i|qqdSdS) zuLoad all intersphinx mappings into the environment. The intersphinx mappings are expected to be normalized. )r. target_uri locationszCAn invalid intersphinx_mapping entry was added after normalisation.NcSsh|]}|jqSr5)r8.0projectr5r5r6 sz load_mappings..rc s&g|]}jt|jjdqS))r<cachenowrsrcdir)submit_fetch_inventory_grouprr@r:rintersphinx_cacher?poolr5r6 s z!load_mappings..cSsg|]}|qSr5)resultr;fr5r5r6rFsr)key)inttimer builderenvr>rr valuesr r)r r r+ frozenset concurrentfuturesThreadPoolExecutor as_completedanyclearrsortednamed_inventoryr"main_inventory setdefaultupdate)r inventoriesr projectsr.r1r9r<errr0 expected_urisrRupdatedby_name_and_time cache_values_expiryinvdataobjtypeobjectsr5rCr6 load_mappingssT            rgr<r r>'dict[InventoryURI, InventoryCacheEntry]r?rKr@rboolc Cs`|jdkr ||jd}nd}d}g}|jD]a}|dur$t|jt} n|} d| vs8|j|vs8||jd|krwttd|j t | z t |j| ||d} Wnt yg} z | | jWYd} ~ qd} ~ ww| rw|j || f||j<d}nq|s} |St|t|jkrttd |D]} tj| q|Sd d d |D} ttd d | |S)NriQF://rz.loading intersphinx inventory '%s' from %s ...r8 inv_locationrr@TzXencountered some issues with some of the inventories, but they had working alternatives: css$|] }|d|ddVqdS)rrNr5rHr5r5r6 s"z)_fetch_inventory_group..zAfailed to reach any of the inventories with the following issues:)intersphinx_cache_limitr9 posixpathjoinr8rr infor r. _get_safe_url_fetch_inventoryr*r+argslenwarning)r<r>r?rr@ cache_timer`failureslocationr2rdr^failissuesr5r5r6rBsn       rBr1rr2r$rcCst|||j|jdS)6Fetch, parse and return an intersphinx inventory file.rk)rtrr@)rr1r2r5r5r6fetch_inventorys r~r8rlc Csdd|vrt|}zd|vrt||d}n tt||d}Wnty5}z d||jt|f|_d}~wwzct |drb|j }||krbt d}t |||||t|t|dhvrbt|}|+z t||tj}Wnty} z d | }t|| d} ~ wwWdW|S1swYW|Sty}z d ||jjt|f|_d}~ww) r}rj)rrbz4intersphinx inventory %r not fetchable due to %s: %sNurlz)intersphinx inventory has moved: %s -> %s/z*unknown or unsupported inventory version: z3intersphinx inventory %r not readable due to %s: %s)_strip_basic_auth_read_from_urlopenrrqr* __class__r$ruhasattrrr r rrdirnamerloadrpr)__name__) r8rlrr@rIr^new_inv_locationr0rdexcr5r5r6rt$sd      rtrcCsht|}|jdur |St|}|jr%|jd|jd|j|d<t|S|jd|j|d<t|S)a5Gets version of *url* with basic auth passwords obscured. This function returns results suitable for printing and logging. E.g.: https://user:12345@example.com => https://user@example.com :param url: a url :type url: ``str`` :return: *url* with password removed :rtype: ``str`` N@:r)rusernamer'porthostnamer)rpartsfragsr5r5r6rsZs rscCs6tt|}d|dvr|ddd|d<t|S)aReturns *url* with basic auth credentials removed. Also returns the basic auth username and password if they're present in *url*. E.g.: https://user:pass@example.com => https://example.com *url* need not include basic auth credentials. :param url: url which may or may not contain basic auth credentials :type url: ``str`` :return: *url* with any basic auth creds removed :rtype: ``str`` rr)r'rsplitr)rrr5r5r6rss  rrcCs@tj|d|j|j|j|jfd}||j|j_d|j_ |jS)uReads data from *url* with an HTTP *GET*. This function supports fetching from resources which use basic HTTP auth as laid out by RFC1738 § 3.1. See § 5 for grammar definitions for URLs. .. seealso: https://www.ietf.org/rfc/rfc1738.txt :param url: URL of an HTTP resource :type url: ``str`` :return: data read from resource described by *url* :rtype: ``file``-like object T)streamtimeout _user_agent _tls_info) rgetintersphinx_timeout user_agent tls_verify tls_cacertsraise_for_statusrrawdecode_content)rrrr5r5r6rs  r)rrrrrr)rrrr) r<r r>rhr?rKrrr@rrri)rrr1rr2r$rr) r8rrlr$rrr@rrr)rr$rr$)rr$rrrr)6__doc__ __future__rconcurrent.futuresrQrprLoperatorrosrtypingr urllib.parserrsphinx.builders.htmlr sphinx.errorsr sphinx.ext.intersphinx._sharedr r r sphinx.localer sphinx.utilrsphinx.util.inventoryrpathlibrurllib3.responsersphinx.applicationr sphinx.configrrrrrrsphinx.util.typingrrr7rgrBr~rtrsrrr5r5r5r6s<               e C M 6