用于创建简单ascii表的python模块。

texttable · PyPI

  1. NAME
  2.     texttable - module for creating simple ASCII tables
  4. FILE
  5.     /usr/local/lib/python2.7/dist-packages/texttable.py
  7. DESCRIPTION
  9.     Example:
  11.         table = Texttable()
  12.         table.set_cols_align(["l", "r", "c"])
  13.         table.set_cols_valign(["t", "m", "b"])
  14.         table.add_rows([["Name", "Age", "Nickname"],
  15.                         ["Mr\nXavier\nHuon", 32, "Xav'"],
  16.                         ["Mr\nBaptiste\nClement", 1, "Baby"],
  17.                         ["Mme\nLouise\nBourgeau", 28, "Lou\n\nLoue"]])
  18.         print table.draw() + "\n"
  20.         table = Texttable()
  21.         table.set_deco(Texttable.HEADER)
  22.         table.set_cols_dtype(['t',  # text
  23.                               'f',  # float (decimal)
  24.                               'e',  # float (exponent)
  25.                               'i',  # integer
  26.                               'a']) # automatic
  27.         table.set_cols_align(["l", "r", "r", "r", "l"])
  28.         table.add_rows([["text",    "float", "exp", "int", "auto"],
  29.                         ["abcd",    "67",    654,   89,    128.001],
  30.                         ["efghijk", 67.5434, .654,  89.6,  12800000000000000000000.00023],
  31.                         ["lmn",     5e-78,   5e-78, 89.4,  .000000000000128],
  32.                         ["opqrstu", .023,    5e+78, 92.,   12800000000000000000000]])
  33.         print table.draw()
  35.     Result:
  37.         +----------+-----+----------+
  38.         |   Name   | Age | Nickname |
  39.         +==========+=====+==========+
  40.         | Mr       |     |          |
  41.         | Xavier   |  32 |          |
  42.         | Huon     |     |   Xav'   |
  43.         +----------+-----+----------+
  44.         | Mr       |     |          |
  45.         | Baptiste |   1 |          |
  46.         | Clement  |     |   Baby   |
  47.         +----------+-----+----------+
  48.         | Mme      |     |   Lou    |
  49.         | Louise   |  28 |          |
  50.         | Bourgeau |     |   Loue   |
  51.         +----------+-----+----------+
  53.          text     float       exp      int     auto
  54.         ==============================================
  55.         abcd      67.000   6.540e+02    89   128.001
  56.         efghijk   67.543   6.540e-01    90   1.280e+22
  57.         lmn        0.000   5.000e-78    89   0.000
  58.         opqrstu    0.023   5.000e+78    92   1.280e+22
  60. CLASSES
  61.     class Texttable
  62.      |  Methods defined here:
  63.      |
  64.      |  __init__(self, max_width=80)
  65.      |      Constructor
  66.      |
  67.      |      - max_width is an integer, specifying the maximum width of the table
  68.      |      - if set to 0, size is unlimited, therefore cells won't be wrapped
  69.      |
  70.      |  add_row(self, array)
  71.      |      Add a row in the rows stack
  72.      |
  73.      |      - cells can contain newlines and tabs
  74.      |
  75.      |  add_rows(self, rows, header=True)
  76.      |      Add several rows in the rows stack
  77.      |
  78.      |      - The 'rows' argument can be either an iterator returning arrays,
  79.      |        or a by-dimensional array
  80.      |      - 'header' specifies if the first row should be used as the header
  81.      |        of the table
  82.      |
  83.      |  draw(self)
  84.      |      Draw the table
  85.      |
  86.      |      - the table is returned as a whole string
  87.      |
  88.      |  header(self, array)
  89.      |      Specify the header of the table
  90.      |
  91.      |  reset(self)
  92.      |      Reset the instance
  93.      |
  94.      |      - reset rows and header
  95.      |
  96.      |  set_chars(self, array)
  97.      |      Set the characters used to draw lines between rows and columns
  98.      |
  99.      |      - the array should contain 4 fields:
  100.      |
  101.      |          [horizontal, vertical, corner, header]
  102.      |
  103.      |      - default is set to:
  104.      |
  105.      |          ['-', '|', '+', '=']
  106.      |
  107.      |  set_cols_align(self, array)
  108.      |      Set the desired columns alignment
  109.      |
  110.      |      - the elements of the array should be either "l", "c" or "r":
  111.      |
  112.      |          * "l": column flushed left
  113.      |          * "c": column centered
  114.      |          * "r": column flushed right
  115.      |
  116.      |  set_cols_dtype(self, array)
  117.      |      Set the desired columns datatype for the cols.
  118.      |
  119.      |      - the elements of the array should be either a callable or any of
  120.      |        "a", "t", "f", "e" or "i":
  121.      |
  122.      |          * "a": automatic (try to use the most appropriate datatype)
  123.      |          * "t": treat as text
  124.      |          * "f": treat as float in decimal format
  125.      |          * "e": treat as float in exponential format
  126.      |          * "i": treat as int
  127.      |          * a callable: should return formatted string for any value given
  128.      |
  129.      |      - by default, automatic datatyping is used for each column
  130.      |
  131.      |  set_cols_valign(self, array)
  132.      |      Set the desired columns vertical alignment
  133.      |
  134.      |      - the elements of the array should be either "t", "m" or "b":
  135.      |
  136.      |          * "t": column aligned on the top of the cell
  137.      |          * "m": column aligned on the middle of the cell
  138.      |          * "b": column aligned on the bottom of the cell
  139.      |
  140.      |  set_cols_width(self, array)
  141.      |      Set the desired columns width
  142.      |
  143.      |      - the elements of the array should be integers, specifying the
  144.      |        width of each column. For example:
  145.      |
  146.      |              [10, 20, 5]
  147.      |
  148.      |  set_deco(self, deco)
  149.      |      Set the table decoration
  150.      |
  151.      |      - 'deco' can be a combinaison of:
  152.      |
  153.      |          Texttable.BORDER: Border around the table
  154.      |          Texttable.HEADER: Horizontal line below the header
  155.      |          Texttable.HLINES: Horizontal lines between rows
  156.      |          Texttable.VLINES: Vertical lines between columns
  157.      |
  158.      |         All of them are enabled by default
  159.      |
  160.      |      - example:
  161.      |
  162.      |          Texttable.BORDER | Texttable.HEADER
  163.      |
  164.      |  set_header_align(self, array)
  165.      |      Set the desired header alignment
  166.      |
  167.      |      - the elements of the array should be either "l", "c" or "r":
  168.      |
  169.      |          * "l": column flushed left
  170.      |          * "c": column centered
  171.      |          * "r": column flushed right
  172.      |
  173.      |  set_max_width(self, max_width)
  174.      |      Set the maximum width of the table
  175.      |
  176.      |      - max_width is an integer, specifying the maximum width of the table
  177.      |      - if set to 0, size is unlimited, therefore cells won't be wrapped
  178.      |
  179.      |  set_precision(self, width)
  180.      |      Set the desired precision for float/exponential formats
  181.      |
  182.      |      - width must be an integer >= 0
  183.      |
  184.      |      - default value is set to 3
  185.      |
  186.      |  ----------------------------------------------------------------------
  187.      |  Data and other attributes defined here:
  188.      |
  189.      |  BORDER = 1
  190.      |
  191.      |  HEADER = 2
  192.      |
  193.      |  HLINES = 4
  194.      |
  195.      |  VLINES = 8
  197. DATA
  198.     __all__ = ['Texttable', 'ArraySizeError']
  199.     __author__ = 'Gerome Fournier <jef(at)foutaise.org>'
  200.     __credits__ = 'Jeff Kowalczyk:\n    - textwrap improved import\n ...at...
  201.     __license__ = 'MIT'
  202.     __version__ = '1.6.2'
  204. VERSION
  205.     1.6.2
  207. AUTHOR
  208.     Gerome Fournier <jef(at)foutaise.org>
  210. CREDITS
  211.     Jeff Kowalczyk:
  212.         - textwrap improved import
  213.         - comment concerning header output
  215.     Anonymous:
  216.         - add_rows method, for adding rows in one go
  218.     Sergey Simonenko:
  219.         - redefined len() function to deal with non-ASCII characters
  221.     Roger Lew:
  222.         - columns datatype specifications
  224.     Brian Peterson:
  225.         - better handling of unicode errors
  227.     Frank Sachsenheim:
  228.         - add Python 2/3-compatibility
  230.     Maximilian Hils:
  231.         - fix minor bug for Python 3 compatibility
  233.     frinkelpi:
  234.         - preserve empty lines