texttable

用于创建简单ASCII表格的Python模块

可用性

该模块可在PyPI上获取，并已被打包用于多个Linux/Unix平台 （Debian、 FreeBSD、Fedora、Suse等）。

依赖

如果可用，会使用cjkwrap库代替textwrap，以更好地包装CJK文本。

如果可用，会使用wcwidth库以获得更好的渲染效果（基本的emoji支持）。

文档

名称
    texttable - 用于创建简单ASCII表格的模块

文件
    /usr/local/lib/python2.7/dist-packages/texttable.py

描述

    示例：

        table = Texttable()
        table.set_cols_align(["l", "r", "c"])
        table.set_cols_valign(["t", "m", "b"])
        table.add_rows([["姓名", "年龄", "昵称"],
                        ["Xavier\nHuon\n先生", 32, "Xav'"],
                        ["Baptiste\nClement\n先生", 1, "Baby"],
                        ["Louise\nBourgeau\n女士", 28, "Lou\n\nLoue"]])
        print(table.draw())
        print()

        table = Texttable()
        table.set_deco(Texttable.HEADER)
        table.set_cols_dtype(['t',  # 文本
                              'f',  # 浮点数（小数）
                              'e',  # 浮点数（指数）
                              'i',  # 整数
                              'a']) # 自动
        table.set_cols_align(["l", "r", "r", "r", "l"])
        table.add_rows([["文本",    "浮点数", "指数", "整数", "自动"],
                        ["abcd",    "67",    654,   89,    128.001],
                        ["efghijk", 67.5434, .654,  89.6,  12800000000000000000000.00023],
                        ["lmn",     5e-78,   5e-78, 89.4,  .000000000000128],
                        ["opqrstu", .023,    5e+78, 92.,   12800000000000000000000]])
        print(table.draw())

    结果：

        +----------+-----+----------+
        |   姓名   | 年龄|   昵称   |
        +==========+=====+==========+
        | Xavier   |     |          |
        | Huon     |  32 |          |
        | 先生     |     |   Xav'   |
        +----------+-----+----------+
        | Baptiste |     |          |
        | Clement  |   1 |          |
        | 先生     |     |   Baby   |
        +----------+-----+----------+
        | Louise   |     |   Lou    |
        | Bourgeau |  28 |          |
        | 女士     |     |   Loue   |
        +----------+-----+----------+

         文本     浮点数       指数     整数    自动
        ==============================================
        abcd      67.000   6.540e+02    89   128.001
        efghijk   67.543   6.540e-01    90   1.280e+22
        lmn        0.000   5.000e-78    89   0.000
        opqrstu    0.023   5.000e+78    92   1.280e+22
