U /e@sdZddlmZddlZeeZddlZddlZddl Z ddl m Z ddl m Z mZddlmZmZddlmZdd lmZd d lmZd ZGd ddZdS)z^ Provide a utility class ``CodeRunner`` for use by handlers that execute Python source code. ) annotationsN)basename)CodeType ModuleType)CallableList)PathLike)make_globally_unique_id)handle_exception) CodeRunnerc@s&eZdZUdZded<ded<ded<ded<ded <d ed <d ed <ded<ded<ded<ded<ded<d0d dd dddddZeddddZeddddZedddd Z eddd!d"Z eddd#d$Z ed dd%d&Z ddd'd(Z ddd)d*Zd1d+d,dd-d.d/ZdS)2r zA Compile and run Python source code. .. autoclasstoc:: zCodeType | None_codez str | None_doc_permanent_error_permanent_error_detailr _pathstr_sourcez List[str]_argvzModuleType | None_packageboolran_failed_error _error_detailNNone)sourcepathargvpackagereturnc Cs|rt|dkrtdd|_d|_|ddl}d|_zL||t |}t ||ddd|_t t |jj |jj}|dd|_Wnrtk r}zTd|_|jdk rtj|jnd } d | d |jpd d |jpd |_t|_W5d}~XYnX||_||_||_||_d |_dS)a Args: source (str) : A string containing Python source code to execute path (str) : A filename to use in any debugging or error output argv (list[str]) : A list of string arguments to make available as ``sys.argv`` when the code executes package (bool) : An optional package module to configure Raises: ValueError, if package is specified for an __init__.py __init__.pyz)__init__.py cannot have package specifiedNrexecT)filenamemode dont_inherit__doc__z???zInvalid syntax in z on line z: F)r ValueErrorrrreset_run_errorsastrparseosfspathcompiledictzipco_names co_constsgetr SyntaxErrorr$rlinenotext traceback format_excrrrrr) selfrrrr r*Znodesder$r<J/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/application/handlers/code_runner.py__init__Js,$zCodeRunner.__init__)r!cCs|jS)z7 Contents of docstring, if code contains one. )rr9r<r<r=doc}szCodeRunner.doccCs|jdkr|jS|jS)zH If code execution fails, may contain a related error message. N)rrr?r<r<r=errorszCodeRunner.errorcCs|jdkr|jS|jS)zM If code execution fails, may contain a traceback or other details. N)rrr?r<r<r= error_detailszCodeRunner.error_detailcCs|jp|jdkS)z, ``True`` if code execution failed N)rrr?r<r<r=failedszCodeRunner.failedcCs|jS)z= The path that new modules will be configured with. )rr?r<r<r=rszCodeRunner.pathcCs|jS)z[ The configured source code that will be executed when ``run`` is called. )rr?r<r<r=rszCodeRunner.sourcecCs||jdkrdSdtdd}t|}tj|j|j d<|j rf|j j |_ tj |jg|_t|jdkr||_ tj |jg|_|S)zN Make a fresh module to run in. Returns: Module NZ bokeh_app_-__file__r")r)rr replacerr,rabspathr__dict__r__name__ __package__dirname__path__r)r9 module_namemoduler<r<r= new_modules  zCodeRunner.new_modulecCsd|_d|_d|_dS)zg Clears any transient error conditions from a previous run. Returns None FN)rrrr?r<r<r=r)szCodeRunner.reset_run_errorsrzCallable[[], None] | None)rO post_checkr!c Cst}ttj}ttj}tjdtj|jtj |jg|j t_|j dk sZt zNzt|j |j|rv|Wn,tk r}zt||W5d}~XYnXW5t ||t_|t_d|_XdS)at Execute the configured source code in a module and run any post checks. Args: module (Module) : A module to execute the configured code in. post_check (callable, optional) : A function that raises an exception if expected post-conditions are not met after code execution. rNT)r,getcwdlistsysrrinsertrLrrrrAssertionErrorchdirrr#rI Exceptionr )r9rOrQZ_cwdZ _sys_pathZ _sys_argvr;r<r<r=runs      zCodeRunner.run)N)N)rJ __module__ __qualname__r'__annotations__r>propertyr@rArBrCrrrPr)rYr<r<r<r=r 5s: 3  r )r' __future__rlogging getLoggerrJlogr,rTr7os.pathrtypesrrtypingrrZ core.typesr Zutil.serializationr handlerr __all__r r<r<r<r=s