+j'dZddlZddlZddlZddlZddlZddlZddlZddlm Z  ddl m Z ddl m Z e e gZn #e$rgZYnwxYwgdZdZdZdZdd Zd Zd Zd Zd ZdZdZdZdZdZdZdZdZ dS)aAutomatically reload function code each time it is called This module provides a `hot_reload` decorator where the decorated function is reloaded from source every time the function is called. This works primarily for global functions and class methods, but it also has limited support for nested functions as well*. This module also provides a `reload` function that can be used to reload a function on demand, i. e. `new_func = reload(old_func)`. This module is based upon Julian Vossen's reloading library: https://github.com/julvo/reloading But it is heavily modified, and includes additional support for things like class methods. The license for the original library is pasted at the bottom of this file. * Nested functions have the following issues: 1. You cannot use the `nonlocal` statement in nested functions. When the code is reloaded, Python treats it as a global function, and therefore the `nonlocal` keyword is not allowed. 2. You cannot add capture variables during reloading. Whatever was captured when the function was first defined is what will continue to be captured. This is because the outer function is never reloaded, and the outer function's local scope may potentially be gone at the time of decorating. 3. If some of the capture variables share the same name as global variables, but are different, then references to the global variable within the function or functions it calls may end up referring to the capture variable instead. N)Path)AbstractLayout)AbstractElement)ctrlstate life_cycleTcztddrStjfd}d|_|S)zDecorator to reload the function on every call If there are multiple decorators on this function, only the decorators after the `@hot_reload` decorator will be reloaded __is_hot_reload_funcFc6td}||i|S)NF)perform_checks)reload)argskwargsnew_funcfuncs W/DATA/AppData/hermes/venv/lib/python3.11/site-packages/trame_server/utils/hot_reload.pywrappedzhot_reload..wrappedNs,$u555x((((T)getattr functoolswrapsr )rrs` r hot_reloadrCs^ t+U33 _T))))) $(G Nrc|rt|tjtjfs|St|tjr)t|jt t r|Str d|jvr|Strt|r|S t|S#t$rt|YnwxYw0)aDAttempt to reload the provided function This works by locating the file the function was defined in, reloading its body of code, and returning the reloaded function. If perform_checks is True, then several checks will be performed beforehand to determine whether or not the function should be skipped. z) isinstancetypes FunctionType MethodType__self__tuple SKIP_CLASSESSKIP_LAMBDA_FUNCS __qualname__SKIP_SITE_PACKAGES_func_in_site_packages _reload_func Exception_handle_exception)rr s rr r Zs$!3U5E FGG K dE, - - $-|)<)<==   t/@!@!@K  "8">"> K$ $%% % $ $ $ d # # # # # $$sB))CCc@t|}t|}|j}||t ||||j}t|tj rtj ||j }|SN) _find_function_locals_recompile_function __globals__copyupdateexec__name__rrrr)r func_localscode globals_copyrs rr%r%|s'--K t $ $D #((**L $$$|DM*H$())=#Hdm<< OrcTd|jvr|jStj|jS)Nz)r"r,inspectgetclosurevars nonlocals)rs rr*r*s1***  !$ ' ' 11rct|}t|j|s1tj|}d|jd|d}t |t|ddS)NzFailed to find 'z ' in file ''r/)filenamemode)!_parse_func_file_until_successful_isolate_function_defr0r5getfiler"r&compile)rtreepathmsgs rr+r+sn ,T 2 2D  5 5t$$F!2FFtFFFnn 4"6 2 2 22rctj|} t|} tj|S#t $rt |YnwxYwDr))r5r? _load_fileastparse SyntaxErrorr')rrBsources rr=r=sl ?4 D$D!! $9V$$ $ $ $ $ d # # # # # $ $s:AAcjd}|dkr't|}|dk'|dzS)Nr: )r read_text)rBsrcs rrErEs< C ))4jj""$$ )) :rctj|D]k}t|tjrO|j|krDd|jD}d|vrt |t|t|g|_ dSldS)zStrip everything but the function definition from the ast in-place. Also strips the hot_reload decorator (including all decorators before it) from the function definitionc,g|]}t|S_get_decorator_name.0decs r z)_isolate_function_def..s!WWWC2377WWWrrTF) rFwalkr FunctionDefnamedecorator_list_strip_hot_reload_decorator_strip_decoratorsSTRIP_DECORATORSbody)funcnamerAnodedecorator_namess rr>r>s   dCO , , h1F1FWW4CVWWWO..+D111 d$4 5 5 5DI44 5rc>tj|}tj}|dd|d}t j|dztd|j d|dt j dS)NzFile ""zFile ""rKzEdit 'z' in 'z' and press return to continue) r5r? traceback format_excreplacesysstderrwriteprintr"stdinreadline)rfpathexcs rr'r's OD ! !E   C ++'):%):):): ; ;CJS4Z    Q4$ Q QE Q Q QRRRIrc>t|dr|jSt|drGt|jdr |jjSt|jdr|jjjSt|dr |jjSd|}t |)NidrvaluezFailed to find decorator name: )hasattrrprrqr&)dec_noderCs rrRrRsx{x  * 8=$ ' ' $=# # 8=' * * *=&) )x!!!~  6H 6 6C C..rcd|jD}|d}|j|dzd|_dS)z>Remove the 'hot_reload' decorator and all decorators before itc,g|]}t|SrPrQrSs rrVz/_strip_hot_reload_decorator..s!OOOC*3//OOOrrN)rZindex)rrahot_reload_idxs rr[r[sLOO4;NOOOO$**<88N-nq.@.B.BCDrc8fd|jD|_dS)zStrip only specific decoratorsc6g|]}t|v|SrPrQ)rTrU blacklists rrVz%_strip_decorators..s3.A#.F.Fi.W.W.W.W.WrN)rZ)rr{s `rr\r\s7*Drctj|tfdtjDS)z=Return whether a function is in any site-packages directoriesc3BK|]}|VdSr)) startswith)rTxrBs r z)_func_in_site_packages..s/BBatq!!BBBBBBr)r5r?anysitegetsitepackages)rrBs @rr$r$s> ?4 D BBBB4+?+A+ABBB B BBra*MIT License Copyright (c) 2019 Julian Vossen Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. )T)!__doc__rFrr5rrgrdrpathlibrtrame_client.ui.corertrame_client.widgets.corerr ImportErrorr]r!r#rr r%r*r+r=rEr>r'rRr[r\r$JULVO_RELOADING_LICENSErPrrrsB   333333999999$^4LLLLL 322 .$$$$D> 2 2 2333$$$&"DDDCCC s7AA