EdX~dZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z dZd Zd Zd Z ddZd S)z7Tools for setting up printing in interactive sessions. ) version_tuple)BytesIO)latex)preview)debug) Printablec 8ddl}ddlfd}||_dS)z.Setup printing in Python interactive session. rNcX|&d_t|fi|_dSdS)zPython's pretty-printer display hook. This function was adapted from: http://www.python.org/dev/peps/pep-0217/ N)_print)argbuiltinssettingsstringify_funcs :lib/python3.11/site-packages/sympy/interactive/printing.py _displayhookz+_init_python_printing.._displayhooksI  HJ ..1111 2 2 2HJJJ  )sysr displayhook)rrrrrs`` @r_init_python_printingr sGJJJOOO       #COOOrc    !"#$%&'( ddlm'n#t$rYnwxYw=|j} | dkrdn | dkrdndt d |d krd z%nd %d } d}t d z}d| |||fz}|#d z}dd|g$t d#t d$| pt&fd}#%fd!$%fd"' fd d((fd !& fd}"& fd} & fd}& fd}fd }ddl tj td!krptttt t"t$t&g}|jjd"}|t,gzD]}||||jjd#}|d$vr7t d%|D]}||||t,_nMt d&|D]%}||jvr|j|&t,jt,_|jjd'}|d(vr7t d)|D]}||||t,_n|d*kr7t d+|D]}||||t,_nMt d,|D]%}||jvr|j|&t,jt,_|jjd-}|d.vr8t d/|D]}||||t,_dSt d0|D]%}||jvr|j|&t,jt,_dS|d1|dS)2z/Setup printing in IPython interactive session. r) latex_to_pngNlightbgBlacklinuxWhiteGrayz*init_printing: Automatic foreground color:svgz \special{color %s}tightz0cm,0cmz-T %s -D %d -bg %s -fg %s -O %sg@z --no-fontsz --scale={}zinit_printing: DVIOPTIONS:zinit_printing: DVIOPTIONS_SVG:c|r ||dS|jj|dS)z*caller for pretty, for use in IPython 0.11N)textlibpretty)r pcycleIPython _can_printrs r _print_plainz,_init_ipython_printing.._print_plainOs` :c?? 3 FF>>#&& ' ' ' ' ' FF7;%,,S11 2 2 2 2 2rc t} t|dd|n1#t$r$}tddt |d}~wwxYw|S)Npngroutputviewereuler outputbufferextra_preamble dvioptionsfontsizez png printing:"_preview_wrapper exception raised:)rr Exceptionrreprgetvalue)o exprbufferer3r0r2r4s r_preview_wrapperz0_init_ipython_printing.._preview_wrapperVsYY   AeIU!+N)H > > > > >    /#Gq''       ""$$$) AAAc t} t|dd|n1#t$r$}tddt |d}~wwxYw|dS)Nrrr-z svg printing:r5zutf-8)rrr6rr7r8decode)r9r:r;dvioptions_svgr0r2r4s r _svg_wrapperz,_init_ipython_printing.._svg_wrappercsYY   AeIU!+N- B B B B B    /#Gq''       ""$$++G444r=c |S#t$r|cYSwxYw#t$r(}tdt|Yd}~dSd}~wwxYw)N)colorscalezmatplotlib exception caught:) TypeError ValueErrorrr7)r9r; forecolorrrDs r_matplotlib_wrapperz3_init_ipython_printing.._matplotlib_wrapperps  '#|AYeDDDD ' ' '#|A&&& '    0$q'' : : :44444 s$ *-*- AAA)_latex _sympystr_pretty _sympyreprct ttttf}t |r]t jd|Dvs t jd|DvrdStfdDSt trtfdDSt trdSt trdStfdDrdSt ttfrrdSdS#t$rYdSwxYw)zReturn True if type o can be printed with one of the SymPy printers. If o is a container type, this is True if and only if every element of o can be printed in this way. c3$K|] }|jV dSN)__str__.0is r z=_init_ipython_printing.._can_print..s$+M+M!AI+M+M+M+M+M+Mrc3$K|] }|jV dSrO)__repr__rQs rrTz=_init_ipython_printing.._can_print..s$,O,OAQZ,O,O,O,O,O,OrFc3.K|]}|VdSrO)rRrSr)s rrTz=_init_ipython_printing.._can_print..s+44Q::a==444444rc3PK|] }|o|V!dSrOrX)rRrSr)r9s rrTz=_init_ipython_printing.._can_print..s>II!::a===ZZ!-=-=IIIIIIrTc38K|]}t|VdSrO)hasattr)rRhookr9s rrTz=_init_ipython_printing.._can_print..s-AA$WQ%%AAAAAAr)listtupleset frozenset isinstancetyperPrValldictboolranyfloatint RuntimeError)r9 builtin_typesr) print_builtinprinting_hookss` rr)z*_init_ipython_printing.._can_printsw "5#y9M!]++ GGO+M+M}+M+M+MM!GG$,O,O,O,O,OO! 54444!444444At$$ IIIIIqIIIIIIAt$$ uAy)) tAAAA.AAAAA tAs|,,  t5   55 s6A*D)0D) 0D)<D)D)*D)D)) D76D7c|rs|fdi}dkrd|z} |S#t$rD}tdt|ddkr |fddi}|cYd}~Sd}~wwxYwdS)z A function that returns a png rendered by an external latex distribution, falling back to matplotlib rendering modeplain$\displaystyle %s$preview failed with:z# Falling back to matplotlib backendinlineNrirr7) r9sr;r)rHr<r latex_moders r_print_latex_pngz0_init_ipython_printing.._print_latex_pngs :a== .a55j5H55AW$ .)A- .''*** . . .,d1gg;===)<a;;h;(;;A**1--------  . . .s / A=9A82A=8A=c|rX|fdi}dkrd|z} |S#t$r)}tdt|dYd}~dSd}~wwxYwdS)zz A function that returns a svg rendered by an external latex distribution, no fallback available. rnrorprqz No fallback available.Nrs)r9rtr;r)rArrurs r_print_latex_svgz0_init_ipython_printing.._print_latex_svgs :a== 1a55j5H55AW$ .)A- 1#|A& 1 1 1,d1gg/111111111 1  1 1s / A"AA"cJ|r|fddi}|SdS)zD A function that returns a png rendered by mathtext rnrrNrX)r9rtr)rHrrs r_print_latex_matplotlibz7_init_ipython_printing.._print_latex_matplotlibsL :a== *a33h3(33A&&q)) ) * *rcN|r|fdi}dkrd|zS|SdS)zW A function to generate the latex representation of SymPy expressions. rnrorpNrX)r9rtr)rrurs r_print_latex_textz1_init_ipython_printing.._print_latex_textsX :a== a55j5H55AW$ 1,q00H   rc|jjr.|}d|vrtt|dStt|dS)zIPython's pretty-printer display hook, for use in IPython 0.10 This function was adapted from: ipython/IPython/hooks.py:155  N)rcpprintr r7)selfr outrs r_result_displayz/_init_ipython_printing.._result_displays^ 7>  .%%Cs{  #JJJJJ $s))     rz0.11z text/plainz image/svg+xml)rz"init_printing: using svg formatterz*init_printing: not using any svg formatterz image/png)Tr,z"init_printing: using png formatter matplotlibz)init_printing: using matplotlib formatterz*init_printing: not using any png formatterz text/latex)Tmathjaxz&init_printing: using mathjax formatterz-init_printing: not using text/latex formatterresult_display)IPython.lib.latextoolsr ImportErrorcolorslowerrroundsplitformat default_latexr(r __version__rgr^r]r_r`rdrhdisplay_formatter formattersrfor_type _repr_svg_ type_printerspop_repr_disabled _repr_png_ _repr_latex_set_hook))ipr use_latexr0rG backcolorr4rurk latex_printerrDrrC imagesizeoffset resolutiondvi svg_scaler*rvrxrzr|rprintable_typesplaintext_formattercls svg_formatter png_formatterlatex_formatterr(r)rHr<rAr3r@r2rrrls) ` `` ``` `` @@@@@@@@@@@r_init_ipython_printingr!s 7777777       G !! I  II g  III :IFFFE09<I Fs5y!!J ,:y)V0= =CJu I"L$7$7 $B$BCN & 333 *N;;;  *]E3333333 % % % % % % % % 5 5 5 5 5 5 5 5       FN!!!!!!!L..........$ 1 1 1 1 1 1 1 1 1********$NNNW())]6-B-BBC7 !%sItSI 2=lK #i[0 <  >&&s,<====#3I > ? ? ?& 9 9-559!/33C888#,#;I ,7 D  % < 6 7 7 7& > >&&s,<====#3I , & < = > > >& E E&&s,CDDDD#:I > ? ? ?& 9 9-559!/33C888#,#;I .9,G ) ) > : ; ; ;& A A((.?@@@@%6I " " " A B B B& ; ;/77;#155c:::%.%=I " " " $o66666s  ))cddlm}d|vrdS ddlm}n*#t$r ddlm}n#t$rYYdSwxYwYnwxYwt ||S)z%Is a shell instance an IPython shell?r)modulesr(F)InteractiveShell)rrIPython.core.interactiveshellrr IPython.iplibra)shellrrs r _is_ipythonr3su BBBBBBB   6 6 6 6 6 6 6   555  7 6 e- . ..s$ <'< 6<6<<FTN Transparent10ptro?c $ddl}ddlm}|r ||}nddlm}n ||}nddlm}d}|$ t }|du}n#t$rYnwxYw|r|st|}|r|r ddl }t|j tdkrddl m }nddlm }dd lm}t#|||fsBd d |jvr&t)d d |t)dd }n#t*$rYnwxYwt,s|s|n||r fd}nfd}|r@|dd}|rt)dt3||||| | | | | ||f i|dSt5|fi|dS)a1 Initializes pretty-printer depending on the environment. Parameters ========== pretty_print : bool, default=True If ``True``, use :func:`~.pretty_print` to stringify or the provided pretty printer; if ``False``, use :func:`~.sstrrepr` to stringify or the provided string printer. order : string or None, default='lex' There are a few different settings for this parameter: ``'lex'`` (default), which is lexographic order; ``'grlex'``, which is graded lexographic order; ``'grevlex'``, which is reversed graded lexographic order; ``'old'``, which is used for compatibility reasons and for long expressions; ``None``, which sets it to lex. use_unicode : bool or None, default=None If ``True``, use unicode characters; if ``False``, do not use unicode characters; if ``None``, make a guess based on the environment. use_latex : string, bool, or None, default=None If ``True``, use default LaTeX rendering in GUI interfaces (png and mathjax); if ``False``, do not use LaTeX rendering; if ``None``, make a guess based on the environment; if ``'png'``, enable LaTeX rendering with an external LaTeX compiler, falling back to matplotlib if external compilation fails; if ``'matplotlib'``, enable LaTeX rendering with matplotlib; if ``'mathjax'``, enable LaTeX text generation, for example MathJax rendering in IPython notebook or text rendering in LaTeX documents; if ``'svg'``, enable LaTeX rendering with an external latex compiler, no fallback wrap_line : bool If True, lines will wrap at the end; if False, they will not wrap but continue as one line. This is only relevant if ``pretty_print`` is True. num_columns : int or None, default=None If ``int``, number of columns before wrapping is set to num_columns; if ``None``, number of columns before wrapping is set to terminal width. This is only relevant if ``pretty_print`` is ``True``. no_global : bool, default=False If ``True``, the settings become system wide; if ``False``, use just for this console/session. ip : An interactive console This can either be an instance of IPython, or a class that derives from code.InteractiveConsole. euler : bool, optional, default=False Loads the euler package in the LaTeX preamble for handwritten style fonts (http://www.ctan.org/pkg/euler). forecolor : string or None, optional, default=None DVI setting for foreground color. ``None`` means that either ``'Black'``, ``'White'``, or ``'Gray'`` will be selected based on a guess of the IPython terminal color setting. See notes. backcolor : string, optional, default='Transparent' DVI setting for background color. See notes. fontsize : string or int, optional, default='10pt' A font size to pass to the LaTeX documentclass function in the preamble. Note that the options are limited by the documentclass. Consider using scale instead. latex_mode : string, optional, default='plain' The mode used in the LaTeX printer. Can be one of: ``{'inline'|'plain'|'equation'|'equation*'}``. print_builtin : boolean, optional, default=True If ``True`` then floats and integers will be printed. If ``False`` the printer will only print SymPy types. str_printer : function, optional, default=None A custom string printer function. This should mimic :func:`~.sstrrepr()`. pretty_printer : function, optional, default=None A custom pretty printer. This should mimic :func:`~.pretty()`. latex_printer : function, optional, default=None A custom LaTeX printer. This should mimic :func:`~.latex()`. scale : float, optional, default=1.0 Scale the LaTeX output when using the ``'png'`` or ``'svg'`` backends. Useful for high dpi screens. settings : Any additional settings for the ``latex`` and ``pretty`` commands can be used to fine-tune the output. Examples ======== >>> from sympy.interactive import init_printing >>> from sympy import Symbol, sqrt >>> from sympy.abc import x, y >>> sqrt(5) sqrt(5) >>> init_printing(pretty_print=True) # doctest: +SKIP >>> sqrt(5) # doctest: +SKIP ___ \/ 5 >>> theta = Symbol('theta') # doctest: +SKIP >>> init_printing(use_unicode=True) # doctest: +SKIP >>> theta # doctest: +SKIP \u03b8 >>> init_printing(use_unicode=False) # doctest: +SKIP >>> theta # doctest: +SKIP theta >>> init_printing(order='lex') # doctest: +SKIP >>> str(y + x + y**2 + x**2) # doctest: +SKIP x**2 + x + y**2 + y >>> init_printing(order='grlex') # doctest: +SKIP >>> str(y + x + y**2 + x**2) # doctest: +SKIP x**2 + x + y**2 + y >>> init_printing(order='grevlex') # doctest: +SKIP >>> str(y * x**2 + x * y**2) # doctest: +SKIP x**2*y + x*y**2 >>> init_printing(order='old') # doctest: +SKIP >>> str(x**2 + y**2 + x + y) # doctest: +SKIP x**2 + x + y**2 + y >>> init_printing(num_columns=10) # doctest: +SKIP >>> x**2 + x + y**2 + y # doctest: +SKIP x + y + x**2 + y**2 Notes ===== The foreground and background colors can be selected when using ``'png'`` or ``'svg'`` LaTeX rendering. Note that before the ``init_printing`` command is executed, the LaTeX rendering is handled by the IPython console and not SymPy. The colors can be selected among the 68 standard colors known to ``dvips``, for a list see [1]_. In addition, the background color can be set to ``'Transparent'`` (which is the default value). When using the ``'Auto'`` foreground color, the guess is based on the ``colors`` variable in the IPython console, see [2]_. Hence, if that variable is set correctly in your IPython console, there is a high chance that the output will be readable, although manual settings may be needed. References ========== .. [1] https://en.wikibooks.org/wiki/LaTeX/Colors#The_68_standard_colors_known_to_dvips .. [2] https://ipython.readthedocs.io/en/stable/config/details.html#terminal-colors See Also ======== sympy.printing.latex sympy.printing.pretty rN)Printer)r%)sstrreprFz1.0)TerminalInteractiveShell)InteractiveConsolezipython-consolerz*init_printing: Setting use_unicode to TrueTz(init_printing: Setting use_latex to Trueorder use_unicode wrap_line num_columnsc |fd|S)NrrX)exprr_stringify_funcrrrrs rzinit_printing..s8,_T99D7@9D9908 99rc|fdi|S)NrrX)rrrrs rrzinit_printing..%s+*3*3 %*3)1*3*3rrnzMinit_printing: Mode is not able to be set due to internalsof IPython printing)rsympy.printing.printerrsympy.printingr%r get_ipython NameErrorrr(rr!IPython.terminal.interactiveshellr*IPython.frontend.terminal.interactiveshellcoderrajoinargvrr NO_GLOBALset_global_settingsrrr) pretty_printrrrrr no_globalrr0rGrr4rurk str_printerpretty_printerrrDrrrr in_ipythonr(rrmode_in_settingsrs `` `` @r init_printingrHsvJJJ...... B  @+NN ? ? ? ? ? ? ?  B(NN A A A A A AJ * *BD.JJ    D   %*% __ %l% % NNNW011]55I5II `VVVVVVV______ / / / / / / b#57O"PQQ %)1B1BB %'FGGG"&K%DEEE $I    D  3Y3##%[.7[ $ R R R R)  399999999NN33333  :#<<55  ) ( ) ) )r>9e()Xz,mU + +"* + + + + + n9999999s#A A A)rs==444444777777******&&&&&&------###*P7P7P7d///&  =A>BCG4:4837,/ j:j:j:j:j:j:r