2\c@@sdZddlmZmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZyddlmZWn!ek rddlm ZnXddl!m"Z"m#Z#ddl$m%Z%m&Z&ddl'm(Z(e(j)yddl*Z*Wn#ek ree&d nXy e*j+Z+Wn#e,k r.ee&d nXe+d dfkr]ee&d e*j-ndd l*m.Z.ddl*m/Z/ddl0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6ddlm7Z7m8Z8m9Z9y e:Z:Wne;k re<Z:nXddl=m>Z>m?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGddlHmIZIddlJmKZKddlLmMZMddlNmOZOddlPmQZQddl=mRZRddlSmTZTddlUmVZVmWZWdd lXmYZYmZZZm[Z[dd!l\m]Z]dd"l^m_Z_dd#l`maZambZbmcZcdd$ldmeZedd%lfmgZgdd&lhmiZimjZjmkZkmlZlmmZmmnZnmoZompZpmqZqmrZrmsZsmtZtmuZumvZvdd'lwmxZxdd(l\myZymzZzdd)l{m|Z|dd*l}m~Z~mZdd+lmZmZmZmZmZd,Zd-Zd.Zd/e/jfd0YZd1eYfd2YZd3ed4Zd5eYfd6YZd7eYfd8YZeeZZiied96d:6e&d;fed<6d:6e&d?fed>6d:eYfd\YZed]ZejZZdS(^s(A tornado based Jupyter notebook server.i(tabsolute_importtprint_functionN(t encodebytes(t encodestring(t EnvironmenttFileSystemLoader(ttranst_(tioloops,The Jupyter Notebook requires tornado >= 4.0sBThe Jupyter Notebook requires tornado >= 4.0, but you have < 1.1.0is=The Jupyter Notebook requires tornado >= 4.0, but you have %s(t httpserver(tweb(t url_concat(t LogFormattertapp_logt access_logtgen_log(tDEFAULT_STATIC_FILES_PATHtDEFAULT_TEMPLATE_PATH_LISTt __version__i(t Template404tRedirectWithParams(t log_request(tMappingKernelManager(t ConfigManager(tContentsManager(tFileContentsManager(tLargeFileManager(tSessionManager(t LoginHandler(t LogoutHandler(tFileFindHandler(tConfig(tcatch_config_errort boolean_flag(t JupyterAppt base_flagst base_aliases(tjupyter_config_path(t KernelManager(tKernelSpecManagert NoSuchKerneltNATIVE_KERNEL_NAME(tSession(tNotebookNotary(tAnytDicttUnicodetIntegertListtBooltBytestInstancet TraitErrortTypetFloattobservetdefaulttvalidate(t py3compat(tjupyter_runtime_dirt jupyter_path(t get_sys_info(tutcnowtutcfromtimestamp(t url_path_joint check_pidt url_escapeturljoint pathname2urls jupyter notebook # start the notebook jupyter notebook --certfile=mycert.pem # use SSL/TLS certificate jupyter notebook password # enter a password to protect the server cc@snx&ttd|D]}||VqWx>t|dD],}td|tjd|d|Vq:WdS(sGenerate 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]. iiiiN(trangetmintmaxtrandomtrandint(tporttnti((s3lib/python2.7/site-packages/notebook/notebookapp.pyt random_portss cC@st|ddg}|jS(s:Load the (URL pattern, handler) tuples for each component.tfromlisttdefault_handlers(t __import__RO(tnametmod((s3lib/python2.7/site-packages/notebook/notebookapp.pyt load_handlersstNotebookWebApplicationcB@s/eZdZddZdZdZRS(c  C@s\|j||||||||| | | | } |j| }tt|j|| dS(N(t init_settingst init_handlerstsuperRTt__init__(tselft jupyter_apptkernel_managertcontents_managertsession_managertkernel_spec_managertconfig_managertextra_servicestlogtbase_urlt default_urltsettings_overridestjinja_env_optionstsettingsthandlers((s3lib/python2.7/site-packages/notebook/notebookapp.pyRXs   c WC@s| jd|j} t| tjr3| f} ng| D]}tjj|^q:}itd6}|j | rw| nit dt |ddg|}t }tjj tjjtdd}tjjtjj|d}tjdd tjj|d d t}|j|d t|rJd d}|j|n|ddkrcd}ntjjjd}|jr|jtd|jtddtjtdtnt}|j }tjjd}|j!|tjj"rd|t#|}nt$dt%d| d| d|d|j&d|j'dt(dt)| ddit)| d d!gd"6d#|d$|jd%|j*d&|j+d'|j,d(|j-d)t)| d*d+|j.d,|j/d-|j0d.td/|j1d0|j2d1|j3d2|d3|d4|d5|d6|d7|d8|d9id:|j4d;|j5d<|j6d=|j7d>|j8d?|j9d@|j:dA|j;dB|j<dC|dD|dEt+}|j | |S(FNt template_patht autoescapetloadert extensionssjinja2.ext.i18ns..s.gittnbuit localedirs notebook/i18ntfallbacktnewstylesIt looks like you're running the notebook from source. If you're working on the Javascript of the notebook, try running %s in another terminal window to have the system incrementally watch and build the notebook's JavaScript for you, as you make changes.snpm run build:watcht commit_sourcet repositoryts %Y%m%d%H%M%Ss@The `ignore_minified_js` flag is deprecated and no longer works.sIAlternatively use `%s` when working on the notebook's Javascript and LESSsOThe `ignore_minified_js` flag is deprecated and will be removed in Notebook 6.0t~t log_functionRbRct static_pathtstatic_custom_pathtstatic_handler_clasststatic_url_prefixs/static/tstatic_handler_argststatictcustomtno_cache_pathst version_hashtignore_minified_jstiopub_msg_rate_limittiopub_data_rate_limittrate_limit_windowt cookie_secrett login_urls/logintlogin_handler_classtlogout_handler_classtpasswordt xsrf_cookiestdisable_check_xsrftallow_remote_accesstlocal_hostnamesR[R\R]R^R_R`tstartedtlast_activity_timestjinja_template_varstnbextensions_patht websocket_urlt mathjax_urltmathjax_configtshutdown_buttontconfigt config_dirtallow_password_changetserver_root_dirt jinja2_envtterminals_available(=tgetttemplate_file_patht isinstanceR:t string_typestostpatht expandusertTruetupdateRRR=trealpathtjoint__file__texiststgettextt translationtinstall_gettext_translationstFalsetinfotdatetimetnowtstrftimeR~twarningRtwarningstwarntDeprecationWarningR>troot_dirt startswithtseptlentdictRtstatic_file_pathRvRR@RRRRRRRRRRRRRRRt quit_buttonRRR(RYRZR[R\R]R^R_R`RaRbRcRdRet_template_pathRRhtjenv_opttenvtsys_infotbase_dirtdev_modeRlt DEV_NOTE_NPMR}RRthomeRf((s3lib/python2.7/site-packages/notebook/notebookapp.pyRUs  % ! $!*                             cC@sg}x%|dD]}|jt|qW|jtd|jd|dfg|jd|dfg|jtd|jtd|jtd |jtd |jtd |jtd |jtd |jtd|jtd|jtd|jtd|jtd|jtd|jtd|jtd|jtd|j|dj|jdti|dd6dgd6f|jdti|dd6dgd6f|jtd|jd ti|d!d"6td#6fg}xO|D]G}t|d$|d%}t|gt |d&}|j|qZW|jd't f|S((s:Load the (URL pattern, handler) tuples for each component.R`snotebook.tree.handlerss/loginRs/logoutRsnotebook.files.handlerssnotebook.view.handlerssnotebook.notebook.handlerssnotebook.nbconvert.handlerssnotebook.bundler.handlerssnotebook.kernelspecs.handlerssnotebook.edit.handlerssnotebook.services.api.handlerss!notebook.services.config.handlerss"notebook.services.kernels.handlerss#notebook.services.contents.handlerss#notebook.services.sessions.handlerss$notebook.services.nbconvert.handlerss&notebook.services.kernelspecs.handlerss#notebook.services.security.handlerssnotebook.services.shutdownR\s/nbextensions/(.*)RRt/R|s /custom/(.*)Rvsnotebook.base.handlerss/?Rcturlt permanentRbiis(.*)( textendRStget_extra_handlerstappendRRRR@ttupletlistR(RYRfRgtservicet new_handlersthandlertpatternt new_handler((s3lib/python2.7/site-packages/notebook/notebookapp.pyRV sV       cC@s|jd|jdjg}y|j|jdWntk rHnXy|j|jdWntk rtnX|j|jdjt|S(sGet a UTC timestamp for when the server last did something. Includes: API activity, kernel activity, kernel shutdown, and terminal activity. RR[tapi_last_activitytterminal_last_activityR(Rftlast_kernel_activityRtKeyErrorRtvaluesRG(RYtsources((s3lib/python2.7/site-packages/notebook/notebookapp.pyt last_activity]s   N(t__name__t __module__RXtNoneRURVR(((s3lib/python2.7/site-packages/notebook/notebookapp.pyRTs  x =tNotebookPasswordAppcB@s&eZdZeZdZdZRS(sSet a password for the notebook server. Setting a password secures the notebook server and removes the need for token-based authentication. cC@stjj|jdS(Nsjupyter_notebook_config.json(RRRR(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_config_file_default|scC@s;ddlm}|d|j|jjd|jdS(Ni(t set_passwordt config_filesWrote hashed password to %s(t auth.securityRRRaR(RYR((s3lib/python2.7/site-packages/notebook/notebookapp.pytstarts(RRt__doc__t descriptionRR(((s3lib/python2.7/site-packages/notebook/notebookapp.pyRss ic C@sddlm}m}|d}|d}||ddddd d id |d d 6}|rt|jd|n|j|xNt|dD]<}t|r|r|jd|ntStj dqWt j j drt S|r|jd|ntj|tjxNt|dD]<}t|rW|rS|jd|ntStj dq(W|r|jd|ntj|tjtS(sShutdown a notebook server in a separate process. *server_info* should be a dictionary as produced by list_running_servers(). Will first try to request shutdown using /api/shutdown . On Unix, if the server is still running after *timeout* seconds, it will send SIGTERM. After another timeout, it escalates to SIGKILL. Returns True if the server was stopped by any means, False if stopping it failed (on Windows). i(t HTTPClientt HTTPRequestRtpids api/shutdowntmethodtPOSTtbodyRrtheadersstoken ttokent AuthorizationsPOST request to %sapi/shutdowni sServer PID %s is goneg?twinsSIGTERM to PID %ssSIGKILL to PID %s(ttornado.httpclientRRtdebugtfetchRERARttimetsleeptsystplatformRRRtkilltsignaltSIGTERMtSIGKILL( t server_infottimeoutRaRRRRtreqR((s3lib/python2.7/site-packages/notebook/notebookapp.pytshutdown_servers:     tNbserverStopAppcB@sJeZeZdZeddeddZddZ dZ dZ RS( s7Stop currently running notebook server for a given porti"Rthelps-Port of the server to be killed. Default 8888cC@s<tt|j||jr8t|jd|_ndS(Ni(RWRtparse_command_linet extra_argstintRJ(RYtargv((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs cC@st|d|jS(NRa(RRa(RYtserver((s3lib/python2.7/site-packages/notebook/notebookapp.pyRscC@stt|j}|s+|jdnx|D]O}|d|jkr2td|jd|j|s}tjdndSq2Wtdj|jdtj tddtj x.|D]&}td j|ddtj qW|jd dS( NsThere are no running serversRJsShutting down server on ports...sCould not stop servers/There is currently no server running on port {}tfilesPorts currently in use:s - {}i( Rtlist_running_serverst runtime_dirtexitRJtprintRRtformattstderr(RYtserversR((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs  $N( RRRtversionRR/RRJRRRR(((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs   tNbserverListAppcB@seZeZedZediied6d6edfdiied6d6edfZe e dededZ e e deded Z d Z RS( s(List currently running notebook servers.tjsonlistR s*Produce machine-readable JSON list output.tjsons<Produce machine-readable JSON object on each line of output.RRsIf True, the output will be a JSON list of objects, one per active notebook server, each with the details from the relevant server info file.sIf True, each line of output will be a JSON object with the details from the server info file. For a JSON list output, see the NbserverListApp.jsonlist configuration valuecC@stt|j}|jr:ttj|ddn|jrjx|D]}ttj|qJWn]tdxP|D]H}|d}|jdr|d|d}nt|d|dq{WdS( NtindentisCurrently running servers:RRs ?token=%ss::t notebook_dir(RRRR RR tdumpsR(RYtserverinfo_listt serverinfoR((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs      (RRRRRRRRtflagsR1RR R R(((s3lib/python2.7/site-packages/notebook/notebookapp.pyR s t open_browsert NotebookApps3Don't open the notebook in a browser after startup.s no-browserRtpylabsIDISABLED: use %pylab or %matplotlib in the notebook to enable matplotlib.tenable_mathjaxs<Disable MathJax MathJax is the javascript library Jupyter uses to render math/LaTeX. It is very large, so you may want to disable it if you have a slow internet connection, or for offline use of the notebook. When disabled, equations etc. will appear as their untransformed TeX source. s no-mathjaxt allow_roots,Allow the notebook to be run from root user.s allow-roottscriptsFileContentsManager.save_scriptsDEPRECATED, IGNOREDsNotebookApp.iptipsNotebookApp.portRJsNotebookApp.port_retriess port-retriessKernelManager.transportt transportsNotebookApp.keyfiletkeyfilesNotebookApp.certfiletcertfilesNotebookApp.client_cas client-casNotebookApp.notebook_dirs notebook-dirsNotebookApp.browsertbrowsersNotebookApp.pylabc B@s eZdZeZedZeZe Z e Z e e e eeeegZee Z ee Z edeejjdfdeejjdfdeejjdfZeZeddZedd Zed d Ze e!d e"d edZ#e$dd e"Z%e$dd e"d dZ&e$dd e"d dZ'e e!d e"d edZ(e e!d e"d edZ)e$dd e"d edZ*e$dd e"d edZ+eddZ,e-ddZ.e$dd e"d edZ/e0dd e"d edZ1e0dd e"d ed Z2e$dd e"d ed!Z3e$dd e"d ed"Z4e$dd e"d ed#Z5e$d e"d ed$Z6ed%d&Z7e8dd e"d d'Z9ed(d)Z:d*Z;e$d+d ed,j<d e"Z=e"Z>ed-d.Z?e0dd e"d d1Z@e0dd e"d d2ZAeBd-d3ZCe$dd e"d d4ZDe e!d e"d d5ZEe e"d e"d d6ZFe e!d e"d d7ZGe d e"d d8ZHed9d:ZIeJe$dgd e"d d;ZKe e"d e"d d<ZLe$dd e"d d=ZMe0d>d e"d ed?ZNed e"d ed@ZOeBdAdBZPed e"d edCZQeRdd e"d edDZTed e"d edEZUed e"d edFZVed e"d edGZWed e"d edHZXed e"d edIZYed e"d edJZZe e"d e"d dKZ[eBdLdMZ\e$dNd e"d dOZ]e-dPdQZ^e$dNd e"d edRZ_eBdSdTZ`eJe$d e"d dUZaebdVZceJe$d edWZdedXdYZeeJe$d e"d edZZfebd[ZgeJe$d e"d ed\ZheJe$d e"d ed]Ziebd^Zje$dd e"d d_Zke$dd e"d d`ZledadbZmeBdadcZne$ddd e"d edeZoeBdfdgZpe e"d e"d dhZqerdiesdjed e"d edkZterdie d e"d edlZuerdievd e"d edmZwerdiexd e"d ednZyezedoe"Z{erdied e"d dpZ|erdie}dje~jd e"d edqZerdiedje~jd e"d edrZe e!d e"d edsZe$ZedtduZe$ZedvdwZe$dxd e"d edyZeBdzd{Ze$d e"d ed|Zed}d~Ze-d}dZeBd}dZeJe$d e"d edZeBddZeid e"d edZe e!d e"d edZedd e"d edZedd e"d edZedd e"d edZe0dd e"d dZe e"d e"d edZddZdZdZdZebdZebdZdZdZdZdZdZdZdZdZdZdZdZdZdZeddZdZe"dZdZdZdZdZdZdZdZdZdZRS(sjupyter-notebooksThe Jupyter HTML Notebook. This launches a Tornado based HTML Notebook Server that serves up an HTML5/Javascript Notebook client.RitstopRt log_levelcC@stjS(N(tloggingtINFO(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_log_levelGst log_datefmtcC@sdS(s%Exclude date from default date formats%H:%M:%S((RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_log_datefmtKst log_formatcC@sdS(s+override default log format to include timeuV%(color)s[%(levelname)1.1s %(asctime)s.%(msecs).03d %(name)s]%(end_color)s %(message)s((RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_log_formatPsRRsXDeprecated: Use minified JS file or not, mainly use during dev to avoid JS recompilationRrsSet the Access-Control-Allow-Origin header Use '*' to allow any origin to access your server. Takes precedence over allow_origin_pat. sLUse 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. s5Set the Access-Control-Allow-Credentials: true headers6Whether to allow the user to run the notebook as root.s/trees'The default URL to redirect to from `/`t localhosts2The IP address the notebook server will listen on.RcC@sbtj}y|jdWn0tjk rO}|jjtd|dSX|jdSdS(sReturn localhost if available, 127.0.0.1 otherwise. On some (horribly broken) systems, localhost cannot be bound. R&is:Cannot bind to localhost, using 127.0.0.1 as default ip %ss 127.0.0.1N(R&i(tsockettbindterrorRaRRtclose(RYtste((s3lib/python2.7/site-packages/notebook/notebookapp.pyt _default_ips  cC@s#|d}|dkrd}n|S(Ntvalueu*u((RYtproposalR.((s3lib/python2.7/site-packages/notebook/notebookapp.pyt _valdate_ips   usOverride 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).i"s,The port the notebook server will listen on.i2sMThe number of additional ports to try if the specified port is not available.s-The full path to an SSL/TLS certificate file.s;The full path to a private key file for usage with SSL/TLS.sWThe full path to a certificate authority certificate for SSL/TLS client authentication.s+The file where the cookie secret is stored.tcookie_secret_filecC@stjj|jdS(Ntnotebook_cookie_secret(RRRR(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_cookie_secret_filessThe random bytes used to secure cookies. By default this is a new random number every time you start the Notebook. 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). RcC@stjj|jrBtj|jd}|j}WdQXn"ttjd}|j |t j |dt j }|j|jj|jS(Ntrbi t digestmod(RRRR1tiotopentreadRturandomt_write_cookie_secret_filethmactnewthashlibtsha256RRtencodetdigest(RYtftkeyth((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_cookie_secrets cC@s|jjtd|jy/tj|jd}|j|WdQXWn2tk r}|jjtd|j|nXyt j |jdWn-tk r|jj td|jnXdS(s!write my secret to my secret_files+Writing notebook server cookie secret to %stwbNs'Failed to write cookie secret to %s: %sisCould not set permissions on %s( RaRRR1R6R7twritetOSErrorR)RtchmodR(RYtsecretRAR,((s3lib/python2.7/site-packages/notebook/notebookapp.pyR:s   s s Token used for authenticating first-time connections to the server. When no password is enabled, the default is to generate a new, random token. Setting to an empty string disables authentication altogether, which is NOT RECOMMENDED. RcC@sgtjdr%t|_tjdS|jr;t|_dSt|_tjtjdj dSdS(Nt JUPYTER_TOKENuitascii( RtgetenvRt_token_generatedRRtbinasciithexlifyR9tdecode(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_token_defaults     iisF 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. s Gets or sets the maximum amount of memory, in bytes, that is allocated for use by the buffer manager. cC@s t|_dS(N(RRM(RYtchange((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_token_changedss Hashed password to use for web authentication. To generate, type in a python/IPython shell: from notebook.auth import passwd; passwd() The string should be of the form type:salt:hashed-password. sForces users to use a password for the Notebook server. This is useful in a multi user environment, for instance when everybody in the LAN can access each other's machine through ssh. In such a case, server the notebook server on localhost is not secure since any user can connect to the notebook server via ssh. sAllow password to be changed at login for the notebook server. While loggin in with a token, the notebook server UI will give the opportunity to the user to enter a new password at the same time that will replace the token login mechanism. This can be set to false to prevent changing password from the UI/API. s:Disable cross-site-request-forgery protection Jupyter notebook 4.3.1 introduces 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. sjAllow 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. RcC@sytj|j}Wntk rxtj|j|jdtjD]}|dd}tj sw|j d}ny tj|j dd}Wn'tk r|j j d|qHnX|jpd|ko|jsHtSqHWtSX|j SdS(sDDisallow remote access if we're listening only on loopback addressesiiRKt%sUnrecognised IP address: %rN(t ipaddresst ip_addressRt ValueErrorR't getaddrinfoRJt SOCK_STREAMR:tPY3RPtsplitRaRt is_loopbackt is_link_localRR(RYtaddrRtparsed((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_allow_remote\s" (    sHostnames 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. spWhether 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. slSpecify 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. isSpecify 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. s DEPRECATED, use tornado_settingstwebapp_settingscC@s'|jjtd|d|_dS(Ns: webapp_settings is deprecated, use tornado_settings. R<(RaRRttornado_settings(RYRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_webapp_settingsssPSupply overrides for the tornado.web.Application that the Jupyter notebook uses.sq 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. sHSupply overrides for terminado. Currently only supports "shell_command".siExtra keyword arguments to pass to `set_secure_cookie`. See tornado's set_secure_cookie docs for details.siExtra keyword arguments to pass to `get_secure_cookie`. See tornado's get_secure_cookie docs for details.s\Supply SSL options for the tornado HTTPServer. See the tornado docs for details.s@Supply extra arguments that will be passed to Jinja environment.s<Extra variables to supply to jinja templates when rendering.skWhether to enable MathJax for typesetting math/TeX MathJax is the javascript library Jupyter uses to render math/LaTeX. It is very large, so you may want to disable it if you have a slow internet connection, or for offline use of the notebook. When disabled, equations etc. will appear as their untransformed TeX source. RcC@s|dsd|_ndS(s/set mathjax url to empty if mathjax is disabledR<uN(R(RYRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_enable_mathjaxs RsThe base URL for the notebook server. Leading and trailing slashes can be omitted, and will automatically be added. RbcC@sF|d}|jds&d|}n|jdsB|d}n|S(NR.R(Rtendswith(RYR/R.((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_base_urls    sDEPRECATED use base_urltbase_project_urlcC@s'|jjtd|d|_dS(Ns,base_project_url is deprecated, use base_urlR<(RaRRRb(RYRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_base_project_urlssExtra paths to search for serving static files. This allows adding javascript/css to be available from the notebook server machine, or overriding individual files in the IPythoncC@s|jtgS(s)return extra paths + the default location(textra_static_pathsR(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyRss!Path to search for custom.js, cssRvcC@s/g|jtfD]}tjj|d^qS(NR{(RRRRR(RYtd((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_static_custom_pathssvExtra paths to search for serving jinja templates. Can be used to override templates from notebook.templates.cC@s |jtS(s*return extra paths + the default locations(textra_template_pathsR(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyRss6extra paths to look for Javascript notebook extensionssKhandlers that should be loaded at higher priority than the default servicescC@s^|jtd}yddlm}Wntk r:n X|jtjj|d|S(s3The path to look for Javascript notebook extensionst nbextensionsi(tget_ipython_dir( textra_nbextensions_pathR<t IPython.pathsRnt ImportErrorRRRR(RYRRn((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs sThe 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] sA custom url for MathJax.js. Should be in the form of a case-sensitive url to MathJax, for example: /static/components/MathJax/MathJax.js RcC@s5|js dS|jjdd}t|dddS(NuRxRzt componentstMathJaxs MathJax.js(RRbRR@(RYRx((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_mathjax_url;s cC@sC|d}|r&|j r&d|_n|jjtd|dS(NR<usUsing MathJax: %s(RRRaRR(RYRRR<((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_mathjax_urlBs  sTeX-AMS-MML_HTMLorMML-full,Safes5The MathJax.js configuration file that is to be used.RcC@s!|jjtd|ddS(Ns$Using MathJax configuration file: %sR<(RaRR(RYRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_mathjax_configOssZIf True, display a button in the dashboard to quit (shutdown the notebook server).t default_valuetklasss"The notebook manager class to use.s The kernel manager class to use.s!The session manager class to use.sThe config manager class to uset allow_nones 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. sThe login handler class to use.s The logout handler class to use.sWhether 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 SSLt info_filecC@s&dtj}tjj|j|S(Nsnbserver-%s.json(RtgetpidRRR(RYRz((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_info_filestbrowser_open_filecC@s&dtj}tjj|j|S(Nsnbserver-%s-open.html(RR{RRR(RYtbasename((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_browser_open_filestdisableds[ DISABLED: use %pylab or %matplotlib in the notebook to enable matplotlib. RcC@sm|ddkr!d|d}nd}|jjtd|jjtdj||jddS( s5when --pylab is specified, display a warning and exitR<Rs %sRrsDSupport for specifying --pylab on the command line has been removed.sBPlease use `%pylab{0}` or `%matplotlib{0}` in the notebook itself.iN(RaR)RRR(RYRRtbackend((s3lib/python2.7/site-packages/notebook/notebookapp.pyt _update_pylabs s/The directory to use for notebooks and kernels.R cC@s6|jr(tjjtjj|jStjSdS(N(t file_to_runRRtdirnametabspathR:tgetcwd(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_default_notebook_dirs cC@s|d}tjj|\}}|tjkr5|S|jtj}tjj|sntjj|}ntjj|stt j d|n|S(NR.sNo such notebook dir: '%r'( RRt splitdriveRtrstriptisabsRtisdirR4RR(RYR/R.RR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_notebook_dir_validates cC@s,|d}||jj_||jj_dS(s+Do a bit of validation of the notebook dir.R<N(RRRR(RYRRR<((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_notebook_dirs s3DEPRECATED use the nbserver_extensions dict insteadtserver_extensionscC@s'|jjtd|d|_dS(Ns8server_extensions is deprecated, use nbserver_extensionsR<(RaRRR(RYRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt_update_server_extensionsssDict of Python modules to load as notebook server extensions.Entry values can be used to enable and disable the loading ofthe extensions. The extensions will be loaded in alphabetical order.s9Reraise exceptions encountered loading server extensions?isg(msgs/sec) Maximum rate at which messages can be sent on iopub before they are limited.i@Bsm(bytes/sec) Maximum rate at which stream output can be sent on iopub before they are limited.isJ(sec) Time window used to check the message and data rate limits.scShut down the server after N seconds with no kernels or terminals running and no activity. This can be used together with culling idle kernels (MappingKernelManager.cull_idle_timeout) to shutdown the notebook 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.s/Set to False to disable terminals. This does *not* make the notebook 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. cC@stt|j||jr|jd}tjj|}|jj|tjj |s|j j t d||j dnt}tjj|r||j_n!tjj|r||j_n|j|ndS(NisNo such file or directory: %si(RWRRRRRRRtremoveRRatcriticalRRRRR tisfileRt update_config(RYRtarg0RAtc((s3lib/python2.7/site-packages/notebook/notebookapp.pyR s   c C@s|jd||_|jd|d|jd|jd|j|_|jd|d|j|_|jd|d|jd|jd|j|_ |j d|d|j|_ dS(NtparentRatconnection_dirR^R[R\( tkernel_spec_manager_classR^tkernel_manager_classRaRR[tcontents_manager_classR\tsession_manager_classR]tconfig_manager_classR_(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pytinit_configurables s$          cC@spt|j_x&tttfD]}|jj|_qWtjd}t |_|j|_ |j |jj dS(Nttornado( RRat propagateR RRRQRt getLoggerRRtsetLeveltlevel(RYRatlogger((s3lib/python2.7/site-packages/notebook/notebookapp.pyt init_logging9s   c C@sz|j|jd<|j|jd<|jrEtj|j|jd}PqW|sv|jjtd|jd ndS(s(initialize tornado webapp and httpservert allow_origintwebsocket_compression_optionstallow_origin_pattallow_credentialstcookie_optionstget_secure_cookie_kwargsRs?Notebook servers are configured to only be run with a password.s1Hint: run the following command to set a passwords# $ python -m notebook.auth passwordiRRtca_certsiNt ssl_versiont cert_reqst ssl_optionstxheaderst max_body_sizetmax_buffer_sizes3The port %i is already in use, trying another port.t WSAEACCESs&Permission to listen on port %i deniedsYERROR: the notebook server could not be started because no available port could be found.(?RRbRRtretcompileRRRRRcRRbR@tpassword_requiredRRaRRRRRTR[R\R]R^R_R`tjinja_environment_optionstweb_appRRRt client_caRtsslt setdefaulttPROTOCOL_TLSv1RRt CERT_REQUIREDRtvalidate_securityR t HTTPServerttrust_xheadersRRt http_serverRMRJt port_retriestlistenRR'R)terrnot EADDRINUSERtEACCEStgetattrRR(RYRRtsuccessRJR,((s3lib/python2.7/site-packages/notebook/notebookapp.pyt init_webappHsr            ' cC@s|jr1|j}|jdsk|d7}qkn:|jdkrSdtj}n |j}|j|}|jr|jr|jnd}t|i|d6}n|S(NRRrs0.0.0.0s(%s or 127.0.0.1)s...R(Rrs0.0.0.0( tcustom_display_urlReRR't gethostnamet_urlRRMR (RYRRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyt display_urls    cC@s%|jr|jnd}|j|S(NR&(RR(RYR((s3lib/python2.7/site-packages/notebook/notebookapp.pytconnection_urlscC@s/|jrdnd}d|||j|jfS(Nthttpsthttps %s://%s:%i%s(RRJRb(RYRtproto((s3lib/python2.7/site-packages/notebook/notebookapp.pyRscC@s|js dSyCddlm}||j|j|j|jt|jjdt j |}t |dd}|dk r;||nWqtk r}|jr[n|jjtd|dtqXqqWdS( sLoad 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. itread_config_pathRtnbserver_extensionstload_jupyter_server_extensions!Error loading server extension %stexc_infoN(RRRR%RtinsertRRtconfig_file_nametitemstsortedt importlibt import_moduleRRt Exceptiont!reraise_server_extension_failuresRaRR( RYt modulenamet config_pathtmanagertsectionRktenabledRRtfunc((s3lib/python2.7/site-packages/notebook/notebookapp.pytinit_server_extensionss0      cC@s$tjddtjdddS(Nstext/csss.csssapplication/javascripts.js(t mimetypestadd_type(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pytinit_mime_overrides.scC@s|j}t|dkrdSy|jjd}Wntk rFnX|jrTdSt|jjj}|j j d|||j kr|j j d||j ndS(sBShutdown server on timeout when there are no kernels or terminals.iNtterminal_managersNo activity for %d seconds.s6No kernels or terminals for %d seconds; shutting down.(R[RRRfRt terminalsR>Rt total_secondsRaRtshutdown_no_activity_timeoutRR(RYtkmtterm_mgrtseconds_since_active((s3lib/python2.7/site-packages/notebook/notebookapp.pytshutdown_no_activity8s      cC@sK|jdkrG|jjd|jtj|jd}|jndS(Nis=Will shut down after %d seconds with no kernels or terminals.i`(RRaRRtPeriodicCallbackRR(RYtpc((s3lib/python2.7/site-packages/notebook/notebookapp.pytinit_shutdown_no_activityOs   cC@stt|j||j|jr-dS|j|j|j|j|j |j |j |j dS(N( RWRRRt _dispatchingRRRRRRRR(RYR((s3lib/python2.7/site-packages/notebook/notebookapp.pyRVs         cC@sOt|jj}tjdd|}|jj|||jjdS(sShutdown all kernels. The kernels will shutdown themselves when this process no longer exists, but explicit shutdown allows the KernelManagers to cleanup the connection files. sShutting down %d kernelsShutting down %d kernelsN(RR[tlist_kernel_idsRtngettextRaRt shutdown_all(RYt n_kernelst kernel_msg((s3lib/python2.7/site-packages/notebook/notebookapp.pytcleanup_kernelsescC@sy|jjd}|r^t|jj}tjdd|}|||7}|d7}n|td|j7}|S(sCReturn the current working directory and the server url informations s%d active kernels%d active kernelss&The Jupyter Notebook is running at: %s( R\t info_stringRR[RRRRR(RYt kernel_countRR!R"((s3lib/python2.7/site-packages/notebook/notebookapp.pyRps cC@si |jd6|jr|jndd6|jd6t|jd6|jd6|jd6tjj |j d6t|j d 6tj d 6S( s8Return a JSONable dict of information about this server.RR&thostnameRJtsecureRbRR RR( RRRJtboolRRbRRRRR RR{(RY((s3lib/python2.7/site-packages/notebook/notebookapp.pyR|s    c C@szyAt|jd)}tj|j|dddtWdQXWn2tk ru}|jjt d|j|nXdS(s=Write the result of server_info() to the JSON file info_file.RR it sort_keysNs%Failed to write server-info to %s: %s( R7RzR tdumpRRRGRaR)R(RYRAR,((s3lib/python2.7/site-packages/notebook/notebookapp.pytwrite_server_info_files ,cC@sFytj|jWn+tk rA}|jtjkrBqBnXdS(sRemove the nbserver-.json file created for this server. Ignores the error raised when the file has already been removed. N(RtunlinkRzRGRtENOENT(RYR,((s3lib/python2.7/site-packages/notebook/notebookapp.pytremove_server_info_files cC@sN|jt|j}tj|jddd}|j||WdQXdS(skWrite an nbserver--open.html file This can be used to open the notebook in a browser Rtencodingsutf-8N(RcRRbR6R7R}t_write_browser_open_file(RYtopen_urlRA((s3lib/python2.7/site-packages/notebook/notebookapp.pytwrite_browser_open_filescC@ss|jr%t|i|jd6}nt|j|}|jjd}|jd}|j|jd|dS(NRRsbrowser-open.htmlR1( RR R@RRRft get_templateRFtrender(RYRtfhRttemplate((s3lib/python2.7/site-packages/notebook/notebookapp.pyR0s  cC@sFytj|jWn+tk rA}|jtjkrBqBnXdS(sRemove the nbserver--open.html file created for this server. Ignores the error raised when the file has already been removed. N(RR,R}RGRR-(RYR,((s3lib/python2.7/site-packages/notebook/notebookapp.pytremove_browser_open_files c@sjytjjpdWn6tjk rT}jjtd|dnXs_dSjr2t j j jsjj tdjj dnt j jjj}ttd|jt j}tjdd\}tj|ddd }j||WdQXn jfd }tjd |jdS( NsNo web browser found: %s.s%s does not existit notebookstsuffixs.htmlRR/sutf-8c@s%jtdtdjS(Nsfile:R<(R7RCRDtwebbrowser_open_new((Rt open_fileRY(s3lib/python2.7/site-packages/notebook/notebookapp.pytsR(t webbrowserRRRtErrorRaRRRRRRRRtrelpathR RBR@R[RttempfiletmkstempR6R7R0R}RRR(RYR,R?turitfdR5tb((RR;RYs3lib/python2.7/site-packages/notebook/notebookapp.pytlaunch_browsers&  ! c C@stt|j|js{ytj}Wntk rEd}nX|dkr{|jjt d|j dq{n|jj }x-|j dt jdD]}||qW|t ddtjkr|t d n|j|j|js|jr|jn|jrv|jrv|jjdjdd d td t|jd d |jgntjj|_ t!j"j#drtj$dd}|jnz9y|j jWn!t%k r|t dnXWd|j&|j'|j(XdS(s Start the Notebook server app, after initialization This method takes no arguments so all configuration and initialization must be done prior to calling this method.iis?Running as root is not recommended. Use --allow-root to bypass.iR%s sYUse Control-C to stop this server and shut down all kernels (twice to skip confirmation).tdevsWelcome to Project Jupyter! Explore the various tools available and their corresponding documentation. If you are interested in contributing to the platform, please visit the communityresources section at https://jupyter.org/community.html.s4To access the notebook, open this file in a browser:s %ssfile:s$Or copy and paste one of these URLs:RcS@sdS(N(R(((s3lib/python2.7/site-packages/notebook/notebookapp.pyR< RrisInterrupted...N()RWRRRRtgeteuidtAttributeErrorRaRRRRRRR[tnotebookRR+R2RRRERRMRRCRDR}RRtIOLooptcurrentRRRRRtKeyboardInterruptR.R7R#(RYtuidRRR((s3lib/python2.7/site-packages/notebook/notebookapp.pyRsL     "       c@s#fd}jj|dS(Nc@sjjjjdS(N(RRR((RY(s3lib/python2.7/site-packages/notebook/notebookapp.pyt_stops (Rt add_callback(RYRN((RYs3lib/python2.7/site-packages/notebook/notebookapp.pyRsii ii N(RRRQRRRRt _examplestexamplestaliasesRR&R*RRRR+R'tclassesR-RR t splitlinesRRt subcommandsR t_log_formatter_clsR8R!R#R%R1RRR~R.RRRRRRcRR-R9R0RR/RJRRRRR1R3R2RRDR:ttagRRMRQRRR7RSRRRRRR`R0RRRR:RaRcRbR,RRRRRRRRRRdRbRfRgRhRitpropertyRRvRkRlRRoR`RRRRtRuRRvRR5RRRRRRRR3R^RRR tRequestHandlerRRRRRzR|R}RRRR RRRRRRRR6RRRRRRRRRRRRRRRRRRRRRRRRR RR#RRR+R.R2R0R7RERR(((s3lib/python2.7/site-packages/notebook/notebookapp.pyR,s                                                                J   !    0    tj tjj ||dd}t j |}WdQXd|krt |dr|Vqy tjtjj ||Wqtk rqXq>q>WdS(s Iterate over the server info files of running notebook servers. Given a runtime directory, find nbserver-* files in the security directory, and yield dicts of their information, each one pertaining to a currently running notebook server instance. Nsnbserver-(.+).jsonR/sutf-8R(RR;RRRtlistdirRtmatchR6R7RR tloadRAR,RG(Rt file_nameRAR((s3lib/python2.7/site-packages/notebook/notebookapp.pyRs  '  (Rt __future__RRRIRNRRRR=R;RR6RUR RRRRHRRRR'RR@RRRR=tbase64RRqRtjinja2RRtnotebook.transutilsRRt zmq.eventloopRtinstallRt version_infoRHRR R ttornado.httputilR t tornado.logR R RRRRRt raw_inputt NameErrortinputt base.handlersRRRaRtservices.kernels.kernelmanagerRtservices.configRtservices.contents.managerRtservices.contents.filemanagerRt"services.contents.largefilemanagerRt services.sessions.sessionmanagerRt auth.loginRt auth.logoutRRttraitlets.configRttraitlets.config.applicationR R!tjupyter_core.applicationR"R#R$tjupyter_core.pathsR%tjupyter_clientR&tjupyter_client.kernelspecR'R(R)tjupyter_client.sessionR*t nbformat.signR+t traitletsR,R-R.R/R0R1R2R3R4R5R6R7R8R9tipython_genutilsR:R;R<tnotebook._sysinfoR=t_tzR>R?tutilsR@RARBRCRDRPRMRSt ApplicationRTRRRRR RRRRRRRRRtlaunch_instancetmaintlaunch_new_instance(((s3lib/python2.7/site-packages/notebook/notebookapp.pyts                              "   ^(  .!'       !