5pjk/%SrSSKJr SSKrSSKrSSKJrJr SSKJ r SSK J r SSK J r JrJrJrJrJrJrJrJrJr SS KJrJr S rS rS r\\\4rS \S'SSjr\"SS9"SS55r Sq!S\S'SSjr"SSjr#/SQr$g)ayRuntime configuration for the ModelScope Hub SDK. Configuration values follow a clear precedence chain: 1. Explicit constructor argument 2. Process environment variable 3. Persisted file on disk (token only) 4. Sensible default This separation keeps the SDK trivially testable: tests can supply a :class:`HubConfig` instance with overrides and never touch real credentials. ) annotationsN) dataclassfield)Path)Any) CONFIG_DIR_NAMECOOKIES_FILE_NAMECREDENTIALS_DIR_NAMEDEFAULT_CACHE_DIR_NAMEDEFAULT_ENDPOINT ENV_CACHEENV_MODELSCOPE_DOMAINGIT_TOKEN_FILE_NAMESESSION_FILE_NAMEUSER_INFO_FILE_NAME) CacheErrorInvalidParameterMODELSCOPE_ENDPOINTMODELSCOPE_API_TOKENMODELSCOPE_HOMEztuple[str, ...]_CREDENTIAL_FILE_NAMEScP[U5R5R5$N)r expanduserresolve)paths Q/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/modelscope_hub/config.py_expandr2s : " * * ,,T)slotscJ\rSrSr%SrSrS\S'\"SS9rS\S '\"S S9r S\S 'Sr S\S '\"S S S S9r S\S'\"S S S S9r S\S'\"S S S S9r S\S'S!Sjr\S"Sj5r\S#Sj5rS!SjrS$SjrS%SjrS!SjrS&SjrS'SjrS(SjrS)SjrS%SjrS*SjrS rg)+ HubConfig6zCentralised runtime configuration object. The dataclass form makes it cheap to copy/override in tests via :func:`dataclasses.replace`, and keeps fields explicit and discoverable. N str | Noneendpointc[[RR[5=(d [ R "5S- [- 5$)Nz.cache)rosenvirongetrrhomer r rHubConfig.@s- y(A(tTYY[S[E[^tEt ur )default_factoryr cache_dirc[[RR[5=(d [ R "5[- 5$r)rr(r)r*ENV_HOMErr+r r,r rr-r.Bs+WRZZ^^H=U=vY]YbYbYdgvYv5wr config_dirtokenF)defaultinitreprbool _logged_out_endpoint_overridden_token_overriddenc$URbSUlO[RR [ 5(a0[RR [ 5UlSUlO[RR [ S5R5nU(aY[R"S[SS9 URS5(dURS5(dSU3nXlSUlO [UlURUR5UlURbSUlg[ [R;a$[R[ UlSUlgUR#5Ulg)NTzVEnvironment variable MODELSCOPE_DOMAIN is deprecated, use MODELSCOPE_ENDPOINT instead.) stacklevelhttp://https://)r&r:r(r)r* ENV_ENDPOINTrstripwarningswarn FutureWarning startswithr normalize_endpointr4r; ENV_TOKEN load_token)selfdomains r __post_init__HubConfig.__post_init__Ks == $(,D % ZZ^^L ) )JJNN<8DM(,D %ZZ^^$92>DDFF l!  ((33F :: !%)D " "** $I.DJ%)D "*DJr cU=(d SR5=(d [nUR5RS5(dSU3nUR S5$)aReturn *endpoint* with a scheme guaranteed and no trailing slash. Bare domains such as ``modelscope.ai`` are common input, especially from the CLI. Without a scheme every request built from them fails deep in the transport layer instead of surfacing a usable error, so the normalisation lives here and is reused by every entry point that accepts an endpoint. Scheme detection is case-insensitive because URI schemes are, so an input like ``HTTPS://host`` is recognised instead of being prefixed a second time. r=)r@rArA/)rCr lowerrGrstrip)r&values rrHHubConfig.normalize_endpointmsOR&&(<,<{{}''(?@@ug&E||C  r c(UR[- $r)r3r )rKs rcredentials_dirHubConfig.credentials_dirs!555r cURRSSS9 URRSSS9 URRSSS9 g![an[ SU35UeSnAff=f)z=Create the config and cache directories if they do not exist.T)parentsexist_okz"Failed to create SDK directories: N)r3mkdirr0rVOSErrorr)rKexcs r ensure_dirsHubConfig.ensure_dirssv R OO ! !$ ! > NN  =  & &td & C RA#GHc Q RsAA A/A**A/cU(aUR5(d [S5eSSKnSSKJn SSKJn SSKJn UR5nU"UR=(d [5R=(d Sn[UR55S-nU"5nURU"S0S S_S S _S U_S S_SS_SU_SS_SS_SS_SS_SS_SU_SS_SS_SS_S0_SS_65 URU5 XlSUlg)zPersist token as ``m_session_id`` cookie in ``credentials/cookies``. Creates a :class:`~requests.cookies.RequestsCookieJar` with a 30-day expiry, matching the old SDK convention where the API token lives exclusively inside the pickled cookie jar. z token must be a non-empty stringrN)Cookie)urlparse)RequestsCookieJarz modelscope.cni'versionname m_session_idrSportport_specifiedFrLdomain_specifiedTdomain_initial_dotrrPpath_specifiedsecureexpiresdiscardcomment comment_urlrestrfc2109r,)rCrtimehttp.cookiejarra urllib.parserbrequests.cookiesrcr&r hostnameint set_cookie save_cookiesr4r9) rKr4rsrarbrcrLrmjars r save_tokenHubConfig.save_tokensGEKKMM"#EF F))6 $--;+;<EEXdiik"^3!    #     %     "& $)   $      !  ! "#  * #  r cUR(agUR5nU(a'UH!nURS:XdMURs $ g)aLoad the API token from ``~/.modelscope/credentials/cookies``. Reads the pickled cookie jar and extracts the ``m_session_id`` value. Returns ``None`` if: - no cookies file exists - the ``m_session_id`` cookie has expired - :meth:`clear_token` was called (explicit logout) Nrf)r9 load_cookiesrerS)rKcookiescookies rrJHubConfig.load_tokensF   ##% !;;.0!<<'"r cSUlSUl[H nURU- R SS9 M" g![ a M2f=f)zRemove every persisted credential artefact. All login artefacts are dropped together. Removing only the session cookie would leave the git token and the cached identity behind, a half-logged-out state that later reads can still pick up. NT) missing_ok)r4r9rrVunlinkr\)rKres r clear_tokenHubConfig.clear_tokensR *D %%,444E+  s: AAcSSKnSSKnUR5 UR[- n[ US5nUR X5 SSS5 URURUR-5 g!,(df  N7=f)z8Pickle cookies to ``~/.modelscope/credentials/cookies``.rNwb) picklestatr^rVr opendumpchmodS_IRUSRS_IWUSR)rKrrrrfs rrzHubConfig.save_cookiessd ##&77 $  KK # 4<<$,,./ s A;; B c|SSKnUR[- nUR5(dg[ US5nUR U5nSSS5 W(dgUH,nURS:XdMUR5(dM, g U$!,(df  NJ=f![ UR4a gf=f)z8Load saved cookies, returning None if absent or expired.rNrbrf) rrVr is_filerloadr\UnpicklingErrorre is_expired)rKrrrrrs rrHubConfig.load_cookiess##&77||~~ dD!Q ++a."F{{n,1B1B1D1D"!//0  s. B"B B" BB"B""B;:B;ctUR5 UR[- nURUSU3SS9 g)z>Save ``username:email`` to ``~/.modelscope/credentials/user``.:utf-8encodingN)r^rVr write_text)rKusernameemailrs rsave_user_infoHubConfig.save_user_infos: ##&99 8*AeW-@r cSSKnUR5 UR[- nUR USS9 UR UR UR-5 g)z:Save git token to ``~/.modelscope/credentials/git_token``.rNrr)rr^rVrrrrr)rK git_tokenrrs rsave_git_tokenHubConfig.save_git_token sK ##&99  G4 4<<$,,./r cUR[- nUR5(a'URSS9R 5=(d S$g![ a gf=f)z> ~~w~7==?G4G  s%A AAcRSSKnUR[- nUR5(a0UR SS9R 5n[ U5S:XaU$UR5RnUR5 URUSS9 U$![a NHf=f)zReturn a stable SDK session UUID, auto-generating if absent. The session ID is persisted to ``~/.modelscope/credentials/session`` and included in the User-Agent header for telemetry. rNrr ) uuidrVrrrrClenr\uuid4hexr^r)rK_uuidrsids rget_session_idHubConfig.get_session_ids ##&77 <<>> nngn6<<>s8r>J"kkm  g.   s-B B&%B&)r:r9r;r&r4)returnNone)r&r%rstr)rr)r4rrr)rr%)robjectrr)rr)rrrrrr)rrrr)rr)__name__ __module__ __qualname____firstlineno____doc__r&__annotations__rr0r3r4r9r:r;rM staticmethodrHpropertyrVr^r|rJrrzrrrrr__static_attributes__r,r rr#r#6s  HjuIt-wxJxE:e%eDKD!&u5u!M$M#EEJtJ +D!!*66R,!\& $ 0&A 0r r#HubConfig | None_default_configc0[c [5q[$)zBReturn the lazily-instantiated process-wide default configuration.)rr#r,r rget_default_configr7s#+ r cUqg)z;Override (or clear) the process-wide default configuration.N)r)configs rset_default_configr?s Or )rrBr2rIr#rr)rzstr | os.PathLike[str]rr)rr#)rrrr)%r __future__rr(rD dataclassesrrpathlibrtypingr constantsr r r r r rrrrrerrorsrrrBrIr2rrrr#rrr__all__r,r rrs # (   1% "  +- yyyz%)!(  r