oiČddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlmZddlmZddlmZddlmZddlZddlZddlZddlmZdd lmZmZdd l m!Z!dd l"m#Z#dd l$m%Z% d Z&ddl'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.ddl/m0Z0ddl1m2Z2ddl*m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;ddl$rdZ&ddl4m5Z5m7Z7ddl?m9Z9YwxYw)/N)VoilaKernelWebsocketHandler)ExecutionRequestHandler)VoilaContentsHandler)urljoin) pathname2url)jupyter_config_path)FileFindHandler path_regex)recursive_update)LargeFileManager) KernelHandlerT)AllowAllAuthorizer Authorizer)PasswordIdentityProvider)DEFAULT_TEMPLATE_PATH_LISTDEFAULT_STATIC_FILES_PATH)BaseKernelWebsocketConnection)ZMQChannelsWebsocketConnection)IdentityProvider) url_path_join)run_sync) ConfigManager) ThemesHandler)VoilaLoginHandlerF)rr) BoolCallableDictIntegerListUnicodedefaultTypeBytesvalidate) Application)Config)warn) __version__)VoilaConfiguration) VoilaExecutor) VoilaExporter)ROOT STATIC_ROOTcollect_static_pathscollect_template_paths)RequestInfoSocketHandler)VoilaShutdownKernelHandler)AllowListFileHandlerMultiStaticFileHandlerTemplateStaticFileHandler)TornadoVoilaHandler)TornadoVoilaTreeHandler)create_include_assets_functions get_data_dirpjoinget_voila_labextensions_path)voila_kernel_manager_factoryz"(?P\w+-\w+-\w+-\w+-\w+)c|SN)xs Q/home/ubuntu/docker-apps/notebooks/venv/lib/python3.12/site-packages/voila/app.py_rBrs HceZdZdZeZdZdejiddide dfddd iie d fd d diie d fd ddiie dfdZ e rie ddddiie dfiZ e dZ e dZe Zedde dZed de dZe de dZe ede dZddddd d!d"d#d$d%d&d'd(d)d*Ze riedd+iZeeegZe de d,Ze Ze d-de d.Ze d/dde d01Ze d/dde d21Z e!gde d3Z"e!egde d4Z#e d/dd56jId7Z%e d/dd86jId7Z&ed9de d:Z'e d;de d<Z(edde d=Z)e ddd>Z*ed?de d@Z+e dde dAZ,e-d/dde dBCZ.e/dDdEZ0e re1dFddGZ2e d/dHdIjId7Z3ed dJdIjId7Z4e5dKdLZ6e7e8e9de dMNZ:e7e;ee?de dPNZ@eAdQZBeAdRZCdSZDe!e de dTZEeFide dUZGe5dVdWZHe5dXdYZIe5ddZZJeAd[ZKeAd\ZLeAd]ZMeAd^ZNe5d_d`ZOe/dadbZPe/dcddZQdeZRdqfdf ZSdgZTdheFfdiZUdhe!fdjZVdkZWdlZXdmZYdnZZdoZ[dpZ\xZ]S)rVoilavoilazvoila example.ipynb --port 8888 log_levelshow_tracebacksT)rEr*zLSet the log level to logging.DEBUG, and show exception tracebacks in output. open_browserFz3Don't open the notebook in a browser after startup.r* show_marginszXShow left and right margins for the "lab" template, this gives a "classic" template look classic_treezFUse the jinja2-based tree page instead of the new JupyterLab-based one)debugz no-browserz show-marginsz classic-treetoken auto_tokenzovoila [OPTIONS] NOTEBOOK_FILENAME This launches a stand-alone server for read-only notebooks. zZ notebook_path: File name of the Jupyter notebook to display. i"u(Port of the Voilà server. Default 8866.)confighelpzVWill autoreload to server and the page when a template, js file or Python code changesz#The directory to use for notebooks.z9Directory holding static assets (HTML, JS and CSS files).zVoila.autoreloadzVoila.base_urlz Voila.portzVoila.static_rootzVoila.server_urlz$VoilaConfiguration.default_pool_sizez"VoilaConfiguration.show_tracebacksz!VoilaConfiguration.preheat_kernelz(VoilaConfiguration.progressive_renderingz VoilaConfiguration.strip_sourceszVoilaConfiguration.templatezVoilaConfiguration.themezVoilaConfiguration.classic_treez,VoilaConfiguration.kernel_spec_manager_class) autoreloadbase_urlportstatic server_url pool_sizerHpreheat_kernelprogressive_rendering strip_sourcestemplatethemerKkernel_spec_manager_classz Voila.tokenzYLocation of temporary connection files. Defaults to system `tempfile.gettempdir()` value./uHPath for Voilà API calls. If server_url is unset, this will be used for both the base route of the server and the client. If server_url is set, the server will server the routes prefixed by server_url, while the client will prefix by base_url (this is useful in reverse proxies).NuIPath to prefix to Voilà API handlers. Leave unset to default to base_url)rP allow_nonerQu%path to notebook to serve with Voilàzpath to jinja2 templateszpaths to static assetsz/ Mathjax default configuration )r_rQ)rPzT URL to load Mathjax from. Defaults to loading from cdnjs. 2zMThe number of additional ports to try if the specified port is not available. localhostz2The IP address the notebook server will listen on.apWhether to open in a browser after starting. The specific browser used is platform dependent and determined by the python standard library `webbrowser` module, unless it is overridden using the --browser (NotebookApp.browser) configuration option. alSpecify what command to use to invoke a web browser when opening the notebook. If not specified, the default browser will be determined by the `webbrowser` standard library module, which allows setting of the BROWSER environment variable to override it. aiSpecify Where to open the notebook on startup. This is the `new` argument passed to the standard library method `webbrowser.open`. The behaviour is not guaranteed, but depends on browser support. Valid values are: - 2 opens a new tab, - 1 opens a new window, - 0 opens in an existing window. See the `webbrowser.open` documentation for details. aOverride URL shown to users. Replace actual URL, including protocol, address, port and base URL, with the given value when displaying URL to the users. Do not change the actual connection URL. If authentication token is enabled, the token is added to the custom URL automatically. This option is intended to be used when the URL to display to the user cannot be determined reliably by the Jupyter notebook server (proxified or containerized setups for example).aA function that is called prior to the launch of a new kernel instance when a user visits the voila webpage. Used for custom user authorization or any other necessary pre-launch functions. Should be of the form: def hook(req: tornado.web.RequestHandler, notebook: nbformat.NotebookNode, cwd: str) Although most customizations can leverage templates, if you need access to the request object (e.g. to inspect cookies for authentication), or to modify the notebook itself (e.g. to inject some custom structure, although much of this can be done by interacting with the kernel in javascript) the prelaunch hook lets you do that. ) default_valuer_rPrQprelaunch_hookcXtdtd|d|j_|dS)NzXVoila.prelaunch_hook is deprecated, please use VoilaConfiguration.prelaunch_hook insteadrb stacklevelvalue)r(DeprecationWarningvoila_configurationrdselfproposals rA_valid_prelaunch_hookzVoila._valid_prelaunch_hookhs3 f  3;72C  /  rCrCaThe random bytes used to secure cookies. By default this is a new random number every time you start the server. Set it to a value in a config file to enable logins to persist across server sessions. Note: Cookie secrets should be kept private, do not share config files with cookie_secret stored in plaintext (you can read the value from a file). zToken for identity provider )rQr_zGenerate token automatically cookie_secretc,tjdS)N )osurandomrls rA_default_cookie_secretzVoila._default_cookie_secrets::b> !rCzThe authorizer class to use.)rcklassrPrQz#The identity provider class to use.z-The kernel websocket connection class to use.c|jr#|j}|jdsH|dz }nB|jdvrdtjzn |j}|j |}t rJ|jjr4|jjr|jjnd}d|}nd}||S)Nr^)rOz0.0.0.0z%sz...z?token=rO) custom_display_urlendswithipsocket gethostname_urlJUPYTER_SERVER_2identity_providerrMtoken_generated)rlurlrzrMquerys rA display_urlzVoila.display_urls  " "))C<<$s 04?0J**,,PTPWPWB))B-C  6 6 < <))99&&,,  eW%EEugrCcX|jr |jnd}|j|S)Nra)rzr})rlrzs rAconnection_urlzVoila.connection_urls!TWW[yy}rCc@d}d|||j|jfzS)Nhttpz %s://%s:%i%s)rTrS)rlrzprotos rAr}z Voila._urls%DIIt}} EEErCz#Paths to search for voila.(py|json)zFExtra settings to apply to tornado application, e.g. headers, ssl, etcconfig_file_pathsc@tjgtSr>)rrgetcwdr rts rA_config_file_paths_defaultz Voila._config_file_paths_defaults 41344rCconnection_dir_rootcjtj}|jjd|z|S)Nz"Using %s to store connection files)tempfile gettempdirloginfo)rlconnection_dirs rA_default_connection_dirzVoila._default_connection_dirs,!,,.  :^KLrCc"tjSr>)loggingINFOrts rA_default_log_levelzVoila._default_log_levels ||rCc@t|jjSr>)r;rjextra_labextensions_pathrts rAlabextensions_pathzVoila.labextensions_paths+  $ $ = =  rCctSr>)r9rts rAdata_dirzVoila.data_dirs ~rCc.t|jdS)Nschemasr:rrts rA schemas_dirzVoila.schemas_dirsT]]I..rCc.t|jdS)Nthemesrrts rA themes_dirzVoila.themes_dirsT]]H--rCroot_dirc|jrFtjjtjj |jStj Sr>) notebook_pathrrpathdirnameabspathrrts rA_default_root_dirzVoila._default_root_dirs=   77??277??43E3E#FG G99; rC mathjax_urlc0tdtd|dS)NzWVoila.mathjax_url is deprecated, this option will be removed in the next major release.rbrfrhr(rirks rA_valid_mathjax_urlzVoila._valid_mathjax_urls  e    rCmathjax_configc0tdtd|dS)NzZVoila.mathjax_config is deprecated, this option will be removed in the next major release.rbrfrhrrks rA_valid_mathjax_configzVoila._valid_mathjax_configs  h    rCctjjdrTtjdk\r@ddl} ddlm}m}t|j|ur|j|yyyy#t$rYywxYw)a,set default asyncio policy to be compatible with tornado Tornado 6 (at least) is not compatible with the default asyncio implementation on Windows Pick the older SelectorEventLoopPolicy on Windows if the known-incompatible default policy is in use. do this as early as possible to make it a low priority and overridable ref: https://github.com/tornadoweb/tornado/issues/2608 FIXME: if/when tornado supports the defaults in asyncio, remove and bump tornado requirement for py38 win)rN)WindowsProactorEventLoopPolicyWindowsSelectorEventLoopPolicy) sysplatform startswith version_infoasynciorrtypeget_event_loop_policyset_event_loop_policy ImportError)rlrrrs rA_init_asyncio_patchzVoila._init_asyncio_patchs << " "5 )c.>.>&.H  T668956 112P2RS 6/I )  sA55 BBc|j|jjd|jt||t |jdk(rw|jd}|jstjj|r||_ netjj|r||_n>td|zt |jdk7rtd|jz|jd|jt!||_|j%t'j&t&j(|j*y) Nz"Searching path %s for config filesrrz.argument is neither a file nor a directory: %rz!provided more than 1 argument: %rrF)rparent)rrrLrsuper initializelen extra_argsrrrrisdirrisfile ValueErrorload_config_filer*rjsetup_template_dirssignalSIGTERM_handle_signal_stop)rlargvarg __class__s rArzVoila.initialize%s   " ;T=S=ST 4 t 1 $//!$C%%77==%$'DMWW^^C(),D&$H3N !Q &@4??RS S gD,B,BC#5T#B    " fnnd&>&>?rCc|jjrC|jj}tddg|d|_t ddg||_t r|j jt|jDcgc]"}tjj|d$}}|D]}tjj|s#t|5}tj|}ddddvsQt!|d|jj"j$t'|d|jj"_|j(j+d|jj|j(j+dd j|j|j(j+d d j|j |j,rBtjj|j,st/d |j,zyycc}w#1swYSxYw) NrF nbconvertT)prunez conf.jsontraitlet_configurationzusing template: %sztemplate paths: %sz zstatic paths: %szNotebook not found: %s)rjr[r0template_pathsr/ static_pathsr~appendrrrrjoinexistsopenjsonloadr rPr*r'rrLrr)rl template_named conf_pathsp json_fileconfs rArzVoila.setup_template_dirs@s  # # , , 44==M"8+& T#D !5+& !D  !!(()BC@D@S@ST1"'',,q+6TJT 77>>!$a4I#yy34047( !9: 44;;NN NT !9:N0077J  +T-E-E-N-NO . D=2)page_config_hook) comm_open comm_closecomm_msgcomm_info_requestkernel_info_requestshutdown_request)rrkernel_spec_managerallowed_message_types autoescapeTzjinja2.ext.i18n)loader extensionsnbuii18n) localedirfallbackF)newstyle)rrlogin_handler_classrOrM)rrrr^) rSrVkernel_managerrallow_remote_accessrRvoila_jinja2_env jinja2_envserver_root_dircontents_managerconfig_managerrrz/login)ro authorizerr!kernel_websocket_connection_class login_urlr?)1rVrSrjr]rr rrrrrrr rrXdefault_pool_sizerd ExceptionrYr~r<multi_kernel_manager_classrrrjinja2 EnvironmentFileSystemLoaderrgettext translationr-install_gettext_translationsrrrrMrNidentity_provider_classrauthorizer_classrdictrRrrnamerorr) rlrrrXrWrYkernel_manager_classjenv_optenvr server_envidentity_provider_kwargssettingss rA init_settingszVoila.init_settingsbs//:T]]#'#;#;#U#U$V$  6I5J 01BGGLLN +   BUBWXQRWW\\!Z8XX+*: !1 =#77FF11CC d66EETU U $ 8 8 N N 3O  $9T  <  $ $ ? ?  !55FF   3.. $ 8 8#   $    **4+>+>?)*   "" bggll484  (((> ++../IJ-.J  3 3D5 3 Ixx'8( $ zz!$//46(1'48JJ(1%AT%A%A&*&D "#33T=S=S4DO]]7$--.. $ 8 8 $ %5z3!22....(( # !%!3!3"oo%)%;%;595[5[*4==(C H_ Ys 'O?'Pc g}d|ji}|jt|jdtzt ft|jdtzt ft|jdtft|jdt|jddft|jdtd |jt|jjd gd ft|jd tfgtr)|j|j j#|jj$r2|j't|jd tzt(f|jj*r2|j't|jdtzt,f|j't|jdt.|j0d gdf|j't|jdt2|jj4|jj6|j8df|j:r|j't|jdt<t>j@jC|j:|j8|jD|jF|jdf|S|jHjKd|j8|j|jtLd|jift|jdtNztLd|jift|jdt<|jD|jF|jdft|jdtNztP|fg|S)z*Initialize handlers for Voila application.rjz/api/kernels/%sz/api/kernels/%s/channelsz/voila/templates/(.*)z/voila/static/(.*)z index.html)pathsdefault_filenamez/voila/api/themes/(.*)z/voila/api/themesr^) themes_urlrrno_cache_pathsz/voila/api/shutdown/(.*)z/voila/query/%sz/voila/execution/%sz/voila/labextensions/(.*))rr z/voila/files/(.*)) allowlistdenylistrz/(.*))rrrPrjzserving directory: %rz /voila/treez/voila/render/(.*))rrPrjz/voila/api/contents%s))rjextendrrV_kernel_id_regexrrr5r4rrrr;rr2r~r get_handlersrXrr1rYrr rr3file_allowlist file_denylistrrr6rrrrelpathrrPrrLr7r r)rlhandlerstree_handler_confs rA init_handlerszVoila.init_handlerss2D4L4LM");>N)N" ")DGW)W0 "$//3KL- "$//3HI*"//\R "$//3LM!&9 $.J 44MM/,/%  "$//3NO.E& ( T  OOD22??A B  # # 2 2 OO!);>N)N-    # # 9 9 OO!)?BR)R,   doo/KL 33'*e   doo/CD$!%!9!9!H!H $ 8 8 F F MM      OO!$//8<')+ .. *+/*=*="&++/3/G/G   ^A HHNN2DMM B OO/.0H0HI &doo~ 7RS/.0H0HI &doo7LM+.2.A.A&*kk373K3K& OO-E -R-) + >rCc.tjd|j|_|jj d|jz|jj d|j z|j}tjjdi||_ |jjj|j|j}|jj!d||j#y)Nvoila_)prefixdirzStoring connection files in %s.zServing static files from %s.z.*$r?)rmkdtemprrrr static_rootrtornadowebr&apprupdatetornado_settingsr+ add_handlerslisten)rlrr)s rAstartz Voila.startis&..!9!9   7$:M:MMN  58H8HHI%%';;**6X6   !6!67%%' eX. rCc|jjd|z|jj|jjy)NzHandle signal %s.)rrioloopadd_callback_from_signalstop)rlsigframes rArzVoila._handle_signal_stopxs4  )C/0 ,,T[[-=-=>rCctj|jt|jj yr>)shutilrmtreerrr shutdown_allrts rAr=z Voila.stop|s- d))*2$$1124rCc #Kttd|D] }||z t|dz D]-}td|tjd|zd|zz/yw)zGenerate a list of n random ports near the given port. The first 5 ports will be sequential, and the remaining n-5 will be randomly selected in the range [port-2*n, port+2*n]. rrbN)rangeminmaxrandomrandint)rlrTnis rA random_portszVoila.random_portssg s1ay! A(N q1u ?AarAvq1u ==> > ?sA!A#c d}|j|j|jdzD]} |jj ||j ||_|j jr|jjd|jjd|jz||_d}n|s5|jj%td |j'd|j(r|j+t,j.j0j3|_ |j.j5|j9y#t$r}|jtjk(r-|jjtd|zYd}~|jtjt!tdtjfvr-|jj#td|zYd}~d}~wwxYw#t6$r|jjd YwxYw#|j9wxYw) NFrz"Progressive rendering is activateduVoilà is running at: %sTz3The port %i is already in use, trying another port. WSAEACCESz&Permission to listen on port %i denieduWERROR: the Voilà server could not be started because no available port could be found.z Stopping...)rNrT port_retriesr4r8rzrjrYrrrOSErrorerrno EADDRINUSErBEACCESgetattrwarningcriticalexitrIlaunch_browserr2r;IOLoopcurrentr9KeyboardInterruptr=)rlsuccessrTes rAr8z Voila.listens%%dii1B1BQ1FG D dgg.  ++AAHHMM"FG 9D.targets0<<i!89t?W?W  rC)rjr?) webbrowsergetrhErrorrrWrBrSrmkstemprrrr8rjr[r4r get_templatewriterenderr\ threadingThreadr9) rlr_urifdfhrinclude_assets_functionsrr[rjrhris ` @@rArZzVoila.launch_browsersT  nnT\\%9T:G  mm ((8 I "cG ,  3 3S9C'F((113( $**+=>J!../BCH HH  2288/   $  '--/C  HH  Q:;a? @G   s$#D,BE6,E3?)E..E36E?r>)^__name__ __module__ __qualname__rr)versionexamplesrDEBUGrBflagsr~r! descriptionoption_descriptionnotebook_filenamerrTrrRrr.r1aliasesr*r+r,classesrrrSrVrr rrtagrrrQrzrIrhrgrxrrdr%rnr$rorMrNr"rur#rrrrrrrrrpropertyrrr}rrr6rrrrrrrrrrrrrrr+r9rr=rNr8rZ __classcell__)rs@rArErEvs DG0H &w}}5'8$&?  ^   ~u- . C D %~t&<  j   %~t&<  V W  - E<  <./"  K !    41-W+X YD   d Jd+P)QRH J KK )$%(;?=!K;1+9%SG 5W5g}5!=-@G!  7 YN   )  H   W J  6 7 M"T2L0MNN d;S9TUL    cc    cc   [ L  C D B      L  G"   &   !   J      N0! !    9d #T#   ; #T#    ! " " " ,12  #'2"89 # -18/BC - )*F  $Q'L%M   T  !5"5 "#$  [  //.. Z m!!! !T>@6 LDytyvJtJX ?5 ?.`$0rCrE)vrSrrrrrrJrArr{rrrrrk tornado.kernel_websocket_handlerr!tornado.execution_request_handlerrtornado.contentshandlerr urllib.parserurllib.requestrr tornado.ioloopr2 tornado.webjupyter_core.pathsr jupyter_server.base.handlersr r jupyter_server.config_managerr 1jupyter_server.services.contents.largefilemanagerr (jupyter_server.services.kernels.handlersrr~jupyter_server.auth.authorizerrrjupyter_server.auth.identityrjupyter_serverrr/jupyter_server.services.kernels.connection.baser3jupyter_server.services.kernels.connection.channelsrrjupyter_server.utilsrjupyter_core.utilsr&jupyter_server.services.config.managerr jupyterlab_server.themes_handlerrvoila_identity_providerrrjupyter_server.services.config traitletsrrrrr r!r"r#r$r%traitlets.config.applicationr&traitlets.config.loaderr'warningsr(_versionr) configurationr*executer+exporterr,rr-r.r/r0request_info_handlerr1shutdown_kernel_handlerr2static_file_handlerr3r4r5tornado.handlerr6tornado.treehandlerr7utilsr8r9r:r;voila_kernel_managerr<r$rBrElaunch_instancemainr?rCrArs)   IF9 ' 2D:NB=MET3+D>:(:   5*!-"#RR:? 18 ?8 i 0Ki 0X I=<< =sAE33F  F