MhWdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZddlmZddl mZddl Z ddl!m"Z"ddl#m$Z$dd l%m&Z&dd l'm(Z(m)Z)m*Z*dd l+m,Z,dd l-m.Z.dd l/m0Z0ddl1m2Z2m3Z3m4Z4ddl5m6Z6ddl7m8Z8m9Z9m:Z:m;Z;ddlm?Z?m@Z@ejABdsddld?gd@dAgdBgdCgdDgdEgdFgdG Ze^ZddMZddQZGdRdSe4jZddWZGdXdYe(Zdd[ZGd\d]e(ZGd^d_e(Zee*Zd`dadbiiedcfedd<dedfidedfidgedhfedi<djdkidjdkidgedlfedm<d`dndbiidofedn<eƠeZdpdqdrdree)ZeȠdsdtdudvdwdxdydzd{d|d}d~dddGdd`e(Z dddZejxZZdS)zA tornado based Jupyter server.) annotationsN) encodebytes)partial)Path)KernelSpecManager) KernelManager)Session) JupyterApp base_aliases base_flags)jupyter_runtime_dir) EventLogger)NotebookNotary) httpserverioloopweb) url_concat) LogFormatter access_logapp_loggen_log) bind_sockets)MatcherRulewin)bind_unix_socket)AnyBoolBytesDictFloatInstanceIntegerList TraitErrorTypeUnicodeUniondefaultobservevalidate)Config) boolean_flagcatch_config_error)DEFAULT_EVENTS_SCHEMA_PATHDEFAULT_JUPYTER_SERVER_PORTDEFAULT_STATIC_FILES_PATHDEFAULT_TEMPLATE_PATH_LISTJUPYTER_SERVER_EVENTS_URI __version__) get_sys_info)utcnow)AllowAllAuthorizer Authorizer)IdentityProviderLegacyIdentityProviderPasswordIdentityProvider) LoginHandler) LogoutHandler)FileFindHandler MainHandlerRedirectWithParams Template404)ExtensionConfigManager)ExtensionManager)ServerExtensionApp)GatewayWebSocketConnection) GatewayClient)GatewayKernelSpecManagerGatewayMappingKernelManagerGatewaySessionManager) log_request)ACTIVE_DURATION LAST_ACTIVITYSERVER_EXTENSION_INFO SERVER_INFOSERVER_STARTED) ConfigManager)AsyncFileContentsManagerFileContentsManager)AsyncLargeFileManager)AsyncContentsManagerContentsManager)BaseKernelWebsocketConnection)ZMQChannelsWebsocketConnection)AsyncMappingKernelManagerMappingKernelManager)SessionManager)JupyterServerAuthWarning check_pidfetchunix_socket_in_use url_escape url_path_joinurlencode_unix_socket_path) EnvironmentFileSystemLoader) secure_write) ensure_async)_i18ntrans) pathname2urlurljoin)rz.The Jupyter Server requires tornado >=%s.%s.%sz jupyter server # start the server jupyter server --certfile=mycert.pem # use SSL/TLS certificate jupyter server password # enter a password to protect the server z$jupyter_server.services.api.handlersz'jupyter_server.services.config.handlersz)jupyter_server.services.contents.handlerszjupyter_server.files.handlersz(jupyter_server.services.kernels.handlersz#jupyter_server.kernelspecs.handlersz,jupyter_server.services.kernelspecs.handlersz!jupyter_server.nbconvert.handlersz*jupyter_server.services.nbconvert.handlersz)jupyter_server.services.security.handlersz)jupyter_server.services.sessions.handlersz jupyter_server.services.shutdownzjupyter_server.view.handlersz'jupyter_server.services.events.handlers) authapiconfigcontentsfileskernels kernelspecs nbconvertsecuritysessionsshutdownvieweventsportintnreturnt.Generator[int, None, None]c #Kttd|D] }||zV t|dz D]0}td|tjd|zd|zzV1dS)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]. rkN)rangeminmaxrandomrandint)ryr{i_s X/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/jupyter_server/serverapp.py random_portsrs 3q!99  Qh 1q5\\;;!TFN261q5999::::::;;namestrt.Anyc4t|dg}|jS):Load the (URL pattern, handler) tuples for each component.default_handlers)fromlist) __import__r)rmods r load_handlersrs! T%7$8 9 9 9C  rcfeZdZdZddddddfd ZfdZ ddddddddZdZdZdd Z xZ S)ServerWebApplicationzA server web application.N authorizeridentity_provider!kernel_websocket_connection_classwebsocket_ping_intervalwebsocket_ping_timeoutcp|,tjdtdt|}|-tjdtdt ||}||||||||| | | | | ||||||}|||}g}|D].^}}}|| ||/|rKd d |z}|j rtj|tdnt|tj|fi|dS) z$Initialize a server web application.Nzridentity_provider unspecified. Using default IdentityProvider. Specify an identity_provider to avoid this message.r stacklevelparentziauthorizer unspecified. Using permissive AllowAllAuthorizer. Specify an authorizer to avoid this message.)rrrzZCore endpoints without @allow_unauthenticated, @ws_authenticated, nor @web.authenticated:  )warningswarnRuntimeWarningr9r[r7 init_settings init_handlersextend_check_handler_authjoinallow_unauthenticated_access Exceptionsuper__init__)self jupyter_appdefault_serviceskernel_managercontents_managersession_managerkernel_spec_managerconfig_manager event_loggerextra_serviceslogbase_url default_urlsettings_overridesjinja_env_optionsrrrrrsettingshandlersundecorated_methodsmatcherhandlerrmessage __class__s rrzServerWebApplication.__init__s0  $ MG      !1 D D D    M@(      ,;RcdddJ%%             !/.O$;#9%&  (%%&6AA $, S S GWq  & &t'?'?'Q'Q R R R R  )m))/001 7 ) ,   (((..X.....rcg}|D]T}t|tr|j}|j}n|^}}}||||U|rA|jds4dd|z}tj |tdt ||S)Nrz_Extension endpoints without @allow_unauthenticated, @ws_authenticated, nor @web.authenticated: rrr) isinstancerrtargetrrrrrrr[r add_handlers) r host_pattern host_handlersrrulerrrrrs rrz!ServerWebApplication.add_handlersFs ! S SD$%% ,,+'+$1  & &t'?'?'Q'Q R R R R  t}5S'T r))/001  M(     ww##L-@@@rcN| d|j}t|tr|f}d|D}ddi}|| r| nit d>t |dgd|}t}tj tj tdd}tjdtj |d d }||d |d dkrd}nDt jj}t j|d}t+}|j}tj d}||tj jzrd|t5|dz}idt7t8|jd| d| d|d|jd|jdt@dtC| dddtC| dd gid!|d"|j"d#|j#d$|j$d%|j%d&|j&d'|j'd(tC| d)id*dd+|j(d,|j)d-|j*d.|j+d/|j,d0|d1|d2|d3|d4|d5|d6|d7|d8|d9|d:|||i|j-|j.|j/|j0|j1|j2|||d; }|| | r d<|vrd=| i|d<<|S)?z,Initialize settings for the web application. template_pathcLg|]!}tj|"S)ospath expanduser).0rs r z6ServerWebApplication.init_settings..zs(MMMd++D11MMMr autoescapeTzjinja2.ext.i18n)loader extensionsz..nbuizjupyter_server/i18n) localedirfallbackF)newstyle commit_source repository)tzz %Y%m%d%H%M%S~N log_function)record_prometheus_metricsrr static_pathstatic_custom_pathstatic_handler_classstatic_url_prefixz/static/static_handler_argsno_cache_pathsstaticcustom version_hashkernel_ws_protocol limit_rateiopub_msg_rate_limitiopub_data_rate_limitrate_limit_window cookie_secret login_urlz/login xsrf_cookiesdisable_check_xsrfrallow_remote_accesslocal_hostnamesauthenticate_prometheusrrrrrrrrrrr) rstartedlast_activity_timesjinja_template_vars websocket_urlshutdown_buttonrn config_dirallow_password_changeserver_root_dir jinja2_env serverappxsrf_cookie_kwargsrr)3gettemplate_file_pathrrupdaterbrcr5rrrealpathr__file__gettext translationinstall_gettext_translationsdatetimetimezoneutcnowstrftimer6root_dirr startswithseplenrrJrecord_http_request_metricsstatic_file_pathrr>r`rrrrrrrrrrrrr quit_buttonrnrr) rrrrrrrrrrrrrrrrrrr_template_pathrjenv_optenvsys_infobase_dirrrrrrhomers rrz"ServerWebApplication.init_settings]s.,//   *   nc * * /,.NMMnMMM &2D%9->F))BGGG #M22@Q?R  V^   >>7##BGLL4$F$FGG" gll8-BCC    (((>>> O $ 4 4LL#'C#,00C088AA.QQLhh#,w!!#&&   tbgk1 2 2 3Xc$iikk22H= G{7^=  = ; =  ]=  ;7=  !+"@=  #O=  x!D!D=  " =8X#N#N"O$= L!= $ !+"@%= ( +0)= * #K$D+= , $[%F-= . !>/= 2 [63= 4 x::5= = 6 D7= 8 !+"@9= : +K,T;= < ";#B== > {:?= @ &{'JA= D nE= F  0G= H I= J "#6K= L nM= N *O= P !2Q= R LS= T 01RU= V &'>W= X %&.+s. Y Y YXS##,,GW:X:X YS Y Y Yrr)rlast_kernel_activityritemsvaluesr)rsourcess r last_activityz"ServerWebApplication.last_activitys M) $ M* + @   Y Y!4!4!6!6 Y Y Y    t}%:;BBDDEEE7||rrt.Union[str, Matcher]rtype[web.RequestHandler]c g}|jD]}t||}|tjjk}t |d}t|}|s'|s%|s#|d|d|j d||S)N__allow_unauthenticatedz- z of z registered for ) SUPPORTED_METHODSgetattrlowerrRequestHandler_unimplemented_methodhasattr_has_tornado_web_authenticatedr%__name__) rrrmissing_authentication method_namemethodis_unimplementedis_allowlistedis_blocklisteds rrz(ServerWebApplication._check_handler_auth0s"$"4  KWk&7&7&9&9::F%);)QQ $V-FGGN;FCCN# N > &--UUU'*:UUGUU&%rN)rr9rr:) rD __module__ __qualname____doc__rrrrr8r __classcell__rs@rrrs##&*. $#+R/R/R/R/R/R/R/hAAAAAJD *. $#)DDDDDL888t& & & & & & & & &rrrGt.Callable[..., t.Any]boolc,t|dsdSt|dsdS|j}t|dr|jdSt|dr.|jddd SdS) zCheck if given method was decorated with @web.authenticated. Note: it is ok if we reject on @authorized @web.authenticated because the correct order is @web.authenticated @authorized. __wrapped__F__code__ co_qualname authenticated co_filename\r!ztornado/web.py)rBrUrVrrXreplacer1)rGcodes rrCrC@s 6= ) )u 6: & &u ?Dt]##N**?;;; } % %N''c22;;>'**B j.A AACc4J!78888  9 9rN)rDrLrMrNr4rrhrfr^flagsrrrrgrrrrrs 99GuFGGKGGGG$j$%7 8 E> ? ? $fd^ 4 EP Q Q  Et  U )  H 4  U H     D99999rr ServerApp allow_rootTz*Allow the server to be run from root user.z allow-root open_browserF)r ExtensionAppz6Prevent the opening of the default url in the browser.z no-browser log_levelDEBUGzESet debug level for the extension and underlying server applications.rq autoreloadzAutoreload the webapp Enable reloading of the tornado webapp and all imported Python packages when any changes are made to any Python src files in server or extensions. scriptzFileContentsManager.save_scriptzDEPRECATED, IGNOREDz ServerApp.ipzServerApp.portzServerApp.port_retrieszServerApp.sockzServerApp.sock_modezKernelManager.transportzServerApp.keyfilezServerApp.certfilezServerApp.client_cazServerApp.root_dirzServerApp.preferred_dirzServerApp.browserzServerApp.pylabzGatewayClient.url)ipryz port-retriesrz sock-mode transportkeyfilecertfilez client-caz notebook-dirz preferred-dirbrowserpylabz gateway-urlcneZdZUdZdZeZded<edZ ded<e Z e e Z e eZeeeeeeeeeeeeeeeeee gZ!e"e"j #dfe$e$j #dfe%e%j #dfe&e&j #dfdZ'd ed <d Z(e)Z*e+d d Z,e-dd-dZ.e-dd.dZ/e0dd1dZ2e0dd1dZ3e0dddZ4e0dddZ5e+d dedZ6e+d dedZ7e+d ded Z8e0d!ded"Z9e0d#ded$Z:e-d%d.d&Z;ed+Z?e@ZAeBded,ZCe-d-d-d.ZDd/ZEd0ZFeBeFded1ZGe-d2d-d3ZHe0ddd4ZIe0d5dd6ZJeZPeQd?dd@ZRe-dAd1dCZSd2dFZTd ZUe0dGedH1dZVeWdId3dKZXe-dId.dLZYeBddMdNZZe-dOd4dQZ[eBdRddSZ\eBdRddTZ]e0dddUZ^e+d ddVZ_e+dddWZ` d5d6d\ZaeWd]d3d^ZbeWd_d`d3daZce+d ddbZddcZee+ddddeedeZfe-dfdgZge+ddhZhe-did7dkZie+dddlZjeke0d#gddmZle+d ddnZme0dddoZneBdpdedqZoe dedrZpeqdXdedsZre eseke0gdedtZte deduZue dedvZveWdwdxd3dyZwe ddedz{Zxe ded|Zye ded}Zze0d!dd~Z{edZӐd5d?fd ZԐd@dZՐd@dZ֐d@dZאd@dZؐd@dZ dAdBdZe~d.dZe~d.dZe~d.dZe~d.dZސd@dZߐdCdZd@dZd@dZdCdZdCdZd@dZd@dZd@dZd@dZd@dZd@dZd@dZe~dDdZd@dZd@dZd7d Zd7d Zd@d Zed@d Zd@d Ze dEdFfd Zd@dZd@dZdGdHdZdIdZd@dZd@dZd.dZdJdZd@dZd@dZd@dZd@d ZdKd"Zd@d#Zd@fd$ Zd@d%Zd@d&Zd@d'Zd(Z d@d)Z d@d*Z dLdMd,Z xZ S(Nrz%The Jupyter Server application class.zjupyter-serverrrzFThe Jupyter Server. This launches a Tornado-based Jupyter Server.r^r)r&stoppassword extensiondict[str, t.Any] subcommands) rmrlrnrorprqrrrsrtrurvrwrxFz!Signal that we've begun stopping.)rrr|rzctjSrK)loggingINFOr`s r_default_log_levelzServerApp._default_log_levels |r log_formatc dS)z2override default log format to include date & timezV%(color)s[%(levelname)1.1s %(asctime)s.%(msecs).03d %(name)s]%(end_color)s %(message)srr`s r_default_log_formatzServerApp._default_log_formats e  rrz5Open the named file when the application is launched.T)rn notebooksz/The URL prefix where files are opened directly.zSet the Access-Control-Allow-Origin header Use '*' to allow any origin to access your server. Takes precedence over allow_origin_pat. ra,Use a regular expression for the Access-Control-Allow-Origin header Requests from an origin matching the expression will get replies with: Access-Control-Allow-Origin: origin where `origin` is the origin of the request. Ignored if allow_origin is set. z5Set the Access-Control-Allow-Credentials: true headerz4Whether to allow the user to run the server as root.z@Reload the webapp when changes are made to any Python src files.r!z'The default URL to redirect to from `/` localhostz1The IP address the Jupyter server will listen on.rctj} |d|dS#t$r3}|jt d|Yd}~dSd}~wwxYw)zReturn localhost if available, 127.0.0.1 otherwise. On some (horribly broken) systems, localhost cannot be bound. )rrrz:Cannot bind to localhost, using 127.0.0.1 as default ip %sN 127.0.0.1)socketbindcloserrwarningrf)rses r _default_ipzServerApp._default_ips MOO  FF# $ $ $ GGIII;    H  STTVW   ;;;;;  sA A= (A88A=proposalrcVtjt|d}|dkrd}|S)Nvalue*r)tcastrrrrs r _validate_ipzServerApp._validate_ip s+sHW-.. C<<E raOverride 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 server (proxified or containerized setups for example). JUPYTER_PORTz7The port the server will listen on (env: JUPYTER_PORT).rycZttj|j|jSrK)rzrgetenvport_envport_default_valuer`s r _port_defaultzServerApp._port_default-s!29T]D,CDDEEErJUPYTER_PORT_RETRIES2ziThe number of additional ports to try if the specified port is not available (env: JUPYTER_PORT_RETRIES). port_retriescZttj|j|jSrK)rzrrport_retries_envport_retries_default_valuer`s r_port_retries_defaultzServerApp._port_retries_default<s"29T2D4STTUUUrz2The UNIX socket the Jupyter server will listen on.0600z>The permissions mode for UNIX socket creation (default: 0600). sock_modec|d} t|d}tt|tjzt|tjz|dkfsJnE#t$r}td|z|d}~wt$r}td|z|d}~wwxYw|S)Nrz>$1 2 2 0d-t44 ffhh               bjnn--C  * *3 / / / HSGN 3 3 3 %%''(((xxzzsAA"AsecretNonect|jtd|j t |jd5}||ddddS#1swxYwYdS#t $r9}|jtd|j|Yd}~dSd}~wwxYw)z!write my secret to my secret_filez*Writing Jupyter server cookie secret to %sTNz'Failed to write cookie secret to %s: %s)rrfrfrrdwritererror)rrrrs rrz#ServerApp._write_cookie_secret_files  eHII4Kbccc d5t<<                       HNN?@@'          s;A4A' A4'A++A4.A+/A44 B7>.B22B7z z&DEPRECATED. Use IdentityProvider.tokenrmchangec2||ddSNr9_warn_deprecated_configrr s r_deprecated_tokenzServerApp._deprecated_token $$V-?@@@@@rcRtjdtd|jjS)NVServerApp.token config is deprecated in jupyter-server 2.0. Use IdentityProvider.tokenr)rrDeprecationWarningrrmr`s r_deprecated_token_accessz"ServerApp._deprecated_token_accesss2 d     %++rz Gets or sets a lower bound on the open file handles process resource limit. This may need to be increased if you run into an OSError: [Errno 24] Too many open files. This is not applicable when running on Windows. )rnr allow_nonemin_open_files_limitt.Optional[int]ctdStjtj\}}d}||kr|S|jd|||S)NrzDDefault value for min_open_files_limit is ignored (hard=%r, soft=%r))resource getrlimit RLIMIT_NOFILErrq)rsofthard default_softs r_default_min_open_files_limitz'ServerApp._default_min_open_files_limitsb  4'(>?? d <     R      ri aD Sets the maximum allowed size of the client request body, specified in the Content-Length request header field. If the size in a request exceeds the configured value, a malformed HTTP message is returned to the client. Note: max_body_size is applied even in streaming mode. z Gets or sets the maximum amount of memory, in bytes, that is allocated for use by the buffer manager. z?DEPRECATED in 2.0. Use PasswordIdentityProvider.hashed_passwordzADEPRECATED in 2.0. Use PasswordIdentityProvider.password_requiredzEDEPRECATED in 2.0. Use PasswordIdentityProvider.allow_password_changeNclsnamenew_namet.Optional[str]c V||j}||jvs||j|vr@|jd|jd|d|d|j|j||<dS|j|||jkr+|jd|jd|d|ddSdS)zWarn on deprecated config.Nz ServerApp.z" config is deprecated in 2.0. Use .zIgnoring deprecated ServerApp.z config. Using )rrnrrr)rr r$r%s rrz!ServerApp._warn_deprecated_configs  {H $+ % %W9M)M)M H  aV[aaGaaV^aaa   .4ZDK  * * *[ !( +vz 9 9 H  bbbWbbW_bbb     : 9rrc6||dddS)Nr;hashed_password)r%rrs r_deprecated_passwordzServerApp._deprecated_passwords% $$V-GRc$dddddrpassword_requiredrc2||ddS)Nr;rrs r_deprecated_password_configz%ServerApp._deprecated_password_configs $$V-GHHHHHra0Disable cross-site-request-forgery protection Jupyter server includes protection from cross-site request forgeries, requiring API requests to either: - originate from pages served by this server (validated with XSRF cookie and token), or - authenticate with a token Some anonymous compute resources still desire the ability to run code, completely without authentication. These services can disable all authentication and security checks, with the full knowledge of what that implies. +JUPYTER_SERVER_ALLOW_UNAUTHENTICATED_ACCESSaSAllow unauthenticated access to endpoints without authentication rule. When set to `True` (default in jupyter-server 2.0, subject to change in the future), any request to an endpoint without an authentication rule (either `@tornado.web.authenticated`, or `@allow_unauthenticated`) will be permitted, regardless of whether user has logged in or not. When set to `False`, logging in will be required for access to each endpoint, excluding the endpoints marked with `@allow_unauthenticated` decorator. This option can be configured using `z` environment variable: any non-empty value other than "true" and "yes" will prevent unauthenticated access to endpoints without `@allow_unauthenticated`. rctj|jr+tj|jdvSdS)N)trueyesT)rr!_allow_unauthenticated_access_envenvironr?r`s r%_allow_unauthenticated_access_defaultz/ServerApp._allow_unauthenticated_access_default@s? 9T; < < a:dDEKKMMQ`` `trajAllow requests where the Host header doesn't point to a local server By default, requests get a 403 forbidden response if the 'Host' header shows that the browser thinks it's on a non-local domain. Setting this option to True disables this check. This protects against 'DNS rebinding' attacks, where a remote web server serves you a page and then changes its DNS to send later requests to a local IP, bypassing same-origin checks. Local IP addresses (such as 127.0.0.1 and ::1) are allowed as local, along with hostnames configured in local_hostnames. rrRc|jdkrdS tj|j}|j S#t$rt j|j|jdt jD]}|dd} tj| dd}n+#t$r|j d|YfwxYw|jsd|vr|j sYdSYdSwxYw)zDDisallow remote access if we're listening only on loopback addressesrTr%zUnrecognised IP address: %rF) r ipaddress ip_address is_loopbackrr getaddrinfory SOCK_STREAMsplitrr is_link_local)raddrrfparseds r_default_allow_remotezServerApp._default_allow_remoteWs 7b==4 ('00D*'' ')   *47DIq&BTUU  Awqz&1$**S//!2DEEFF!H$$%BDIIIH& ,/4KKV=QK44455% s:0AC*6-B$#C*$%C  C* C  C*%C*)C*aDisable launching browser by redirect file For versions of notebook > 5.7.2, a security feature measure was added that prevented the authentication token used to launch the browser from being visible. This feature makes it difficult for other users on a multi-user system from running code in your Jupyter session as you. However, some environments (like Windows Subsystem for Linux (WSL) and Chromebooks), launching a browser using a redirect file can lead the browser failing to load. This is because of the difference in file structures/paths between the runtime and the browser. Disabling this setting to False will disable this behavior, allowing the browser to launch by using a URL and visible token (as before). zHostnames to allow as local when allow_remote_access is False. Local IP addresses (such as 127.0.0.1 and ::1) are automatically accepted as local as well. anWhether 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 (ServerApp.browser) configuration option. akSpecify what command to use to invoke a web browser when starting the server. 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. raSpecify where to open the server 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. zNSupply overrides for the tornado.web.Application that the Jupyter server uses.aq Set the tornado compression options for websocket connections. This value will be returned from :meth:`WebSocketHandler.get_compression_options`. None (default) will disable compression. A dict (even an empty one) will enable compression. See the tornado docs for WebSocketHandler.get_compression_options for details. zHSupply overrides for terminado. Currently only supports "shell_command".z/DEPRECATED. Use IdentityProvider.cookie_optionsz9DEPRECATED. Use IdentityProvider.get_secure_cookie_kwargscookie_optionsget_secure_cookie_kwargsc2||ddSrrrs r_deprecated_cookie_configz#ServerApp._deprecated_cookie_configrrz\Supply SSL options for the tornado HTTPServer. See the tornado docs for details.)rrnrz@Supply extra arguments that will be passed to Jinja environment.z.s(```a Q))```r)rr1r`s r_default_static_custom_pathz%ServerApp._default_static_custom_paths``DOE^3_````rz|Extra paths to search for serving jinja templates. Can be used to override templates from jupyter_server.templates.c |jtzS)z*return extra paths + the default locations)extra_template_pathsr2r`s rrzServerApp.template_file_path*s(+EEErzKhandlers that should be loaded at higher priority than the default serviceszThe base URL for websockets, if it differs from the HTTP server (hint: it almost certainly doesn't). Should be in the form of an HTTP origin: ws[s]://hostname[:port] zYIf True, display controls to shut down the Jupyter server, such as menu items or buttons.z!The content manager class to use.) default_valueklassrnrz The kernel manager class to use.)rSrnrkernel_manager_class-t.Union[str, type[AsyncMappingKernelManager]]c,|jjrdStS)Nz;jupyter_server.gateway.managers.GatewayMappingKernelManager)gateway_configgateway_enabledrXr`s r_default_kernel_manager_classz'ServerApp._default_kernel_manager_classTs   . QPP((rz!The session manager class to use.session_manager_class"t.Union[str, type[SessionManager]]c,|jjrdStS)Nz5jupyter_server.gateway.managers.GatewaySessionManager)rWrXrZr`s r_default_session_manager_classz(ServerApp._default_session_manager_class_s   . KJJrz-The kernel websocket connection class to use.r2t.Union[str, type[ZMQChannelsWebsocketConnection]]c,|jjrdStS)Nz=jupyter_server.gateway.connections.GatewayWebSocketConnection)rWrXrWr`s r*_default_kernel_websocket_connection_classz4ServerApp._default_kernel_websocket_connection_classks   . SRR--raC Configure the websocket ping interval in seconds. Websockets are long-lived connections that are used by some Jupyter Server extensions. Periodic pings help to detect disconnected clients and keep the connection active. If this is set to None, then no pings will be performed. When a ping is sent, the client has ``websocket_ping_timeout`` seconds to respond. If no response is received within this period, the connection will be closed from the server side. z Configure the websocket ping timeout in seconds. See ``websocket_ping_interval`` for details. zThe config manager class to use)rRrnr)ra The kernel spec manager class to use. Should be a subclass of `jupyter_client.kernelspec.KernelSpecManager`. The Api of KernelSpecManager is provisional and might change without warning between this version of Jupyter and the next stable one. kernel_spec_manager_class%t.Union[str, type[KernelSpecManager]]c,|jjrdStS)Nz8jupyter_server.gateway.managers.GatewayKernelSpecManager)rWrXrr`s r"_default_kernel_spec_manager_classz,ServerApp._default_kernel_spec_manager_classs   . NMM  rzThe login handler class to use.)rRrSrrnrz The logout handler class to use.zThe authorizer class to use.z#The identity provider class to use.zWhether to trust or not X-Scheme/X-Forwarded-Proto and X-Real-Ip/X-Forwarded-For headerssent by the upstream reverse proxy. Necessary if the proxy handles SSLzUAn EventLogger for emitting structured event data from Jupyter Server and extensions.)rr info_filecxdtjz}tj|j|S)Nzjpserver-%s.jsonrgetpidrrr)rres r_default_info_filezServerApp._default_info_files+&4 w||D,i888rzCIf True, do not write redirect HTML file disk, or show in messages.browser_open_filecxdtjz}tj|j|S)Nzjpserver-%s-open.htmlrgrbasenames r_default_browser_open_filez$ServerApp._default_browser_open_files+*RY[[8w||D,h777rbrowser_open_file_to_runcxdtjz}tj|j|S)Nz!jpserver-file-to-run-%s-open.htmlrgrls r!_default_browser_open_file_to_runz+ServerApp._default_browser_open_file_to_runs+6Dw||D,h777rdisabledz[ DISABLED: use %pylab or %matplotlib in the notebook to enable matplotlib. rc$|ddkr d|dznd}|jtd|jtd||ddS) z5when --pylab is specified, display a warning and exitrrz %srzDSupport for specifying --pylab on the command line has been removed.zBPlease use `%pylab{0}` or `%matplotlib{0}` in the notebook itself.rkN)rr rfrr)rr backends r _update_pylabzServerApp._update_pylabs,2%=F+B+B%&-''  X Y Y     V W W ^ ^     ! rzDEPRECATED, use root_dir. notebook_dirc|jrdS|jtd|d|_dS)Nz(notebook_dir is deprecated, use root_dirr) _root_dir_setrrrfrrs r_update_notebook_dirzServerApp._update_notebook_dir s@    F IJJKKKu  raThe directory to look at for external kernel connection files, if allow_external_kernels is True. Defaults to Jupyter runtime_dir/external_kernels. Make sure that this directory is not filled with left-over connection files, that could result in unnecessary kernel manager creations.zgWhether or not to allow external kernels, whose connection files are placed in external_connection_dir.z/The directory to use for notebooks and kernels.rc|jrHd|_tjtj|jStjSNT) file_to_runrxrrdirnameabspathgetcwdr`s r_default_root_dirzServerApp._default_root_dir(sF   !%D 7??27??43C#D#DEE E9;; rrc(tj|\}}|tjkr|S|tj}tj|stj|}|S)zNormalize a directory.)rr splitdriverrstripisabsr~)rrrrs r_normalize_dirzServerApp._normalize_dir0sn'$$U++4 26>>L RV$$w}}U## +GOOE**E rc||d}tj|s$t t jd|z|S)NrzNo such directory: '%r'rrrisdirr%rgr rs r_root_dir_validatezServerApp._root_dir_validate=sT##HW$566w}}U## OU]+DEEMNN N rcd|_dSr{)rxrs r_root_dir_changedzServerApp._root_dir_changedDs"rzPreferred starting directory to use for notebooks and kernels. ServerApp.preferred_dir is deprecated in jupyter-server 2.0. Use FileContentsManager.preferred_dir instead preferred_dirc|jSrK)rr`s r_default_prefered_dirzServerApp._default_prefered_dirQs }rc||d}tj|s$t t jd|z|S)NrzNo such preferred dir: '%r'rrs r_preferred_dir_validatez!ServerApp._preferred_dir_validateUsT##HW$566w}}U## SU]+HIIEQRR R rserver_extensionscn|jtd|d|_dS)Nz8server_extensions is deprecated, use jpserver_extensionsr)rrrfrrs r_update_server_extensionsz#ServerApp._update_server_extensions\s3 YZZ[[[!'rzDict of Python modules to load as Jupyter server extensions.Entry values can be used to enable and disable the loading ofthe extensions. The extensions will be loaded in alphabetical order.)rR value_traitrnrz9Reraise exceptions encountered loading server extensions?zADEPRECATED. Use ZMQChannelsWebsocketConnection.kernel_ws_protocolrc2||ddSNrWrrs r_deprecated_kernel_ws_protocolz(ServerApp._deprecated_kernel_ws_protocol{ $$V-MNNNNNrz9DEPRECATED. Use ZMQChannelsWebsocketConnection.limit_raterc2||ddSrrrs r_deprecated_limit_ratez ServerApp._deprecated_limit_raterrzCDEPRECATED. Use ZMQChannelsWebsocketConnection.iopub_msg_rate_limitrc2||ddSrrrs r _deprecated_iopub_msg_rate_limitz*ServerApp._deprecated_iopub_msg_rate_limitrrzDDEPRECATED. Use ZMQChannelsWebsocketConnection.iopub_data_rate_limitrc2||ddSrrrs r!_deprecated_iopub_data_rate_limitz+ServerApp._deprecated_iopub_data_rate_limitrrz@DEPRECATED. Use ZMQChannelsWebsocketConnection.rate_limit_windowrc2||ddSrrrs r_deprecated_rate_limit_windowz'ServerApp._deprecated_rate_limit_windowrraTShut down the server after N seconds with no kernelsrunning and no activity. This can be used together with culling idle kernels (MappingKernelManager.cull_idle_timeout) to shutdown the Jupyter server when it's not in use. This is not precisely timed: it may shut down up to a minute later. 0 (the default) disables this automatic shutdown.a&Set to False to disable terminals. This does *not* make the server more secure by itself. Anything the user can in a terminal, they can also do in a notebook. Terminals may also be automatically disabled if the terminado package is not available. terminals_enabledcdSr{rr`s r_default_terminals_enabledz$ServerApp._default_terminals_enabledstrzG" Require authentication to access prometheus metrics. )rrnaT Record http_request_duration_seconds metric in the metrics endpoint. Since a histogram is exposed for each request handler, this can create a *lot* of metrics, creating operational challenges for multitenant deployments. Set to False to disable recording the http_request_duration_seconds metric. z Paths to set up static files as immutable. This allow setting up the cache control of static files as immutable. It should be used for static file named with a hash for instance. z1jupyter_server.extension.application.ExtensionApp)rRrrSc|jS)z+Get the Extension that started this server.) _starter_appr`s r starter_appzServerApp.starter_apps   rrt.Optional[list[str]]ct||jr|jd}tj|}|j|tj|s=|j td|| dt}tj|r ||j_n+tj|r ||j_||dSdS)zParse the command line options.rzNo such file or directory: %srkN)rrrrrr~rremoverrcriticalrfrr,rrrisfiler| update_config)rrarg0rcrs rrzServerApp.parse_command_lines ""4((( ? "?1%D%%A I  T " " "7>>!$$ !!%(G"H"H!LLL ! Aw}}Q ,'( $$"" ,*+ '   q ! ! ! ! ! " "rcPtj||_t|jt st jdtdt|j tst jdtd| ||_ ||j |j|j d}tjdkr:|jr2|j}|$t't)|jd z }||d <n!|jr|j d |jdi||_| ||j |_|jj|||j |j|j |_|||j |_||j d }|jt<urY|jt@urKtB|_|j d|jd|j|d<|j"r |j"|d<n1|jt<ur#|j d|jd|jdi||_#|jtBur(|j#j$|j%d<|j#j&|j%d<|j'r^|j d|j#j(rd|j#_(|j&|j#_&n|j d|)||j |j#|_*dS)zInitialize configurables.rzhThe synchronous MappingKernelManager class is deprecated and will not be supported in Jupyter Server 3.0rrzfThe synchronous ContentsManager classes are deprecated and will not be supported in Jupyter Server 3.0)rrconnection_dirr)rrrNexternal_kernelsexternal_connection_dirzAlthough allow_external_kernels=True, external kernels are not supported because jupyter-client's version does not allow them (should be >8.3.0).)rr)rrrrz=Customizing authentication via ServerApp.login_handler_class=zs is deprecated in Jupyter Server 2.0. Use ServerApp.identity_provider_class. Falling back on legacy authentication.login_handler_classlogout_handler_classz9Ignoring deprecated config ServerApp.login_handler_class=zQ. Superseded by ServerApp.identity_provider_class={self.identity_provider_class}.rrmrFz*Ignoring deprecated ServerApp.token config)rrrr)+rFinstancerW issubclassrTrXrrrcontents_manager_classrTrarrrjupyter_client version_infoallow_external_kernelsrrrrrrrrZrconfig_manager_classrrr<identity_provider_classr;r:rrr*tornado_settingsrm _token_settoken_generatedauthorizer_classr)rkwargsridentity_provider_kwargss rinit_configurableszServerApp.init_configurabless,4DAAA  % %    Mz"       '     Mx"     $(#A#A$B$ $  8".#'#;     & 2 2* L*.*F'*2.1$t7G2H2HK]2].^.^+4K01  (  H  [    8d7AA&AA $ ; ;!<! !  ++#99.!2 :   #778  /348#D#D   $L 8 8,0HHH ,BD ( H  :PTPh:::    ?C>V $%: ;( ]CGC\()?@  %\ 9 9 H  cDLdccc   ">!=!Y!Y@X!Y!Y  '+A A A040F0VD !* --1-C-ID !' * ? O H  h   %5 O:?&6/3z&,,  !MNNN//TX9O0  rcd|j_tttfD]}|jj|_t jd}d|_|j|_| |jj dS)zInitialize logging.FtornadoTN) r propagaterrrrr getLoggerrsetLevellevel)rrloggers r init_loggingzServerApp.init_loggingzsn #J/ % %Cx}CHH"9-- '''''rct||_gd}|D]G}|tdzddz}t|z }|j|HdS)zInitialize the Event Bus.r)z=https://events.jupyter.org/jupyter_server/contents_service/v1z;https://events.jupyter.org/jupyter_server/gateway_client/v1z;https://events.jupyter.org/jupyter_server/kernel_actions/v1r!rz.yamlN)rrrZr3r/register_event_schema)r schema_ids schema_idrel_schema_path schema_paths rinit_event_loggerzServerApp.init_event_loggers't444   $ A AI'//0IC0OQSTTW^^O4FK   3 3K @ @ @ @  A Arc|j|jd<|j|jd<|jr!t j|j|jd<|j|jd<|j|jd<|jj |jd<|jj |jd<|jj |jd<|j r|j |jd <|j |jst!|j|j |_ |jr|jt&kr/|jd t-jd nd |_|jr|jd |jr.|jdt-jd t,jdr6|jd|jzt-jd t9||j|j|j|j |j!|j"|j#|j$|j|j|j |j|j%|j&|j|j'|j(|j)|_*|j+r|j+|j,d<|j-r|j-|j,d<|j.r|j.|j,d<|j,sd|_,nnd dl/}|j,0dtc|d|j2|j,3ddr |j,0d|j4|j5||j,tm|jtnr|j*j8|j_8dSdS)zinitialize tornado webapp allow_originwebsocket_compression_optionsallow_origin_patallow_credentialsrrCrDrmstatic_immutable_cachez;Options --port and --sock are mutually exclusive. Aborting.rkrz;Ignoring --ServerApp.open_browser due to --sock being used.zBOptions --ServerApp.file_to_run and --sock are mutually exclusive.rzIOption --sock is not supported on Windows, but got value of %s. Aborting.rrrca_certsN ssl_version PROTOCOL_TLSF cert_reqs) ssl_options)9rrrrrecompilerrrrCrDrmrrrrr`rryr0rrrtrrrfr|rurrrrrrrrrjinja_environment_optionsrrrrweb_apprrr client_cassl setdefaultr>PROTOCOL_SSLv23r CERT_REQUIREDvalidate_securityrr:r)rrs r init_webappzServerApp.init_webapps040An-AEAc=>   Z8: 4CX8Y8YD !"4 5595K12.2ol+372H2W./  " ; 89*.)?)Eg&  & Z>B>YD !": ;**4=99 N,T]D'    * = 9+/=D Z ( < 7*.,D Y ' > :+/>D Z ( L $D   JJJ   ' 'wsNCz; hard )rrrqrrr setrlimit)rold_softold_hardr r!s rinit_resourceszServerApp.init_resources s   HNNn    F%/0FGG((  4d{{ HNN\\\T\\(\\VZ\\     x5d| D D D D D  rr include_tokenurllib.parse.ParseResultc|jrd}t|j}n\|jsd}n;|jdvrdtjz}nd|jvr d|jdn|j}|d|j}|jrdnd }|s|j}d }|rG|jj r;|jj r |jj nd }tj d |i}tj ||||pd d d }|S)zConstructs a urllib named tuple, ParseResult, with default values set by server config. The returned tuple can be manipulated using the `_replace` method. z http+unixr)z0.0.0.0rz%s:[]httpshttpNz...rmr)schemenetlocrqueryparamsfragment)rrarr gethostnameryrrrrmrurllibparse urlencode ParseResult) rrrrrrrrmurlpartss r _get_urlpartszServerApp._get_urlparts s7 9 : F/ ::FF7 C ---F.000'*dg~~^^^^^47((TY((F $ 9WW6F $#D  =T39 =040F0Va&,,\a L**GU+;<z(ServerApp.public_url..B s#PPPIC4Pc4PPPrr) rcustom_display_urlrrurlparse_asdictr5_replacegeturl)rpartsrcustom_updatess r public_urlzServerApp.public_url: s"""66  " 5\**4+BCCKKMMFPPPPPN"EN44^44E||~~rc|d}|js-d|jvrdnd}||d|j}|S)NTrrz[::1]r)r)rrrr ryr )rr rs r local_urlzServerApp.local_urlG sg"""66y F#&$'>>{INNY*D*D*D*DNEEE||~~rcL|j}|j|jkr |d|j}|S)z`Human readable string with URLs for interacting with the running Jupyter Server z )rr)rrs r display_urlzServerApp.display_urlP s4 o ?dn , ,0000C rc`||j}|S)N)r)rrr )rrs rconnection_urlzServerApp.connection_urlZ s*%%4=%99   rctjdsNtjrBtjr$t jt j|jt jt j|j tt dr$t jt j |j tt dr&t jt j |j dSdS)zInitialize signal handlers.rSIGUSR1SIGINFON)rtrurstdinisattyrwSIGINT_handle_sigintrx _signal_stoprBr _signal_inforr`s r init_signalzServerApp.init_signal_ s ''.. >  >   "" > M&-)< = = = fnd&7888 69 % % = M&.$*; < < < 69 % % = M&.$*; < < < < < = =rsigframectjtj|jtj|j}d|_|dS)zSIGINT handler spawns confirmation dialog Note: JupyterHub replaces this method with _signal_stop in order to bypass the interactive prompt. https://github.com/jupyterhub/jupyterhub/pull/4864 rTN)rwrr threadingThread _confirm_exitdaemonrg)rrr threads rrzServerApp._handle_siginto sK  fmT%6777!);<<<  rcNtjtj|jdS)z.callback for restoring original SIGINT handlerN)rwrrr`s r_restore_sigint_handlerz!ServerApp._restore_sigint_handler s fmT%899999rc$|jj}|td|jr?|jtd|ddS||td}td}tj td||fztj tj tj gggd \}}}|rtj }||rU||vr?|jtd |ddSn!|jrdS|td |td |j|jdS) zconfirm shutdown on ^C A second ^C, or answering 'y' within 5s will cause shutdown, otherwise original SIGINT handler will be restored. This doesn't work on Windows. interruptedzShutting down...T from_signalNyr{z)Shut down this Jupyter server (%s/[%s])? rzShutdown confirmedzNo answer for 5s:zresuming operation...)rrfrf answer_yesrrrunning_server_infortstdoutr flushselectrreadliner?r _stoppingio_loopadd_callback_from_signalr))rrfr2norwxlines rr%zServerApp._confirm_exit sx} U= ! !""" ?  H  e$677 8 8 8 II$I ' ' ' F T % % ' '(((Cjj 3ZZ JKKsTViWXXX - RQ771a -9%%''Dzz||&&s++ $**,,0F0F!!%(<"="=>>> d +++~  D*++ , , , U* + +,,, --d.JKKKKKrc|jtd||ddS)zHandle a stop signal. Note: JupyterHub configures this method to be called for SIGINT. https://github.com/jupyterhub/jupyterhub/pull/4864 zreceived signal %s, stoppingTr,N)rrrfrrrr s rrzServerApp._signal_stop s? % >??EEE d #####rc^|j|dS)zHandle an info signal.N)rrfr0r>s rrzServerApp._signal_info s(  d..0011111rcdS)z8Check the components submodule, and warn if it's uncleanNrr`s rinit_componentszServerApp.init_components src<t|j}|}t|D]P\}}||jvrB|jjj||i|j||iQdS)zA Searches Jupyter paths for jpserver_extensions. )read_config_pathN) rBconfig_file_pathsget_jpserver_extensionssortedr5jpserver_extensionsrnrr)rmanagerr modulenameenableds rfind_server_extensionsz ServerApp.find_server_extensions s)$:PQQQ4466 #)**:*:*<*<#=#= G G J!999 %9@@*gAVWWW(//W0EFFF G Grct|j||_|j|j|jdS)a) If an extension's metadata includes an 'app' key, the value must be a subclass of ExtensionApp. An instance of the class will be created at this step. The config for this instance will inherit the ServerApp's config object and load its own config. )rrN)rCrextension_managerfrom_jpserver_extensionsrGlink_all_extensionsr`s rinit_server_extensionsz ServerApp.init_server_extensions sP"2dh$!O!O!O 778PQQQ 2244444rc8|jdS)zLoad any extensions specified by config. Import the module, then call the load_jupyter_server_extension function, if one exists. The extension API is experimental, and may change in future releases. N)rMload_all_extensionsr`s rload_server_extensionsz ServerApp.load_server_extensions s 2244444rctjdkrtjgtjddtjdddS)Nnt)rpztext/cssz.csszapplication/javascriptz.js)rr mimetypesinitadd_typer`s rinit_mime_overrideszServerApp.init_mime_overrides sO 7d?? N $ $ $ $:v...3U;;;;;rc|j}t|dkrdS|jrdSt |jz }|j d|||j kr1|j d|| dSdS)zBShutdown server on timeout when there are no kernels or terminals.rNzNo activity for %d seconds.z)No kernels for %d seconds; shutting down.) rrrM any_activityr6rr8 total_secondsrrqshutdown_no_activity_timeoutrfr)rkmseconds_since_actives rshutdown_no_activityzServerApp.shutdown_no_activity s   r77a<< F  ! . . 0 0  F &4<+E+E+G+G GVVXX 46JKKK $"C C C HMM;$    IIKKKKK D Crc|jdkrP|jd|jtj|jd}|dSdS)z%Initialize a shutdown on no activity.rz0Will shut down after %d seconds with no kernels.i`N)r]rrfrPeriodicCallbackr`rgrpcs rinit_shutdown_no_activityz#ServerApp.init_shutdown_no_activity sa  ,q 0 0 HMMB1   ()BEJJB HHJJJJJ 1 0rhttpserver.HTTPServercR |jS#t$rd}t|dwxYw)zIAn instance of Tornado's HTTPServer class for the Server Web Application.zAn HTTPServer instance has not been created for the Server Web Application. To create an HTTPServer for this application, call `.init_httpserver()`.N) _http_serverAttributeErrorrr*s r http_serverzServerApp.http_server sG 0$ $ 0 0 0:  !%%4 /  0s &c*t|dsd}t|tj|j|j|j|j|j|_ |j s| |j |jdS)zCreates an instance of a Tornado HTTPServer for the Server Web Application and sets the http_server attribute. rzUA tornado web application has not be initialized. Try calling `.init_webapp()` first.)rxheaders max_body_sizemax_buffer_sizeN)rBrir HTTPServerrrtrust_xheadersrnrorhr_find_http_portr6 add_callback_bind_http_serverrjs rinit_httpserverzServerApp.init_httpserver( s tY'' &6 !%% %'1 L((, 0    y #  " " " !!$"899999rc|jr|n|}|s>|jt d|ddSdS)zBind our http server.XERROR: the Jupyter server could not be started because no available port could be found.rkN)r_bind_http_server_unix_bind_http_server_tcprrrfr)rsuccesss rrtzServerApp._bind_http_serverB s~379^$--///$B\B\B^B^  H  8    IIaLLLLL  rct|jr1|jt d|jzdS t |jt |jd}|j |dS#t$r}|j tj kr5|jt d|jzYd}~dS|j tjttdtjfvr5|jt d|jzYd}~dSd}~wwxYw) zBind an http server on unix.z The socket %s is already in use.Fr)modeTN WSAEACCESz&Permission to listen on sock %s denied)r^rrrrfrrzrrrk add_socketrerrno EADDRINUSEEACCESr>)rrrs rrxz ServerApp._bind_http_server_unixN sM di ( (  H  U#EFFR S S S5 #DIC8M8M8O8OQR4S4STTTD   ' ' - - -4   w%***  'I!J!JTY!VWWWuuuuuU\75+u|+T+TUUU  'O!P!PSWS\!\]]]uuuuu s'AB E (AE2A"EEE cP|j|j|jdS)zBind a tcp server.T)rklistenryrr`s rryzServerApp._bind_http_server_tcpc s$  47333trc d}|j}t|j|jdzD](} t||j}|dd}||_n#t $r}|jtjkra|jr+|j td|zn*|j td|zYd}~|jtj ttdtj fvr0|j td |zYd}~!d}~wwxYw|sp|jr(|j td n*|j td |z|ddSdS) zFind an available http port.FrkrTz3The port %i is already in use, trying another port.zThe port %i is already in use.Nr}z'Permission to listen on port %i denied.rwzPERROR: the Jupyter server could not be started because port %i is not available.)ryrrrrrrrrrrfrfrr>rrr)rrzrysocketsrs rrrzServerApp._find_http_porth sy D,=,ABB  D &tTW55   """$  '   7e...(V !"WXX[__ e,L&M&MPT&TUUUHHHH7LE; ==H$$U+T%U%UX\%\]]]HHHH (   !!<!!4  IIaLLLLL!  s%/A%% E/A1E %AE E  Ectjdrbddl} ddlm}m}t ||ur||dSdS#t$rYdSwxYwdS)aset default asyncio policy to be compatible with tornado Tornado 6.0 is not compatible with default asyncio ProactorEventLoop, which lacks basic *_reader methods. Tornado 6.1 adds a workaround to add these methods in a thread, but SelectorEventLoop should still be preferred to avoid the extra thread for ~all of our events, at least until asyncio adds *_reader methods to proactor. rrN)WindowsProactorEventLoopPolicyWindowsSelectorEventLoopPolicy) rtrurasynciorrtypeget_event_loop_policyset_event_loop_policy ImportError)rrrs r_init_asyncio_patchzServerApp._init_asyncio_patch s < " "5 ) ) T NNN Tbbbbbbbb 557788A?ctjdtijjD]G}t j|j|j t|j  Hj jd}tj|t%jfdt)jfddS)z\ Initialize any prometheus metrics that need to be set up on server startup r)rrrJrcZjSrK)rr8 timestampr`srz(ServerApp.init_metrics.. s!4<+E+E+G+G+Q+Q+S+Srcjjjdz S)Nr)rr8rr\r`srrz(ServerApp.init_metrics.. s1 **,,t|/DY/OOmoorN)rNrfr4rMrr6rMlabelsrrrrJr?rrrOsetrrL set_functionrK)rextrs` r init_metricszServerApp.init_metrics s )[1222)4;;==  C ! (Xs{C rrlist_kernel_idsrgngettextrrfre shutdown_all)r n_kernels kernel_msgs rcleanup_kernelszServerApp.cleanup_kernels s t-t44  F+;;==>> ^ %'A9    j9,---4.;;==>>>>>>>>>>>rc Kt|ddsdSt|jj}t jdd|}|j||zt|j d{VdS)z&Call shutdown hooks in all extensions.rMNzShutting down %d extensionzShutting down %d extensions) r>rrMextension_appsrgrrrfrestop_all_extensions)r n_extensions extension_msgs rcleanup_extensionszServerApp.cleanup_extensions st0$77  F41@AA  (*G    ml233341EEGGHHHHHHHHHHHr kernel_countctjt|jdz}|rIt |j}tj dd|}|||zz }|dz }|td tj |jz }|jjr|td|jjzz }|S)zCReturn the current working directory and the server url informationrz%d active kernelz%d active kernelsz-Jupyter Server {version} is running at: {url})rrz= Kernels will be managed by the Gateway server running at: %s)rrrr info_stringrrrrgrrfrrrrrWrXr)rrrfrrs rr0zServerApp.running_server_info% svc40<<>>??$F  D/??AABBI(:[\ ] ] ] ] ] ] ] ] ] ^s:A+A AAAAA B%.BBc tj|jdS#t$r!}|jtjkrYd}~dSd}~wwxYw)zRemove the jpserver-.json file created for this server. Ignores the error raised when the file has already been removed. N)rrrerrENOENTrrs rremove_server_info_filez!ServerApp.remove_server_info_fileP sd   Idn % % % % %   w%,&&'&&&&&  AAAc tj|j}tj|j}||z }t |t |}|rG|j|kr|j dt | |S|j d| ddS)afReturns a relative path from file_to_run to root_dir. If root_dir and file_to_run are incompatible, i.e. on different subtrees, crash the app and log a critical message. Note that if root_dir is not configured and file_to_run is configured, root_dir will be set to the parent directory of file_to_run. zThe `root_dir` trait is set to a directory that's not the immediate parent directory of `file_to_run`. Note that the server will start at `root_dir` and open the the file from the relative path to the `root_dir`.z`root_dir` and `file_to_run` are incompatible. They don't share the same subtrees. Make sure `file_to_run` is on the same path as `root_dir`.rkr) pathlibrrabsoluter|rrrrrq relative_torr)rrootdir_abspath file_rawpath combined_pathis_childs r!_resolve_file_to_run_and_root_dirz+ServerApp._resolve_file_to_run_and_root_dir[ s",t}55>>@@|D$455 (<7AACC }%%00_1E1EFF  C#66I }00AABB B  1   ! rrrfhc,|jjrt|d|jji}t|j|}|jjd}|d}|| ||j dS)zWrite the browser open file.rmrzbrowser-open.html)open_urlrN) rrmrr`rrr get_templater renderr)rrrrtemplates r_write_browser_open_filez"ServerApp._write_browser_open_file{ s  ! ' KS7D,B,H"IJJCD/55\*<8 **+>?? # FFGGGGGrcl||jr|}tt |jg|tjR}t|j dd5}| ||ddddS#1swxYwYdSdS)zWrite an `browser_open_file` and `browser_open_file_to_run` files This can be used to open a file directly in a browser. r:utf-8encodingN) write_browser_open_filer|rr_r`file_url_prefixr>rrrror)rfile_to_run_relpath file_open_urlrs rwrite_browser_open_filesz"ServerApp.write_browser_open_files s $$&&&   @"&"H"H"J"J &d2W5H5N5Nrv5V5VWWWMd3S7KKK @q--mQ??? @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @sB''B+.B+c|jt|jd}t|jdd5}|||ddddS#1swxYwYdS)zkWrite an jpserver--open.html file This can be used to open the notebook in a browser Nr:rr)rrrrrjr)rrrs rrz!ServerApp.write_browser_open_file s #C $6$6$8$89 $(# @ @ @ 7A  ) )(A 6 6 6 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7sAA!$A!c| tj|jdS#t$r!}|jt jkrYd}~dSd}~wwxYw)zRemove the `browser_open_file` and `browser_open_file_to_run` files created for this server. Ignores the error raised when the file has already been removed. N)remove_browser_open_filerrrorrrrs rremove_browser_open_filesz#ServerApp.remove_browser_open_files sy %%'''  Id3 4 4 4 4 4   w%,&&'&&&&& s1 AAAc tj|jdS#t$r!}|jtjkrYd}~dSd}~wwxYw)zRemove the jpserver--open.html file created for this server. Ignores the error raised when the file has already been removed. N)rrrjrrrrs rrz"ServerApp.remove_browser_open_file se   Id, - - - - -   w%,&&'&&&&& rtuple[str, t.Optional[str]]cJ|jsI|jt|jd}|jjrt |d|jji}|jr|j}n|j }|jrtdt|}nt|j |}||fS)zPrepare to open the browser.Nrmfile:)use_redirect_filerrrrrmrr|rorjrirhr`r)ruri open_file assembled_urls r_prepare_browser_openzServerApp._prepare_browser_open s% O"3t}#5#5#7#78C%+ O w0F0L&MNN   /5II.I  ! D#G\)-D-DEEMM)$*=sCCMi''rchddl} |jpdnC#|j$r6}jt d|zdYd}~nd}~wwxYwsdS\}fd}tj | dS)zLaunch the browser.rNzNo web browser found: %r.cHJjdS)N)r)rwebbrowser_open_new)rrrsrrz(ServerApp.launch_browser..target s.&&& LLD,DL E E E E Err") webbrowserrrErrorrrrfrr#r$rg)rrrrrrrs` @@rlaunch_browserzServerApp.launch_browser s   nnT\%9T::GG    H  U#>??!C D D DGGGGGG   F5577 q F F F F F F F '''--/////s& A&,A!!A&c t|jsi tj}n#t $rd}YnwxYw|dkr<|jtd| d|jj }| d dD] }|||tdd tvr|td ||js||jr|js||jjr|jjr|jrL|jddd |jzd d |jd|jdgdS|jrdtdd|jzg}nLdtddt5dt7|jztdd|jzg}|jd|dSdSdS)z%Start the Jupyter Server application.rz?Running as root is not recommended. Use --allow-root to bypass.rkF)rrzYUse Control-C to stop this server and shut down all kernels (twice to skip confirmation).devzWelcome to Project Jupyter! Explore the various tools available and their corresponding documentation. If you are interested in contributing to the platform, please visit the community resources section at https://jupyter.org/community.html.z!Jupyter Server is listening on %srzbUNIX sockets are not browser-connectable, but you can tunnel to the instance via e.g.`ssh -L 8888:z' -N user@this_host` and then open e.g. z in a browser.z7To access the server, copy and paste one of these URLs:z %sz2To access the server, open this file in a browser:rz$Or copy and paste one of these URLs:N)rrgrrgeteuidrirrrfrrfr0r>r4rno_browser_open_filerrrrrrmrrrrrirhrj)ruidrfr<rrs r start_appzServerApp.start_app s    jll!    axx!![\\ ! x},,%,@@FFtLL  D DJJJJ  k     K   DP    ##%%%( ,  ) ) + + +   "TY "    ! ! !  ! '& 6D,B,R& 6y# 6!!II ?$BRR!QEIY!Q!Q-1-@!Q!Q!Q        ,WXX 4#33GGP!77LAW4X4X#Y#YYB!4#33 G!!$))G"4"455555M& 6& 6& 6& 6s> A  A c"K|||d{V|d{V |jd{Vn#t $rYnwxYwt|ddr|j t|ddr|j t|dr|j dSdS)zeGeneral cleanup of files, extensions and kernels created by this instance ServerApp. Nrrrk)rrrrr close_allrir>r__del__rrrBrkrr`s r_cleanupzServerApp._cleanup> sR $$&&& &&(((%%'''''''''""$$$$$$$$$ 8BBDD D D D D D D D D    D  4)4 0 0 *   ' ' ) ) ) 4*D 1 1 )  & & ( ( ( 4 ' ' $   ! ! # # # # # $ $s B B  B cztjdr*tjdd}| |j|j|jdS#t$r+|j tdYdSwxYw)zStart the IO Loop.rcdSrKrrrrrz(ServerApp.start_ioloop..` srizInterrupted...N) rtrurrrbrgr6rs _post_startKeyboardInterruptrrfrfrcs r start_ioloopzServerApp.start_ioloop[ s < " "5 ) ) (t<r6rr`s r_stopzServerApp._stop s^mmoo 4D ) ) L         rr-cd|_t|dr|jt |ddrD|r!|j|jdS|j|jdSdS)z&Cleanup resources and stop the server.Trkr6N) r5rBrkrr>r6r7rrs)rr-s rrzServerApp.stop s 4 ' ' $   ! ! # # # 4D ) ) 6 6 55djAAAAA ))$*55555  6 6r)r|rz)r|r)rrr|r)rrr|r)r|r)rrr|r)r rr|r)r|rrK)r rr$rr%r&r|r)r|rR)r|rI)r|rU)r|r[)r|r^)r|rb)rrr|r)r|r)rrr|r)r|r)NF)rr&rrRr|r)rrr rr|r)r|rf)NTTN) rrrrRrrRrrr|r)T)rrRr|r)r|r)rrrrr|r)r|r)F)r-rRr|r(rDrLrMrNrr4rrhrfr^ _examplesexamplesr raliasesrr rYrrXrUrRrTrQrrHrGrIrErFr8rrWclassesr splitlinesrr]rDrrr_log_formatter_clsrr5r)rrr'tagr|rrrrrrrrrr+rrrr0rr#ryrrrrrrrrrrrrrrrrrrrmr*rrrr#rnrorr,rrr+r.rr3rr5rrBrr$rrrrrrrr(terminado_settingsrCrDrFrrrrrHrKpropertyrrrOrQrrrrr&rSrrTrYrZr]rVrr`rrrPrr"rrardr<rr@rr=rr7rr;r9rrqrrerirrjrnrorqrrurvryrrrrxrrrrrgr rrrrrG!reraise_server_extension_failuresrrrrr!rrrrrrr]rrrrrrrrrrrrrrrrrrrrr)r%rrrArKrPrSrYr`rerkrurtrxryrrrrrr.rrrr0rzrrrrrrrrrrrrrrrrgrrrOrPs@rrres// DGu 5K H DKKEd7mmG ! # "&%G. ! , 7 7 9 9! < ! , 7 7 9 9! <   * 5 5 7 7 :   * 5 5 7 7 : %%K, &U!DEEEI W[ W\    '"#Z[[[__`KgK cc 7     Lw        UJ K K   UI J JJ   UU V VJ '#d7`1a1abbbK  UF G G   B  WT]]]"Xd^^^ !  U 1   "H4 7 UL M M   D  WV__FFF_F.!#7" U 5  L W^VVVV 72d)] ^ ^ ^D MI Xk.w  UF G GH g  UT U UG   U i  I!%% QRR W !""GGG#"GE     M W_        J GN/[)\)\ ] ] ] a a b  E WWAAAA WW,,,,#7     W #$$%$&G    Mg Ow  RH   T !D  XHL* WZeeee W "9::III;:I   $)V%#'4   /P    $$$ & W +,,-, $  " W "##((($#(@   $d     O4    Lg    G"'  U    $t U \  %(C  U    %%%! ttvvwwyy!"" U] ^ ^ T UD E EN $t UN O O     W 9::AAA;:A$ U 1  K!% UU V V!!! $ UQ R R w HXj 9EEEXEggiiee4[.\.\]]] W !""aaa#"a 4  U L  FFFXFT  U ]  NG  M$  lK "T+ U6 7 7  4" U5 6 6  W #$$)))%$) !D U6 7 7  W $%%&% )-+ UB C C)))%  W 011...21.&g  "%W  4# U4 5 5 #(#4FFF $  ! ! ! W ())!!!*)! $"  U4 5 5  4#  U5 6 6 t( U1 2 2 #d. U8 9 9 T  EY     N8 dL  I W[9999 4 Y   W !!888"!8 'wyy W '((888)(8 G U      E WW    7$UU3N-O-OPPPL W^&&&&&g  U I    "T  U u  wd/`)a)abbbHM WZ    Xj  WZ"""" G U] x  M W_Xo  W !!///"!/$DFF E     )-  UN O O)))% ! UV W W  W !""OOO#"O UN O OJ  W\OOOO!5 UX Y Y  W #$$OOO%$O"E UY Z Z  W $%%OOO&%O UU V V  W !!OOO"!O$+7  @ $ $ $  U        W !!"!#d   #'$   # # #"T     8AL !!!X!"""""""*r r r r h(((( AAAA$fDfDfDfDPEEEE(CH!!!!!F   X XX!!!X!==== "::::*L*L*L*LX $ $ $ $2222GGGGGGGG. 5 5 5 55555 < < < <$ 0 0 0X 0::::4    * ,,,,\TTT\T0    *'+ $##' D#D#D#D#D#D#D#L ? ? ? ? I I I I&    ^^^^    @HHHH@@@@* 7 7 7 7        ((((.0000.Q6Q6Q6Q6Q6Q6f$$$$: 3 3 3 3////        6 6 6 6 6 6 6 6 6rrr&rt.Optional[logging.Logger]t.Generator[t.Any, None, None]c#K|t}tj|sdStj|D](}t jd|rttj||d5} tj |}n #tj $rYddd{wxYw dddn #1swxYwYd|vrt|dr|V tj tj||#t$r2}|r%|t!d|zYd}~ d}~wwxYw*dS)aIterate over the server info files of running Jupyter servers. Given a runtime directory, find jpserver-* files in the security directory, and yield dicts of their information, each one pertaining to a currently running Jupyter server instance. Nzjpserver-(.+).jsonrrrjz%Deleting server info file failed: %s.)r rrrlistdirrmatchrrrloadJSONDecodeErrorr\rrrrf)rr file_namerrfrs rrr s)++  7== % %Z ,,XX 8() 4 4 Xbgll; ::WMMM QR9Q<2D11 E-;'E((E-)ryrzr{rzr|r})rrr|r)rGrQr|rR)rN)NN)rr&rrr|r)rN __future__rr rr rrr9rrrVrrrrr3rwrrrtr#rrtypingrrrbase64r functoolsrrrjupyter_client.kernelspecrjupyter_client.managerrjupyter_client.sessionr jupyter_core.applicationr r r jupyter_core.pathsr jupyter_events.loggerr nbformat.signrrrrrtornado.httputilr tornado.logrrrrtornado.netutilrtornado.routingrrrurrcoloramarWr traitletsrrrr r!r"r#r$r%r&r'r(r)r*r+traitlets.configr,traitlets.config.applicationr-r.jupyter_serverr/r0r1r2r3r4jupyter_server._sysinfor5jupyter_server._tzr6jupyter_server.auth.authorizerr7r8jupyter_server.auth.identityr9r:r;jupyter_server.auth.loginr<jupyter_server.auth.logoutr=jupyter_server.base.handlersr>r?r@rAjupyter_server.extension.configrB jupyter_server.extension.managerrC(jupyter_server.extension.serverextensionrD"jupyter_server.gateway.connectionsrE%jupyter_server.gateway.gateway_clientrFjupyter_server.gateway.managersrGrHrIjupyter_server.logrJ!jupyter_server.prometheus.metricsrKrLrMrNrOjupyter_server.services.configrP,jupyter_server.services.contents.filemanagerrQrR1jupyter_server.services.contents.largefilemanagerrS(jupyter_server.services.contents.managerrTrU/jupyter_server.services.kernels.connection.baserV3jupyter_server.services.kernels.connection.channelsrW-jupyter_server.services.kernels.kernelmanagerrXrY/jupyter_server.services.sessions.sessionmanagerrZjupyter_server.utilsr[r\r]r^r_r`rarjinja2rbrcrdjupyter_core.utilsrejupyter_server.transutilsrfrgrhri MIN_TORNADOrrirrrr"DEFAULT_SERVER_PORTrr ApplicationrrCr]r~rrdictrrrrrlaunch_instancemainlaunch_new_instancerrrrNsg %%#"""""       777777000000******IIIIIIIIII222222------((((((++++++++++''''''BBBBBBBBBBBB(((((()))))))) |u%%1000000<5!!         "$#####IIIIIIII100000%%%%%%IIIIIIII 322222444444 CBBBBB======GGGGGGIIIIII?????? +*****988888TSSSSSZZZZZZZZYYYYYY^^^^^^KJJJJJOOOOHHH10000000++++++++++++2222222266666666 dNNN  ; . . . . .^^4ddd +eeLMMP[[ \ \bccdOOOOHHH    2 389<=- .2 .6 ,4==<=34 + ,89+22 ; ; ; ;    N&N&N&N&N&3?N&N&N&b &HHHHHHHH*@@@@FBBBBB:BBBJ2929292929:292929r Z<&' E 677l "5)NE;RSS E BCCl (;:PQQ E QRRg <&'l L)  $|   0 *.&(*,2&"*0m$6m$6m$6m$6m$6 m$6m$6m$6bILP#X#X#X#X#XT'66sND""D*)D*(H--H76H7!I33J;JJJ!!J+*J+