f&dZddlZddlZddlZddlZddlmZddlmZddlm Z ddl m Z dd l m Z dd lmZdd lmZdd lmZmZmZmZmZmZmZmZmZmZdd lmZGdde ZdZ Gdde!Z"edZ#GddejHZ%dZ&dZ'e de(dZ)Gdde Z*Gdde*Z+Gdd e*Z,Gd!d"e*Z-Gd#d$e*Z.Gd%d&e*Z/Gd'd(e*Z0Gd)d*e*Z1Gd+d,e*Z2Gd-d.e*Z3Gd/d0e*Z4Gd1d2e*Z5Gd3d4e*Z6e%joe*e%joe+e%joe,e%joe-e%joe.e%joe/e%joe4e%joe0e%joe1e%joe2e%joe3e%joe5e%joe6d6d5Z8y)7ziDisplay formatters. Inheritance diagram: .. inheritance-diagram:: IPython.core.formatters :parts: 3 N)StringIO) decorator) Configurable) get_ipython)Sentinel)get_real_method)pretty) BoolDictIntegerUnicodeCUnicode ObjectNameListForwardDeclaredInstancedefaultobserve)AnyceZdZeedj dZeddZe ddZ e dZ ed d Z e dZed d ZeZed dZddZedZy)DisplayFormatterzList of currently active mime-types to display. You can use this to set a white-list for formats to display. Most users will not need to change this value. helpTconfig active_typesc|jSN) format_typesselfs R/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/formatters.py_active_types_defaultz&DisplayFormatter._active_types_default,s   ct|jjD]\}}||dvrd|_d|_y)NnewTF) formattersitemsenabled)r"changekey formatters r#_active_types_changedz&DisplayFormatter._active_types_changed0s>"oo335 *NCfUm#$( !$) !  *r% FormatterABCipython_display_formatterct|SNparent)IPythonDisplayFormatterr!s r#_default_formatterz#DisplayFormatter._default_formatter9s &d33r%mimebundle_formatterct|Sr2)MimeBundleFormatterr!s r#_default_mime_formatterz(DisplayFormatter._default_mime_formatter>s "$//r%r(c tttttt t tttg }i}|D]}||}|||j<|S)z Activate the default formatters.r3) PlainTextFormatter HTMLFormatterMarkdownFormatter SVGFormatter PNGFormatter PDFFormatter JPEGFormatterLatexFormatter JSONFormatterJavascriptFormatter format_type)r"formatter_classesdclsfs r#_formatters_defaultz$DisplayFormatter._formatters_defaultEs_             $ !C4 A Aamm  !r%Nci}i}|j|riifS|j|||\}}|s|r|rP|jDcic] \}}||vs ||}}}|jDcic] \}}||vs ||}}}|rP|jDcic] \}}||vs ||}}}|jDcic] \}}||vs ||}}}|jjD]f\}} ||vr | j ||r||vr#|r||vr*d} | |} t | trt| dk(r| \} } | | ||<| b| ||<h||fScc}}wcc}}wcc}}wcc}}w#t $rYwxYw#xYw)aReturn a format data dict for an object. By default all format types will be computed. The following MIME types are usually implemented: * text/plain * text/html * text/markdown * text/latex * application/json * application/javascript * application/pdf * image/png * image/jpeg * image/svg+xml Parameters ---------- obj : object The Python object whose format data will be computed. include : list, tuple or set; optional A list of format type strings (MIME types) to include in the format data dict. If this is set *only* the format types included in this list will be computed. exclude : list, tuple or set; optional A list of format type string (MIME types) to exclude in the format data dict. If this is set all format types will be computed, except for those included in this argument. Mimetypes present in exclude will take precedence over the ones in include Returns ------- (format_dict, metadata_dict) : tuple of two dicts format_dict is a dictionary of key/value pairs, one of each format that was generated for the object. The keys are the format types, which will usually be MIME type strings and the values and JSON'able data structure containing the raw data for the representation in that format. metadata_dict is a dictionary of metadata about each mime-type output. Its keys will be a strict subset of the keys in format_dict. Notes ----- If an object implement `_repr_mimebundle_` as well as various `_repr_*_`, the data returned by `_repr_mimebundle_` will take precedence and the corresponding `_repr_*_` for this mimetype will not be called. includeexcludeNr) r0r7r)r(lookupKeyError isinstancetuplelen) r"objrNrO format_dictmd_dictkvrFr-mddatas r#formatzDisplayFormatter.formatZsh   ) )# .r6M#88gW^8_ W '.9.?.?.ARsqQ'\qsR R*1--/J31QQ'\1Q3JJ.9.?.?.AVsqQgEUqsV V*1--/N31QQg=M1Q3NN&*oo&;&;&= * "Kk)$$S);g5;'1B  ~ $&3t9>b+/ K(~') $A *BG##OSJVN  sN E E 2 E&?E& E,)E, E2E2>E8 F8 FFF cHt|jjS)z>Return the format types (MIME types) of the active formatters.)listr(keysr!s r#r zDisplayFormatter.format_typessDOO((*++r%NN)__name__ __module__ __qualname__rrtagrrr$rr.rr0r6r7r:r r(rKr\propertyr r%r#rr#s   SS   ^!! ^**!8 G ()4*43>B #$0%0 J \(f$P,,r%rcP t|S#t$r}d|zcYd}~Sd}~wwxYw)zNTry to return a repr of an object always returns a string, at least. zun-repr-able object (%r)N)repr Exception)rUes r# _safe_reprrks, .Cy .)A--.s % %%ceZdZdZy)FormatterWarningz&Warning class for errors in formattersN)rarbrc__doc__rfr%r#rmrms0r%rmcT ||g|i|}|j||dS#t$r|jd|dcYSt$r\tj}t }||j |ntj||jd|dcYSwxYw)z$show traceback on failed format callNr) NotImplementedError _check_returnrisysexc_infor showtraceback tracebackprint_exception)methodr"argskwargsrrsips r#catch_format_errorr|s 1 4 )$ )& )   aa )) 1!!$Q00 1<<> ] >   X &  % %x 0!!$Q001s #B'A!B'&B'c<eZdZdZdZdZejdZy)r/aE Abstract base class for Formatters. A formatter is a callable class that is responsible for computing the raw format data for a particular format type (MIME type). For example, an HTML formatter would have a format type of `text/html` and would return the HTML representation of the object when called. text/plainTct|S)zReturn a JSON'able representation of the object. If the object cannot be formatted by this formatter, warn and return None. )rh)r"rUs r#__call__zFormatterABC.__call__sCyr%N) rarbrcrnrFr*abcabstractmethodrrfr%r#r/r/s-KGr%r/) metaclassc>t|dd}t|dd}||fS)zgReturn a (__module__, __name__) tuple for a type. Used as key in Formatter.deferred_printers. rbNra)getattr)typmodulenames r# _mod_name_keyrs* S, -F 3 D )D D>r%c6t|ddxs t|S)z2Return the type of an instance (old and new-style) __class__N)rtype)rUs r# _get_typers 3 T * 7d3i7r%_raise_key_errorzr Special value to raise a KeyError Raise KeyError in `BaseFormatter.pop` if passed as the default value to `pop` cBeZdZUdZedZeZee d<e djdZ e dZejdZejdZejdZedZdZd Zd Zd Zdd ZddZefdZdZy ) BaseFormatteraA base formatter class that is configurable. This formatter should usually be used as the base class of all formatters. It is a traited :class:`Configurable` class and includes an extensible API for users to determine how their objects are formatted. The following logic is used to find a function to format an given object. 1. The object is introspected to see if it has a method with the name :attr:`print_method`. If is does, that object is passed to that method for formatting. 2. If no print method is found, three internal dictionaries are consulted to find print method: :attr:`singleton_printers`, :attr:`type_printers` and :attr:`deferred_printers`. Users should use these dictionaries to register functions that will be used to compute the format data for their objects (if those objects don't have the special print methods). The easiest way of using these dictionaries is through the :meth:`for_type` and :meth:`for_type_by_name` methods. If no function/callable is found to compute the format data, ``None`` is returned and this format type is not used. r~ _return_typeTr__repr__c|jr |j|}||Sy#t$rYnwxYwt||j}||Sy)!Compute the format for an object.Nr*rPrQr print_methodr"rUprinterrws r#rzBaseFormatter.__call__Jsg << $++c*s|#   %S$*;*;22r%ct|trit|jdd}||jvr1|j D]!}t ||k(s|j |cSnY|j|Stj|D]2}||j vs|j|s#|j |cStdj|)abLook up the registered formatter for a type. Parameters ---------- typ : type or '__module__.__name__' string for a type Returns ------- f : callable The registered formatting callable for the type. Raises ------ KeyError if the type has not been registered. .rzNo registered printer for {0!r}) rRstrrSrsplitdeferred_printers type_printersrr _get_mro_in_deferred_typesrQr\)r"rtyp_keyrIs r#rzBaseFormatter.lookup_by_types c3 CJJs1-.Gd444 --7C$S)W4#11#667--g66s+ 3$,,,0G0G0L--c22 3 8??DEEr%Nct|tr(|jdd\}}|j|||S |j |}|||j |<|S#t $rd}Y wxYw)atAdd a format function for a given type. Parameters ---------- typ : type or '__module__.__name__' string for a type The class of the object that will be formatted using `func`. func : callable A callable for computing the format data. `func` will be called with the object to be formatted, and will return the raw data in this formatter's format. Subclasses may use a different call signature for the `func` argument. If `func` is None or not specified, there will be no change, only returning the current value. Returns ------- oldfunc : callable The currently registered callable. If you are registering a new formatter, this will be the previous value (to enable restoring later). rrN)rRrrfor_type_by_namerrQr)r"rfunc type_module type_nameoldfuncs r#for_typezBaseFormatter.for_types4 c3 %(ZZQ%7 "K((iF F ))#.G  &*D  s #  G sA A,+A,c|||f} |jd|z}|||j|<|S#t$rd}Y wxYw)a"Add a format function for a type specified by the full dotted module and name of the type, rather than the type of the object. Parameters ---------- type_module : str The full dotted name of the module the type is defined in, like ``numpy``. type_name : str The name of the type (the class name), like ``dtype`` func : callable A callable for computing the format data. `func` will be called with the object to be formatted, and will return the raw data in this formatter's format. Subclasses may use a different call signature for the `func` argument. If `func` is None or unspecified, there will be no change, only returning the current value. Returns ------- oldfunc : callable The currently registered callable. If you are registering a new formatter, this will be the previous value (to enable restoring later). z%s.%sN)rrQr)r"rrrr,rs r#rzBaseFormatter.for_type_by_namesZ<I& ))'C-8G  *.D " "3 '  G s - ;;ct|trt|jdd}||jvr?|j D]-}t ||k(s|j j|}no|}nk|jj|}nO||j vr|j j|}n%|jjt ||}|turtdj||S)aPop a formatter for the given type. Parameters ---------- typ : type or '__module__.__name__' string for a type default : object value to be returned if no formatter is registered for typ. Returns ------- obj : object The last registered object for the type. Raises ------ KeyError if the type is not registered and default is not specified. rrzNo registered value for {0!r}) rRrrSrrrrpoprrQr\)r"rrrrIolds r#rzBaseFormatter.pops& c3 CJJs1-.Gd444 --"C$S)W4"0044S9" "C,,009d(((((,,S1,,00s1CWM " ":AA#FG G r%ct|dd}t|dd}||f}||jvr+|jj|}||j|<yy)z Check if the given class is specified in the deferred type registry. Successful matches will be moved to the regular type registry for future use. rbNraTF)rrrr)r"rImodrr,rs r#rz BaseFormatter._in_deferred_types(sc c<.sJ-Dk $(( (,,005G&-D  s #r%r)rarbrcrnrrFrrr__annotations__r rdr*rrr rrrr|rrrqrPrrrrrrrfr%r#rrs0,'KL#4jnnDn)Gj)L40FJJdJ+M $ /$ 3. FD&P'R 0'Rr%rc(eZdZdZedZedjdZe e jdjdZ e dZedjdZedjdZe d jdZed jdZed Zed jdZed dZeddZeddZeddZedZy)r<a`The default pretty-printer. This uses :mod:`IPython.lib.pretty` to compute the format data of the object. If the object cannot be pretty printed, :func:`repr` is used. See the documentation of :mod:`IPython.lib.pretty` for details on how to write pretty printers. Here is a simple example:: def dtype_pprinter(obj, p, cycle): if cycle: return p.text('dtype(...)') if hasattr(obj, 'fields'): if obj.fields is None: p.text(repr(obj)) else: p.begin_group(7, 'dtype([') for i, field in enumerate(obj.descr): if i > 0: p.text(',') p.breakable() p.pretty(field) p.end_group(7, '])') r~TFrzTruncate large collections (lists, dicts, tuples, sets) to this size. Set to 0 to disable truncation. r _repr_pretty_O %rfloat_precisionc|d}d|vr|} |dz||_y|rI t|}|dk\sJ d|z}d tj vrHddl}|j| ||_yd }d tj vrddl}|jd ||_y#t$r}td|z|d}~wwxYw#t$r}td|z|d}~wt$r}tdz|d}~wwxYw) afloat_precision changed, set float_format accordingly. float_precision can be set by int or str. This will set float_format, after interpreting input. If numpy has been imported, numpy print precision will also be set. integer `n` sets format to '%.nf', otherwise, format set directly. An empty string returns to defaults (repr for float, 8 for numpy). This parameter can be set via the '%precision' magic. r'%gn! @z.Precision must be int or format string, not %rNrz*int precision must be non-negative, not %rz%%.%ifnumpy) precisionr) ri ValueErrorintAssertionErrorrrmodulesrset_printoptions float_format)r"r+r'fmtrjirs r#_float_precision_changedz+PlainTextFormatter._float_precision_changedss"Um #:C ^G 2 - XHAv v 1*C#++%&&&3  C#++%&&&31 ^ !QRU!UV\]] ^ ^ !QRU!UV\]]! X !Ma!OPVWW Xs:BB7 B4 B//B47 C/C C/C**C/rc>tjjSr)r _singleton_pprinterscopyr!s r#_singleton_printers_defaultz.PlainTextFormatter._singleton_printers_defaults**//11r%rctjj}fd|t<dtj vrddl}fd||j<|S)Nc@|jj|zSrtextrrUpcycler"s r#z;PlainTextFormatter._type_printers_default..sqvvd.?.?.C'Dr%rrc@|jj|zSrrrs r#rz;PlainTextFormatter._type_printers_default..sQVVDtjjSr)r _deferred_type_pprintersrr!s r#_deferred_printers_defaultz-PlainTextFormatter._deferred_printers_defaults..3355r%c l|js t|St}tj||j |j |j|j|j|j|j}|j||j|jS)z0Compute the pretty representation of the object.)max_seq_lengthsingleton_pprinterstype_pprintersdeferred_pprinters)pprintrhrr RepresentationPrinterverbose max_widthnewlinerrrrflushgetvalue)r"rUstreamrs r#rzPlainTextFormatter.__call__s{{9 ZF2264<< #22$($;$;#11#'#9#9 ;G NN3  MMO??$ $r%N)rarbrcrnrrFr rdr*rr MAX_SEQ_LENGTHrrrrrrrrrrrrrrrrr|rrfr%r#r<r<9sT0,'K4jnnEn*GV22   cc o.L$Z^^4^ (F5kooTo*G t,Idmt,G4=Lrl&&d&3O +  + \ !"2#2 _ !6"6 %%r%r<c0eZdZdZedZedZy)r=aAn HTML formatter. To define the callables that compute the HTML representation of your objects, define a :meth:`_repr_html_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. The return value of this formatter should be a valid HTML snippet that could be injected into an existing DOM. It should *not* include the ````` or ````` tags. z text/html _repr_html_NrarbrcrnrrFrrrfr%r#r=r=s +&Km,Lr%r=c0eZdZdZedZedZy)r>aQA Markdown formatter. To define the callables that compute the Markdown representation of your objects, define a :meth:`_repr_markdown_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. The return value of this formatter should be a valid Markdown. z text/markdown_repr_markdown_Nrrfr%r#r>r>s/*K/0Lr%r>c0eZdZdZedZedZy)r?aAn SVG formatter. To define the callables that compute the SVG representation of your objects, define a :meth:`_repr_svg_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. The return value of this formatter should be valid SVG enclosed in `````` tags, that could be injected into an existing DOM. It should *not* include the ````` or ````` tags. z image/svg+xml _repr_svg_Nrrfr%r#r?r?s /*Kl+Lr%r?c8eZdZdZedZedZee fZ y)r@aXA PNG formatter. To define the callables that compute the PNG representation of your objects, define a :meth:`_repr_png_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. The return value of this formatter should be raw PNG data, *not* base64 encoded. z image/png _repr_png_N rarbrcrnrrFrrbytesrrrfr%r#r@r@s& +&Kl+L3sj 9   a EAr s  B A B  >BA]D73??r%) rarbrcrnrrFr^dictrrrrq __classcell__rs@r#rDrD.s4 ,-K$``` tags. zapplication/javascript_repr_javascript_Nrrfr%r#rErETs 23K12Lr%rEc8eZdZdZedZedZee fZ y)rAaXA PDF formatter. To define the callables that compute the PDF representation of your objects, define a :meth:`_repr_pdf_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. The return value of this formatter should be raw PDF data, *not* base64 encoded. zapplication/pdf _repr_pdf_Nrrfr%r#rArAds' +,Kl+L3_` methods, `_repr_mimebundle_` should return mime-bundle data, either the mime-keyed `data` dictionary or the tuple `(data, metadata)`. Any mime-type is valid. To define the callables that compute the mime-bundle representation of your objects, define a :meth:`_repr_mimebundle_` method or use the :meth:`for_type` or :meth:`for_type_by_name` methods to register functions that handle this. .. versionadded:: 6.1 _repr_mimebundle_cdtt| ||}|iifSt|ts|ifS|Sr)rr9rqrRrS)r"rzrUrs r#rqz!MimeBundleFormatter._check_returns= %t :1c B 9r6M!U#b5Lr%c|jr |j|}||Sy#t$rYnwxYwt||j}| |||Sy)zCompute the format for an object. Identical to parent's method but we pass extra parameters to the method. Unlike other _repr_*_ `_repr_mimebundle_` should allow extra kwargs, in particular `include` and `exclude`. NrMr)r"rUrNrOrrws r#rzMimeBundleFormatter.__call__sm << $++c*s|#   %S$*;*;r?r@rBrCrDrErAr5r9registerrrfr%r#r&s 6#%( b,|b,T.1{1 * *$S[[28 .XLXvM%M%`-M-" 1 1,=," = $ M $.]."#@M#@L 3- 3  = "&m&R3-3l m$ () m$ '( l# l# l# m$ n% m$ )* -. )*!r%