@=d*^dZddlZddlZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZddlmZdd lmZ d'd Zd(d ZiZee jeddeddeddd iidfdd d didfddd iidfddd iidfdeded<Gdde ZGddeZGddeZGd d!e Zd"ZGd#d$e ZejZ d%Z!e"d&kr e dSdS))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||}|d}|didi} | |d} ||n| } |r3| r|d|n|d || | |<|r|d ||d|| rt ||dSdS) 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 :lib/python3.11/site-packages/nbclassic/serverextensions.pytoggle_serverextension_pythonr'sI2 (55DD dzBBBJ f D D DB &&* + +C }b)) )2 . . $'' T::K$0''+oK 5  5 KK2[22 3 3 3 3 KK3k33 4 4 4%0k" 7 555666II'---6 f5555566cdg}g}d}rd tj|}t|dd}t|dd}n&#t$rd|YnwxYwd}|/||t|n.||t|d}rN|rfd |Dfd |Dn/|||t|S) 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 {} {} {}c:g|]}|S)r).0rr s r& z,validate_serverextension..ts% 1 1 14V[[   1 1 1r(c:g|]}|Sr-)warn)r.warningr s r&r/z,validate_serverextension..us% : : :gV[[ ! ! : : :r() r importlib import_modulegetattr Exceptionr2appendformatr r ) rr warningsinfosfuncmodversion import_msg post_mortems ` r&rrMsoH E D + )***I%k22s;TBB#}b11 III:KHHHHHI-J  Z&&x==>>>> ))%==>>>"K L  L 1 1 1 15 1 1 1 1 : : : : : : : : : KK **;JJ K K K Os6A A:9A: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-prefixpyrEceZdZdZdZdZeZedddZedddZ eddd Z d Z d Z d Z d S)rAz.A base class for enabling/disabling extensionsz0jupyter nbclassic-serverextension enable/disablezEEnable/disable a server extension using frontend configuration files.TzWhether to do a user install)confighelpFz Use the sys.prefix as the prefixrCcXt||j||j|j|jdS)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< & +Dtytx 9 9 9 9 9 9r(cnt|\}}|D]}|d}|| dS)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_metadatarM)rLpackagem server_exts server_extrOs r&toggle_server_extension_pythonz7ToggleServerExtensionApp.toggle_server_extension_pythonsO8@@;% 1 1J)F  ( ( 0 0 0 0 1 1r(c|jstjd|jD]4}|jr||||5dS)'Perform the App's actions as configuredz>Please specify a server extension/package to enable or disableN) extra_argssysexitrBrUrM)rLargs r&startzToggleServerExtensionApp.startsq W HU V V V? 2 2C{ 233C8888,,S1111  2 2r(N)__name__ __module__ __qualname____doc__name descriptionflagsr rrrBrMrUr\r-r(r&rArAs88 =DYK E 4T(F G G GDeD/QRRRJ T%+J K K KF999 111"22222r(ceZdZdZdZdZdZdS)EnableServerExtensionAppz5An App that enables (and validates) Server Extensionsz(jupyter nbclassic-serverextension enablez Enable a serverextension in configuration. Usage jupyter nbclassic-serverextension enable [--system|--sys-prefix] TNr]r^r_r`rarbrJr-r(r&reres'?? 5DK MMMr(receZdZdZdZdZdZdS)DisableServerExtensionAppz&An App that disables Server Extensionsz)jupyter nbclassic-serverextension disablez Disable a serverextension in configuration. Usage jupyter nbclassic-serverextension disable [--system|--sys-prefix] FNrfr-r(r&rhrhs'00 6DK MMMr(rhc*eZdZdZdZeZdZdZdZ dS)ListServerExtensionsAppz3An App that lists (and validates) Server Extensionsz&jupyter nbclassic-serverextension listzdS) zList all enabled and disabled server extensions, by config path Enabled extensions are validated, potentially generating warnings. rrrrz config dir: z  N) rrrrprintitemsr r rrK)rL config_dirsrr!datar#rrs r&list_server_extensionsz.ListServerExtensionsApp.list_server_extensionss *++ % @ @J&dzJJJB66344D r221266 ! 31Z11222(9(?(?(A(A @ @$ WW[WWG+U==WWXXX(dh???? @ @ @r(c.|dS)rWN)rq)rLs r&r\zListServerExtensionsApp.starts ##%%%%%r(N) r]r^r_r`rarr=rbrqr\r-r(r&rjrjsJ== 3DGPK@@@&&&&&&r(rjaJ jupyter nbclassic-serverextension list # list all configured server extensions jupyter nbclassic-serverextension enable --py # enable all server extensions in a Python package jupyter nbclassic-serverextension disable --py # disable all server extensions in a Python package cZeZdZdZdZeZdZeZ e e dfe dfe dfZfdZxZS) ServerExtensionAppzRoot level server extension appz!jupyter nbclassic-serverextensionz#Work with Jupyter server extensionszEnable a server extensionzDisable a server extensionzList server extensions)enabledisablelistctdt|j}t jd|dS)rWz, z'Please supply at least one subcommand: N)superr\joinsorted subcommandsrYrZ)rLsubcmds __class__s r&r\zServerExtensionApp.startsQ  ))F4#34455 D7DDEEEEEr()r]r^r_r`rarr=rb _examplesexamplesdictrerhrjr|r\ __classcell__)r~s@r&rtrts)) .DG7KH$(*EF*,HI%'? @K FFFFFFFFFr(rtct|}t|dstd|d||fS)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)rOrRs r&rPrP0sV& FA 17 8 8caFaaabbb a//11 11r(__main__)NNTFN)N)#r`r3rYjupyter_core.pathsr_versionrconfig_managerr extensionsrrr r r r traitletsr traitlets.utils.importstringrr'rrcrpoprArerhrjrrtlaunch_instancemainrPr]r-r(r&rsAA  222222!!!!!!111111444444EIFJ36363636l,,,,f   #$$$ #t T""" " T&   9 #& &   0  # 4&   L # t&   , #.+h4242424242/424242n     7         8   &&&&&.&&&<  FFFFF)FFF.)2220 zDFFFFFr(