.PhU dZddlmZddlZddlmZddlmZm Z m Z  ddl m Z e d Z n#e$r eZ YnwxYw d gZdd Zdd Zedeeeeeeeeeejejejejh Z Gd de!Z"GddZ#Gdde#Z$Gdde#Z%Gdde#Z&Gdde#Z'Gdde#Z(Gdd Z)dS)a If there is one recurring theme in ``boltons``, it is that Python has excellent datastructures that constitute a good foundation for most quick manipulations, as well as building applications. However, Python usage has grown much faster than builtin data structure power. Python has a growing need for more advanced general-purpose data structures which behave intuitively. The :class:`Table` class is one example. When handed one- or two-dimensional data, it can provide useful, if basic, text and HTML renditions of small to medium sized data. It also heuristically handles recursive data of various formats (lists, dicts, namedtuples, objects). For more advanced :class:`Table`-style manipulation check out the `pandas`_ DataFrame. .. _pandas: http://pandas.pydata.org/ )escapeN)islice)SequenceMappingMutableSequence) make_sentinel_MISSING)var_nameTablec< t|}ne#t$rX tt|}n7#t$r*tt|}YnwxYwYnwxYw|r#t ||kr|d|dz dz}|S)Nz...)str Exceptionreprobject__repr__lenobjmaxlentexts R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/boltons/tableutils.pyto_textrTs-3xx --- -tCyy>>DD - - -vs++,,DDD -- )#d))f$$KVaZK 5( Ks/ A4:A41A.+A4-A..A43A4cFt||}t|dS)NrT)quote)r html_escapers r escape_htmlrbs' 3v & & &D t4 ( ( ((ceZdZdS)UnsupportedDataN)__name__ __module__ __qualname__r rr"r"msDr r"ceZdZdZdZdS) InputTypecdSNr&)selfakws r__init__zInputType.__init__rs r c$fd|DS)Nc<g|]}|Sr&) get_entry).0entryheadersr+s r z+InputType.get_entry_seq..vs'EEE5ug..EEEr r&)r+data_seqr4s` `r get_entry_seqzInputType.get_entry_sequs!EEEEEHEEEEr N)r#r$r%r.r7r&r rr(r(qs7   FFFFFr r(c&eZdZdZdZdZdZdS) DictInputTypec,t|tSr*) isinstancerr+rs r check_typezDictInputType.check_typezs#w'''r cDt|Sr*)sortedkeysr<s r guess_headerszDictInputType.guess_headers}schhjj!!!r c fd|DS)Nc:g|]}|Sr&getr2hrs rr5z+DictInputType.get_entry..s#,,,q ,,,r r&r+rr4s ` rr1zDictInputType.get_entrys,,,,G,,,,r c fd|DS)Nc.g|]fdDS)c:g|]}|Sr&rD)r2rGcis rr5z:DictInputType.get_entry_seq...s#,,,q,,,r r&)r2rLr4s @rr5z/DictInputType.get_entry_seq..s/;;;,,,,G,,,;;;r r&rHs `rr7zDictInputType.get_entry_seqs;;;;s;;;;r Nr#r$r%r=rAr1r7r&r rr9r9ysP((("""---<<<<.s)))AQ)))r r&res rr7zTupleInputType.get_entry_seqs))))))r NrMr&r rrhrhsP&&&*****r rhc&eZdZdZdZdZdZdS)NamedTupleInputTypecLt|dot|tS)N_fields)rTr;rjr<s rr=zNamedTupleInputType.check_types!sI&&A:c5+A+AAr c*t|jSr*)rnrur<s rrAz!NamedTupleInputType.guess_headerssCK   r c fd|DS)Nc2g|]}t|dSr*rWrFs rr5z1NamedTupleInputType.get_entry..s%777!Q%%777r r&rHs ` rr1zNamedTupleInputType.get_entrys7777w7777r c fd|DS)Nc.g|]fdDS)c2g|]}t|dSr*ryrFs rr5z@NamedTupleInputType.get_entry_seq...s%8881a&&888r r&)r2rr4s @rr5z5NamedTupleInputType.get_entry_seq..s/LLLS8888888LLLr r&res `rr7z!NamedTupleInputType.get_entry_seqsLLLLGLLLLr NrMr&r rrsrssXBBB!!!888MMMMMr rsc~eZdZdZeeeeegZ d\Z Z d\Z Z d\ZZd\ZZd\ZZd\ZZdedfd Zd Zdd Zd ZeeddfdZeeddfdZeeddfdZeedfdZdZ dZ!dZ" ddZ#dZ$dZ%dZ&ddZ'dS)r aM This Table class is meant to be simple, low-overhead, and extensible. Its most common use would be for translation between in-memory data structures and serialization formats, such as HTML and console-ready text. As such, it stores data in list-of-lists format, and *does not* copy lists passed in. It also reserves the right to modify those lists in a "filling" process, whereby short lists are extended to the width of the table (usually determined by number of headers). This greatly reduces overhead and processing/validation that would have to occur otherwise. General description of headers behavior: Headers describe the columns, but are not part of the data, however, if the *headers* argument is omitted, Table tries to infer header names from the data. It is possible to have a table with no headers, just pass in ``headers=None``. Supported inputs: * :class:`list` of :class:`list` objects * :class:`dict` (list/single) * :class:`object` (list/single) * :class:`collections.namedtuple` (list/single) * TODO: DB API cursor? * TODO: json Supported outputs: * HTML * Pretty text (also usable as GF Markdown) * TODO: CSV * TODO: json * TODO: json lines To minimize resident size, the Table data is stored as a list of lists. )zz)zz)zz)zz)zz)zz
Nc|tur*g}|r&t|dt|dd}}|pg|_|pi|_g|_d|_||dS)Nrr)r rnrr4metadata_data_widthextend)r+datar4rs rr.zTable.__init__sv h  G E $T!W vdAt/D/D}"  B    Dr c|sdS|j|||dS)z@ Append the given data to the end of the Table. N)rr _set_width_fill)r+rs rrz Table.extendsH  F $  r Fc|rd|_|jrdS|jrt|j|_dStd|jD|_dS)Nrc,g|]}t|Sr&r)r2ds rr5z$Table._set_width..%s666a3q66666r )rr4rmaxr)r+resets rrzTable._set_widthsd  DK ;  F < dl++DK F664:66677 r c|jdg}}|sdS|jD]2}|t|z }|dkr|||z3dS)Nr)rrrr)r+widthfillerrrems rrz Table._fill'sa dVv  F ' 'A#a&&.CQww#&&&r rcN||||t|S)zCreate a Table from a :class:`dict`. Operates the same as :meth:`from_data`, but forces interpretation of the data as a Mapping. rr4 max_depth _data_typer) from_datar9clsrr4rrs r from_dictzTable.from_dict1/ }}$'0]__&.00 0r cN||||t|S)zCreate a Table from a :class:`list`. Operates the same as :meth:`from_data`, but forces the interpretation of the data as a Sequence. r)rr_rs r from_listzTable.from_list;rr cN||||t|S)zCreate a Table from an :class:`object`. Operates the same as :meth:`from_data`, but forces the interpretation of the data as an object. May be useful for some :class:`dict` and :class:`list` subtypes. r)rrOrs r from_objectzTable.from_objectEs1}}$'0_=N=N&.00 0r c |dd}|dd}|dkr |||St|t}|rA|s |||S|d}|s'|jD]} | |r| }nd}|}n(t |t vr||gg||S|}|sB|jD]} | |r| }n tdt |z|tur| |}|r| ||} n| ||g} |dkrw|dz } t| D]b\} } t| D]M\}}t |t vr | || | | |<>#t$rYJwxYwc|| ||S) aCreate a Table from any supported data, heuristically selecting how to represent the data in Table format. Args: data (object): Any object or iterable with data to be imported to the Table. headers (iterable): An iterable of headers to be matched to the data. If not explicitly passed, headers will be guessed for certain datatypes. max_depth (int): The level to which nested Tables should be created (default: 1). _data_type (InputType subclass): For advanced use cases, do not guess the type of the input data, use this data type instead. rNrr)r4rrFzunsupported data type %rr)popr;r _input_typesr=rRrSr"r rAr7r1 enumerater)rrr4rkwargsrris_seqto_checkitentries new_max_depthir3jcells rrzTable.from_dataPs0::j$//ZZ d33 q==3w::: :D(++   ?s7X>>>>AwH $*$$B}}X..%'  #F#HDzzT!!sTF8WxHHHHH 4& 4 4==**!#JE&&@(,T '3444 h   ..x88G  < ..tW==GG!++D'::;G q==%MM%g.. ! !5(//!!GAtDzzT)) !(+ d@M)6)O)O 1 *!!! !!s7Gh????s F>> G  G c*t|jSr*)rr)r+s r__len__z Table.__len__s4:r c|j|Sr*)r)r+idxs r __getitem__zTable.__getitem__sz#r cl|jj}|jr|d|jd|jdS|d|jdS)Nz (headers=z, data=)()rQr#r4r)r+cns rrzTable.__repr__sR ^ $ < +II4<II$*III I**4:*** *r Tcg}g}|rq|jrjt|j|} | d|d|} |dkr*|| |d|rT|jrM||j|dg|jt|jz z|r||j |pd}|d  } | d krt|d krd nd } | d kr| |||n1| d kr| |||ntd|z|r7|jr0|dkr*|d|| |r||j|rdnd} | |S)aRender this Table to HTML. Configure the structure of Table HTML by subclassing and overriding ``_html_*`` class attributes. Args: orientation (str): one of 'auto', 'horizontal', or 'vertical' (or the first letter of any of those). Default 'auto'. wrapped (bool): whether or not to include the wrapping '
' tags. Default ``True``, set to ``False`` if appending multiple Table outputs or an otherwise customized HTML wrapping tag is needed. with_newlines (bool): Set to ``True`` if output should include added newlines to make the HTML more readable. Default ``False``. with_metadata (bool/str): Set to ``True`` if output should be preceded with a Table of preset metadata, if it exists. Set to special value ``'bottom'`` if the metadata Table HTML should come *after* the main HTML output. max_depth (int): Indicate how deeply to nest HTML tables before simply reverting to :func:`repr`-ing the nested data. Returns: A text string of the HTML of the rendered table. rTF) with_headers with_newlines with_metadatarbottomz
Nautorr,rrGv)r4rz;expected one of 'auto', 'vertical', or 'horizontal', not %r )rr rto_htmlrYr4rrr_html_table_taglower_add_horizontal_html_lines_add_vertical_html_lines ValueError_html_table_tag_closejoin) r+ orientationwrappedrrrrlinesr4metadata_table metadata_htmlolseps rrz Table.to_htmlsL<  'T] '"__T]7@-BBN*22ANAF=F3HHM(( ]+++ X&&&  GDL G NN4< ( ( ( NND6T[3t|3D3D%DE F F F  / LL- . . .!+V ^ ! ! # # 99D A 3B 99  + +E76? , A A A A 3YY  ) )%4= * ? ? ? ?57BCDD D  (T] (}/H/H LL " " " LL ' ' '  5 LL3 4 4 4#+ddxxr c t|S)zCalled on each value in an HTML table. By default it simply escapes the HTML. Override this method to add additional conditions and behaviors, but take care to ensure the final output is HTML escaped. )r)r+values r get_cell_htmlzTable.get_cell_htmls 5!!!r c  |j |dkr|dz n|}|dkr|dz }|r|j|jz}||j||j|jz| fd|Dz|jz|jz||j|j|j z|j |j z|j |jz}}}||j |j D]} |dkreg} | D]_} t| tr*| | |A|  | `n fd| D} |d||| |g||jdS)Nrc&g|] }|Sr&r&)r2rGescs rr5z4Table._add_horizontal_html_lines..s!$=$=$=SSVV$=$=$=r rc&g|] }|Sr&r&)r2crs rr5z4Table._add_horizontal_html_lines..s!333!ss1vv333r r)r_html_th_close_html_thrY _html_thead_html_trr_html_tr_close_html_thead_close_html_td_html_td_close _html_tbodyrr;r r_html_tbody_close) r+rr4r new_depth_ththtrtd_tdtd_td_trrow _fill_partsrrs @rrz Table._add_horizontal_html_liness %.]]IMM q==!A I  1'$-7E LL) * * * LL6$=$=$=$=W$=$=$=>>?,-/3/BC D D D LL/ 0 0 0#}t}<#2T]B#2T5HHe  T%&&&: K KC1}} 66D!$..6#**4<<)<+L+LMMMM#**33t995555 6 4333s333 LL$ ;(?(?!HII J J J J T+,,,,,r c|j|dkr|dz n|}|j|j|j}}}|j|j|jz} }|j|jz} t|jD]|g} |r'| |||g|dkr}|dz }g} |j D]m} | }t|tr*| ||I| | nnfd|j D} | || | | g| d| dS)Nrrc2g|]}|Sr&r&)r2rrrs rr5z2Table._add_vertical_html_lines..*s%AAAsss3q6{{AAAr r)rrrrrrrrangerrrr;r rYrr)r+rr4rrtrth_thtdrr line_partsrrrrrs @@rrzTable._add_vertical_html_liness %.]]IMM mT]D4GBM4#6#FE$t'::t{## . .AJ >!!2ss71:"<===1}}%M  :88Cq6D!$..8#**4<<)<+L+LMMMM#**33s1v;;7777 8BAAAAdjAAA   r5::k#:#:FC D D D LL,, - - - -! . .r c  g}g t|j}fd|jD}t|jD]i}d|D}|r7|t t|| t|j|rs|d fdt|D|d d D|D]C}|d fdt|DDd |S) aGet the Table's textual representation. Only works well for Tables with non-recursive data. Args: with_headers (bool): Whether to include a header row at the top. maxlen (int): Max length of data in each cell. c,g|]}fd|DS)c2g|]}t|S)r)r)r2rrs rr5z,Table.to_text...9s&CCCtgd6222CCCr r&)r2rrs rr5z!Table.to_text..9s>,,,DCCCsCCC,,,r c,g|]}t|Sr&r)r2curs rr5z!Table.to_text..<s888s#c((888r rz | cLg|] \}}||!Sr&center)r2rrGwidthss rr5z!Table.to_text..AsC%E%E%E)-A&'XXfQi%8%8%E%E%Er z-|-cg|]}d|zS)-r&)r2ws rr5z!Table.to_text..Cs$=$=$=S1W$=$=$=r cLg|] \}}||!Sr&r)r2rrrs rr5z!Table.to_text..EsC%D%D%D)0D&*[[%;%;%D%D%Dr r) rnr4rrrrYrrrrr) r+rrrr4 text_datar cur_widthsrrs ` @rrz Table.to_text.st|$$,,,, $ ,,, %% + +C88i888J M!!#ggcl6&J&J&J"K"KLLL MM#j// * * * *  @ LL%E%E%E%E1:71C1C%E%E%EFF G G G LL$=$=f$=$=$=>> ? ? ? F FC LL%D%D%D%D4=cNN%D%D%DEE F F F Fyyr )F)NTTTFr)TN)(r#r$r%__doc__r9r_rsrhrOrrrrrrrrrrrrrr r.rrr classmethodrrrrrrrrrrrrr&r rr r s %%P"MOO]]__''))>>+;+;#O%%'L /Hn.Hn.Hn%:"K"%:"K".C*O* (T    8888%-T000[0%-T000[0'/1t000[0%-K@K@K@[K@Z+++1515/0DDDDL"""---:...0      r r*)*rhtmlrrtypes itertoolsrcollections.abcrrr typeutilsr r ImportErrorr__all__rrrRboolcomplexfloatNotImplementedslicerbytesint FunctionType MethodTypeBuiltinFunctionType GeneratorTyperS TypeErrorr"r(r9rOr_rhrsr r&r rrs>*'&&&&& >>>>>>>>>>((((((}j111HHvxxHHH$ )    )))) T D'5$$~*>*> UC E, !5#68      i   FFFFFFFF < < < <