o g@sbddlmZddlmZddlmZddlZddlmZm Z m Z m Z m Z m Z mZmZmZddlmZddlZddlmZddlmZdd lmZmZdd lmZdd lmZdd l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd l'm(Z(ddl)m*m+Z,edddZ-ddl.m/Z0ee1e fZ2ee2e ee e2ffZ3ee1ee1e4e5ffZ6e e6Z7ee1e7fZ8GdddeZ9e e9Z:ee;ee"fZdod"d#Z? dpdqd+d,Z@drd-d.ZAdsd1d2ZBdtdud7d8ZCdvd=d>ZDd?d@ZE    A  dwdxdFdGZFdydJdKZGdzdOdPZHGdQdRdRZId{dUdVZJd|dXdYZK 3dtd}d]d^ZL 3dtd~dddeZMddhdiZNddjdkZOdldmZPdS)) annotations) defaultdict)partialN) AnyCallable DefaultDictDictListOptionalSequenceTupleUnion)uuid4) get_option)lib)FrameOrSeriesUnion TypedDict)import_optional_dependency) ABCSeries) DataFrameIndex IndexSlice MultiIndexSeriesisna) is_list_likejinja2z DataFrame.style requires jinja2.)extraescapec@seZdZUded<ded<dS)CSSDictstrselector CSSPropertiespropsN)__name__ __module__ __qualname____annotations__r)r)\/home/ubuntu/cloudmapper/venv/lib/python3.10/site-packages/pandas/io/formats/style_render.pyr 5s  r c@seZdZdZeddZejeddZe dZ e dZ e dZ e d Z dLdMddZdNdd ZdNd!d"Zd#d$ZdOdPd(d)ZdQd1d2ZdRd8d9ZdSd=d>Z ? dTdUdJdKZd S)VStylerRendererzT Base class to process rendering a Styler with a specified jinja2 template. pandaszio/formats/templatesT)loader trim_blockszhtml.tplzhtml_table.tplzhtml_style.tplz latex.tplNdataruuid str | Noneuuid_lenint table_stylesCSSStyles | Nonetable_attributescaptionstr | tuple | Nonecell_idsboolcst|tr |}t|tstd||_|j|_|j|_t|tr&|dks*tdt d||_ |p:t j d|j d|_ ||_||_||_||_d|_d|_g|_g|_tt|_tt|_g|_d|_tdtfdd |_dS) Nz&``data`` must be a Series or DataFramerz1``uuid_len`` must be an integer in range [0, 32]. _Fdisplay.precisioncs ttdS)N) precision)r_default_formatterr) def_precisionr)r*rs z)StylerRenderer.__init__..) isinstancerto_framer TypeErrorr0indexcolumnsr4minr3rhexr1r5r7r8r: hide_index_ hide_columns_ hidden_rowshidden_columnsrlistctxr! cell_context_todotooltipsr_display_funcs)selfr0r1r3r5r7r8r:r)rAr*__init__Js4     zStylerRenderer.__init__ sparse_indexsparse_columnsreturnr!cKs>||||}|||jjdi||j|jdS)z Renders the ``Styler`` including all applied styles to HTML. Generates a dict with necessary kwargs passed to jinja2 template. )html_table_tplhtml_style_tplNr))_compute _translateupdate template_htmlrendertemplate_html_tabletemplate_html_stylerUrWrXkwargsdr)r)r* _render_htmlts    zStylerRenderer._render_htmlcKsn||j||dd}||t|jjd<t|jjd<t|jjd<t|jjd<| ||jj di|S) z1 Render a Styler in latex format )blank parse_wrap parse_table parse_cell parse_headerNr)) r\r]_translate_latex_parse_latex_table_wrappingtemplate_latexglobals_parse_latex_table_styles_parse_latex_cell_styles_parse_latex_header_spanr^r`rcr)r)r* _render_latexs      zStylerRenderer._render_latexcCs6|j|}|jD]\}}}|||i|}q |S)a Execute the style functions built up in `self._todo`. Relies on the conventions that all style functions go through .apply or .applymap. The append styles to apply as tuples of (application method, *args, **kwargs) )rPclearrR)rUrfuncargsrdr)r)r*r\s zStylerRenderer._compute  sparse_colsrhc Cs:d}d}d}d}d}d} d} |} |jt|jpg|jd} td } tt|jjt|jj | \}}| | | |||||}| d |it t |_|| ||||||}| d |id d |jD}| d|i|j}td}|s|pwd}d|vr|dd}n|d7}| d|i|jr|j|j|j| } | S)aV Process Styler data and settings into a dict for template rendering. Convert data and settings from ``Styler`` attributes such as ``self.data``, ``self.tooltips`` including applying any methods in ``self._todo``. Parameters ---------- sparse_index : bool Whether to sparsify the index or print all hierarchical index elements. Upstream defaults are typically to `pandas.options.styler.sparse.index`. sparse_cols : bool Whether to sparsify the columns or print all hierarchical column elements. Upstream defaults are typically to `pandas.options.styler.sparse.columns`. Returns ------- d : dict The following structure: {uuid, table_styles, caption, head, body, cellstyle, table_attributes} row_heading col_heading index_namecol_trimrow_trimr0rh)r1r5r8zstyler.render.max_elementsheadbodycSsg|] \}}t||dqS))r$ selectors)rO).0r$rr)r)r* s z-StylerRenderer._translate.. cellstylezdisplay.html.use_mathjaxrgzclass="zclass="tex2jax_ignore z class="tex2jax_ignore"r7)r1_format_table_stylesr5r8r_get_trimming_maximumslenr0rGrH_translate_headerr^rrO cellstyle_map_translate_bodyitemsr7replacerSr])rUrWrzrhROW_HEADING_CLASSCOL_HEADING_CLASSINDEX_NAME_CLASSTRIMMED_COL_CLASSTRIMMED_ROW_CLASS DATA_CLASS BLANK_CLASS BLANK_VALUEre max_elementsmax_rowsmax_colsrrr table_attr use_mathjaxr)r)r*r]sl   zStylerRenderer._translate blank_class blank_valueindex_name_classcol_heading_class sparsify_colsrtrimmed_col_classc stj||jjjd|}jjjdkr!dd|D}tt|}g} jst jjjD]kt dj gjj jd} jjj } t d| durUnd| dura| nj g} |rfddt|D} tjj|kr| t ddd|d d d d | | | | q3jj j rtjjj j rj sjsfd dtjj j D}tjj|krt|d}nt|dd}fddt |D}| ||| S)a Build each within table as a list Using the structure: +----------------------------+---------------+---------------------------+ | index_blanks ... | column_name_0 | column_headers (level_0) | 1) | .. | .. | .. | | index_blanks ... | column_name_n | column_headers (level_n) | +----------------------------+---------------+---------------------------+ 2) | index_names (level_0 to level_n) ... | column_blanks ... | +----------------------------+---------------+---------------------------+ Parameters ---------- blank_class : str CSS class added to elements within blank sections of the structure. blank_value : str HTML display value given to elements within blank sections of the structure. index_name_class : str CSS class added to elements within the index_names section of the structure. col_heading_class : str CSS class added to elements within the column_names section of structure. sparsify_cols : bool Whether column_headers section will add colspan attributes (>1) to elements. max_cols : int Maximum number of columns to render. If exceeded will contain `...` filler. trimmed_col_class : str CSS class added to elements within a column including `...` trimmed vals. Returns ------- head : list The associated HTML elements needed for template rendering. NcSg|]}|gqSr)r)rxr)r)r*r0z4StylerRenderer._translate_header..th levelc sfg|]/\}}tddd||t||fddkr-d|fddnddqS) rr colrr colspan=""rg attributes)_element _is_visiblegetrcvalue)r col_lengthsrvr)r*rFs   ...Trgrcs4g|]\}}tdd||durn|dqS)rrNT)r)rrname)rrr)r*ris rcs*g|]}tdd||jvqS)rrrrNrr)rrrUr)r*rxs )_get_level_lengthsrHrNr0tolistnlevelsrOziprLrangerrKrGnames enumeraterappendcom any_not_none)rUrrrrrrrclabelsr index_blanksr column_namecolumn_headers index_names blank_len column_blanksr))rrrrrrvrUr*rsr-          z StylerRenderer._translate_header data_classrow_heading_classsparsify_indexrtrimmed_row_classc sXtj||jjjd|}jjjdkr!dd|D}g} tjD]\} |krufddtjjjD} fddt|D} t jj |krk| t ddd|d d d d | | | | Sfd dt|D} g} t| ddD]\} }| |kr| t ddd|d d d d nud }| fj vrdj | f}t ddd| ||| jvoֈjvd j| f|d}js| fjvrdd| |d<| fjvrj| frjtj| f dd| | |q| | | q*| S)a Build each within table as a list Use the following structure: +--------------------------------------------+---------------------------+ | index_header_0 ... index_header_n | data_by_column | +--------------------------------------------+---------------------------+ Also add elements to the cellstyle_map for more efficient grouped elements in block Parameters ---------- data_class : str CSS class added to elements within data_by_column sections of the structure. row_heading_class : str CSS class added to elements within the index_header section of structure. sparsify_index : bool Whether index_headers section will add rowspan attributes (>1) to elements. Returns ------- body : list The associated HTML elements needed for template rendering. NrcSrr)r)rr)r)r*rrz2StylerRenderer._translate_body..c s2g|]}tdd|ddj ddqS)rrrrrgr)rrKr)rrUrr)r*rsc s4g|]}tdd|dd|jvddqS)tdrrrrgrrr)rrUrr)r*rsrrrTrgrc s|g|]:\}}tdd|d|t|oj d|d|fddkr8d|fddnd d qS) rr rowlevel_rowrr rowspan="rrg)idr)rrrKrr) idx_lengthsrvrrUr)r*rs rr)r display_valuerow_colr)rrGrMr0rrr itertuplesrrrHrrrQrNrTr:rPrtuple)rUrrrrrrrrlabelsrrow_tup index_headersr0rrcls data_elementr))rrrvrrUrr*rs$     9     zStylerRenderer._translate_bodyredictNonecs|dd|dD|d<g}t|dD]$\}jrg}ndd|D}fddt|D}|||q||d<dS)a Post-process the default render dict for the LaTeX template format. Processing items included are: - Remove hidden columns from the non-headers part of the body. - Place cellstyles directly in td cells rather than use cellstyle_map. - Remove hidden indexes or reinsert missing th elements if part of multiindex or multirow sparsification (so that \multirow and \multicol work correctly). cSsg|] }dd|DqS)cSsg|]}|dr|qS) is_visibler)rcolr)r)r*rsz>StylerRenderer._translate_latex...r))rrr)r)r*rsz3StylerRenderer._translate_latex..rrcSs8g|]}|ddkri|d|dr|dndiqS)typerrrrgr)rr)r)r*r"s  csHg|] \}}|dr"|ddkri|dj|jjjfiqS)rrrr)rPr0rGr)rrrrvrUr)r*r-s "N)rrKr)rUrerrrow_body_headersrow_body_cellsr)rr*rms   zStylerRenderer._translate_latex. formatterExtFormatter | Nonesubset Subset | Nonena_repr? int | Nonedecimal thousandsrc stdu|du|du|dk|du|du|dufr |j|S|dur(tdn|}t|}|jj|}ttsCfdd|j D|j |j } |j |j } | D]} t |j | |||||d} | D] } | |j| | f<qgqS|S)u Format the text display value of cells. Parameters ---------- formatter : str, callable, dict or None Object to define how values are displayed. See notes. subset : label, array-like, IndexSlice, optional A valid 2d input to `DataFrame.loc[]`, or, in the case of a 1d input or single key, to `DataFrame.loc[:, ]` where the columns are prioritised, to limit ``data`` to *before* applying the function. na_rep : str, optional Representation for missing values. If ``na_rep`` is None, no special formatting is applied. .. versionadded:: 1.0.0 precision : int, optional Floating point precision to use for display purposes, if not determined by the specified ``formatter``. .. versionadded:: 1.3.0 decimal : str, default "." Character used as decimal separator for floats, complex and integers .. versionadded:: 1.3.0 thousands : str, optional, default None Character used as thousands separator for floats, complex and integers .. versionadded:: 1.3.0 escape : str, optional Use 'html' to replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in cell display string with HTML-safe sequences. Use 'latex' to replace the characters ``&``, ``%``, ``$``, ``#``, ``_``, ``{``, ``}``, ``~``, ``^``, and ``\`` in the cell display string with LaTeX-safe sequences. Escaping is done before ``formatter``. .. versionadded:: 1.3.0 Returns ------- self : Styler Notes ----- This method assigns a formatting function, ``formatter``, to each cell in the DataFrame. If ``formatter`` is ``None``, then the default formatter is used. If a callable then that function should take a data value as input and return a displayable representation, such as a string. If ``formatter`` is given as a string this is assumed to be a valid Python format specification and is wrapped to a callable as ``string.format(x)``. If a ``dict`` is given, keys should correspond to column names, and values should be string or callable, as above. The default formatter currently expresses floats and complex numbers with the pandas display precision unless using the ``precision`` argument here. The default formatter does not adjust the representation of missing values unless the ``na_rep`` argument is used. The ``subset`` argument defines which region to apply the formatting function to. If the ``formatter`` argument is given in dict form but does not include all columns within the subset then these columns will have the default formatter applied. Any columns in the formatter dict excluded from the subset will be ignored. When using a ``formatter`` string the dtypes must be compatible, otherwise a `ValueError` will be raised. Examples -------- Using ``na_rep`` and ``precision`` with the default ``formatter`` >>> df = pd.DataFrame([[np.nan, 1.0, 'A'], [2.0, np.nan, 3.0]]) >>> df.style.format(na_rep='MISS', precision=3) 0 1 2 0 MISS 1.000 A 1 2.000 MISS 3.000 Using a ``formatter`` specification on consistent column dtypes >>> df.style.format('{:.2f}', na_rep='MISS', subset=[0,1]) 0 1 2 0 MISS 1.00 A 1 2.00 MISS 3.000000 Using the default ``formatter`` for unspecified columns >>> df.style.format({0: '{:.2f}', 1: '£ {:.1f}'}, na_rep='MISS', precision=1) 0 1 2 0 MISS £ 1.0 A 1 2.00 MISS 3.0 Multiple ``na_rep`` or ``precision`` specifications under the default ``formatter``. >>> df.style.format(na_rep='MISS', precision=1, subset=[0]) ... .format(na_rep='PASS', precision=2, subset=[1, 2]) 0 1 2 0 MISS 1.00 A 1 2.0 PASS 3.00 Using a callable ``formatter`` function. >>> func = lambda s: 'STRING' if isinstance(s, str) else 'FLOAT' >>> df.style.format({0: '{:.1f}', 2: func}, precision=4, na_rep='MISS') 0 1 2 0 MISS 1.0000 STRING 1 2.0 MISS FLOAT Using a ``formatter`` with HTML ``escape`` and ``na_rep``. >>> df = pd.DataFrame([['
', '"A&B"', None]]) >>> s = df.style.format( ... '{0}', escape="html", na_rep="NA" ... ) >>> s.render() ... <div></div> "A&B" NA ... Using a ``formatter`` with LaTeX ``escape``. >>> df = pd.DataFrame([["123"], ["~ ^"], ["$%#"]]) >>> s = df.style.format("\\textbf{{{}}}", escape="latex").to_latex() \begin{tabular}{ll} {} & {0} \\ 0 & \textbf{123} \\ 1 & \textbf{\textasciitilde \space \textasciicircum } \\ 2 & \textbf{\$\%\#} \\ \end{tabular} Nrcsi|]}|qSr)r)rrr)r* rz)StylerRenderer.format..)rr?rrr)allrTruslicenon_reducing_slicer0locrDrrHget_indexer_forrG_maybe_wrap_formatterr)rUrrrr?rrrr0cisrisci format_funcrir)rr*format6sB   zStylerRenderer.format)Nr/NNNT)r0rr1r2r3r4r5r6r7r2r8r9r:r;)rWr;rXr;rYr!)ry)rWr;rzr;rhr!)rr!rr!rr!rr!rr;rr4rr!)rr!rr!rr;rr4rr4rr!rr!)rerrYr)NNNNrNN)rrrrrr2r?rrr!rr2rr2rYr+)r%r&r'__doc__r PackageLoaderr- Environmentenv get_templater_rarbrorVrfrtr\r]rrrmrr)r)r)r*r+>s@      *   Z  &r+ html_elementr! html_classrrrr;rYrcKs"d|vr||d<||||d|S)z] Template to return container with information for a or element. r)rrclassrr))rrrrrdr)r)r*rs r皙?cs:fdd}|||kr|||\}}|||ks ||fS)aa Recursively reduce the number of rows and columns to satisfy max elements. Parameters ---------- rn, cn : int The number of input rows / columns max_elements : int The number of allowable elements Returns ------- rn, cn : tuple New rn and cn values that satisfy the max_elements constraint cs(||kr |t|fSt||fSN)r4)rncnscaling_factorr)r* scale_downsz*_get_trimming_maximums..scale_downr))r r rr r r)r r*rs   rrGrsparsify max_indexr4hidden_elementsSequence[int] | Nonec Cs>t|tr|jtjdd}n|}|durg}i}|jdkr4t|D]\}}||vr1d|d|f<q#|St|D][\}}t|D]R\} } | |krJnI|sSd||| f<q@| tjure| |vre| } d||| f<q@| tjurs| } d||| f<q@| |vr||| fdkr| } d||| f<q@||| fd7<q@q8dd|D} | S)aZ Given an index, find the level length for each element. Parameters ---------- index : Index Index or columns to determine lengths of each element sparsify : bool Whether to hide or show each distinct element in a MultiIndex max_index : int The maximum number of elements to analyse along the index due to trimming hidden_elements : sequence of int Index positions of elements hidden from display in the index affecting length Returns ------- Dict : Result is a dictionary of (level, initial_position): span F)radjoinNrrcSsi|] \}}|dkr||qS)rr))relementlengthr)r)r*rbsz&_get_level_lengths..)rDrrr no_defaultrrr) rGrrrlevelslengthsirlvljr last_labelnon_zero_lengthsr)r)r*r!sD    rcCs ||f|vS)z/ Index -> {(idx_row, idx_col): bool}). r))idx_rowidx_colrr)r)r*ris rstyles CSSStylescCsdd|DS)z looks for multiple CSS selectors and separates them: [{'selector': 'td, th', 'props': 'a:v;'}] ---> [{'selector': 'td', 'props': 'a:v;'}, {'selector': 'th', 'props': 'a:v;'}] cSs.g|]}|ddD] }||ddq qS)r",r$r"r$)split)rcss_dictr"r)r)r*rws  z(_format_table_styles..r))rr)r)r*rpsrFrr?rcCsLt|ttfr|r|d|dS|d|dSt|tr$|r$|dS|S)a Format the display of a value Parameters ---------- x : Any Input variable to be formatted precision : Int Floating point precision used if ``x`` is float or complex. thousands : bool, default False Whether to group digits with thousands separated with ",". Returns ------- value : Any Matches input type, or string if input is float or complex or int with sep. z,.frz,.0f)rDfloatcomplexr4)rr?rr)r)r*r@~sr@rrrr2csfdd}|S)z Takes a string formatting function and wraps logic to deal with thousands and decimal parameters, in the case that they are non-standard and that the input is a (float, complex, int). cst|tttfrLdkr$dur$dkr$|ddddSdkr8dus0dkr8|dSdkrLdurLdkrL|dS|S)Nrr!u§_§-)rDr&r'r4rrrrrr)r*wrappersz(_wrap_decimal_thousands..wrapperr))rrrr*r)r)r*_wrap_decimal_thousandss r+cCs<t|tr|dkr t|S|dkrt|Std||S)z/if escaping: only use on str, else return inputhtmllatexz2`escape` only permitted in {'html', 'latex'}, got )rDr! escape_html _escape_latex ValueError)rrr)r)r* _str_escapes r1rBaseFormatter | Nonerrrcsttr fddn(trn!dur+|durtdn|}tt||dudn tdtdur@fdd}n}|dksN|durV|d krVt|||d n|dur^Sfd dS) z Allows formatters to be expressed as str, callable or None, where None returns a default formatting function. wraps with na_rep, and precision where they are available. cs |Sr)rr(rr)r*rCs z'_maybe_wrap_formatter..Nr>)r?rz*'formatter' expected str or callable, got cst|dS)Nr)r1r()rfunc_0r)r*rCsrr!)rrcst|rS|Sr)rr()func_2rr)r*rCs) rDr!callablerrr@rFrr+)rrr?rrrfunc_1r))rrr3r4rr*rs&  rslice_Subsetcs~ttjtttf}t||rtdd|f}dddt|s2t|t s+|gg}t |S|g}t |Sfdd|D}t |S) z Ensure that a slice doesn't reduce to a Series or Scalar. Any user-passed `subset` should have this called on it to make sure we're always working with DataFrames. NrYr;cSs.t|trtdd|DSt|tpt|S)z Returns ------- bool True if slice does *not* reduce, False if `part` is a tuple. css"|] }t|tp t|VqdSr)rDrr)rsr)r)r* s z3non_reducing_slice..pred..)rDranyrr)partr)r)r*preds z non_reducing_slice..predcsg|] }|r |n|gqSr)r))rpr=r)r*rsz&non_reducing_slice..rYr;) rnpndarrayrrOr!rDrrrr)r7kindsr)r?r*rs   rstyler#CSSListcCsHt|tr"|d}zdd|DWSty!td|dw|S)z Convert css-string to sequence of tuples format if needed. 'color:red; border:1px solid black;' -> [('color', 'red'), ('border','1px solid red')] ;cSs<g|]}|dkr|dd|ddfqS)rg:rr)stripr#rr)r)r*r#s  "z/maybe_convert_css_to_tuples..zSStyles supplied as string must follow CSS rule formats, for example 'attr: val;'. 'z ' was given.)rDr!r# IndexErrorr0)rDr9r)r)r*maybe_convert_css_to_tupless   rJc@sHeZdZdZgddefdd d Zed d ZdddZdddZ dS) Tooltipsa An extension to ``Styler`` that allows for and manipulates tooltips on hover of ```` cells in the HTML result. Parameters ---------- css_name: str, default "pd-t" Name of the CSS class that controls visualisation of tooltips. css_props: list-like, default; see Notes List of (attr, value) tuples defining properties of the CSS class. tooltips: DataFrame, default empty DataFrame of strings aligned with underlying Styler data for tooltip display. Notes ----- The default properties for the tooltip CSS class are: - visibility: hidden - position: absolute - z-index: 1 - background-color: black - color: white - transform: translate(-20px, -20px) Hidden visibility is a key prerequisite to the hover functionality, and should always be included in any manual properties specification. )) visibilityhidden)positionabsolute)zz-indexr)background-colorblack)colorwhite) transformztranslate(-20px, -20px)zpd-t css_propsr#css_namer!rSrcCs||_||_||_g|_dSr) class_nameclass_propertiestt_datar5)rUrUrVrSr)r)r*rVNs  zTooltips.__init__cCsd|jt|jdgS)a Combine the ``_Tooltips`` CSS class name and CSS properties to the format required to extend the underlying ``Styler`` `table_styles` to allow tooltips to render in HTML. Returns ------- styles : List rr")rWrJrX)rUr)r)r* _class_styles`s zTooltips._class_stylesr1rrr4rtextcCsZd|dt|dt|}|d|dgd|d|dd d |d fgdgS) a: For every table data-cell that has a valid tooltip (not None, NaN or empty string) must create two pseudo CSS entries for the specific element id which are added to overall table styles: an on hover visibility change and a content change dependent upon the user's chosen display string. For example: [{"selector": "T__row1_col1:hover .pd-t", "props": [("visibility", "visible")]}, {"selector": "T__row1_col1 .pd-t::after", "props": [("content", "Some Valid Text String")]}] Parameters ---------- uuid: str The uuid of the Styler instance name: str The css-name of the class used for styling tooltips row : int The row index of the specified tooltip string data col : int The col index of the specified tooltip string data text : str The textual content of the tooltip to be displayed in HTML. Returns ------- pseudo_css : List z#T_rrz:hover .)rLvisibler"z .z::aftercontentr)r!)rUr1rrrr[ selector_idr)r)r* _pseudo_cssrs  zTooltips._pseudo_css styler_datarrercsj|_jjr |SjjjdBddfddttjjDD_ j rg|dD]}|D]}|ddkrUt |dd jd |d<q>q:|d  j |d  j |S) a= Mutate the render dictionary to allow for tooltips: - Add ```` HTML element to each data cells ``display_value``. Ignores headers. - Add table level CSS styles to control pseudo classes. Parameters ---------- styler_data : DataFrame Underlying ``Styler`` DataFrame used for reindexing. uuid : str The underlying ``Styler`` uuid for CSS id. d : dict The dictionary prior to final render Returns ------- render_dict : Dict rgcSsg|] }|D]}|qqSr)r))rsublistrDr)r)r*rsz'Tooltips._translate..c sRg|]%}ttjjD]}j||fs ||tjj||fq qSr))rrrYrHilocr_r!)rrrmaskrrUr1r)r*rs  rrrrz r5) rY reindex_likeemptyrWreqrrrGr5r!extendrZ)rUr`r1reritemr)rcr*r]s.    zTooltips._translateN)rUr#rVr!rSr) r1r!rr!rr4rr4r[r!)r`rr1r!rer) r%r&r'rrrVpropertyrZr_r]r)r)r)r*rK0s   +rKr5r8cs.gd|duotfdd|Dp|duS)a8 Indicate whether LaTeX {tabular} should be wrapped with a {table} environment. Parses the `table_styles` and detects any selectors which must be included outside of {tabular}, i.e. indicating that wrapping must occur, and therefore return True, or if a caption exists and requires similar. )toprulemidrule bottomrule column_formatNc3s|] }|dvVqdS)r"Nr))rreIGNORED_WRAPPERSr)r*r:sz._parse_latex_table_wrapping..)r;)r5r8r)ror*rns rnr"cCsD|dddD]}|d|krt|dddddSqdS) ux Return the first 'props' 'value' from ``tables_styles`` identified by ``selector``. Examples -------- >>> table_styles = [{'selector': 'foo', 'props': [('attr','value')], ... {'selector': 'bar', 'props': [('attr', 'overwritten')]}, ... {'selector': 'bar', 'props': [('a1', 'baz'), ('a2', 'ignore')]}] >>> _parse_latex_table_styles(table_styles, selector='bar') 'baz' Notes ----- The replacement of "§" with ":" is to avoid the CSS problem where ":" has structural significance and cannot be used in LaTeX labels, but is often required by them. Nr"r$rr§rG)r!r)r5r"rDr)r)r*rqs   rq latex_stylesr convert_cssc Cs|rt|}|dddD]P\}}d|d|dd|d|d|d|d|d|dd|d |dd }d||d |}d D]}|t|vr\||d t||d}nqFq |S)a Mutate the ``display_value`` string including LaTeX commands from ``latex_styles``. This method builds a recursive latex chain of commands based on the CSSList input, nested around ``display_value``. If a CSS style is given as ('', '') this is translated to '\{display_value}', and this value is treated as the display value for the next iteration. The most recent style forms the inner component, for example for styles: `[('c1', 'o1'), ('c2', 'o2')]` this returns: `\c1o1{\c2o2{display_value}}` Sometimes latex commands have to be wrapped with curly braces in different ways: We create some parsing flags to identify the different behaviours: - `--rwrap` : `\{}` - `--wrap` : `{\ }` - `--nowrap` : `\ ` - `--lwrap` : `{\} ` - `--dwrap` : `{\}{}` For example for styles: `[('c1', 'o1--wrap'), ('c2', 'o2')]` this returns: `{\c1o1 \c2o2{display_value}} Nrqz{\z --to_parse }\z --to_parse} z --to_parse{z --to_parse}{)--wrap--nowrap--lwrap--rwrap--dwrapr)rxrwryrzr{z --to_parserarg)_parse_latex_css_conversionr!r_parse_latex_options_strip)rsrrtcommandoptionsrr}r)r)r*rrs&  rrcelldict[str, Any]multirow_alignmulticol_alignwrapcCsd|vrX|d}d|vr0||ddd}t|d|d}d|d|d|dd Sd |vrX||d dd}t|d|d}d |d |d |dd S|rbd|dd S|dS)a Refactor the cell `display_value` if a 'colspan' or 'rowspan' attribute is present. 'rowspan' and 'colspan' do not occur simultaneouly. If they are detected then the `display_value` is altered to a LaTeX `multirow` or `multicol` command respectively, with the appropriate cell-span. ``wrap`` is used to enclose the `display_value` in braces which is needed for column headers using an siunitx package. Requires the package {multirow}, whereas multicol support is usually built in to the {tabular} environment. Examples -------- >>> cell = {'display_vale':'text', 'attributes': 'colspan="3"'} >>> _parse_latex_header_span(cell, 't', 'c') '\multicol{3}{c}{text}' rr Nrz \multicolumn{z}{rrurz \multirow[z]{z}{*}{{)findr4)rrrrattrscolspanrowspanr)r)r*rs+s&rsstr | int | floatr}cCs$t||dddddS)z Strip a css_value which may have latex wrapping arguments, css comment identifiers, and whitespaces, to a valid string for latex options parsing. For example: 'red /* --wrap */ ' --> 'red' rgz/*z*/)r!rrHr|r)r)r*rWs$rc Csdd}dd}dd}|t|ddd t|d d d |d }g}|D]F\}}t|tr9d |vr9|||d d f||vrgd }dD]} | t|vrU| t|| }}nqC||||} | durg|| gq!|S)z Convert CSS (attribute,value) pairs to equivalent LaTeX (command,options) pairs. Ignore conversion if tagged with `--latex` option, skipped if no conversion found. cSs|dks|dkr d|fSdS)Nboldbolderbfseriesr)r|r)r)r* font_weighths z0_parse_latex_css_conversion..font_weightcSs(|dkr d|fS|dkrd|fSdS)Nitalicitshapeobliqueslshaper)r|r)r)r* font_stylems   z/_parse_latex_css_conversion..font_stylec Ss|dkr|n|}|ddkr$t|dkr$|d|ddd|fS|ddkrTt|d krT|dd |d d |d d }|d|d|fS|dd d krtd |d}d|vrtt|dddnt|d}td|d}d|vrt|dddnt|d}|d dkrtd|d}n td|d}d|vrt|dddnt|d}|d|dd|dd|dd|fS|d|d|fS)a CSS colors have 5 formats to process: - 6 digit hex code: "#ff23ee" --> [HTML]{FF23EE} - 3 digit hex code: "#f0e" --> [HTML]{FF00EE} - rgba: rgba(128, 255, 0, 0.5) --> [rgb]{0.502, 1.000, 0.000} - rgb: rgb(128, 255, 0,) --> [rbg]{0.502, 1.000, 0.000} - string: red --> {red} Additionally rgb or rgba can be expressed in % which is also parsed. rgr#z[HTML]{rNrurgbz(?<=\()[0-9\s%]+(?=,)%rqdz(?<=,)[0-9\s%]+(?=,)az(?<=,)[0-9\s%]+(?=\))z[rgb]{z.3fz, r)rupperrefindallrHr&r4) ruser_argrcomm_argr}valrvgbr)r)r*rRts"  4(( (&z*_parse_latex_css_conversion..color cellcolorry)rrrRrg)z font-weightrPrRz font-stylez--latex)rwrxryr{rzN)rrDr!rrkeysrrh) rrrrRCONVERTED_ATTRIBUTESrs attributerr}r latex_styler)r)r*r~as0"      r~cCst|ddddddddd d d d d dddddddddddddddS)al Replace the characters ``&``, ``%``, ``$``, ``#``, ``_``, ``{``, ``}``, ``~``, ``^``, and ``\`` in the string with LaTeX-safe sequences. Use this if you need to display text that might contain such characters in LaTeX. Parameters ---------- s : str Input to be escaped Return ------ str : Escaped string rvu ab2§=§8yzu ab2§=§8yz uab2§=§8yz\space &z\&rz\%$z\$rz\#r=z\_rz\{ruz\}z~ z~\space ~z\textasciitilde z^ z^\space ^z\textasciicircum z\textbackslash )r)r9r)r)r*r/s r/) rr!rr!rrrr;rYr)rr)rGrrr;rr4rrr@)rr rYr )F)rrr?r4rr;rYr)rrrr!rr2rYr)NNNrNN)rr2rr2r?rrr!rr2rr2rYr)r7r8)rDr#rYrE)r5r r8r2rYr;)r5r r"r!rYr2)rsrErr!rtr;rYr!) rrrr!rr!rr;rYr!)rrr}r!rYr!)rrErYrE)Q __future__r collectionsr functoolsrrtypingrrrrr r r r r r1rnumpyrApandas._configr pandas._libsrpandas._typingrrpandas.compat._optionalrpandas.core.dtypes.genericrr,rrrrrrpandas.api.typesrpandas.core.commoncorecommonrr markupsaferr.r! BaseFormatter ExtFormatterr4r&CSSPairrEr#r r rr8r+rrrrrr@r+r1rrrJrKrnrqrrrsrr~r/r)r)r)r*sx  ,            6 ! H    - + %  1 , L