a 2b c @sHdZddlZddlZddlmZddlmZmZm Z m Z ddl m Z ddlmZddlmZddlmZmZmZmZmZdd lmZdd lmZmZmZmZd d l m!Z!d d l"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.mZm/Z/m0Z0d dl1m2Z2d dl3m4Z4d dl5m6Z6m7Z7m8Z8d dl9m:Z:d dl;mZ>d dl?m@Z@dZAdZBeCe ZDdeDd<deDd<deDd<deDd<deDd<d eDd!<eCe ZEd"d#d$iid%feEd<d"dd&iid'feEd(<d"d)d$iid*feEd+<e!ZFe,ZGeFeGkrd,e!eGfZFd-ZHGd.d"d"ee4ZIeCe ZJd/eJd<d0ZKeCe ZLd1d2d$iid3eKfeLd2<d1d4d$iid5feLd4<d1d6d$iid7feLd6<d1d8d$iid9eKfeLd8<Gd:d;d;e%ZMGdd>eZOGd?d@d@eZPGdAdBdBeZQGdCdDdDeZRGdEdFdFeZSGdGdHdHeZTeCe ZUeUVdIdJdKdLdMdNdOdPdQdR GdSdTdTeeZWeWjXZYZZe[dUkrDeYdS)Vz#A tornado based Jupyter lab server.N)join) JupyterAppNoStart base_aliases base_flags) version_info)flags) url_path_join) LabServerApp LicensesAppWorkspaceExportAppWorkspaceImportAppWorkspaceListApp)NBClassicConfigShimMixin)BoolInstanceUnicodedefault) __version__)DEV_DIRHERE AppOptionsbuildclean ensure_app ensure_core ensure_dev get_app_dirget_app_versionget_user_settings_dirget_workspaces_dirpjoinwatch watch_dev) CoreConfig)DebugLogFileMixin)Builder BuildHandler build_path) ErrorHandler)ExtensionHandlerExtensionManagerextensions_handler_path)YjsEchoWebSocketzYou're running JupyterLab from source. If you're working on the TypeScript sources of JupyterLab, try running jupyter lab --dev-mode --watch to have the system incrementally watch and build JupyterLab for you, as you make changes. zH Running the core application with no additional extensions or settings zLabBuildApp.app_dirapp-dirzLabBuildApp.namenamezLabBuildApp.versionversionzLabBuildApp.dev_buildz dev-buildzLabBuildApp.minimizeminimizez DebugLogFileMixin.debug_log_pathzdebug-log-path LabBuildApp dev_buildTzBuild in development mode.Fz#Do not minimize a production build.z no-minimize splice_source*Splice source packages into app directory. splice-sourcez%s (dev), %s (app)aBuild failed. Troubleshooting: If the build failed due to an out-of-memory error, you may be able to fix it by disabling the `dev_build` and/or `minimize` options. If you are building via the `jupyter lab build` command, you can disable these options like so: jupyter lab build --dev-build=False --minimize=False You can also disable these options for all JupyterLab builds by adding these lines to a Jupyter config file named `jupyter_config.py`: c.LabBuildApp.minimize = False c.LabBuildApp.dev_build = False If you don't already have a `jupyter_config.py` file, you can create one by adding a blank file of that name to any of the Jupyter config directories. The config directories can be listed by running: jupyter --paths Explanation: - `dev-build`: This option controls whether a `dev` or a more streamlined `production` build is used. This option will default to `False` (i.e., the `production` build) for most users. However, if you have any labextensions installed from local files, this option will instead default to `True`. Explicitly setting `dev-build` to `False` will ensure that the `production` build is used in all circumstances. - `minimize`: This option controls whether your JS bundle is minified during the Webpack build, which helps to improve JupyterLab's overall performance. However, the minifier plugin used by Webpack is very memory intensive, so turning it off may help the build finish successfully in low-memory environments. c@seZdZeZdZeZeZe e ddZ e ddddZ e ddddZe ddd dZed ddd d Zeddd dZeddddZeddddZddZd S)r3z Build the JupyterLab application The application is built in the JupyterLab app directory in `/staging`. When the build is complete it is put in the JupyterLab app `/static` directory, where it is used to serve the application. T allow_nonezThe app directory to build inconfighelp JupyterLabz!The name of the built applicationz$The version of the built applicationNzWhether to build in dev mode. Defaults to True (dev mode) if there are any locally linked extensions, else defaults to False (production mode).)r9r<r=z:Whether to minimize a production build (defaults to True).Fz4Whether to clean before building (defaults to False)r6c Cs|jp t}t||j|j|jd}|jdt||j rZ|jd|t |d|jd|z2|j durxdn|j }t |j |j|||jdWn0ty}ztt|WYd}~n d}~00Wdn1s0YdS)N)app_dirlogger core_configr5z JupyterLab %sz Cleaning %s app_optionszBuilding in %s)r0r1rC productionr2)r?rrlogrAr5infor1Z debug_logging pre_cleanrr4rr0r2 ExceptionprintbuildFailureMsg)selfr?rCrDerM0lib/python3.9/site-packages/jupyterlab/labapp.pystarts$     zLabBuildApp.start)__name__ __module__ __qualname__r1 description build_aliasesaliases build_flagsrrr%rArr?r0rr4r2rGr5rOrMrMrMrNr3ss6 zLabCleanApp.app_dirzSWARNING: this will delete all of your extensions, which will need to be reinstalled LabCleanApp extensions$Also delete /extensions. %ssettingsAlso delete /settingsstaticAlso delete /staticall3Delete the entire contents of the app directory. %sc@s4eZdZedZedZedZedZedZdS)LabCleanAppOptionsFTN) rPrQrRrrXrZZstagingr\r^rMrMrMrNr`s r`c@s~eZdZeZdZeZeZe e ddZ e ddddZ edddedZeddd dZeddd dZeddd edZd d ZdS)rWa  Clean the JupyterLab application This will clean the app directory by removing the `staging` directories. Optionally, the `extensions`, `settings`, and/or `static` directories, or the entire contents of the app directory, can also be removed. Tr8r:zThe app directory to cleanr;FrYr[r]r_c Cs2t|j|j|j|j|j|j|jd}t|ddS)N)r@rAr?rXrZr\r^rB) r`rErAr?rXrZr\r^r)rKrCrMrMrNrOs zLabCleanApp.startN)rPrQrRr1rS clean_aliasesrU clean_flagsrrr%rArr?r ext_warn_msgrXrZr\r^rOrMrMrMrNrWs c@seZdZeZdZddZdS) LabPathAppaD Print the configured paths for the JupyterLab application The application path can be configured using the JUPYTERLAB_DIR environment variable. The user settings path can be configured using the JUPYTERLAB_SETTINGS_DIR environment variable or it will fall back to `/lab/user-settings` in the default Jupyter configuration directory. The workspaces path can be configured using the JUPYTERLAB_WORKSPACES_DIR environment variable or it will fall back to '/lab/workspaces' in the default Jupyter configuration directory. cCs.tdttdttdtdS)NzApplication directory: %szUser Settings directory: %szWorkspaces directory: %s)rIrr r!rKrMrMrNrOszLabPathApp.startN)rPrQrRr1rSrOrMrMrMrNrds rdc@s eZdZeZedddZdS)LabWorkspaceExportAppworkspaces_dircCstSNr!rerMrMrN_default_workspaces_dirsz-LabWorkspaceExportApp._default_workspaces_dirNrPrQrRr1rrjrMrMrMrNrfsrfc@s eZdZeZedddZdS)LabWorkspaceImportApprgcCstSrhrirerMrMrNrjsz-LabWorkspaceImportApp._default_workspaces_dirNrkrMrMrMrNrlsrlc@s eZdZeZedddZdS)LabWorkspaceListApprgcCstSrhrirerMrMrNrjsz+LabWorkspaceListApp._default_workspaces_dirNrkrMrMrMrNrm srmcsleZdZeZdZeZeejdfed<e e jdfed<e e jdfed<fddZ Z S)LabWorkspaceAppz Import or export a JupyterLab workspace or list all the JupyterLab workspaces There are three sub-commands for export, import or listing of workspaces. This app should not otherwise do any work. rZexportimportlistcsBz ttd|dWnty2Yn0|ddS)Nz6One of `export`, `import` or `list` must be specified.rr)superrOrIexitrre __class__rMrNrO+s  zLabWorkspaceApp.start) rPrQrRr1rSdict subcommandsrf splitlinesrlrmrO __classcell__rMrMrsrNrns   rnc@s|eZdZeZeddddZeddddZiej ddiZ iej d dd diid fiZ e d d dZ e dddZ dS)LabLicensesAppFTWhether to start the app in dev mode. Uses the unpublished local JavaScript packages in the `dev_mode` folder. In this case JupyterLab will show a red stripe at the top of the page. It can only be used if JupyterLab is installed as `pip install -e .`. r;r:z,The app directory for which to show licensesr/zLabLicensesApp.app_dirdev-modedev_mode2Start the app in dev mode for running from source.r?cCstSrh)rrerMrMrN_default_app_dirSszLabLicensesApp._default_app_dir static_dircCs t|jdSNr\r"r?rerMrMrN_default_static_dirWsz"LabLicensesApp._default_static_dirN)rPrQrRr1rr|rr?r rUrrr~rrMrMrMrNry5s4   ryz ServerApp.ipzServerApp.portzServerApp.port_retrieszServerApp.keyfilezServerApp.certfilezServerApp.client_cazServerApp.root_dirzServerApp.browserzServerApp.pylab) Zipportz port-retriesZkeyfileZcertfilez client-caz notebook-dirZbrowserZpylabc seZdZeZdZdZdZdZdZe Z e ddide d <e Z dd diid fe d <dd diidfe d<dddiidfe d<dddiidfe d<dddiidfe d<dddiidfe d<dddiidfe d<e e e jdfeejdfeejdfeejdfeejdfeejdfeejdfdZedddd Zedd!d Zedd"d Zed#dd$d Zeedd%d Zeedd&d Zed'dd(d Zed'dd)d Zed'dd*d Z ed'dd+d Z!ed'ddd Z"ed'dd,d Z#ed'ddd Z$e%d-d.d/Z&e%d0d1d2Z'e%d3d4d5Z(e%d6d7d8Z)e%d9d:d;Z*e%d<d=d>Z+e%d?d@dAZ,e%dBdCdDZ-e%dEdFdGZ.e%dHdIdJZ/dKdLZ0fdMdNZ1fdOdPZ2dSfdQdR Z3Z4S)TLabAppZlabr>TaB JupyterLab - An extensible computational environment for Jupyter. This launches a Tornado based HTML Server that serves up an HTML5/Javascript JupyterLab client. JupyterLab has three different modes of running: * Core mode (`--core-mode`): in this mode JupyterLab will run using the JavaScript assets contained in the installed `jupyterlab` Python package. In core mode, no extensions are enabled. This is the default in a stable JupyterLab release if you have no extensions installed. * Dev mode (`--dev-mode`): uses the unpublished local JavaScript packages in the `dev_mode` folder. In this case JupyterLab will show a red stripe at the top of the page. It can only be used if JupyterLab is installed as `pip install -e .`. * App mode: JupyterLab allows multiple JupyterLab "applications" to be created by the user with different combinations of extensions. The `--app-dir` can be used to set a directory for different applications. The default application path can be found using `jupyter lab path`. a jupyter lab # start JupyterLab jupyter lab --dev-mode # start JupyterLab in development mode, with no extensions jupyter lab --core-mode # start JupyterLab in core mode, with no extensions jupyter lab --app-dir=~/myjupyterlabapp # start JupyterLab with a particular set of extensions jupyter lab --certfile=mycert.pem # use SSL/TLS certificate r#z LabApp.watchzLabApp.app_dirr/ core_modezStart the app in core mode.z core-moder|r}r{zStart the app in watch mode.r5r6r7expose_app_in_browserzExpose the global app instance to browser via window.jupyterapp. It is also available via the deprecated window.jupyterlab name.zexpose-app-in-browserextensions_in_dev_modez%Load prebuilt extensions in dev-mode.zextensions-in-dev-mode collaborativez4Whether to enable collaborative mode (experimental).r)rrpathpathsZ workspaceZ workspacesZlicensesz/labz'The default URL to redirect to from `/`r;z8The override url for static lab assets, typically a CDN.z>The override url for static lab theme assets, typically a CDN.Nz,The app directory to launch JupyterLab from.z The directory for user settings.zThe directory for workspacesFaWhether to start the app in core mode. In this mode, JupyterLab will run using the JavaScript assets that are within the installed JupyterLab Python package. In core mode, third party extensions are disabled. The `--dev-mode` flag is an alias to this to be used when the Python package itself is installed in development mode (`pip install -e .`). rzaWWhether to load prebuilt extensions in dev mode. This may be useful to run and test prebuilt extensions in development installs of JupyterLab. APIs in a JupyterLab development install may be incompatible with published packages, so prebuilt extensions compiled against published packages may not work correctly.z&Whether to serve the app in watch modezJWhether to expose the global app instance to browser via window.jupyterlabr?cCs t}|jrt}n |jrt}|Srh)rrrr|r)rKr?rMrMrNr~s zLabApp._default_app_dirZapp_settings_dircCs t|jdS)NrZrrerMrMrN_default_app_settings_dirsz LabApp._default_app_settings_dir app_versioncCstSrh)rrerMrMrN_default_app_versionszLabApp._default_app_version cache_filescCsdS)NFrMrerMrMrN_default_cache_filesszLabApp._default_cache_filesZ schemas_dircCs t|jdS)NZschemasrrerMrMrN_default_schemas_dirszLabApp._default_schemas_dir templates_dircCs t|jdSrrrerMrMrN_default_templates_dir szLabApp._default_templates_dirZ themes_dircCs|jr dSt|jdS)Nr:Zthemes)override_theme_urlr"r?rerMrMrN_default_themes_dirszLabApp._default_themes_dirrcCs t|jdSrrrerMrMrNrszLabApp._default_static_dirZstatic_url_prefixcCs,|jr |jSdj|jd}t|jj|SdS)Nz/static/{name}/)r0)override_static_urlformatr0ujoin serverappZbase_url)rKZ static_urlrMrMrN_default_static_url_prefixs z!LabApp._default_static_url_prefixZ theme_urlcCs|jr |jSdS)Nr:)rrerMrMrN_default_theme_url!szLabApp._default_theme_urlcCs |js|jttjr*d|_|jd|jsB|jt tjrTd|_|jd|j rr|jrr|j dd|_ |jr|jr|j dd|_|jrt t d}|g|_ |g|_|jsg|_g|_nB|jrt td}|g|_ |g|_g|_g|_n|jg|_ |jg|_dS)NTzRunning JupyterLab in core modezRunning JupyterLab in dev modez3Cannot watch in core mode, did you mean --dev-mode?Fz3Conflicting modes, choosing dev_mode over core_moder\)rr? startswithrosseprErFr|rr#warnrZ static_pathsZtemplate_pathsrlabextensions_pathextra_labextensions_pathrr)rKZdev_static_dirrMrMrNinitialize_templates's6         zLabApp.initialize_templatescstdSrh)rqinitialize_settingsrersrMrNrLszLabApp.initialize_settingscsg}jjjdi}|dj o*j |dj oBj j|d<jj|d<j|d<jj|d<j |d<jj j |d <t t|d <jd tjd jtjjjjjd }tj|d}ttd|if}||dtf}||d}jr8jttjnzjr`jst jjt!nRjrrt jt"j}|rfdd|Dj#t$d|if} || d}jrjdjrt%jnt|dd|d<d_&js"|s"t'|d} t(t)d| if} || djj*vrjj*} | d} | |d<| d|d<| d|d<t+| d|d<t,jd rjj-|d!<t./d"d#}||d<|jjjd<j01|t23dS)$NZpage_config_dataZbuildAvailableZ buildCheckZdevModetokenZexposeAppInBrowserZ quitButtonrZallow_hidden_filesZnotebookVersionz#JupyterLab extension loaded from %sz&JupyterLab application directory is %s)r@r?rr5rBbuilderz /api/yjs/(.*)Fcsg|]}j|qSrM)rEerror).0msgrerMrN |z.LabApp.initialize_handlers..messagesTz!Starting JupyterLab watch mode...Zmanager hub_prefixZ hubPrefixZhub_hostZhubHostuserZhubUserz user-redirectZshareUrl server_nameZ hubServerNameZJUPYTERHUB_API_TOKENr:)4rZweb_apprZ setdefaultrr|rrZ quit_buttonrZcontents_managerZ allow_hiddenjsondumpsjpserver_version_inforErFrr?rrrr5r'r)r(appendr. CORE_NOTEstriprr#rDEV_NOTErZapp_urlr*r$rr,r-r+tornado_settingsrhasattrrrgetenvhandlersextendrqinitialize_handlers)rKrZ page_configZbuild_handler_optionsrZ build_handlerZyjs_echo_handlerZerroredZmsgsZhandlerZ ext_managerZ ext_handlerrrZ api_tokenrsrerNrPs~                      zLabApp.initialize_handlerscstdS)zMSubclass because the ExtensionApp.initialize() method does not take argumentsN)rq initialize)rKargvrsrMrNrszLabApp.initialize)N)5rPrQrRr1r0Zapp_nameZload_other_extensionsrSZexamplesrUupdaterrur3rwrWrdrnryrvrZ default_urlrrr?r Zuser_settings_dirr!rgrrr|rr#r5rrrr~rrrrrrrrrrrrrrxrMrMrsrNrjs                    %  Xr__main__)\__doc__rrZos.pathrr"Zjupyter_core.applicationrrrrZjupyter_server._versionrrZjupyter_server.serverapprZjupyter_server.utilsr rZjupyterlab_serverr r r r rZnbclassic.shimrZ traitletsrrrrZ_versionrZcommandsrrrrrrrrrrr r!r#r$Z coreconfigr%Zdebuglogr&Zhandlers.build_handlerr'r(r)Zhandlers.error_handlerr*Z"handlers.extension_manager_handlerr+r,r-Zhandlers.yjs_echo_wsr.rrrurTrVr1rrJr3rarcrbr`rWrdrfrlrmrnryrUrrZlaunch_instancemainZlaunch_new_instancerPrMrMrMrNs      D          %8  ( ' H