访问官网
Githubtexttable
用于创建简单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后端支持。
