ik SrSSKrSSKrSSKrSSKrSSKrSSKJr SSK J r SSK J r SSKJr SSKJr \ R$"\5r"SS \5rS rS r\\ 4\\ 4\S4\S4S \4\\4\\4S .r"SS5r"SS5rg)z- Code related to processing of import hooks. N)log)format_binaries_and_datas)importlib_load_source) PostGraphAPI)ImportErrorWhenRunningHookc>^\rSrSrSrSrU4SjrSrSrSr U=r $)ModuleHookCachea Cache of lazily loadable hook script objects. This cache is implemented as a `dict` subclass mapping from the fully-qualified names of all modules with at least one hook script to lists of `ModuleHook` instances encapsulating these scripts. As a `dict` subclass, all cached module names and hook scripts are accessible via standard dictionary operations. Attributes ---------- module_graph : ModuleGraph Current module graph. _hook_module_name_prefix : str String prefixing the names of all in-memory modules lazily loaded from cached hook scripts. See also the `hook_module_name_prefix` parameter passed to the `ModuleHook.__init__()` method. rc>[TU]5 [R"U5UlSR [ R5Ul[ =RS- slURU5 g)ai Cache all hook scripts in the passed directories. **Order of caching is significant** with respect to hooks for the same module, as the values of this dictionary are lists. Hooks for the same module will be run in the order in which they are cached. Previously cached hooks are always preserved rather than overridden. By default, official hooks are cached _before_ user-defined hooks. For modules with both official and user-defined hooks, this implies that the former take priority over and hence will be loaded _before_ the latter. Parameters ---------- module_graph : ModuleGraph Current module graph. hook_dirs : list List of the absolute or relative paths of all directories containing **hook scripts** (i.e., Python scripts with filenames matching `hook-{module_name}.py`, where `{module_name}` is the module hooked by that script) to be cached. z__PyInstaller_hooks_{}_N) super__init__weakrefproxy module_graphformatr _cache_id_next_hook_module_name_prefix_cache_hook_dirs)selfr hook_dirs __class__s GC:\des-py\RoboSAPF\venv\Lib\site-packages\PyInstaller\depend\imphook.pyrModuleHookCache.__init__8s`*  $MM,7)B(H(HIgIg(h%&&!+& i(c UGHup#[RRU5n[RRU5(d[ SR U55e[ R "[RRUS55nUHin[RRU5SSn[URUUURUS9nURU/5nURU5 Mk GM UR5H2nXn [U 5S:Xa U SX'M[!U SS S 9n U SX'M4 g ) z Cache all hook scripts in the passed directories. Parameters ---------- hook_dirs : list List of the absolute or relative paths of all directories containing hook scripts to be cached. zHook directory "{}" not found.z hook-*.py)r module_name hook_filenamehook_module_name_prefixdefault_priorityr rcUR$N)priority)hooks r2ModuleHookCache._cache_hook_dirs..sdmmrT)keyreverseN)ospathabspathisdirFileNotFoundErrorrglobjoinbasename ModuleHookrr setdefaultappendkeyslensorted) rrhook_dirr"hook_filenamesr r module_hook module_hookshooks sorted_hookss rr ModuleHookCache._cache_hook_dirs\s*+4 &Hwwx0H77==**'(H(O(OPX(YZZ"YYrww||Hk'JKN!/ !gg..}=aC )!%!2!2 +"/,0,I,I%5   ${B? ##K0!"0+48 99;K%E5zQ$)!H! &e1KUYZ $0O!'rcUHDnURUS5nUcM[RRURS5 MF g)z Remove the passed modules and all hook scripts cached for these modules from this cache. Parameters ---------- module_names : list List of all fully-qualified module names to be removed. N)popsysmoduleshook_module_name)r module_namesrr;s rremove_modulesModuleHookCache.remove_moduless>(K((;5K&  < % E3  e} EeYO PPrc[U[[45(a [U5$[U[5(a [U/5$[ SU<35e)Nz1Invalid value for bindepend_symlink_suppression: )rQlistsetrSrTrUs r(_bindepend_symlink_suppression_sanitizerr[sI%$%%5z E3  E7| H R SSrcg)NTr]rrr'r'sdr)datasbinariesexcludedimports hiddenimportswarn_on_missing_hiddenimportsmodule_collection_modebindepend_symlink_suppressioncZ^\rSrSrSrSrSrU4SjrSrS Sjr Sr S r S r S r U=r$) r3aI Cached object encapsulating a lazy loadable hook script. This object exposes public attributes (e.g., `datas`) of the underlying hook script as attributes of the same name of this object. On the first access of any such attribute, this hook script is lazily loaded into an in-memory private module reused on subsequent accesses. These dynamic attributes are referred to as "magic." All other static attributes of this object (e.g., `hook_module_name`) are referred to as "non-magic." Attributes (Magic) ---------- datas : set Set of `TOC`-style 2-tuples `(target_file, source_file)` for all external non-executable files required by the module being hooked, converted from the `datas` list of hook-style 2-tuples `(source_dir_or_glob, target_dir)` defined by this hook script. binaries : set Set of `TOC`-style 2-tuples `(target_file, source_file)` for all external executable files required by the module being hooked, converted from the `binaries` list of hook-style 2-tuples `(source_dir_or_glob, target_dir)` defined by this hook script. excludedimports : set Set of the fully-qualified names of all modules imported by the module being hooked to be ignored rather than imported from that module, converted from the `excludedimports` list defined by this hook script. These modules will only be "locally" rather than "globally" ignored. These modules will remain importable from all modules other than the module being hooked. hiddenimports : set Set of the fully-qualified names of all modules imported by the module being hooked that are _not_ automatically detectable by PyInstaller (usually due to being dynamically imported in that module), converted from the `hiddenimports` list defined by this hook script. warn_on_missing_hiddenimports : bool Boolean flag indicating whether missing hidden imports from the hook should generate warnings or not. This behavior is enabled by default, but individual hooks can opt out of it. module_collection_mode : dict A dictionary of package/module names and their corresponding collection mode strings ('pyz', 'pyc', 'py', 'pyz+py', 'py+pyz'). bindepend_symlink_suppression : set A set of paths or path patterns corresponding to shared libraries for which binary dependency analysis should not create symbolic links into top-level application directory. Attributes (Non-magic) ---------- module_graph : ModuleGraph Current module graph. module_name : str Name of the module hooked by this hook script. hook_filename : str Absolute or relative path of this hook script. hook_module_name : str Name of the in-memory module of this hook script's interpreted contents. _hook_module : module In-memory module of this hook script's interpreted contents, lazily loaded on the first call to the `_load_hook_module()` method _or_ `None` if this method has yet to be accessed. _default_priority : int Default (location-based) priority for this hook. priority : int Actual priority for this hook. Might be different from `_default_priority` if hook file specifies the hook priority override. c[U[R5(deXlX lX0lXPlX@RRSS5-UlSUl SUl SUl g)a Initialize this metadata. Parameters ---------- module_graph : ModuleGraph Current module graph. module_name : str Name of the module hooked by this hook script. hook_filename : str Absolute or relative path of this hook script. hook_module_name_prefix : str String prefixing the name of the in-memory module for this hook script. To avoid namespace clashes with similar modules created by other `ModuleHook` objects in other `ModuleHookCache` containers, this string _must_ be unique to the `ModuleHookCache` container containing this `ModuleHook` object. If this string is non-unique, an existing in-memory module will be erroneously reused when lazily loading this hook script, thus erroneously resanitizing previously sanitized hook script attributes (e.g., `datas`) with the `format_binaries_and_datas()` helper. default_priority : int Default, location-based priority for this hook. Used to select active hook when multiple hooks are defined for the same module. ._FN) rQr ProxyTypesrrr _default_priorityreplacerD_loaded_has_hook_function _hook_module)rrrr r!r"s rrModuleHook.__init__sr2,(:(:;;;;(&*"2!8:J:J:R:RSVX[:\ \ "' rcUS:XaUR5 [X5$U[;a,UR(dUR 5 [X5$[ U5e)a Get the magic attribute with the passed name (e.g., `datas`) from this lazily loaded hook script if any _or_ raise `AttributeError` otherwise. This special method is called only for attributes _not_ already defined by this object. This includes undefined attributes and the first attempt to access magic attributes. This special method is _not_ called for subsequent attempts to access magic attributes. The first attempt to access magic attributes defines corresponding instance variables accessible via the `self.__dict__` instance dictionary (e.g., as `self.datas`) without calling this method. This approach also allows magic attributes to be deleted from this object _without_ defining the `__delattr__()` special method. See Also ---------- Class docstring for supported magic attributes. r%)_load_hook_metadatagetattr_MAGIC_MODULE_HOOK_ATTRSrm_load_hook_moduleAttributeError)r attr_names r __getattr__ModuleHook.__getattr__?sV$  "  $ $ &4+ + 0 0  " " $4+ +!+ +rcV>U[;aUR5 [TU] X5$)am Set the attribute with the passed name to the passed value. If this is a magic attribute, this hook script will be lazily loaded before setting this attribute. Unlike `__getattr__()`, this special method is called to set _any_ attribute -- including magic, non-magic, and undefined attributes. See Also ---------- Class docstring for supported magic attributes. )rtrur __setattr__)rrw attr_valuers rr{ModuleHook.__setattr__]s, 0 0  " " $w"999rc URUl[R"S5n[ UR SSS9nUHAnUR U5nUcM[URS55Ul SSS5 g SSS5 g![a' [RSURS5SS 9 NEf=f!,(df  g=f) z* Load hook metadata from its source file. z7^\s*#\s*\$PyInstaller-Hook-Priority:\s*(?P[\S]+)rzutf-8)encodingNrVz/Failed to parse hook priority value string: %r!Texc_info) rkr%recompileopenr matchintgroup Exceptionloggerwarning)rpriority_patternflinems rrrModuleHook._load_hook_metadataus.. ::&`a $$$cG <$**40=(+AGGG,<(= = <= <%MqwwW^O_jn'= B??C Cc VUR(aURcU(dg[RR UR 5up#[ RSX25 [URUR 5UlSUl[URS5Ul[R!5HAunupV[#URUS5nUcU"5nO UbU"U5n[%XU5 MC [%US[#US5R!5VV s0sHupUbUO UR&U _M sn n5 U(dSUlgg![a5 [ RSSS9 [URUR 5ef=fs sn nf)am Lazily load this hook script into an in-memory private module. This method (and, indeed, this class) preserves all attributes and functions defined by this hook script as is, ensuring sane behaviour in hook functions _not_ expecting unplanned external modification. Instead, this method copies public attributes defined by this hook script (e.g., `binaries`) into private attributes of this object, which the special `__getattr__()` and `__setattr__()` methods safely expose to external callers. For public attributes _not_ defined by this hook script, the corresponding private attributes will be assigned sane defaults. For some public attributes defined by this hook script, the corresponding private attributes will be transformed into objects more readily and safely consumed elsewhere by external callers. See Also ---------- Class docstring for supported attributes. Nz*Processing standard module hook %r from %rHook failed with:Trr&rc)rmror+r,splitr rinforrD ImportErrordebugrhasattrrnrtitemsrssetattrr) rkeep_module_ref hook_path hook_basenamerw default_typesanitizer_funcr|r)rVs rruModuleHook._load_hook_modules$ <[URS5(dg[URURUS9nURR U5 URR[UR55 UR R[UR"55 UR$R'UR(5 UR*RUR,5 UR.RUR05 UR2H)nURR5UR6U5 M+ g![ a5 [RSSS9 [URUR5ef=f)z Call this hook's `hook()` function if defined. Parameters ---------- analysis: build_main.Analysis Analysis that calls the hook r&N)rrrrTr)rrorrrr&rrrrrDr r^updaterZ _added_datasr__added_binariesraextend_added_importsrc_module_collection_moderd_bindepend_symlink_suppression_deleted_importsremoveReferencenode)rrhook_apideleted_module_names rrModuleHook._process_hook_funcsHt((&11  D,<,<4K\K\gop X    " "8 , #h3345 S!9!9:; !!("9"9: ##**8+K+KL **11(2Y2YZ$,#<#<     - -hmm=P Q$=! X LL,tL <,T-B-BDDVDVW W Xs E?Fc URHCnURRURSS9nURR X5 ME g![ a. UR (a[RSU5 M|Mf=f)a  Add all imports listed in this hook script's `hiddenimports` attribute to the module graph as if directly imported by this hooked module. These imports are typically _not_ implicitly detectable by PyInstaller and hence must be explicitly defined by hook scripts. F) create_nspkgzHidden import "%s" not found!N) rar find_noder import_hookrrbrr)rimport_module_namecallers rr"ModuleHook._process_hidden_importss#'"4"4  X**44T5E5ETY4Z!!--.@I #5 X55NN#BDVW6 Xs?A1B  B ) rkrnrormr rDrrr%)F)rHrIrJrKrLrrxr{rrrurrrrMrNrOs@rr3r3s=7v'!R,<:0.A%J'4%RNXXrr3c6\rSrSrSrSrSrSrSrSr Sr g ) AdditionalFilesCachei*zi Cache for storing what binaries and datas were pushed by what modules when import hooks were processed. c 0Ul0Ulgr$ _binaries_datas)rs rrAdditionalFilesCache.__init__.s rcURRU/5 URURU=(d /5 URRU/5 URURU=(d /5 gr$)rr4rr)rmodnamer_r^s raddAdditionalFilesCache.add2s` !!'2. w&&x~26 w+ G##EKR0rcHXR;=(d XR;$r$r)rnames r __contains__!AdditionalFilesCache.__contains__9s~~%<)<rs   &@46=   8 $}Dd}D@QT6, -/0T{D\'3D%9 $%FG'*+S%T18MXMX` ,,r