]jx%SSKJr SSKrSSKrSSKrSSKJrJr SSKJr SSK J r SSK J r SSK JrJr S S KJr S S KJr S S KJr SS KJrJrJrJr SSKJ r SSKrSSKJrJrJ r J!r!J"r" \RF(a SSK$J%r% SSK&J'r' \!"S\S\4S9r(\ Sr)\ Sr*\+"00S9r,S\-S'Sr.S\-S'Sr/S\-S'\+"\\S9r0S\-S'"SS 5r1S7S!jr2S8S"jr3\!"S#\4S$S9r5S9S%jr6S:S&jr7S;S'jr8S(r9SS=S.jr?\:"S/5r@\:"S05rA\:"S15rB\;"S/5rC\;"S05rD\;"S15rE"S2S3\5rF"S4S$\5rG"S5S65rHg)>) annotationsN)getopt GetoptError) Configurable)oinspect) UsageError) ESC_MAGIC ESC_MAGIC2)Struct) arg_split)dedent)BoolDictInstanceobserve)error)AnyCallableLiteralTypeVaroverload) FrameType)InteractiveShell_F.)boundlinecell)rr line_celldict[str, dict[str, str]]magicsztuple[_MagicKind, ...] magic_kindsztuple[_MagicSpec, ...] magic_speczdict[_MagicKind, str] magic_escapesc\rSrSrSrg)Bunch?N)__name__ __module__ __qualname____firstlineno____static_attributes__r*O/home/mande/repo/quber/.venv/lib/python3.13/site-packages/IPython/core/magic.pyr(r(?sr0r(cUSSUSSp!/n[5nUH,nXT;aM URU5 URU5 M. X2-$)zCompress a directory history into a new one with at most 20 entries. Return a new list made from the first and last 10 elements of dhist after removal of duplicates. Ni)setappendadd)dhheadtailnewheaddonehs r1compress_dhistr<CsV DS2cd8$GUD  9 q   >r0cSUlU$)zCDecorator to mark magic functions which need to local scope to run.T)needs_local_scope)funcs r1r>r>Vs!D Kr0_TMagicscrSUl[[S[SS9Ul0[S'0[S'U$)aoClass decorator for all subclasses of the main Magics class. Any class that subclasses Magics *must* also apply this decorator, to ensure that all the methods that have been decorated as line/cell magics get correctly registered in the class instance. This is necessary because when method decorators run, the class does not exist yet, so they temporarily store their information into a module global. Application of this class decorator copies that global data to the class instance and clears the global. Obviously, this mechanism is not thread-safe, which means that the *creation* of subclasses of Magic should only be done in a single-thread context. Instantiation of the classes has no restrictions. Given that these classes are typically created at IPython startup time and before user application code becomes active, in practice this should not pose any problems. Trr r) registereddictr#)clss r1 magics_classrFds8$CN6&>v?CJF6NF6N Jr0c@US:XaU=USU'USU'gX0UU'g)a'Utility function to store a function as a magic of a specific kind. Parameters ---------- dct : dict A dictionary with 'line' and 'cell' subdicts. magic_kind : str Kind of magic to be stored. magic_name : str Key to store the magic as. func : function Callable object to store. r!rr Nr*)dct magic_kind magic_namer?s r1 record_magicrK}s4&[ <@@F J#f+j"9&*J #r0c>U[;a[S[-U5eg)zEnsure that the given magic_kind is valid. Check that the given magic_kind is one of the accepted spec types (stored in the global `magic_spec`), raise ValueError otherwise. &magic_kind must be one of %s, %s givenN)r% ValueErrorr$)rIs r1 validate_typerOs( # 4{ BJ  $r0aDecorate the given {0} as {1} magic. The decorator can be used with or without arguments, as follows. i) without arguments: it will create a {1} magic named as the {0} being decorated:: @deco def foo(...) will create a {1} magic named `foo`. ii) with one string argument: which will be used as the actual name of the resulting magic:: @deco('bar') def foo(...) will create a {1} magic named `bar`. To register a class magic use ``Interactiveshell.register_magic(class or instance)``. cd^[T5 SU4Sjjn[RST5UlU$)z3Decorator factory for methods in Magics subclasses.c>^[U5(a$UnURmUn[[TTT5 U$[ U[ 5(aUmSUU4SjjnUnU$[ S5e)Nc@>[[TTUR5 U$N)rKr#r+)r?akwrInames r1mark6_method_magic_marker..magic_deco..marksVZt}}E r04Decorator can only be called with string or functionr?rrTrrUrreturnr)callabler+rKr# isinstancestr TypeError)argr?retvalrWrVrIs @r1 magic_deco(_method_magic_marker..magic_decosn C==D==DF T4 8 S ! !D  F RS Sr0methodr`z_F | strr[z_F | Callable[[_F], _F])rO_docstring_templateformat__doc__)rIrbs` r1_method_magic_markerris/ *,-33HjIJ r0c^[T5 SU4Sjjn[RST5nU[S5- nX!lU$)z+Decorator factory for standalone functions.cv>^^[R"S5nSnSH"n[X5RS5nUcM" O [ S5eU"5m[ U5(a%UnUR mTRUT T5 UnU$[U[5(aUmSUU U4SjjnUnU$[S5e)Nr)f_locals f_globals f_builtins get_ipythonzTRUTT5 U$rS)register_magic_function)r?rTrUiprIrVs r1rW8_function_magic_marker..magic_deco..marks**4TB r0rYrZ) sys _getframegetattrget NameErrorr\r+rqr]r^r_) r`callerronsr?rarWrrrVrIs @@r1rb*_function_magic_marker..magic_decosMM!,=A 9B!&-11-@K&: N  +} C==D==D  & &tZ >F S ! !D  F RS Sr0functiona Note: this decorator can only be used in a context where IPython is already active, so that the `get_ipython()` call succeeds. You can therefore use it in your startup files loaded after IPython initializes, but *not* in the IPython configuration file itself, which is executed before IPython is fully up and running. Any file located in the `startup` subdirectory of your configuration profile will be OK in this sense. re)rOrfrgrrh)rIrbdss` r1_function_magic_markerr~sK*!H  # #J ;B&   B r0_ipython_magic_no_var_expand%_ipython_magic_output_can_be_silencedc([U[S5 U$)aMark a magic function as not needing variable expansion By default, IPython interprets `{a}` or `$a` in the line passed to magics as variables that should be interpolated from the interactive namespace before passing the line to the magic function. This is not always desirable, e.g. when the magic executes Python code (%timeit, %time, etc.). Decorate magics with `@no_var_expand` to opt-out of variable expansion. .. versionadded:: 7.3 T)setattrMAGIC_NO_VAR_EXPAND_ATTR magic_funcs r1 no_var_expandr&s J0$7 r0c([U[S5 U$)zMark a magic function so its output may be silenced. The output is silenced if the Python code used as a parameter of the magic ends in a semicolon, not counting a Python comment that can follow it. T)rMAGIC_OUTPUT_CAN_BE_SILENCEDrs r1output_can_be_silencedr6s J4d; r0rr r!c^\rSrSrSr\"5r\"SS9RSS9r\"5r \ "SSS9r \ "SS S9RSS9r \"S 5SS j5rS S /r\ "SSS9rSSU4SjjjrSSjrSSjrSSSjjrSSjrS SjrS!S"SjjrS!S#SjjrSrU=r$)$ MagicsManageriSz@Object that handles all magic-related functionality for IPython.aM Mapping from magic names to modules to load. This can be used in IPython/IPykernel configuration to declare lazy magics that will only be imported/registered on first use. For example:: c.MagicsManager.lazy_magics = { "my_magic": "slow.to.import", "my_other_magic": "also.slow", } On first invocation of `%my_magic`, `%%my_magic`, `%%my_other_magic` or `%%my_other_magic`, the corresponding module will be loaded as an ipython extensions as if you had previously done `%load_ext ipython`. Magics names should be without percent(s) as magics can be both cell and line magics. Lazy loading happen relatively late in execution process, and complex extensions that manipulate Python/IPython internal state or global state might not support lazy loading. )helpT)configz1IPython.core.interactiveshell.InteractiveShellABC) allow_nonezBAutomatically call line magics without requiring explicit % prefix auto_magiccJURceUSURlg)Nnew)shell automagic)selfchanges r1_auto_magic_changed!MagicsManager._auto_magic_changeds"zz%%%%e} r0z5Automagic is OFF, % prefix IS needed for line magics.z8Automagic is ON, % prefix IS NOT needed for line magics.zIPython.core.magics.UserMagicsc >[[U] "SXUS.UD6 [00S9UlUb#X0R UR R'gg)N)rr user_magicsrr*)superr__init__rDr#registry __class__r+)rrrrtraitsrs r1rMagicsManager.__init__s[ mT+ K CI ,   ">)/)=)=dA)Fq)I)/)>)>)@%,6N#>"L" r0c X RU'g)a_ Lazily register a magic via an extension. Parameters ---------- name : str Name of the magic you wish to register. fully_qualified_name : Fully qualified name of the module/submodule that should be loaded as an extensions when the magic is first called. It is assumed that loading this extensions will register the given magic. N) lazy_magics)rrVfully_qualified_names r1 register_lazyMagicsManager.register_lazys "6r0cLUHnUR(d [S5e[U[5(aU"URS9nX R UR R'[H.nURURURU5 M0 M g)aRegister one or more instances of Magics. Take one or more classes or instances of classes that subclass the main `core.Magic` class, and register them with IPython to use the magic functions they provide. The registration process will then ensure that any methods that have decorated to provide line and/or cell magics will be recognized with the `%x`/`%%x` syntax as a line/cell magic respectively. If classes are given, they will be instantiated with the default constructor. If your classes need a custom constructor, you should instanitate them first and pass the instance. The provided arguments can be an arbitrary mix of classes and instances. Parameters ---------- *magic_objects : one or more classes or instances zOClass of magics %r was constructed without the @register_magics class decorator)rN) rCrNr]typerrrr+r$r#update)r magic_objectsmmtypes r1registerMagicsManager.registers,A<< ;!T""DJJ'34MM!++.. /$ E"))!((5/:%r0c[U5 Uc UROUnURce[URX15 [ UR X#U5 g)aExpose a standalone function as magic function for IPython. This will create an IPython magic (line, cell or both) from a standalone function. The functions should have the following signatures: * For line magics: `def f(line)` * For cell magics: `def f(line, cell)` * For a function that does both: `def f(line, cell=None)` In the latter case, the function will be called with `cell==None` when invoked as `%f`, and with cell as a string when invoked as `%%f`. Parameters ---------- func : callable Function to be registered as a magic. magic_kind : str Kind of magic, one of 'line', 'cell' or 'line_cell' magic_name : optional str If given, the name the magic will have in the IPython namespace. By default, the name of the function itself is used. N)rOr+rrrKr#)rr?rIrJs r1register_functionMagicsManager.register_functionsO@ j!&0&8T]]j +++  *3T[[*$?r0cU[;a[S[-U5eURceURce[ URX#U5n[ URX5 [ URX1U5 g)aRegister an alias to a magic function. The alias is an instance of :class:`MagicAlias`, which holds the name and kind of the magic it should call. Binding is done at call time, so if the underlying magic function is changed the alias will call the new function. Parameters ---------- alias_name : str The name of the magic to be registered. magic_name : str The name of an existing magic. magic_kind : str Kind of magic, one of 'line' or 'cell' rMN)r$rNrr MagicAliasrrKr#)r alias_namerJrI magic_paramsaliass r1register_aliasMagicsManager.register_alias$sy4 [ (8;F  zz%%%+++4::z|L  *4T[[*%@r0r)rzdict[str, Any]r[None)NNN) rInteractiveShell | Nonerrrz Magics | Nonerrr[r)r[r^)r[dict[str, dict[str, Any]])F)rboolrr^r[r")rVr^rr^r[r)rztype[Magics] | Magicsr[r)rN)r?Callable[..., Any]rI _MagicSpecrJ str | Noner[r) rr^rJr^rI _MagicKindrrr[r)r+r,r-r.rhrr#tagrrrrrrrrrrrrrrrrrrr/ __classcell__rs@r1rrSsJVF2 c 3<vH ; E W cc \-- @BL ;MK*.%) H&HH# H  H  HH 235,/ "46$$;R"(!% $@ $@$@ $@  $@T"(#' #A#A#A #A ! #A  #A#Ar0rc^\rSrSr%Sr0rS\S'0rS\S'SrS\S'S r S \S 'SSU4S jjjr SS jr SSjr SSjr SrU=r$)rAiMaBase class for implementing magic functions. Shell functions which can be reached as %function_name. All magic functions should accept a string, which they can parse for their own needs. This can make some functions easier to type, eg `%cd ../` vs. `%cd("../")` Classes providing magic functions need to subclass this class, and they MUST: - Use the method decorators `@line_magic` and `@cell_magic` to decorate individual methods as magic functions, AND - Use the class decorator `@magics_class` to ensure that the magic methods are properly registered at the instance level upon instance initialization. See :mod:`magic_functions` for examples of actual implementation classes. zdict[str, t.Any] options_tabler#FrrCNzNone | InteractiveShellrc >>URR(d [S5eUbO[US5(aURR U5 [US5(aUR SU5 Xl0UlURn0Ul [Hfn0URU'URUnX4nUR5H-upx[U[5(a[X5XW'M)XU'M/ Mh [[ U]F"S0UD6 g)NzMMagics subclass without registration - did you forget to apply @magics_class? configurablesrparentr*)rrCrNhasattrrr4 setdefaultrrr#r$rr]r^rvrrAr) rrkwargs class_magicsrtabcls_tabrJ meth_namers r1rMagics.__init__ks))9   uo..##**40uh''!!(E2 {{   E!#DKK "&++e"4C&2&9G)0% i--&-d&>CO'0 O *9 ! fd$.v.r0cX[S5 [[R"U55 g)z2Print docstring if incorrect arguments were passedzError in arguments:N)printrgetdoc)rr?s r1arg_errMagics.arg_errs #$ hood#$r0c*[R"S[R5n[R"S[-[R5n[R"S[-[R5n[R"S[R5n[R"S5nUR SU5nUR SU5nUR SU5nUR S U5nUR S U5nU$) z$Format a string for latex inclusion.z (%|_|\$|#|&)z ^(%s.*?):z(?P%s.+?\b)(?!\}\}:)z\\$z\\nz%\n\\bigskip\n\\texttt{\\textbf{ \1}}:z\\texttt{\g}z\\\\z\\\1z\\textbackslash{}n)recompile MULTILINEr sub)rstrng escape_re cmd_name_recmd_repar_re newline_res r1 format_latexMagics.format_latexsJJ = jj !92<<H 89DbllSFBLL1ZZ'  H%P /7 7E* gu-4e< r0c [R"S5RRnURR US5<SU<3nUR SS5nUS;a[ SU-5eUR SS 5nUR S [RS :H5nUR S S 5n UR S S5n Un 0n UR5n [U 5S:a[XU 5n[XU5upUHmunnUS:Xa+U (a$U R#USS5R#USS5n UR%S5(aUSSnOUSSnU UR'U5 Mo [-U 5nUS:Xa+U (aU R/5n X4$SR!U 5n X4$![aBn[UR<SU<SU(aSR!SU-5OS<S35UeSnAff=f![(a U UU/U U'GM[*a U(a U/U U'GM1UU U'GM:f=f)aParse options passed to an argument string. The interface is similar to that of :func:`getopt.getopt`, but it returns a :class:`~IPython.utils.struct.Struct` with the options as keys and the stripped argument string still as a string. arg_str is quoted as a true sys.argv vector by using shlex.split. This allows us to easily expand variables, glob files, quote arguments, etc. Parameters ---------- arg_str : str The arguments to parse. opt_str : str The options specification. mode : str, default 'string' If given as 'list', the argument string is returned as a list (split on whitespace) instead of a string. list_all : bool, default False Put all option values in lists. Normally only options appearing more than once are put in a list. posix : bool, default True Whether to split the input line in POSIX mode or not, as per the conventions outlined in the :mod:`shlex` module from the standard library. rr modestring)rlistzincorrect mode given: %slist_allrposixstrictTpreserve_non_optsFz (allowed: "")r)Nz--r )rtruf_codeco_namerrwrNosrVrlenrrrr msgjoinreplace startswithr4AttributeErrorKeyErrorr lstrip)rarg_stropt_str long_optsrUryrrrrrremainder_arg_strodictargsargvoptseorTs r1 parse_optionsMagics.parse_optionssF@q!((00!//33FB?Ivvfh' ) )7$>? ?66*a(w7 23$'FF#6>##%}} t9>WV4D #D9=  18#(9):(A(A!R(K(S(S2q)%<<%%!"A!"A%!HOOA&.e} 8  (//1zxx~zG  uugisxx 0A'BUW'WY &&- %a!}E!H%$%3a#$a %s6=F=&H = H =HH  I$I>II)r#rrrS)rrrrr[r)r?rr[r)rr^r[r^) rr^rr^rr^rUrr[ztuple[Any, Any])r+r,r-r.rhr__annotations__r#rCrrrrrr/rrs@r1rArAMs*')M#(!F !J%)E ")04%/,%/?B%/ %/%/N% 0[[%([69[AD[ [[r0cD\rSrSrSrSSSjjrS SjrSrg) ri aBAn alias to another magic function. An alias is determined by its magic name and magic kind. Lookup is done at call time, so if the underlying magic changes the alias will call the new function. Use the :meth:`MagicsManager.register_alias` method or the `%alias_magic` magic function to create and register a new alias. NcXlX lX@lX0l[UR<UR<3UlSUR -UlSUlg)NzAlias for `%s`.F)rrJrrIr& pretty_targetrh_in_call)rrrJrIrs r1rMagicAlias.__init__sL $($'4T__'EtW(4+=+==  r0cURRURUR5nUc[ SUR -5eUR (a [ S5eSUlUR(a.[U5nURS-US-US'[U5nU"U0UD6SUl$!SUlf=f)zCall the magic alias.zMagic `%s` not found.zBInfinite recursion detected; magic aliases cannot call themselves.TrrF) r find_magicrJrIr rrrrtuple)rrrfn args_lists r1__call__MagicAlias.__call__(s ZZ " "4??DOO D :4t7I7IIJ J ==T   "   J #0036a@ ! Y't&v&!DMEDMs 0AB>> C)rhrrIrJrrrrS) rrrJr^rIrrrr[r)rrrrr[r)r+r,r-r.rhrr&r/r*r0r1rr sF$(   !   ""r0r)r6 list[str]r[r()r?rr[r)rEr@r[r@) rHrrIrrJr^r?rr[r)rIr^r[r)rIrr[z-Callable[[_F | str], _F | Callable[[_F], _F]])rrr[r)I __future__rrrrtrrtraitlets.config.configurablerrrrr inputtransformer2r r utils.ipstructr utils.processr utils.textr traitletsrrrrloggingtypingtrrrrr TYPE_CHECKINGtypesrIPython.core.interactiveshellrrrrrDr#rr$r%r&r(r<r>rr@rFrKrOrfrir~rrrr line_magic cell_magicline_cell_magicregister_line_magicregister_cell_magicregister_line_cell_magicrrArr*r0r1r<s"+ &64#%33<<??> T#s(+, ^ $ 0 1 %)br$:!:&6 #6%B "B'+'L $L  & Th(2+ "+++  +  +2  :  2 F::2:z:F  "& ) !& ) &{3-V4,V41+>tALtAt}\}~/"/"r0