^hR SrSSKrSSKrSSKrSSKrSSKrSSKJrJr J r SSK J r SSK Jr SSKJrJrJrJrJr SSKJr SSKJrJr SS KJr S S KJr S S KJr SS K J!r! \""5r#/SQr$SASjr%SSSSSS\#SS4 Sjr&SBSjr'SCSjr(SDSjr)SESjr*SFSjr+SDSjr,SFSjr-SFSjr.SDSjr/SFSjr0SFSjr1SDSjr2SDSjr3S S K4J5r5J6r6J7r7J8r8J9r9J:r:J;r;JJ?r?J@r@ 0rA\AR\=5 \ARS"S#S00S$4S"S%S00S&4S'.5 \AS%\AS('0rC\CR\<5 \CRS)S*S+S,.5 "S-S"\55rD"S.S/\55rE"S0S1\55rF"S2S3\F5rG"S4S5\F5rH"S6S7\55rIS8rJ"S9S:\55rK\KRrMSDS;jrNSDS<jrOS=rPSGS>jrQS?rR\SS@:Xa\M"5 gg)Hz?Utilities for installing Javascript extensions for the notebookN)basenamejoinnormpath)urlparse) urlretrieve)jupyter_data_dirjupyter_config_path jupyter_pathSYSTEM_JUPYTER_PATHENV_JUPYTER_PATH)ensure_dir_exists) string_typescast_unicode_py2)TemporaryDirectory) __version__)BaseJSONConfigManager) import_item)commonnotebooktreeeditterminalFc^[XX#S9m[RRT5(dg[ U[ 5(aU/n[ U4SjU55$)aCheck whether nbextension files have been installed Returns True if all files are found, False if any are missing. Parameters ---------- files : list(paths) a list of relative paths within nbextensions. user : bool [default: False] Whether to check the user's .jupyter/nbextensions directory. Otherwise check a system-wide install (e.g. /usr/local/share/jupyter/nbextensions). prefix : str [optional] Specify install prefix, if it should differ from default (e.g. /usr/local). Will check prefix/share/jupyter/nbextensions nbextensions_dir : str [optional] Specify absolute path of nbextensions directory explicitly. sys_prefix : bool [default: False] Install into the sys.prefix, i.e. environment user sys_prefixprefixnbextensions_dirFc3v># UH.n[RR[TU55v M0 g7fN)ospathexistspjoin).0fnbexts P/home/james-whalen/.local/lib/python3.13/site-packages/nbclassic/nbextensions.py $check_nbextension..Bs'>1rww~~eE1o..s69)_get_nbextension_dirr"r#r$ isinstancerall)filesrrrrr(s @r)check_nbextensionr0$sL* !d& tE 77>>% %&& >> >>c t U[:waSSKn U RS[5 Sn [ X9XES9n [ U 5 [ [S5(dSn[U[[45(a [S5e[U5nURS5(aU(a [S 5e[5n [!U5R"R%S 5S n[R"R'X5nU(aUR)S US U35 [+X5 [-XUXUS9n SSS5 U $UR/S5(d[1U5(aU(a [S5eU(a [S5eU(aUR)SUS U 35 UR/S5(a[2R4"U5nO&[1U5(a[6R8"U5nWR;U 5 UR=5 Sn U $U(d[?[AU55n[U5n[A[CX55n U(a[R"REU 5(aU(aUR)SU 35 [R"RGU 5(a;[R"RIU 5(d[JRL"U 5 O[RN"U 5 U(ay[R"RQU5n[R"RSU 5(d4U(aUR)SU S U35 [RT"X 5 U $[R"RGU5(a[C[R"RQU5S5n[RV"U5Hunnn[CU U[YU5S5n[R"RSU5(d1U(aUR)SU35 [RZ"U5 UH&n[CUU5n[CUU5n[]UUUS9 M( M U $Un[]UXS9 U $!,(df  U $=f)aInstall a Javascript extension for the notebook Stages files and/or directories into the nbextensions directory. By default, this compares modification time, and only stages files that need updating. If `overwrite` is specified, matching files are purged before proceeding. Parameters ---------- path : path to file, directory, zip or tarball archive, or URL to install By default, the file will be installed with its base name, so '/path/to/foo' will install to 'nbextensions/foo'. See the destination argument below to change this. Archives (zip or tarballs) will be extracted into the nbextensions directory. overwrite : bool [default: False] If True, always install the files, regardless of what may already be installed. symlink : bool [default: False] If True, create a symlink in nbextensions, rather than copying files. Not allowed with URLs or archives. Windows support for symlinks requires Vista or above, Python 3, and a permission bit which only admin users have by default, so don't rely on it. user : bool [default: False] Whether to install to the user's nbextensions directory. Otherwise do a system-wide install (e.g. /usr/local/share/jupyter/nbextensions). prefix : str [optional] Specify install prefix, if it should differ from default (e.g. /usr/local). Will install to ``/share/jupyter/nbextensions`` nbextensions_dir : str [optional] Specify absolute path of nbextensions directory explicitly. destination : str [optional] name the nbextension is installed to. For example, if destination is 'foo', then the source file will be installed to 'nbextensions/foo', regardless of the source name. This cannot be specified if an archive is given as the source. logger : Jupyter logger [optional] Logger instance to use rNzv`install_nbextension`'s `verbose` parameter is deprecated, it will have no effects and will be removed in Notebook 5.0rsymlinkFzpath must be a string pointing to a single extension to install; call this function multiple times to install multiple extensions)zhttps://zhttp://zCannot symlink from URLs/z Downloading:  -> ) overwriter3r destinationloggerz.zipzCannot symlink from archivesz$Cannot give destination for archivesz Extracting: Removing: z Symlinking: zMaking directory: r9)/DEPRECATED_ARGUMENTwarningswarnDeprecationWarningr,r hasattrr"r-listtuple TypeErrorr startswith ValueErrorrrr#splitrinforinstall_nbextensionendswith_safe_is_tarfilezipfileZipFiletarfileopen extractallcloserrr%lexistsisdirislinkshutilrmtreeremoveabspathr$r3walklenmakedirs _maybe_copy)r#r7r3rrrr8verboser9rr> full_destr(tdfilename local_patharchiveparentdirsr/dest_dir file_namesrc dest_files r)rIrIEsP%% OQc dI d& tEe 2y ! !$u &&\] ] D !D .// 78 8  !R~**005b9Hb3J mD6j\BC  )+JU\!&PI"x g v  "24"8"8 ;< < CD D  KK,tfD8 9 == ood+G d # #ll4(G5!  H E"8D>2K&{3 U567 33 j 45ww}}Y''y0I0I i( )$ 77??4(D77>>),,KK,ykdV DE 4+" !WW]]4 .3D')wwt}#e F3t9:,>?ww~~h// &8 $CDKK)!&I 2C %h :IYv>"' (5 C Y 6 y" !x s 6A/share/jupyter/nbextensions`` nbextensions_dir : str [optional] Specify absolute path of nbextensions directory explicitly. logger : Jupyter logger [optional] Logger instance to use rr:rrnbconfig config_dirload_extensionsN)r,rr%r"r#rRrHrSrTrUrVrWr_get_config_dirrNBCONFIG_SECTIONSupdate) rjrequirerrrrr9r(r^rycmsections r)uninstall_nbextensionrs: !d& tE D !De"I wwy!!  KK*YK0 1 77== # #BGGNN9,E,E MM) $ IIi o4OQ[\J * 5B(G IIg 1GT?C D)r1c[U5n[S5Hn[X 5n[RR U5(dM4U(aUR SU35 [RRU5(a<[RRU5(d[R"U5 g[R"U5 g g)zwRemove nbextension files from the first location they are found. Returns True if files were removed, False otherwise. nbextensionsr:TF) rr r%r"r#rRrHrSrTrUrVrW)r`r9r(r#s r)_find_uninstall_nbextensionrs  )Hn-U% 77??4  j/0ww}}T""277>>$+?+? d# $. r1c [U5upgUH7nUSn USn U(aURSU SU 35 [XXX4US9 M9 g)zfUninstall an nbextension bundled in a Python package. See parameters of `install_nbextension_python` rjr~z Uninstalling  rrrrr9N)rkrHr) rorrrrr9rprqr(rjr~s r)uninstall_nbextension_pythonr&s[*&1IAV} "  KK-vQwi8 9d$V M r1TcNU(aSOUn[RR[X4S9S5n[ US9nU(a#UR U(aSOSSUSUS 35 UR US X005 [XS 9 URU5RU5U:H$) aSet whether the section's frontend should require the named nbextension Returns True if the final state is the one requested. Parameters ---------- section : string The section of the server to change, one of NBCONFIG_SECTIONS require : string An importable AMD module inside the nbextensions static path state : bool The state in which to leave the extension user : bool [default: True] Whether to update the user's .jupyter/nbextensions directory sys_prefix : bool [default: False] Whether to update the sys.prefix, i.e. environment. Will override `user`. logger : Jupyter logger [optional] Logger instance to use FrvrwrxEnabling Disablingrz extension z...rzr<) r"r#rr{rrHr}validate_nbextensionget)rr~staterrr9ryrs r)_set_nbextension_stater7s,5DDT9:GJ * 5B  Uz infos js_existsextsjs require_tmplmsgs r)rrsH EI^, T7GMM#$678 <GGNN2& 9  -.L \((7;< ++E7;<  NN@ As#  C  O KK.xj9 : Or1c/n/nURSS5nU[;aURS[SU35 OURS[SU35 URSS5nUb[ R RUS[US5*US 35n[ R RU5(aURS[S U35 OURS[S U35 U(azU(a[URS 5 UHnURU5 M UHnURU5 M URS U35 U$URS[35 U$)a Assess the health of an installed nbextension Returns a list of warnings. Parameters ---------- spec : dict A single entry of _jupyter_nbextension_paths(): [{ 'section': 'notebook', 'src': 'mockextension', 'dest': '_mockdestination', 'require': '_mockdestination/index' }] full_dest : str The on-disk location of the installed nbextension: this should end with `nbextensions/` logger : Jupyter logger [optional] Logger instance to use rNz z section: z section: r~rrjrz require: z require: z- Validating: problems found:z Full spec: z- Validating: ) rr|rnrrr"r#rrZr$rrH) specr^r9rr>rr~ require_pathrs r)rmrmsZ, EHhhy$'G## r(:gY78"UG;wi89hhy$'Gww|| aT&\** +isO  77>>, ' ' LL2hZz,@ A OOb{<.A B  NN: ;s#  C  NN[/ 0 O KK. 3 4 Or1) BaseExtensionAppr{ GREEN_ENABLED RED_DISABLEDrrArgumentConflict _base_aliases _base_flags)BoolUnicodeInstallNBExtensionAppr7!Force overwrite of existing filesr3z'Create symlink instead of copying files)r7r3szInstallNBExtensionApp.prefixz&InstallNBExtensionApp.nbextensions_dirz!InstallNBExtensionApp.destination)rrr8c\rSrSrSrSrSr\r\r\ "SSSS9r \ "SSS S9r \ "S SS S9r \ "S SS S9r\ "S SS S9rSrSrSrSrg)riuz.Entry point for installing notebook extensionsaInstall Jupyter notebook extensions Usage jupyter nbclassic-extension install path|url [--user|--sys-prefix] This copies a file or a folder into the jupyter nbclassic-extensions directory. If a URL is given, it will be downloaded. If an archive is given, it will be extracted into nbextensions. If the requested files are already up to date, no action is taken unless --overwrite is specified. zB jupyter nbclassic-extension install /path/to/myextension FTrconfighelpz(Create symlinks instead of copying filesr;zInstallation prefix;Full path to nbextensions dir (probably use prefix or user)z#Destination for the copy or symlinkcgzThe default config file name.jupyter_notebook_configselfs r)_config_file_name_default/InstallNBExtensionApp._config_file_name_default(r1c |[UR5S:a [S5eUR(a [n0nO[ nSUR 0nU"URS4URURURURURURURS.UD6nU(aURRSUR(aURSOSUR(aSOS UR(aS OS UR(aS OS S 35 g g )z*Perform the installation of nbextension(s)rz[Only one nbextension allowed at a time. Call multiple times to install multiple extensions.r8r)r7r3rrrrr9z To initialize this nbextension in the browser every time the notebook (or other app) loads: jupyter nbclassic-extension enable zz --userr;z --pyz --sys-prefix N)rZ extra_argsrFpythonrtrIr8r7r3rrrrlogrH)rinstallkwargsrss r)install_extensions(InstallNBExtensionApp.install_extensionss t  !OP P ;;0GF)G#T%5%56FT__Q/ '+~~%)\\"&))(,$(KK.2.C.C$(HH  &    HHMMb B  r1cUR(d[R"S5 gUR5 g![a)n[R"[ U55 SnAgSnAff=f)z(Perform the App's function as configuredz(Please specify an nbextension to installN)rsysexitrrstrres r)startInstallNBExtensionApp.startsJ HH? @ !'')# !Q   !s; A.A))A.rN)__name__ __module__ __qualname____firstlineno____doc__ descriptionexamplesaliasesflagsrr7r3rrrr8rrr__static_attributes__rr1r)rrus~8 KHG EU4.QRI5,VWG R+@ AFr$MO"T0UVK) D!r1c\rSrSrSr\rSrSrSSSS.r \ RR5r SS S 00S 4\ S '\ "S S S S9r\ "S S SS9r\ "S S SS9r\"SS S S9rSrSrSrSrSrg)UninstallNBExtensionAppiz0Entry point for uninstalling notebook extensionsabUninstall Jupyter notebook extensions Usage jupyter nbclassic-extension uninstall path/url path/url/entrypoint jupyter nbclassic-extension uninstall --py pythonPackageName This uninstalls an nbextension. By default, it uninstalls from the first directory on the search path where it finds the extension, but you can uninstall from a specific location using the --user, --sys-prefix or --system flags, or the --prefix option. If you specify the --require option, the named extension will be disabled, e.g.:: jupyter nbclassic-extension uninstall myext --require myext/main If you use the --py or --python flag, the name should be a Python module. It will uninstall nbextensions listed in that module, but not the module itself (which you should uninstall using a package manager such as pip). z jupyter nbclassic-extension uninstall dest/dir dest/dir/extensionjs jupyter nbclassic-extension uninstall --py extensionPyPackage zUninstallNBExtensionApp.prefixz(UninstallNBExtensionApp.nbextensions_dirzUninstallNBExtensionApp.require)rrr~systemTz=Uninstall specifically from systemwide installation directoryr;z@Installation prefix. Overrides --user, --sys-prefix and --systemrrz$require.js module to disable loadingFcgrrrs r)r1UninstallNBExtensionApp._config_file_name_defaultrr1c@URURURURURS.nUR (a[ URS40UD6 gUR(aURUS'[URS40UD6 g)z1Uninstall an nbextension from a specific locationrrr~N) rrrrrrrrr~r)rrs r)uninstall_extension+UninstallNBExtensionApp.uninstall_extensionszII//kk $ 5 5hh   ;; (); Fv F||$(LLy! !$//!"4 ? ?r1cURSnUR(a[[U5up#SnUHEn[USURS9(aSn[ Hn[ XeSURS9 M MG O[XRS9nU(d[SU<S35 UR(a,[ H!n[ X`RURS9 M# g g ) z5Uninstall an nbextension from an unspecified locationrFrjr<Tr~zNo installed extension z found.N) rrrkrrr|rprintr~)rname_rqchangedr(rs r)find_uninstall_extension0UninstallNBExtensionApp.find_uninstall_extension sq! ;;1$7IAG.uV}TXXN"G 1G-gY7G59XX? 1  2$xxHG +D87; < <<,)'<<15;- r1cUR(d[R"S5 g[UR5S:a[R"S5 gUR(dDUR (d3UR (d"UR(dUR(aUR5 gUR5 g![a)n[R"[U55 SnAgSnAff=f)Nz*Please specify an nbextension to uninstallrz]Only one nbextension allowed at a time. Call multiple times to uninstall multiple extensions.) rrrrZrrrrrrrrrrs r)rUninstallNBExtensionApp.start$s HHA B  !A % HHM Nii4??dkkT[[&& !((*  ) ) + $ !Q   !s/C DC??DrN)rrrrrrversionrrrrrcopyrrrr~rrrrrrrrr1r)rrs:GK,H 4C4G  " " ' ' )E1Hd3CDGIE(OR OFr$ Jb,RSG % LF)@";4,r1rch\rSrSrSrSr\rSr\ "SSSS9r \ "SSS S9r S S 0r S rS rSrSrSrSrg )ToggleNBExtensionAppi6z4A base class for apps that enable/disable extensionsz*jupyter nbclassic-extension enable/disablez/Enable/disable an nbextension in configuration.rTzMWhich config section to add the extension to, 'common' will affect all pages.rz;Apply the configuration only for the current user (default)rzToggleNBExtensionApp.sectionNcgrrrs r)r.ToggleNBExtensionApp._config_file_name_defaultErr1cUR(a[O[nU"UURURUR S9$)aToggle some extensions in an importable Python module. Returns a list of booleans indicating whether the state was changed as requested. Parameters ---------- module : str Importable Python module exposing the magic-named `_jupyter_nbextension_paths` function rrr9) _toggle_valuerrrrr)rrotoggles r)toggle_nbextension_python.ToggleNBExtensionApp.toggle_nbextension_pythonIs<04/A/A+1 f99!%!XX' 'r1cUR(a[O[nU"URUURUR UR S9$)zToggle some a named nbextension by require-able AMD module. Returns whether the state was changed as requested. Parameters ---------- require : str require.js path used to load the nbextension r)rrrrrrr)rr~rs r)toggle_nbextension'ToggleNBExtensionApp.toggle_nbextension\sA)-(:(:$* dllG99!XX' 'r1cNUR(d[R"S5 O/[UR5S:a[R"S5 UR(aUR URS5 gUR URS5 g)Nz:Please specify an nbextension/package to enable or disablerz0Please specify one nbextension/package at a timer)rrrrZrrrrs r)rToggleNBExtensionApp.startlsi HHQ R  !A % HHG H ;;  * *4??1+= >  # #DOOA$6 7r1r)rrrrrrrrrrrrrrrrrrrrrr1r)rr6sZ> 7DGCKjbG T(e fD89GM)'&' 8r1rc$\rSrSrSrSrSrSrSrg)EnableNBExtensionAppiwz An App that enables nbextensionsz"jupyter nbclassic-extension enablez Enable an nbextension in frontend configuration. Usage jupyter nbclassic-extension enable [--system|--sys-prefix] TrN rrrrrrrrrrr1r)rrws* /DK Mr1rc$\rSrSrSrSrSrSrSrg)DisableNBExtensionAppiz!An App that disables nbextensionsz#jupyter nbclassic-extension disablez Disable an nbextension in frontend configuration. Usage jupyter nbclassic-extension disable [--system|--sys-prefix] Nrr rr1r)r r s+ 0DK Mr1r c0\rSrSrSrSr\rSrSr Sr Sr g) ListNBExtensionsAppiz,An App that lists and validates nbextensionsz jupyter nbclassic-extension listz7List all nbextensions known by the configuration systemc  [5Vs/sH#n[RRUS5PM% nn[ S5 UHnSU3nSn[ XS9n[ HnURU5nSU;dMU(d [ U5 Sn[ SUS 35 USR5HCup[ S U S U (a[O[35 U (dM0[XRS 9 ME M M g s snf)zList all the nbextensionsrwzKnown nbextensions:z config dir: F)rcryrzTz z sectionz rr<N) r r"r#rrrr|ritemsrrrr) rp config_dirsryhead head_shownrrdatar~enableds r)list_nbextensions%ListNBExtensionsApp.list_nbextensionss # install an nbextension from a Python package jupyter nbclassic-extension enable --py # enable all nbextensions in a Python package jupyter nbclassic-extension disable --py # disable all nbextensions in a Python package jupyter nbclassic-extension uninstall --py # uninstall an nbextension in a Python package cd^\rSrSrSrSr\rSr\ r \ "\ S4\ S4\S4\S4\S 4S 9rU4S jrS rU=r$) NBExtensionAppiz4Base jupyter nbclassic-extension command entry pointzjupyter nbclassic-extensionz%Work with Jupyter notebook extensionszInstall an nbextensionzEnable an nbextensionzDisable an nbextensionzUninstall an nbextensionzList nbextensions)renabledisable uninstallrBc>[TU]5 SR[UR55n[ R "SU35 g)r, z'Please supply at least one subcommand: N)superrrsorted subcommandsrr)rsubcmds __class__s r)rNBExtensionApp.starts;  ))F4#3#345 :7)DEr1r)rrrrrrrrr _examplesrdictrrr rr r$rr __classcell__)r&s@r)rrs]> (DG9KH&'?@$&=>&(@A*,FG!#6 7 KFFr1rcF[RRU5(dg[R"U5R[R"U5R- S:aU(aUR SU35 gU(aUR SU35 g)aEShould a file be copied, if it doesn't exist, or is newer? Returns whether the file needs to be updated. Parameters ---------- src : string A path that should exist from which to copy a file src : string A path that might exist to which to copy a file logger : Jupyter logger [optional] Logger instance to use Tgư>z Out of date: z Up to date: F)r"r#r$statst_mtimer?rHrgrjr9s r) _should_copyr/sw 77>>$   wws|rwwt}555<  KK-v. /  l4&)* r1c[XUS9(a5U(aURSUSU35 [R"X5 gg)zCopy a file if it needs updating. Parameters ---------- src : string A path that should exist from which to copy a file src : string A path that might exist to which to copy a file logger : Jupyter logger [optional] Logger instance to use r<z Copying: r6N)r/rHrUcopy2r.s r)r\r\s;Cf-  KK)C5TF3 4 S.r1cP[R"U5$![a gf=f)zSafe version of is_tarfile, return False on IOError. Returns whether the file exists and is a tarfile. Parameters ---------- path : string A path that might not exist and or be a tarfile F)rN is_tarfileOSError)r#s r)rKrK s*!!$'' s  %%cSU4SU4SU4SU4/nUVVs/sHupVU(dMUSU<3PM nnn[U5S:a[SSRU535eU(a[[ 5S 5nU$U(a[[ S S 5nU$U(a[US S S 5nU$U(aUnU$[[ S S 5nU$s snnf) aaReturn the nbextension directory specified Parameters ---------- user : bool [default: False] Get the user's .jupyter/nbextensions directory sys_prefix : bool [default: False] Get sys.prefix, i.e. ~/.envs/my-env/share/jupyter/nbextensions prefix : str [optional] Get custom prefix nbextensions_dir : str [optional] Get what you put in rrrr=rzXcannot specify more than one of user, sys_prefix, prefix, or nbextensions_dir, but got: r!rrsharejupyter)rZrrr%rr r ) rrrr conflictingnvconflicting_setr(s r)r,r,s   6 -. z" K 1<A q|!AaU| OA ?a /23 5   &(.9 L &q)>: L fgy.A L   L)!,n= L!Bs C Cc~[U5n[US5(d[SUS35eUR5nX4$)a{Get the list of nbextension paths associated with a Python module. Returns a tuple of (the module, [{ 'section': 'notebook', 'src': 'mockextension', 'dest': '_mockdestination', 'require': '_mockdestination/index' }]) Parameters ---------- module : str Importable Python module exposing the magic-named `_jupyter_nbextension_paths` function _jupyter_nbextension_pathszThe Python module zU is not a valid nbextension, it is missing the `_jupyter_nbextension_paths()` method.)rrAKeyErrorr>)rorprqs r)rkrkBsT" FA 12 3 3 )G H   ) ) +F 9r1__main__)FNNF)FFFFNNN)NFFNNNr!)FFNNN)TFN)FFNN)Trr"rUrrNrLos.pathrrr%r urllib.parserurllib.requestrjupyter_core.pathsrr r r r jupyter_core.utilsr ipython_genutils.py3compatrripython_genutils.tempdirr_versionrconfig_managerrtraitlets.utils.importstringrobjectr=r|r0rIrtrrrrrrrrrrrrm extensionsrr{rrrrrrr traitletsrrrr}rrrrrr r r(rlaunch_instancemainr/r\rKr,rkrrr1r)rPs`E  55!&1E7!14hF?B).u"4$$(2E#|~AFae:TX8<.Eb*UY#M$@D 1H*.!>@E"16AF#16$=B%)82>C&*8.'T4v$  [  $#   0 #   6  9 c }-=7 K!,K!\p,.p,f>8+>8B /  0 !!*!!H  F%F0%%8 &"%P8 zFr1