h6SrSSKrSSKrSSKJr SSKJrJrJrJ r J r J r Sr \R"S5rSrS SjrS rSS jrSS jrS rg)a Functions that render ASCII tables. Some generic notes about the table formatting functions in this module: - These functions were not written with performance in mind (*at all*) because they're intended to format tabular data to be presented on a terminal. If someone were to run into a performance problem using these functions, they'd be printing so much tabular data to the terminal that a human wouldn't be able to digest the tabular data anyway, so the point is moot :-). - These functions ignore ANSI escape sequences (at least the ones generated by the :mod:`~humanfriendly.terminal` module) in the calculation of columns widths. On reason for this is that column names are highlighted in color when connected to a terminal. It also means that you can use ANSI escape sequences to highlight certain column's values if you feel like it (for example to highlight deviations from the norm in an overview of calculated values). N) coerce_string) ansi_strip ansi_width ansi_wrapterminal_supports_colorsfind_terminal_sizeHIGHLIGHT_COLOR)format_pretty_tableformat_robust_tableformat_rst_tableformat_smart_tablez ^\d+(\.\d+)?$c&UVs/sHn[U5PM nn[U5n[SU55(dE[X5n[[ [ UR 555n[5upVXF::aU$[X5$s snf)a Render tabular data using the most appropriate representation. :param data: An iterable (e.g. a :func:`tuple` or :class:`list`) containing the rows of the table, where each row is an iterable containing the columns of the table (strings). :param column_names: An iterable of column names (strings). :returns: The rendered table (a string). If you want an easy way to render tabular data on a terminal in a human friendly format then this function is for you! It works as follows: - If the input data doesn't contain any line breaks the function :func:`format_pretty_table()` is used to render a pretty table. If the resulting table fits in the terminal without wrapping the rendered pretty table is returned. - If the input data does contain line breaks or if a pretty table would wrap (given the width of the terminal) then the function :func:`format_robust_table()` is used to render a more robust table that can deal with data containing line breaks and long text. c3F# UHn[SU55v M g7f)c3,# UH nSU;v M g7f N).0cs N/var/www/fran/franai/venv/lib/python3.13/site-packages/humanfriendly/tables.py /format_smart_table...[s(a419asN)anyrrs rr%format_smart_table..[s7$Qs(a((($s!) normalize_columnsrr maxmapr splitlinesrr )data column_namesr pretty_table table_widthnum_rows num_columnss rr r >s2+/ /$Q a $D /$\2L 7$7 7 7*4> #j,*A*A*CDE 2 4  %  t 22 0sBc UVs/sH n[USS9PM nnUbN[U5nU(a<[5(aUVs/sHn[U5PM nnURSU5 [R "[ 5n[R "[5n[U5Hyup[U 5Heup[Xj[U 55Xj'U(aUS:XaM-XzR[[R[U 5555 Mg M{ U[!UR#55[%U5S--S--n U /n [U5HupU/n[U 5HpupSXj[U 5- -n['Xz5(aURSU-U -S-5 OURSU -U-S-5 URU5 Mr U RSR)U55 U(dMUS:XdMU RU 5 M U RU 5 SR)U 5$s snfs snf) a Render a table using characters like dashes and vertical bars to emulate borders. :param data: An iterable (e.g. a :func:`tuple` or :class:`list`) containing the rows of the table, where each row is an iterable containing the columns of the table (strings). :param column_names: An iterable of column names (strings). :param horizontal_bar: The character used to represent a horizontal bar (a string). :param vertical_bar: The character used to represent a vertical bar (a string). :returns: The rendered table (a string). Here's an example: >>> from humanfriendly.tables import format_pretty_table >>> column_names = ['Version', 'Uploaded on', 'Downloads'] >>> humanfriendly_releases = [ ... ['1.23', '2015-05-25', '218'], ... ['1.23.1', '2015-05-26', '1354'], ... ['1.24', '2015-05-26', '223'], ... ['1.25', '2015-05-26', '4319'], ... ['1.25.1', '2015-06-02', '197'], ... ] >>> print(format_pretty_table(humanfriendly_releases, column_names)) ------------------------------------- | Version | Uploaded on | Downloads | ------------------------------------- | 1.23 | 2015-05-25 | 218 | | 1.23.1 | 2015-05-26 | 1354 | | 1.24 | 2015-05-26 | 223 | | 1.25 | 2015-05-26 | 4319 | | 1.25.1 | 2015-06-02 | 197 | ------------------------------------- Notes about the resulting table: - If a column contains numeric data (integer and/or floating point numbers) in all rows (ignoring column names of course) then the content of that column is right-aligned, as can be seen in the example above. The idea here is to make it easier to compare the numbers in different columns to each other. - The column names are highlighted in color so they stand out a bit more (see also :data:`.HIGHLIGHT_COLOR`). The following screen shot shows what that looks like (my terminals are always set to white text on a black background): .. image:: images/pretty-table.png T) expandtabsr r)rrhighlight_column_nameinsert collections defaultdictintlist enumeraterrappendboolNUMERIC_DATA_PATTERNmatchrsumvalueslenalljoin)r!r"horizontal_bar vertical_barrnwidths numeric_data row_indexrow column_indexcolumnline_delimiterlineslinepaddings rr r hsh<@ @4a aD 14D @(6 '))BNO,Q 5a 8, O KK< (  $ $S )F**40L#D/ $-cN L#&v';Z=O#PF  Y!^*11$7K7Q7QR\]cRd7e2fg%3* $s6==?';c&kAo'MPQ'QRN  E#D/ ~$-cN LV1Jv4FFGG<-.. C'MF2S89 C&L72S89 KK % %3  SXXd^$ >> from humanfriendly.tables import format_robust_table >>> column_names = ['Version', 'Uploaded on', 'Downloads'] >>> humanfriendly_releases = [ ... ['1.23', '2015-05-25', '218'], ... ['1.23.1', '2015-05-26', '1354'], ... ['1.24', '2015-05-26', '223'], ... ['1.25', '2015-05-26', '4319'], ... ['1.25.1', '2015-06-02', '197'], ... ] >>> print(format_robust_table(humanfriendly_releases, column_names)) ----------------------- Version: 1.23 Uploaded on: 2015-05-25 Downloads: 218 ----------------------- Version: 1.23.1 Uploaded on: 2015-05-26 Downloads: 1354 ----------------------- Version: 1.24 Uploaded on: 2015-05-26 Downloads: 223 ----------------------- Version: 1.25 Uploaded on: 2015-05-26 Downloads: 4319 ----------------------- Version: 1.25.1 Uploaded on: 2015-06-02 Downloads: 197 ----------------------- The column names are highlighted in bold font and color so they stand out a bit more (see :data:`.HIGHLIGHT_COLOR`). z%s:rr+c3T# UHn[[[U55v M g7fN)rrr)rrGs rr&format_robust_table..sGus3z5122s&(z %s -rr,c3D# UHnSRU5v M g7frr<)rbs rrrMs8A%**Q-- )rrr-r3stripr4extendrstripr rrminr.r<) r!r"blocksr?rCrGrD column_textstripped_columnr%r& longest_line delimiters rr r sO^F'8'FG'F!EAI'FLG!!:FG,Q-a0, G)23DS3I)J %L)//1O?* (BOTU  \78 [//1<<>?*K  e /0HGGGLS3|#AABI MM!R MM" >>88 8 > > @@9HGs E.E3cUVs/sHn[U5PM nnU(aURS[U55 [R"[5nUH0n[ U5HupV[ X5[U55X5'M M2 UH@n[ U5H.upVU[U5S- :dMURX55XE'M0 MB [UR55VVs/sH upxSU-PM n nnU(aURSU 5 URSU 5 URU 5 SRSU55$s snfs snnf)aI Render a table in reStructuredText_ format. :param data: An iterable (e.g. a :func:`tuple` or :class:`list`) containing the rows of the table, where each row is an iterable containing the columns of the table (strings). :param column_names: An iterable of column names (strings). :returns: The rendered table (a string). Here's an example: >>> from humanfriendly.tables import format_rst_table >>> column_names = ['Version', 'Uploaded on', 'Downloads'] >>> humanfriendly_releases = [ ... ['1.23', '2015-05-25', '218'], ... ['1.23.1', '2015-05-26', '1354'], ... ['1.24', '2015-05-26', '223'], ... ['1.25', '2015-05-26', '4319'], ... ['1.25.1', '2015-06-02', '197'], ... ] >>> print(format_rst_table(humanfriendly_releases, column_names)) ======= =========== ========= Version Uploaded on Downloads ======= =========== ========= 1.23 2015-05-25 218 1.23.1 2015-05-26 1354 1.24 2015-05-26 223 1.25 2015-05-26 4319 1.25.1 2015-06-02 197 ======= =========== ========= .. _reStructuredText: https://en.wikipedia.org/wiki/ReStructuredText rr*=rc3D# UHnSRU5v M g7f)z NrPrs rr#format_rst_table..Gs04aTYYq\\4rR) rr.r/r0r1r3rr:ljustsorteditemsr4r<) r!r"rr@rCindexrEiwr[s rr r s%D+/ /$Q a $D / A(67  $ $S )F&s^ME s6{;FM,&s^MEC1 %#\\&-8 , &,FLLN%;<%;TQq%;I< Ay!KK9KK  99040 00) 0=s E0Ec/nUH6n[U5nU(aUR5nURU5 M8 U$rL)rr(r4)rCr(resultsvaluetexts rrrJs=GU# ??$Dt  Nc [US[S9$)NT)boldcolor)rr )names rr-r-Ts TO <rvs_( / "zz"23'3TWtLA^61r=rj