类
class Texttable
 |  此处定义的方法：
 |
 |  __init__(self, max_width=80)
 |      构造函数
 |
 |      - max_width 是一个整数，指定表格的最大宽度
 |      - 如果设置为0，大小将不受限制，因此单元格不会被换行
 |
 |  add_row(self, array)
 |      在行堆栈中添加一行
 |
 |      - 单元格可以包含换行符和制表符
 |
 |  add_rows(self, rows, header=True)
 |      在行堆栈中添加多行
 |
 |      - 'rows' 参数可以是返回数组的迭代器，或者是二维数组
 |      - 'header' 指定是否应将第一行用作表格的标题
 |
 |  draw(self)
 |      绘制表格
 |
 |      - 表格作为一个完整的字符串返回
 |
 |  header(self, array)
 |      指定表格的标题
 |
 |  reset(self)
 |      重置实例
 |
 |      - 重置行和标题
 |
 |  set_chars(self, array)
 |      设置用于绘制行和列之间线条的字符
 |
 |      - 数组应包含4个字段：
 |
 |          [水平线, 垂直线, 交叉点, 标题线]
 |
 |      - 默认设置为：
 |
 |          ['-', '|', '+', '=']
 |
 |  set_cols_align(self, array)
 |      设置所需的列对齐方式
 |
 |      - 数组的元素应为 "l"、"c" 或 "r"：
 |
 |          * "l": 列左对齐
 |          * "c": 列居中对齐
 |          * "r": 列右对齐
 |
 |  set_cols_dtype(self, array)
 |      设置列的所需数据类型
 |
 |      - 数组的元素应为可调用对象或以下之一：
 |        "a"、"t"、"f"、"e" 或 "i"：
 |
 |          * "a": 自动（尝试使用最合适的数据类型）
 |          * "t": 作为文本处理
 |          * "f": 作为十进制格式的浮点数处理
 |          * "e": 作为指数格式的浮点数处理
 |          * "i": 作为整数处理
 |          * "b": 作为布尔值处理
 |          * 可调用对象：应为任何给定值返回格式化字符串
 |
 |      - 默认情况下，每列使用自动数据类型
 |
 |  set_cols_valign(self, array)
 |      设置所需的列垂直对齐方式
 |
 |      - 数组的元素应为 "t"、"m" 或 "b"：
 |
 |          * "t": 列在单元格顶部对齐
 |          * "m": 列在单元格中部对齐
 |          * "b": 列在单元格底部对齐
 |
 |  set_cols_width(self, array)
 |      设置所需的列宽
 |
 |      - 数组的元素应为整数，指定每列的宽度。例如：
 |
 |              [10, 20, 5]
 |
 |  set_deco(self, deco)
 |      设置表格装饰
 |
 |      - 'deco' 可以是以下组合：
 |
 |          Texttable.BORDER: 表格周围的边框
 |          Texttable.HEADER: 标题下方的水平线
 |          Texttable.HLINES: 行之间的水平线
 |          Texttable.VLINES: 列之间的垂直线
 |
 |         默认情况下全部启用
 |
 |      - 示例：
 |
 |          Texttable.BORDER | Texttable.HEADER
 |
 |  set_header_align(self, array)
 |      设置所需的标题对齐方式
 |
 |      - 数组的元素应为 "l"、"c" 或 "r"：
 |
 |          * "l": 列左对齐
 |          * "c": 列居中对齐
 |          * "r": 列右对齐
 |
 |  set_max_width(self, max_width)
 |      设置表格的最大宽度
 |
 |      - max_width 是一个整数，指定表格的最大宽度
 |      - 如果设置为0，大小将不受限制，因此单元格不会被换行
 |
 |  set_precision(self, width)
 |      设置浮点数/指数格式的所需精度
 |
 |      - width 必须是大于等于0的整数
 |
 |      - 默认值设置为3
 |
 |  ----------------------------------------------------------------------
 |  此处定义的数据和其他属性：
 |
 |  BORDER = 1
 |
 |  HEADER = 2
 |
 |  HLINES = 4
 |
 |  VLINES = 8

数据
    __all__ = ['Texttable', 'ArraySizeError']
    __author__ = 'Gerome Fournier <jef(at)foutaise.org>'
    __credits__ = 'Jeff Kowalczyk:\n    - textwrap 改进导入\n ...等...'
    __license__ = 'MIT'
    __version__ = '1.7.0'

版本
    1.7.0
作者
    Gerome Fournier <jef(at)foutaise.org>

贡献者
    Jeff Kowalczyk:
        - 改进了textwrap的导入
        - 关于头部输出的注释

    匿名用户:
        - add_rows方法，用于一次性添加多行

    Sergey Simonenko:
        - 重新定义了len()函数以处理非ASCII字符

    Roger Lew:
        - 列数据类型规范

    Brian Peterson:
        - 更好地处理unicode错误

    Frank Sachsenheim:
        - 增加Python 2/3兼容性

    Maximilian Hils:
        - 修复Python 3兼容性的小bug

    frinkelpi:
        - 保留空行

分支

* [latextable](https://github.com/JAEarly/latextable)是texttable的一个分支，提供了LaTeX后端支持。