q-Ph&,ddlmZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZmZmZd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Zd Z Gd d e Z!d?dZ"erNddl#Z#ddl$Z$ddl%Z%ddl&Z&ddl'Z'ddl(Z(ddl)Z)ddl*Z*ddl+Z+ddl,Z,ddl-Z-ddl.Z.ddl/Z/ddl0Z0ddl1Z1ddl2Z2ddl3Z3ddl4Z4ddl5Z5n e"d\Z#Z6e"d\Z$Z6e"d\Z%Z6e"d\Z&Z6e"d\Z'Z6e"d\Z(Ze"d\Z)Ze"d\Z*Ze"d\Z+Ze"d\Z,Ze"d\Z-Ze"d\Z.Ze"d\Z/Ze"d\Z0Ze"d\Z1Ze"d \Z2Ze"d!\Z3Ze"d"\Z5Ze"d#\Z4Z ed@d(Z7d d)dAd-Z8d d)dAd.Z9d d)dAd/Z:d d)dAd0Z;d d)dAd1Zgd>Z?dS)D) annotationsN)Hashable)cache) import_module) find_spec) ModuleType) TYPE_CHECKINGAnyClassVarcastTcReZdZUdZdZdddddZded <dfd ZddZddZ xZ S) _LazyModulea/ Module that can act both as a lazy-loader and as a proxy. Notes ----- We do NOT register this module with `sys.modules` so as not to cause confusion in the global environment. This way we have a valid proxy module for our own use, but it lives *exclusively* within polars. Tznp.zpd.zpa.zpc.)numpypandaspyarrow polars_cloudzClassVar[dict[str, str]]_mod_pfx module_namestrmodule_availableboolreturnNonec||_||_t|_t |dS)a Initialise lazy-loading proxy module. Parameters ---------- module_name : str the name of the module to lazy-load (if available). module_available : bool indicate if the referenced module is actually available (we will proxy it in both cases, but raise a helpful error when invoked if it doesn't exist). N)_module_available _module_nameglobals_globalssuper__init__)selfrr __class__s S/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/polars/dependencies.pyr z_LazyModule.__init__0s>$"2'   %%%%%rct|j}||j|j<|j|j|SN)r__name__rr__dict__update)r!modules r#_importz_LazyModule._importGs=t}--+1 d'( V_--- r$namer cl|dkr|jd|}t||jr$|}t ||S|dkr|jSt jd|r|dkrdS|j|jd}||d|jd}t|d) N __wrapped__z object has no attribute r'z ^__\w+__$ __version__z requires z module to be installed) rAttributeErrorrr+getattrrematchrgetModuleNotFoundError)r!r,msgr*pfxs r# __getattr__z_LazyModule.__getattr__Ns = &KK4KKC %% %  ! 5\\^^F64(( (Z  $ $ XlD ) ) 5dm.C.C4-##D$5r::CV$VV$*;VVVC%c** 4r$)rrrrrr)rr)r,rrr ) r' __module__ __qualname____doc____lazy__r__annotations__r r+r9 __classcell__)r"s@r#rrsH **H&&&&&&.55555555r$rrrrtuple[ModuleType, bool]c|tjvrtj|dfS t|}|dup|jdu }n#t$rd}YnwxYwt |||fS)a Lazy import the given module; avoids up-front import costs. Parameters ---------- module_name : str name of the module to import, eg: "pyarrow". Notes ----- If the requested module is not available (eg: has not been installed), a proxy module is created in its place, which raises an exception on any attribute access. This allows for import and use as normal, without requiring explicit guard conditions - if the module is never used, no exception occurs; if it is, then a helpful exception is raised. Returns ------- tuple of (Module, bool) A lazy-loading module and a boolean indicating if the requested/underlying module exists (if not, the returned module is a proxy). TNF)rr)sysmodulesrloaderr6r)r module_specrs r# _lazy_importrFis0ck!!{;'--! ,, +t 3 Q{7IT7QR !!! ! #-      sA AA dataclasseshtmljsonpickle subprocessaltair deltalakefsspecgevent great_tables hypothesisrrrrpydantic pyicebergtorchpytzclstypetype_rc tfd|DS#t$rYdSwxYw)Nc3@K|]}dt|vVdS).Nr).0orXs r# z_might_be..s4<>) check_typeobjr rdcxto3ttt|rt |n|dS)Nr)_NUMPY_AVAILABLErcr rrWrerds r#_check_for_numpyri9    XJ7tCyyyC88'!!r$cxto3ttt|rt |n|dS)Nr)_PANDAS_AVAILABLErcr rrWrhs r#_check_for_pandasrms9   XJ7tCyyyC88(""r$cxto3ttt|rt |n|dS)Nr)_PYARROW_AVAILABLErcr rrWrhs r#_check_for_pyarrowrps9  ) XJ7tCyyyC88)##r$cxto3ttt|rt |n|dS)NrR)_PYDANTIC_AVAILABLErcr rrWrhs r#_check_for_pydanticrss9  9 XJ7tCyyyC88*$$r$cxto3ttt|rt |n|dS)NrT)_TORCH_AVAILABLErcr rrWrhs r#_check_for_torchrvrjr$cxto3ttt|rt |n|dS)NrU)_PYTZ_AVAILABLErcr rrWrhs r#_check_for_pytzrys9  y XJ7tCyyyC88&  r$required package not foundrequires err_prefix err_suffix min_versionstr | tuple[int, ...] | Nonemin_err_prefixinstall_message str | Nonec 8ddlm}ddlm}|ddd} t |} nj#t $r]|r|ddnd} |rd|dnd} | d|d| d |pd |d z} t| d wxYw|rt||}|| j } | |krS|d|dd d |Ddd d| Dd}||| S)ai Import an optional dependency, returning the module. Parameters ---------- module_name : str Name of the dependency to import. err_prefix : str, optional Error prefix to use in the raised exception (appears before the module name). err_suffix: str, optional Error suffix to use in the raised exception (follows the module name). min_version : {str, tuple[int]}, optional If a minimum module version is required, specify it here. min_err_prefix : str, optional Override the standard "requires" prefix for the minimum version error message. install_message : str, optional Override the standard "Please install it using..." exception message fragment. Examples -------- >>> from polars.dependencies import import_optional >>> import_optional( ... "definitely_a_real_module", ... err_prefix="super-important package", ... ) # doctest: +SKIP ImportError: super-important package 'definitely_a_real_module' not installed. Please install it using the command `pip install definitely_a_real_module`. r) parse_version)ModuleUpgradeRequiredErrorr[ r0'z. z.Please install using the command `pip install z`.Nc34K|]}t|VdSr&r\r]vs r#r_z"import_optional..-s(88qCFF888888r$z or higher (found c34K|]}t|VdSr&r\rs r#r_z"import_optional...s(#@#@qCFF#@#@#@#@#@#@r$)) polars._utils.variousrpolars.exceptionsrsplitr ImportErrorstripr6r/join)rr}r~rrrrr module_rootr*prefixsuffix err_message mod_versionr7s r#import_optionalrsH433333<<<<<<##C++A.K 9{++ 9990:BJ$$S)),,,,0:B,Z%%c**,,,;;+;;;;;  PO OOO "+..D89 2#mK00 #mF$677  $ $!DDKDD8888K88888DD88#@#@K#@#@#@@@DDD  -,S11 1 Ms :A'B!)%rGrHrIrJrKrLrMrNrOrPrrrrRrSrrTrUrirmrprsrvry_ALTAIR_AVAILABLE_DELTALAKE_AVAILABLE_FSSPEC_AVAILABLE_GEVENT_AVAILABLE_GREAT_TABLES_AVAILABLE_HYPOTHESIS_AVAILABLErgrl_POLARS_CLOUD_AVAILABLErorr_PYICEBERG_AVAILABLEru)rrrr@)rVrWrXrrr)rer rdrrr)rzr{Nr|N)rrr}rr~rrrrrrrrr )@ __future__rr3rBcollections.abcr functoolsr importlibrimportlib.utilrtypesrtypingr r r r rrrrrrrgrlrrorrrrurxrrFrGrHrIrJrKrLrMrNrOrPrQrrrrrRrSrUrT_rcrirmrprsrvryr__all__r$r#rs"""""" $$$$$$######$$$$$$555555555555J5J5J5J5J5*J5J5J5Z****Z,1KKKKKKMMMMMMMMMMMMLLLMMMNNNOOOKKKLLLL"\-00NKl6""GD!l6""GD! X&&IFA L..MJ!- X 6 6F &2l;&?&?#I# , X 6 6F  , X 6 6F ,8L,H,H)L)(4 \(B(B%J%*l733E  , X 6 6F ,8L,H,H)L)".,y"9"9G $0L$<$<!H!&2l;&?&?#I#*l733E (L00D/6: 7; 8< 9= 6: 59)!04$"& >>>>>B* * * r$