Ib*"dZddlZddlZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZddlmZdd lmZ d'd Zd(d ZiZej/e j,ej1ddej1ddej/ddd iidfdd d didfddd iidfddd iidfdeded<Gdde ZGddeZGddeZGd d!e Zd"ZGd#d$e Zej>Z d%Z!e"d&k(re yy))z;Utilities for installing server extensions for the notebookN)jupyter_config_path) __version__)BaseJSONConfigManager)BaseExtensionApp_get_config_dir GREEN_ENABLED RED_DISABLEDGREEN_OKRED_X)Bool) import_itemTFc|rdn|}t||}t||}|jd}|jdijdi} | j|d} ||n| } |r+| r|j d|n|j d || | |<|r|j d ||j d|| r t ||yy) avToggle a server extension. By default, toggles the extension in the system-wide Jupyter configuration location (e.g. /usr/local/etc/jupyter). Parameters ---------- import_name : str Importable Python module (dotted-notation) exposing the magic-named `load_jupyter_server_extension` function enabled : bool [default: None] Toggle state for the extension. Set to None to toggle, True to enable, and False to disable the extension. parent : Configurable [default: None] user : bool [default: True] Toggle in the user's configuration location (e.g. ~/.jupyter). sys_prefix : bool [default: False] Toggle in the current Python environment's configuration location (e.g. ~/.envs/my-env/etc/jupyter). Will override `user`. logger : Jupyter logger [optional] Logger instance to use Fuser sys_prefixparent config_dirjupyter_notebook_config NotebookAppnbserver_extensionsNz Enabling: z Disabling: z- Writing config: )rrget setdefaultinfoupdatevalidate_serverextension) import_nameenabledrrrloggerrcmcfgserver_extensions old_enabled new_enableds ;/usr/lib/python3/dist-packages/notebook/serverextensions.pytoggle_serverextension_pythonr's25DD dzBJ f DB &&* +C }b) )2 . $'' T:K$0'+oK  KK*[M2 3 KK+k]3 4%0k"  ( 56II'- f5cdg}g}d}|r|jd tj|}t|dd}t|dd}d}|&|j |jt|n%|j |jt|d}|rh|r@|D cgc]} |j| c} |D cgc]} |j| c} |S|j|j|t|S#t$r|j d|YwxYwcc} wcc} w) a\Assess the health of an installed server extension Returns a list of validation warnings. Parameters ---------- import_name : str Importable Python module (dotted-notation) exposing the magic-named `load_jupyter_server_extension` function logger : Jupyter logger [optional] Logger instance to use Nz - Validating...load_jupyter_server_extensionrz!Error loading server extension %sz {} is {} importable?z {} {} {}) r importlib import_modulegetattr Exceptionwarningappendformatr r warn) rr warningsinfosfuncmodversion import_msg post_mortemrr0s r&rrMs H E D  )*I%%k2s;TB#}b1-J  Z&&x=> ))%=>"K +0 14V[[  119 :gV[[ ! : O KK **;J K O# I:KHI 2 :s/D#D(D-D%$D%yzgenerate-configToggleServerExtensionApprz*Perform the operation for the current userrz!Perform the operation system-widerz=Use sys.prefix as the prefix for installing server extensionspythonInstall from a Python package)rsystemz sys-prefixpyr@cpeZdZdZdZdZeZedddZedddZ eddd Z d Z d Z d Z y )r<z.A base class for enabling/disabling extensionsz&jupyter serverextension enable/disablezEEnable/disable a server extension using frontend configuration files.TzWhether to do a user install)confighelpFz Use the sys.prefix as the prefixr>cvt||j||j|j|jy)a.Change the status of a named server extension. Uses the value of `self._toggle_value`. Parameters --------- import_name : str Importable Python module (dotted-notation) exposing the magic-named `load_jupyter_server_extension` function )rrrr N)r' _toggle_valuerrlog)selfrs r&toggle_server_extensionz0ToggleServerExtensionApp.toggle_server_extensions, & ++Dtyytxx 9r(cZt|\}}|D]}|d}|j|y)a,Change the status of some server extensions in a Python package. Uses the value of `self._toggle_value`. Parameters --------- package : str Importable Python module exposing the magic-named `_jupyter_server_extension_paths` function moduleN)_get_server_extension_metadatarH)rGpackagem server_exts server_extrJs r&toggle_server_extension_pythonz7ToggleServerExtensionApp.toggle_server_extension_pythons98@;% 1J)F  ( ( 0 1r(c|jstjd|jD]1}|jr|j |!|j |3y)'Perform the App's actions as configuredz>Please specify a server extension/package to enable or disableN) extra_argssysexitr=rPrH)rGargs r&startzToggleServerExtensionApp.startsL HHU V?? 2C{{33C8,,S1  2r(N)__name__ __module__ __qualname____doc__name descriptionflagsr rrr=rHrPrWr(r&r<r<sP8 3DYK E T(F GDeD/QRJ %+J KF9 1"2r(ceZdZdZdZdZdZy)EnableServerExtensionAppz5An App that enables (and validates) Server Extensionszjupyter serverextension enablez~ Enable a serverextension in configuration. Usage jupyter serverextension enable [--system|--sys-prefix] TNrXrYrZr[r\r]rEr_r(r&raras? +DK Mr(raceZdZdZdZdZdZy)DisableServerExtensionAppz&An App that disables Server Extensionszjupyter serverextension disablez Disable a serverextension in configuration. Usage jupyter serverextension disable [--system|--sys-prefix] FNrbr_r(r&rdrds0 ,DK Mr(rdc(eZdZdZdZeZdZdZdZ y)ListServerExtensionsAppz3An App that lists (and validates) Server Extensionszjupyter serverextension listz # enable all server extensions in a Python package jupyter serverextension disable --py # disable all server extensions in a Python package cTeZdZdZdZeZdZeZ e e dfe dfe dfZfdZxZS) ServerExtensionAppzRoot level server extension appzjupyter serverextensionz#Work with Jupyter server extensionszEnable a server extensionzDisable a server extensionzList server extensions)enabledisablelistct|djt|j}t j d|y)rRz, z'Please supply at least one subcommand: N)superrWjoinsorted subcommandsrTrU)rGsubcmds __class__s r&rWzServerExtensionApp.starts;  ))F4#3#345 :7)DEr()rXrYrZr[r\rr8r] _examplesexamplesdictrardrfrxrW __classcell__)rzs@r&rprpsK) $DG7KH(*EF*,HI%'? @K FFr(rpcrt|}t|dstd|d||jfS)aLoad server extension metadata from a module. Returns a tuple of ( the package as loaded a list of server extension specs: [ { "module": "mockextension" } ] ) Parameters ---------- module : str Importable Python module exposing the magic-named `_jupyter_server_extension_paths` function _jupyter_server_extension_pathszThe Python module z- does not include any valid server extensions)rhasattrKeyErrorr)rJrMs r&rKrK0sC& FA 17 8+F83`abb a//1 11r(__main__)NNTFN)N)#r[r,rTjupyter_core.pathsr_versionrconfig_managerr extensionsrrr r r r traitletsr traitlets.utils.importstringrr'rr^rpopr<rardrfr{rplaunch_instancemainrKrXr_r(r&rsA  2!14EIFJ36l,f   # #$ #t T" " T&   9 #&   0  # 4&   L # t&   , #.+h42/42n 7   8 &.&<  F)F.))20 zFr(